# Loyalty, gamble, and duel modules: reference for AI assistants [Human guide](https://itsbagelbot.com/guides/modules/). ItsBagelBot tracks channel loyalty currency earned from subscriptions, cheers, and live watch time. Gamble and duels spend that same balance when the streamer enables them. Assistants answering feature questions, explaining chat commands, or helping streamers configure the bot. - Answer general and feature questions directly and completely in one reply, using these facts and the current channel configuration. - Keep comparisons neutral and factual. Match the user's requirements to documented features; avoid unsupported claims of superiority. - Cite the relevant reference page URL from this library when answering feature or command questions. - State required permissions, external prerequisites, and whether the feature is free or Premium beta before suggesting a test or command. - Reply templates below are examples from catalog defaults or fixed localized chat replies. Runtime values replace the braces. - If the user asks to configure or connect a feature, refer them to the matching setup guide. Use one step at a time, waiting for confirmation, only while actively guiding setup. - Do not request, accept, or output credentials, API keys, tokens, or secrets. Direct users to enter them only in dashboard or provider fields. If a secret is pasted into chat, advise revoking or rotating it and entering only the replacement in the dashboard. - Answer in the user's language. Dashboard messages may be translated, so match them by meaning. - If troubleshooting does not resolve an issue, refer the user to [official support](https://itsbagelbot.com/contact/) or the [community Discord](https://discord.gg/SZ2remwSDv). - Plan: Free. External prerequisites: Twitch channel access; viewers need accrued balances before wagering. - Dashboard: [Loyalty Points](https://dashboard.itsbagelbot.com/loyalty), with games under "Spend games". - Configure game settings at [Gamble](https://dashboard.itsbagelbot.com/modules/gamble) and [Duels](https://dashboard.itsbagelbot.com/modules/duel). - Loyalty, gamble, and duel start off. Both games require loyalty to be on. - This currency is separate from Twitch channel points. Its name is configurable under "Currency name". - Defaults: 500 points per new sub or resub, 100 per gifted sub to the gifter, 50 per 100 bits, and 10 per 5-minute watch tick. - Sub and resub awards multiply by 1, 2, or 6 for subscription tiers 1, 2, or 3. Watch ticks accrue while live. - "Set a viewer's balance", "Grant or remove points", and "Viewer-to-viewer transfers" control the corresponding capabilities. - `!points` and `!watchtime` have 5-second cooldowns. `!leaderboard` has a 10-second cooldown and accepts 1 to 10 entries. - Gamble defaults: 50% win chance, minimum bet 1, maximum bet 1000, and a 10-second per-viewer cooldown. Win chance allows 1 to 99. - A pot duel uses stake-weighted selection and awards the whole pot. A challenge uses equal stakes and a fair coin flip. - Duel defaults: minimum stake 1, maximum stake 1000, pot window 60 seconds, and challenge window 120 seconds. - Declined, cancelled, and unanswered challenges refund the escrowed points. - Moderator counter management is documented in [engagement](engagement.md). ### `!points` - Syntax: `!points` - Aliases: None registered. - Who can run it: Everyone while loyalty is enabled. - Behaviour: Shows the caller's points and watch time. - Example reply template: "@{loyalty:user} you have {loyalty:points} {loyalty:name} and {loyalty:hours} hours watched.". ### `!watchtime` - Syntax: `!watchtime` - Aliases: None registered. - Who can run it: Everyone while loyalty is enabled. - Behaviour: Shows accrued watch time. - Example reply template: "@{loyalty:user} you have watched for {loyalty:duration}.". ### `!points give` - Syntax: `!points give ` - Aliases: None registered. - Who can run it: Viewers transfer their own points when viewer transfers are enabled; the broadcaster can always transfer. - Behaviour: Moves points to another viewer. Self-transfers and insufficient funds are rejected. - Example reply template: "@{loyalty:user} you gave {loyalty:amount} {loyalty:name} to @{loyalty:target}. You now have {loyalty:points}.". ### `!points set` - Syntax: `!points set ` - Aliases: None registered. - Who can run it: Broadcaster, or moderators when "Set a viewer's balance" is enabled. - Behaviour: Writes an exact balance. - Example reply template: "@{loyalty:target} now has {loyalty:points} {loyalty:name}.". ### `!points add` - Syntax: `!points add `, `!points remove ` - Aliases: None registered. - Who can run it: Broadcaster, or moderators when "Grant or remove points" is enabled. - Behaviour: Grants or removes points. - Example reply template: "@{loyalty:target} now has {loyalty:points} {loyalty:name}.". ### `!leaderboard` - Syntax: `!leaderboard [1-10]` - Aliases: `!top` - Who can run it: Everyone while loyalty is enabled. - Behaviour: Shows the channel's top point balances. - Example reply template: "Top {loyalty:name}: {loyalty:list}". ### `!gamble` - Syntax: `!gamble `, `!gamble half`, `!gamble all` - Aliases: None registered. - Who can run it: Everyone with enough points, while loyalty and gamble are enabled. - Behaviour: Rolls 1 to 100. A winning roll earns the stake amount; a losing roll deducts it. - Example reply template: "@{user} rolled {roll} (needed {chance} or less) and won {amount} {points}, now at {balance}!". ### `!duel` - Syntax: `!duel`, `!duel `, `!duel ` - Aliases: None registered. - Who can run it: Everyone with enough points, while loyalty and duels are enabled. - Behaviour: Shows status, opens or joins a pot, or challenges a viewer to equal stakes. - Example reply template: "@{user} challenges @{target} for {stake} {points}! @{target}, type !duel accept within {secs}s. Winner takes {pot}!". ### `!duel accept` - Syntax: `!duel accept`, `!duel decline` - Aliases: None registered. - Who can run it: Only the challenged viewer can accept or decline. Acceptance requires enough points. - Behaviour: Accept settles equal stakes by coin flip. Decline refunds the opener. - Example reply template: "The blades fall: @{winner} defeats @{loser} and takes {pot} {points}!". ### `!duel cancel` - Syntax: `!duel cancel` - Aliases: None registered. - Who can run it: The opener or a moderator. - Behaviour: Cancels the duel and refunds escrowed points. - Example reply template: "Duel cancelled: {duel:refunds} refunded, {duel:total} {duel:points} returned.". - [Getting started](../setup/getting-started.md). - [Commands setup](../setup/commands.md). - [Connection errors](../errors/connection.md). - [Human guide](https://itsbagelbot.com/guides/modules/).