Dice Game (Street Craps)

Play street craps with other community members. Games are played in temporary private groups.

Starting a Game

!dice

Start a multiplayer dice game by mentioning players.

!dice @player1 @player2
!dice @player1 @player2 @player3

Example:

!dice @Alice @Bob

What Happens:

1. Bot creates a temporary private group
2. All mentioned players are invited
3. Game instructions are posted
4. First player becomes the “shooter”

---

Gameplay Commands

!roll

Roll the dice (shooter only).

!roll

Rules:

• First roll is the “come out” roll
• 7 or 11 = shooter wins
• 2, 3, or 12 = “craps” (shooter loses)
• Any other number establishes the “point”
• Shooter keeps rolling until they hit the point (win) or roll 7 (lose)

---

!pass

Bet that the shooter will win (Pass Line bet).

!pass
!pass <amount>

Example:

!pass 50

---

!fade

Bet against the shooter (Don’t Pass bet).

!fade
!fade <amount>

Example:

!fade 25

---

!stake

Set your stake/bet amount for the round.

!stake <amount>

Example:

!stake 100

---

!skip

Skip your turn as shooter, pass dice to next player.

!skip

---

!go

Confirm you’re ready to start rolling.

!go

---

!hold

Request a pause in the game.

!hold

---

!points

Check current point totals for all players.

!points

Response: Shows each player’s current balance.

---

!gamestatus / !gs

Show the current game state.

!gamestatus
!gs

Response:

• Current shooter
• Established point (if any)
• Active bets
• Player balances

---

!leave

Leave the current dice game.

!leave

Note: If you’re the shooter, dice pass to the next player.

---

!rematch / !again

Start a new game with the same players.

!rematch
!again

---

Game Flow Example

1. Start Game:

   !dice @Alice @Bob

2. Players Place Bets:

   Alice: !pass 50
   Bob: !fade 50

3. Shooter Rolls:

   Alice: !roll
   > Rolled 8! Point is now 8.

4. Continue Rolling:

   Alice: !roll
   > Rolled 5. Keep rolling for 8...
   
   Alice: !roll
   > Rolled 8! Winner! Alice wins!

5. Check Points:

   !points
   > Alice: 150 (+50)
   > Bob: 50 (-50)

---

Rules Summary

Roll	Come Out Result	Point Roll Result
7	WIN (Natural)	LOSE (Seven Out)
11	WIN (Natural)	No effect
2, 3, 12	LOSE (Craps)	No effect
4, 5, 6, 8, 9, 10	Establishes Point	WIN if matches point

Pass Line: Wins on 7/11 come out, loses on 2/3/12, wins if point is made.

Don’t Pass: Opposite of Pass Line (wins when shooter loses, except 12 is a push).

---

Admin Commands

!endgame

End the current dice game and close the room (admin only).

!endgame

What Happens:

1. Final standings are announced
2. All non-admin members are removed
3. Bot leaves the group
4. Group is closed

---

Auto-Cleanup

Dice game rooms are automatically cleaned up after 24 hours of inactivity (no non-bot messages).

Process:

1. Bot sends a farewell message
2. All members are removed
3. Bot leaves the group
4. Group is marked as closed in database

This prevents orphaned game rooms from accumulating.

For admins: To manually clean up stale dice game rooms:

# Inside the bot container
node /app/scripts/mark-dice-game-groups.js --mark

This marks any groups with 🎲 prefix as dice_game type for cleanup tracking.