# 🎲 **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 **"Final Girlz I.N.C."** 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