Spin the wheel
spin_wheelRead-only
Use this when the user wants to spin the wheel, use a wheel spinner or random name picker, pick a random name or option from a list (wheel spinner with names, yes or no wheel, food wheel, custom wheel), or call on people one at a time. Draws 1 or more different winners with cryptographic, unbiased randomness and shows an animated wheel that lands on the winner. Repeated entries (matched ignoring case) or weights give bigger slices. Returns the winners, each entry's chance, and the remaining entries when remove_winners is true. For fun, classroom, and team decisions only; not for lotteries, gambling, or prize draws that have legal requirements. Does not store results between calls.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | How many different winners to draw in this spin, a whole number from 1 to 50, default 1, e.g. 3 to pick 3 students. | |
| title | No | Optional wheel title shown above the wheel, e.g. "Who presents first?". | |
| entries | Yes | The names or options on the wheel, 2 to 200, e.g. ["Ana", "Ben", "Chloe"]. A repeated entry gets a bigger slice: ["Pizza", "Pizza", "Tacos"] gives Pizza 2 of 3 slots. | |
| weights | No | Optional whole-number weight (1-1000) per entry, same order and length as entries, e.g. [3, 1, 1] makes the first entry three times as likely. Leave out for equal chances. | |
| remove_winners | No | If true, the winners are taken off the wheel and the remaining entries are returned for the next spin, e.g. true for calling on each student once. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| title | Yes | ||
| entries | Yes | ||
| removed | Yes | ||
| weights | Yes | ||
| winners | Yes | ||
| remaining | Yes | ||
| chance_percent | Yes | ||
| winner_indexes | Yes | ||
| remaining_weights | Yes | ||
| equal_chance_percent | Yes |