PerfectOddsBot

PerfectOddsBot is a Discord bot designed to create and manage bets with imaginary points. The bot allows users to place bets & view leaderboards. Admins can create and manage bets and bot settings

Features

• Create and manage bets with multiple options.
• Users can place bets on available options.
• Admins can lock bets to prevent further betting.
• Admins can resolve bets and distribute points based on the outcome.
• Users can view their points and the leaderboard.
• Users gain points for sending messages
• Card game layer: spend points to draw cards, build an inventory, and trigger effects that can impact points, bets, and other users.

Card Game

PerfectOddsBot includes an optional “card game” that sits on top of the points + betting system.

How drawing cards works

• Command: Use /draw-card to draw a random card from the deck.
• Cost & pool: Drawing costs points and (by default) the same amount is added to your server’s Pool. Some cards can also add/remove points from the pool. Certain Mythic cards pay out from the pool.
• Cooldown cycle + escalating price: Each user has a draw “cycle” that resets every (default: 60 minutes).
• 1st draw in the cycle costs CardDrawCost (default: 10 points)
• 2nd draw costs CardDrawCost * 10
• 3rd+ draws cost CardDrawCost * 100
• Server toggle: Admins can enable/disable drawing per server with /toggle-card-drawing.
• Rarities: Cards come in Common, Uncommon, Rare, Epic, and Mythic rarities, with Mythic being the rarest.
• Subscription-gated cards: Some cards are only eligible if your server has a subscribed team set via /subscribe-to-team (these are treated as “premium” cards in the deck logic).

Instant cards vs inventory cards

When you draw a card, it either:

• Resolves immediately: the handler runs right away (e.g. gain/lose points, steal points, global effects).
• Goes into your inventory: some cards are stored in UserInventory so they can be consumed later.
• Use /my-inventory to see what you’re holding.
• Some inventory cards are automatic and trigger on the next applicable event (usually bet resolution), then get consumed.
• Some inventory cards are playable (manual). Currently, /play-card supports STOP THE STEAL (cancel an active bet you’ve placed).

Follow-up selections (targets, bets, choices)

Some cards require extra input after you draw them:

• Target a user: you’ll be prompted to pick a user (examples: Petty Theft, The Jester, Bet Freeze, Grand Larceny, Anti-Anti-Bet, Hostile Takeover).
• Target a bet: you’ll be prompted to pick an active bet you placed (example: Uno Reverse).
• Choose an option: choice cards will prompt a selection (example: The Gambler).

Scheduled card maintenance

Some card effects are handled by scheduled jobs:

• Every hour: collect Loan Shark debts after they mature, and expire Vampire cards after 24 hours.

Commands

Slash Commands

| Command | Description | Admin Only | Premium | Ephemeral |
|---------------------------|-------------------------------------------------------------------------------------------------------|------------|---------|-----------|
| /help | Show this help message with all available commands | No | No | Yes |
| /create-bet | Create a new bet with specified options and odds. | Yes | No | No |
| /create-cfb-bet | Create new CFB bet for provided game id | No | Yes | No |
| /create-cbb-bet | Create new CBB bet for provided game id