RebeccaNod1
494f01c7bf
All notable changes to Peril Dice will be documented in this file. ## [2.1.0] - 2025-01-08 ### ✨ Major Features Added - **Ready State System**: Players must mark themselves ready before games can start - **Game Protection**: Prevents players from joining games in progress - **Performance Optimization**: Reduced lag by limiting confetti to wins only - **Enhanced Bot Intelligence**: Improved bot behavior and duplicate number avoidance ### 🔧 Core Fixes - **Complete Game Flow**: Fixed end-to-end gameplay from start to finish - **Elimination Logic**: Proper handling of player elimination and game continuation - **Win Condition**: Fixed victory detection and game ending - **Data Synchronization**: Resolved corruption in pick data between scripts - **Peril Player Assignment**: Fixed race conditions in peril player transitions ### 🎮 Gameplay Improvements - **Dynamic Picking**: Number of picks now properly based on peril player's lives - **Duplicate Prevention**: Enhanced system to prevent duplicate number selection - **Dialog Pagination**: Improved number selection interface for d30 dice - **Floater Updates**: Real-time HUD updates throughout gameplay - **Bot Continuation**: Bots now properly continue games when humans are eliminated ### 🛠️ Technical Enhancements - **Modular Communication**: Improved inter-script messaging system - **Error Handling**: Comprehensive validation and error recovery - **Memory Management**: Better floater cleanup and channel tracking - **Data Encoding**: Fixed CSV conflicts with semicolon encoding system - **State Management**: Robust game state synchronization across modules ### 🐛 Bug Fixes - Fixed missing pick dialogs after game events - Resolved duplicate message issues between scripts - Fixed lives reset problems between rounds - Corrected floater display inconsistencies - Fixed bot confusion during player elimination - Resolved pick data corruption issues - Fixed peril player variable sync problems ### ⚡ Performance - Removed confetti from life loss (keeping only victory confetti) - Optimized debug output to reduce lag - Improved floater management efficiency - Enhanced bot processing speed ## [2.0.0] - 2024-12-XX ### 🎉 Initial Modular Release - **Modular Architecture**: Separated functionality into specialized scripts - **Bot System**: Added AI players for testing and gameplay variety - **Floating HUD**: Real-time player statistics display - **Dynamic Dice**: Automatic dice sizing based on player count - **Player Management**: Runtime player joining and leaving - **Owner Controls**: Administrative functions for game management ### 🎲 Core Game Features - **Pick System**: Number selection with validation - **Rolling Mechanism**: Automated dice rolling with visual effects - **Life Management**: 3-life system with elimination - **Peril Tracking**: Dynamic peril player assignment - **Victory Conditions**: Last player standing wins ### 🏗️ Architecture - **Main Controller**: Central game logic and state management - **Dialog Handlers**: User interface and input processing - **Roll Module**: Dice mechanics and particle effects - **Bot Manager**: AI player behavior and automation - **Floater Manager**: HUD display coordination - **Game Helpers**: Utility functions and calculations ## [1.0.0] - 2024-XX-XX ### 🌟 Original Release - Basic Peril Dice game implementation - Manual gameplay mechanics - Simple player tracking - Basic dice rolling functionality --- ## Development Notes ### Known Issues - **Bot Race Condition**: Bots may occasionally pick duplicate numbers when triggered simultaneously - **Debug Output**: Extended games may experience minor lag from comprehensive logging ### Future Enhancements - Serialized bot picking to eliminate race conditions - Configurable debug levels - Additional game modes and variants - Enhanced visual effects and animations ### Credits - **Original Game Design**: Noose the Bunny (djmusica28) - Second Life - **Automation & Development**: Enhanced for automated gameplay - **Architecture**: Modular LSL system for scalability and maintainability
108 lines
No EOL
3.9 KiB
Markdown
108 lines
No EOL
3.9 KiB
Markdown
# 🎲 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
|
||
- **⚡ 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
|
||
- If no match or peril player hits themselves → peril player loses a life
|
||
6. **Elimination**: Players with 0 lives are eliminated
|
||
7. **Victory**: Last player standing wins! 🏆
|
||
|
||
## Installation
|
||
|
||
1. Rez the main controller object in your desired location
|
||
2. Ensure all scripts are loaded:
|
||
- `Main.lsl` (Main Controller)
|
||
- `Owner and Player Dialog Handler.lsl`
|
||
- `Number Picker Dialog Handler.lsl`
|
||
- `Roll Confetti Module.lsl`
|
||
- `Bot Manager.lsl`
|
||
- `Floater Manager.lsl`
|
||
- `StatFloat.lsl` (for the floating HUD objects)
|
||
3. Touch the object to register as a player and start playing!
|
||
|
||
## 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 |
|
||
|
||
## Known Issues
|
||
|
||
- **Minor Bot Collision**: Bots may occasionally pick duplicate numbers in rapid succession (race condition)
|
||
- **Performance**: Extended games with many bots may experience some lag due to debug output
|
||
|
||
## Version
|
||
|
||
**Current Version**: 2.1.0
|
||
**Last Updated**: January 2025
|
||
**Status**: Stable - Full game flow functional
|
||
|
||
---
|
||
|
||
## 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!* |