Perchance AI

Perchance is a versatile tool designed for creating and sharing custom random generators. Catering to users from hobbyists to developers, Perchance provides a straightforward way to generate random outputs using a user-friendly syntax. The core functionality allows users to define lists of items and reference these lists in generator templates. For example, a user can create a list of objects and then use a template to randomly select from this list, enhancing the output with varying probabilities.

The platform supports advanced features such as altering capitalization, pluralization, and tense, which allows for nuanced and dynamic text generation. Users can also import generators created by others to integrate into their own projects, offering a collaborative element to the process. Perchance's simplicity combined with its depth makes it suitable for a wide range of applications, from simple random choice to complex text generation tasks.

The underlying technology is based on HTML, CSS, and JavaScript, reflecting Perchance's aim to engage users in coding through a practical and enjoyable interface. For those interested in further extending their projects, Perchance also supports exporting generators as HTML files or embedding them in websites, and even offers options to turn them into Twitter or Tumblr bots.

Perchance is a platform designed for creating and sharing custom random generators. It allows users to generate random outputs based on predefined lists and configurations, enabling the creation of diverse and complex random generation tools with ease.

Main Features

Simple List-Based Setup
Users create generators by defining lists and referencing them in output templates. For example, a generator can have lists for different types of items and packs, which are then randomly selected in the output based on the defined templates.

Customizable Odds and Weights
The platform supports the adjustment of item probabilities. By adding weights to items, users can control the likelihood of certain items appearing more frequently in the output.

Importing and Extending Generators
Generators can import other generators' lists and configurations. This feature allows for the combination and extension of existing generators, facilitating complex setups and enhancing functionality.

Flexible Text Formatting
Users can manipulate text properties such as capitalization, pluralization, and tense. This flexibility is useful for generating dynamic sentences and adapting outputs to various contexts.

Integration and Embedding
Perchance generators can be embedded in external websites or turned into bots for platforms like Twitter and Tumblr. This allows users to integrate their generators into other applications or share them more broadly.

These features combine to offer a powerful and adaptable tool for anyone looking to create random generators with a wide range of applications.

How do I create a random generator on Perchance?

To create a random generator on Perchance, define lists and use references to these lists within an output section. For example:

output
  Your \[pack\] contains \[item\], \[item\] and \[item\].

item
  a few coins
  an old \{silver|bronze\} ring
  a handkerchief
  a shard of bone
  some lint
  a tin of tea leaves

pack
  purse
  backpack
  bag
  pack
  knapsack
  rucksack

In this example, each time \[pack\] is used, it will randomly select an item from the pack list. Modify the lists and syntax as needed for different outputs.

Can I adjust the likelihood of items being chosen?

Yes, you can adjust the likelihood by specifying weights for items. For example:

pack
  purse
  backpack ^2
  bag

Here, backpack is twice as likely to be chosen as the other items in the pack list.

How do I import other generators into my own?

You can import other generators using the import: syntax. For instance:

sentence
  I need a new \{import:noun\}.
  Quickly, \{import:verb\}!

noun
  car
  house
  book

verb
  run
  jump
  swim

This example imports random noun and verb from other generators, combining them into new sentences.

What are some ways to modify text formatting in Perchance?

Perchance supports several text formatting options. For example:

sentence
  \[name.titleCase\], can you hear me?
  HELLO, \[name.upperCase\]!

name
  patricia
  khalid
  anaya

The titleCase and upperCase functions modify how names are capitalized.

Can I share or embed my Perchance generator?

Yes, you can share your generator by sharing its URL. To embed it in a website, use an <iframe> tag:

<iframe src="https://null.perchance.org/my-generator-name" style="width:100%; height:600px; border:none;"></iframe>

You can also download the generator as a single HTML file for offline use or convert it into a Twitter or Tumblr bot.