Show bingo caller
show_bingo_callerRead-only
Use this when the user is running a bingo game: call or draw the next word or number at random, show what has been called on a big screen, check whether a claimed bingo on card number N is real (which line, at which call, and who won first), or list all cards that have bingo now. Pass the same items and the caller_args (mode, grid_size, free_space, card_count, seed, unique_lines) from generate_bingo_cards, plus everything called so far in order. Draws use secure randomness. Does not make or print cards and does not keep game state between calls: always send the full called list. Not for prize, betting or money games.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | words (default): your own words or phrases. numbers_75: classic US bingo, 5x5 with B 1-15, I 16-30, N 31-45, G 46-60, O 61-75. numbers_90: UK-style 3x9 tickets with 15 numbers from 1-90, printed in strips of 6. Example: words. | |
| seed | No | Card set number from an earlier result, e.g. 4242. The same items, options and seed always rebuild the same cards. Leave out for a new random set. | |
| items | No | For mode words: the words or phrases to put on the cards, one per entry, e.g. ["Ugly sweater", "Mistletoe", "Hot cocoa"]. Need at least 24 for 5x5 with a free centre, 25 without, 16 for 4x4, 8 or 9 for 3x3. Up to 300, each up to 100 characters. | |
| title | No | Game title shown on the caller screen, e.g. Holiday Party Bingo. | |
| action | No | draw (default): call the next item at random. check: verify a claimed bingo on card_number. winners: list every card that has the pattern now. board: show what has been called. Example: check. | |
| called | No | Everything already called, in call order, exactly as shown on the cards, e.g. ["Mistletoe", "Hot cocoa"] or ["B-12", "N-40", "O-71"]. Empty for a new game. | |
| pattern | No | Winning pattern to check, e.g. line. line: any row, column or diagonal (90-ball: any row). two_lines: two complete lines. four_corners: the 4 corner squares (not for 90-ball). full_card: every square (full house). Default line. | |
| grid_size | No | Card size for mode words: 3, 4 or 5 (default 5), e.g. 5. Classic numbers_75 is always 5x5; numbers_90 tickets are always 3x9. | |
| list_code | No | For word games: list_code from caller_args of generate_bingo_cards, e.g. 0k3x9qa. Confirms the items were sent in the same order as when the cards were made, so card numbers match. | |
| card_count | No | How many different cards (or tickets) to make, 1-200, e.g. 30. Default 30. | |
| free_space | No | Free centre square on 3x3 and 5x5 cards, e.g. true. Default true for 5x5 and false for 3x3; 4x4 cards have no centre. | |
| card_number | No | For action check: the card number printed on the claimed card, e.g. 17. | |
| unique_lines | No | true = no two cards share an identical winning line (row, column or diagonal), so two players never complete the very same line. Needs enough items; the tool explains if the request is not possible. Default false (cards are always all different). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| view | Yes | ||
| check | Yes | ||
| title | Yes | ||
| action | Yes | ||
| called | Yes | ||
| current | Yes | ||
| pattern | Yes | ||
| winners | Yes | ||
| remaining | Yes | ||
| caller_args | Yes | ||
| total_items | Yes | ||
| called_count | Yes |