PERIL DICE GAME - OFFICIAL RULES
========================================================

CREATED BY REBECCA NOD AND NOOSE THE BUNNY (djmusica28)
CURRENT VERSION: 3.2.0 - THE "SYNC SANCTITY" UPDATE

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.

NEW IN V3.2.0: SYNC SANCTITY & SCOREBOARD VIRTUALIZATION! Total refactoring of the synchronization engine. The Main Controller is now the single source of truth for life counts, permanently eliminating "Ghost Heals." The scoreboard is now "Virtualized"—supporting a professional 3-column Rank/Name/Wins/Losses layout and dynamic Alpha 0.0 hiding for unused player slots.

NEW IN V3.1.0: LINKSET STABILITY & DYNAMIC DISCOVERY! Complete architectural decentralization—scripts now find their linked prims by name, making the game board immune to link-order changes or region-side glitches. Full migration from legacy XYText to modern mesh-based FURWARE Text for dice and leaderboards. Centralized system constants in Peril_Constants.lsl for 100% project consistency.

===============================================================================

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 (hearts)
- 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

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 v2.8.6):
- Winner Glow Celebration - Winners get bright green glow on both 
  scoreboard and floaters
- 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):
- Sync Sanctity Protocol - 100% unified life counting via the Main Controller 🛡️
- Scoreboard Virtualization - Dynamic slot hiding and multi-column Rank/Name/WL grid 🎰
- Dynamic Link Discovery - Unified name-based mapping for Linkset Stability 🔍
- Human-Bot Parity - Delimiter-agnostic picking logic for total shield consistency 🏹
- 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

===============================================================================

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.0
Last Updated: April 05, 2026
Status: Production Ready - Sync Sanctity Release
Credits: Original concept by Noose the Bunny (djmusica28), 
         Automated system implementation by Rebecca Nod

===============================================================================