-
Choose items for you.
An entry of 'Pizza or tacos?' will randomly pick either pizza or tacos for you.
You can put as many things in the list as you want, just separate each with an 'or'.
For example 'fish or chicken or steak or salad or soup?'
If one of your options has an "or" in it, that you don't want interpreted as a choice delimeter,
use an <or> tag. An entry of 'rent a car or truck <or> fix the beater?' will randomly pick between "rent a car or truck" and "fix the beater"
Note: The question mark at the end isn't required, and will be ignored.
-
Roll dice for you
If the entry is a set a description of dice to roll, this will randomly roll the dice for you.
For exmaple, an input of 'd6' will return a number between 1 and 6.
An input of 2d20 will return what each 20 sided die rolled, as well as the total.
An input of 2d10+1 will roll two 10 sided dice, add them up, then add one to the total.
These can be combined as well into more complex rolls.
For example, an input of '3d6 2d12' will roll three regular dice and two 12 sided dice, giving you the results of each roll as well as the total.
If you're feeling adventerous, you can even "roll pigs".
-
Yes or No Questions
If the entry ends in a question mark, but doesn't have 'or' in it, it will be treated as a yes or no question.
You will probably receive a yes or no answer.
-
Pick random things from lists
An entry of 'Give me 3 random names from Danny, George, Lynne, Mike, Sam, Paul, Josh' will randomly pick three names from the list provided, e.g. 'George, Josh and Paul'.
An entry of '10 numbers 1-100' will randomly pick ten numbers from 1 to 100 (inclusive), e.g. '22, 23, 27, 29, 35, 40, 65, 74, 81 and 90'. If a random order is desired, add 'no sort' to the end of the query.
Full Syntax
[select|get|give me]
<number>
[random]
{number|numbers|<something else>}
[from|in|of]
{<number sets>|<list of things>}
[without|w/o|wo|no|don't] [sort|resort]
Syntax Details
- [select|get|give me]
-
This is the optional words 'select' or 'get' or 'give me'.
They are available to make requests easier to read or remember.
You may supply one or none of them.
There is no difference between a query that omits this and one that includes one of the entries.
- <number>
-
This is the count of items you want chosen.
This is required.
- [random]
-
This is the optional word 'random'.
It's just available to make requests easier to read or remember.
There is no difference between a query that omits this and one that includes it.
- {number|numbers|<something else>}
-
This piece identifies what is contained in the list of things being chosen.
This is required.
It must be the string 'number', the string 'numbers' or some other single-word identifier (e.g. 'names').
Plurality is not taken into consideration.
For example, '2 number 1-10' and '2 numbers 1-10' are treated exactly the same.
If this is 'number' or 'numbers', then <number sets> are expected in the final part of the query.
If this is anything else, then a <list of things> is expected.
- [from|in|of]
-
This is the optional words 'from' or 'in' or 'of'.
They are available to make requests easier to read or remember.
You may supply one or none of them.
There is no difference between a query that omits this and one that includes one of the entries.
- <number sets>
-
This identifies the possible numbers to be chosen from.
This is required if the type of things is either 'number' or 'numbers'.
This must be one or more number set descriptions, or else have the format 'up to x'.
A number set has one of these formats:
'x to y',
'x - y',
'x : y',
'x .. y', or
'x'.
Multiple number sets should be delimited using a commas.
Spacing around the 'to', '-', ':', or '..' does not matter.
E.g. '1:10' is the same as '1 : 10'.
Numbers are only ever included once in the resulting set of options.
E.g. '2, 1:3' is equivalent to '1:3'.
The order of the values in each set doesn't matter.
I.e. '5 to 10' is the same as '10 to 5'.
Detailed example: If this portion is '1, 2, 3, 10 .. 12, -13 - -15, 18:16, -21 to -19',
results will be chosen from [-21, -20, -19, -15, -14, -13, 1, 2, 3, 10, 11, 12, 16, 17, 18].
Alternatively, this can be the string 'up to x' where x is a positive number.
This is a shorthand version of '1 to x' but is not allowed when multiple sets are desired.
For example, this is not valid: 'up to 5, 10 to 20'.
- <list of things>
-
This is the list of possible entries to chose from.
This is required if the type of things is anything other than 'number' or 'numbers'.
Unlike number sets, entries are allowed to be duplicated.
However, providing duplicate entries also allows for duplicates in the output.
The entries should be delimited using semicolons, commas, or spaces.
If this portion contains a semicolon, a semicolon is used as the delimiter.
Otherwise, if it contains a comma, a comma is used as the delimiter.
If it has neither a semicolon nor comma, a space is used as the delimiter.
Example 1: 'Pineapple, Canadian Bacon, Peppers; Pepperoni, Black Olive; Cheese'
is split into three options: ['Pineapple, Canadian Bacon, Peppers', 'Pepperoni, Black Olive', 'Cheese'].
Example 2: 'Pineapple, Canadian Bacon, Peppers, Pepperoni, Black Olive, Cheese'
is split into six options: ['Pineapple', 'Canadian Bacon', 'Peppers', 'Pepperoni', 'Black Olive', 'Cheese'].
Example 3: 'Pineapple Canadian Bacon Peppers Pepperoni Black Olive Cheese'
is split into eight options: ['Pineapple', 'Canadian', 'Bacon', 'Peppers', 'Pepperoni', 'Black', 'Olive', 'Cheese'].
- [without|w/o|wo|no|don't] [sort|resort|re-sort]
-
This is the optional words 'without'
or 'w/o'
or 'wo'
or 'no'
or 'don't
followed by one of 'sort'
or 'resort'
or 're-srot'.
The presence of this in a query indicates that the output should not be sorted, i.e the output order is randomized.