Peril_Dice/GAME_RULES.md

305 lines
10 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🎲 **PERIL DICE GAME - OFFICIAL RULES**
**Created by Rebecca Nod and Noose the Bunny**
*Original concept by **Noose the Bunny** (djmusica28) in Second Life*
---
## 🎯 **OBJECTIVE**
Be the last player standing! Survive the deadly dice rolls while others fall to elimination. Only one can claim **Ultimate Victory**!
---
## ⚙️ **SETUP**
### **Players**
- **2-10 players** can join the game
- **Bots available** for testing and variety
- **Owner participation** - game owner can play too!
### **Starting Conditions**
- Each player begins with **3 lives** ❤️❤️❤️
- One player is randomly selected as the **Peril Player** 🎯
- Dice type automatically chosen based on player count
---
## 🎮 **GAMEPLAY PHASES**
### **1️⃣ Ready Phase**
- All players (except game starter) must mark themselves **"Ready"**
- Game starter can begin once everyone is prepared
- No joining allowed once the killing game begins! 🚫
### **2️⃣ Number Picking Phase**
Players pick numbers based on the **Peril Player's remaining lives**:
| Peril Player's Lives | Numbers Each Player Must Pick |
|---------------------|-------------------------------|
| ❤️❤️❤️ (3 lives) | **1 number** |
| ❤️❤️ (2 lives) | **2 numbers** |
| ❤️ (1 life) | **3 numbers** |
**Picking Order:**
1. **Peril Player** picks first
2. All other players pick in sequence
3. **No duplicate picks** - each number can only be chosen once per round
### **3️⃣ Dice Rolling Phase**
- **Peril Player** rolls the dice
- Result determines everyone's fate!
- Roll is displayed on the game board for all to see
### **4️⃣ Resolution Phase**
Three possible outcomes based on the dice roll:
#### 🔄 **PLOT TWIST!**
- Someone **OTHER than the Peril Player** picked the rolled number
- **That player becomes the new Peril Player**
- No lives lost this round
- Game continues with new Peril Player
#### 🩸 **DIRECT HIT!**
- The **Peril Player picked their own rolled number**
- Peril Player **loses 1 life** ❤️ → 💔
- If they survive, they remain the Peril Player for next round
#### 🩸 **NO SHIELD!**
- **Nobody picked the rolled number**
- Peril Player **loses 1 life** ❤️ → 💔
- No protection from other players' picks
### **5️⃣ Elimination**
- Players with **0 lives** are eliminated from the game 💀
- Eliminated players cannot return
- Game continues with remaining survivors
### **6️⃣ Victory**
- **Last player standing wins!** 🏆
- **Winner Glow Celebration** (NEW in v2.8.6): Winner gets bright green glow on both scoreboard and floater 💚
- **Extended Victory Display**: 24-second celebration timer before game reset ⏱️
- **Victory Text**: Winner's floater displays "✨ ULTIMATE VICTORY! ✨" and "🏆 ULTIMATE SURVIVOR 🏆"
- Victory celebration with confetti effects! ✨
- Winner's name recorded on the leaderboard
---
## 🎲 **DICE SCALING SYSTEM**
The game automatically selects appropriate dice to ensure fair gameplay:
| Number of Players | Dice Type | Total Numbers Available |
|------------------|-----------|----------------------|
| 1-2 players | **d6** | 6 numbers (1-6) |
| 3-4 players | **d12** | 12 numbers (1-12) |
| 5-6 players | **d20** | 20 numbers (1-20) |
| 7-10 players | **d30** | 30 numbers (1-30) |
*This ensures exactly 3 numbers per player are always available*
---
## 🎭 **DRAMATIC ANNOUNCEMENTS**
The game features thematic messaging for maximum immersion:
- **"💀 [Player] has entered the deadly game! Welcome to your potential doom! 💀"**
- **"⚔️ [Player] steels themselves for the deadly challenge ahead! ⚔️"**
- **"🏃 [Player] loses their nerve and backs away from the challenge! 🏃"**
- **"⚡ THE KILLING GAME BEGINS! ⚡"**
- **"✨ ULTIMATE VICTORY! [Player] is the Ultimate Survivor! ✨"**
---
## 🎯 **STRATEGY TIPS**
### **As a Regular Player:**
- **Pick numbers that others are likely to avoid** to increase Plot Twist chances
- **All numbers** (1 through dice maximum) have equal probability of being rolled
- **Watch the Peril Player's lives** - affects how many numbers you must pick
### **As the Peril Player:**
- **Avoid common/popular numbers** that others might pick
- **Pick edge numbers** (1, maximum die value) for better survival odds
- **Remember**: The more lives you have, the fewer numbers others pick (easier to avoid)
### **Advanced Tactics:**
- **Psychological warfare** - discuss picks to influence others
- **Alliance forming** - temporary cooperation to eliminate threats
- **Risk assessment** - calculate odds based on remaining numbers
---
## 🏆 **WINNING CONDITIONS**
### **Individual Victory:**
- Be the **last player with lives remaining**
- Achieve **Ultimate Survivor** status
- Earn a permanent record on the leaderboard
### **Leaderboard System:**
- **Wins** and **losses** tracked across all games
- **Persistent records** saved between sessions
- **Top players** displayed for bragging rights
---
## 🤖 **BOT PLAYERS**
- **AI opponents** available for practice and testing
- **Always ready** - no need to mark bots as ready
- **Intelligent picking** - avoid already chosen numbers
- **Auto-rolling** when selected as Peril Player
---
## ⚠️ **IMPORTANT RULES**
### **No Take-Backs:**
- Once numbers are picked, they cannot be changed
- Dice rolls are final - no re-rolls
### **Fair Play:**
- No joining games in progress
- All players must participate actively
- Owner can moderate and manage the game
### **Game Security (NEW in v2.8.0):**
- **Game Lockout** - Owner can lock game to restrict all access to owner only
- **🔒 GAME LOCKED** status displayed when locked
- Non-owners receive clear "access denied" messages when game is locked
- **Kick Player** functionality allows owners to remove disruptive players
- **Leave Game** system properly cleans up all player data
### **Enhanced Display System (UPDATED in v3.2.6):**
- **Hybrid HUD System** - Humans get personal HUDs (Center 2), Bots get in-world floaters! 🎰🤖
- **Experience Requirement** - Land must have **Peril Dice Experience** enabled for the automatic HUD feature. 🔗
- **Winner Glow Celebration** - Winners get bright green glow on both scoreboard and floater 💚
- **Visual Priority System** - Winner glow (green) overrides peril glow (yellow) during victory
- **24-Second Victory Timer** - Extended celebration before game reset for proper recognition
- **Real-Time Status Updates** - Peril status updates immediately on displays
- **Enhanced Elimination** - Players see 0 hearts before removal with red X markers
- **Visual Scoreboard** - Shows all players with profile pictures and hearts
- **Floating HUD Displays** - Personal status displays for each player
- **Professional Status Actions** - Large status prim shows current events
- **Color-Coded Glow System** - Green (winner), Yellow (peril), Red X (eliminated)
### **Technical Rules (UPDATED in v3.2.0):**
- **Dynamic Link Discovery** - Scripts find their targets by name; reordering prims won't break the game 🔍
- **FURWARE Text Mesh Integration** - Professional mesh-based displays for dice and leaderboard 🎨
- **Centralized Constants** - System-wide settings managed in `Peril_Constants.lsl` 🧩
- **Game supports up to 10 players maximum**
- **Owner kick functionality** for managing disruptive players
- **Automatic game reset** on startup (preserves leaderboard)
- **Single linkset architecture** (74 prims total) for reliable operation
- **Professional winner celebration** with 24-second recognition timer
---
## 🎊 **GAME VARIATIONS**
While the core rules remain the same, consider these optional variations:
### **Speed Peril:**
- Reduce dialog timeout to 1 minute for ultra-fast gameplay
### **High Stakes:**
- Start with only 2 lives instead of 3
### **Team Peril:**
- Players form alliances (unofficial - for roleplay only)
---
## 📚 **QUICK REFERENCE**
**🎯 Peril Player Picks:** Always go first
**📊 Pick Count:** 4 minus Peril Player's current lives
**🎲 Dice Roll:** Determines round outcome
**💔 Life Loss:** Direct Hit or No Shield scenarios
**🔄 Plot Twist:** New Peril Player selected
**🏆 Victory:** Last survivor standing
---
## 🎮 **HOW TO PLAY (STEP BY STEP)**
### **For Game Owner:**
1. **Touch the game controller** to access owner menu
2. **Lock/Unlock Game** (NEW in v2.8.0) - Restrict access to owner only
3. **Add Test Players** or bots if desired for practice
4. **Kick Player** (NEW in v2.8.0) - Remove any registered player
5. **Join the game yourself** (optional)
6. **Start Game** when all players are ready
7. **Reset Options** - Game only, Leaderboard only, or Complete reset
### **For Players:**
1. **Touch the game controller** to join
2. **Mark yourself "Ready"** when prepared to play
3. **Wait for game to begin**
4. **Pick your numbers** when prompted (follow on-screen instructions)
5. **Roll dice** if you're the Peril Player
6. **Survive and repeat** until victory or elimination!
### **Dialog System:**
- **Touch controller anytime** to recover lost dialogs
- **Follow button prompts** in dialog boxes
- **Time limit:** 2 minutes to respond to dialogs (reduced from 10 minutes in v2.8.0)
---
## 🔧 **TROUBLESHOOTING**
### **Lost Dialog Box:**
- Touch the game controller to recover your dialog
### **Game Stuck:**
- Owner can access troubleshooting menu
- "Reset Game" restarts current game
- "Reset All" clears everything including leaderboard
### **Can't Join Game:**
- Game may be in progress (no joining mid-game)
- Maximum 10 players may be reached
- Check if you're already registered
---
## 📈 **STATISTICS & RECORDS**
### **Individual Stats:**
- **Games Won:** Total victories achieved
- **Games Lost:** Total eliminations suffered
- **Win Rate:** Percentage of games won
### **Leaderboard Features:**
- **Persistent tracking** across all gaming sessions
- **Top 10 players** displayed publicly
- **Separate reset options** for games vs. leaderboard
---
## 🎪 **SOCIAL FEATURES**
### **Spectating:**
- Non-players can watch the action unfold
- Real-time visual scoreboard shows all player status
- Dramatic announcements keep everyone engaged
### **Community Events:**
- **Tournament play** with multiple rounds
- **Theme nights** with special rules
- **Betting pools** on outcomes (unofficial)
---
*Master these rules and you'll be ready to enter the deadly world of Peril Dice! May luck and strategy guide you to Ultimate Victory!* 🎲✨
---
**Version:** 3.2.6
**Last Updated:** April 05, 2026
**Status:** Production Ready - Hybrid HUD Release
**Credits:** Original concept by Noose the Bunny (djmusica28), Automated system implementation by Rebecca Nod