Peril_Dice/README.md

🎲 Peril Dice — Modular Game System for Second Life

Overview

Peril Dice is a multiplayer elimination game where each player selects numbers before a die is rolled. If the peril player's number is rolled, they lose a life. Players are eliminated when they reach zero lives.

Key Features

• 🎯 Dynamic Player Management: Players can join at runtime (owner and other avatars)
• 🤖 Bot Support: Add AI bots for testing and gameplay variety
• 📱 Floating HUD Display: Real-time stats for each player
• 🎮 Intelligent Dice Sizing: Automatic dice size based on player count
• 🔄 Ready State System: Players must be ready before games start
• 🎭 Dramatic Messaging: Immersive thematic announcements visible to all players
• 🎲 Context-Rich Rolls: Detailed dice information with type and result
• ⚡ Performance Optimized: Reduced lag with selective particle effects
• 🛡️ Robust Error Handling: Comprehensive game state synchronization
• 🚫 Game Protection: Prevents joining games in progress

Game Rules

1. Setup: 2-10 players join the game
2. Ready Phase: All players except starter must mark themselves ready
3. Picking Phase: Each player picks 1-3 numbers (based on peril player's remaining lives)
4. Rolling Phase: Peril player rolls the dice
5. Resolution:
   • If rolled number matches another player's pick → that player becomes new peril player (⚡ PLOT TWIST!)
   • If peril player picked the rolled number → they lose a life (🩸 DIRECT HIT!)
   • If nobody picked the rolled number → peril player loses a life (🩸 NO SHIELD!)
6. Elimination: Players with 0 lives are eliminated
7. Victory: Last player standing wins! 🏆

How to Play

For Owner

• Touch object → Access owner menu
• Add Bot → Add AI players for testing
• Start Game → Begin when all players are ready
• Reset Game → Reset to initial state
• Manage Picks → View/modify player selections

For Players

• Touch object → Register and join game
• Ready/Not Ready → Toggle your ready state
• Pick Numbers → Select your numbers when prompted
• Roll Dice → Roll when you're the peril player

Architecture

The system uses a modular LSL architecture with inter-script communication:

• Main Controller: Core game logic and state management
• Dialog Handlers: User interface and input processing
• Roll Module: Dice rolling and confetti effects
• Bot Manager: AI player behavior
• Floater Manager: Floating HUD display management
• Game Helpers: Utility functions and dice type calculation

Dice Scaling

Dice type is automatically chosen to ensure at least 3 picks per player:

Player Count	Dice Type
1–2	d6
3–4	d12
5–6	d20
7–10	d30

Recent Improvements (v2.2.0)

• 🎭 Dramatic Messaging: All game events now use thematic, immersive language
• 📢 Public Announcements: Players can see all major game events in public chat
• 🎲 Enhanced Dice Messages: Rolls show both dice type (d6, d8, etc.) and result
• 🔧 Bug Fixes: Resolved StatFloat duplication and duplicate message handling issues

Version

Current Version: 2.2.0
Last Updated: August 2025
Status: Stable - Enhanced UX with dramatic messaging system

---

Original Game Rules Credit

Game rules were created by Noose the Bunny (djmusica28) in Second Life. This automated version builds upon their original manual gameplay concept.

Original Manual Rules Summary:

• Each player starts with 3 lives
• Players pick numbers based on peril player's remaining lives:
  • 3 Lives → Pick 1 number
  • 2 Lives → Pick 2 numbers
  • 1 Life → Pick 3 numbers
• Roll dice to determine outcome
• Last player with lives wins

---

Peril Dice provides hours of entertainment for Second Life communities with its blend of strategy, luck, and social interaction!