Peril_Dice/CHANGELOG.md

# Changelog

**Peril Dice Game System - Created by Rebecca Nod and Noose the bunny**

All notable changes to Peril Dice will be documented in this file.

## [2.8.5] - 2025-09-15

### 🧠 **Memory Optimization & Dead Code Cleanup**
- **UpdateHelper.lsl Elimination**: Completely removed vestigial UpdateHelper script that was consuming memory but providing no functionality
  - **Issue**: 204-line script existed but was never actually called - pure dead code consuming ~41KB memory
  - **Fix**: Removed UpdateHelper.lsl file and all supporting infrastructure from Main Controller
  - **Memory Impact**: Main Controller memory usage improved from ~83.8% to 81.4% (2.4 percentage point reduction)
  - **Cleaned Up**: `updateNewPlayer()` function, UpdateHelper message constants, variables, and handlers
  - **Simplified**: `updateHelpers()` function now performs direct scoreboard updates without delegation
- **Verbose_Logger Simplification**: Streamlined debug logging system by removing unused buffering infrastructure
  - **Removed**: Message buffering system, timer events, unused message handlers (MSG_VERBOSE_LOG)
  - **Size Reduction**: Simplified from 149 lines to 80 lines (~47% smaller)
  - **Kept**: Essential debug toggle functionality and system-wide logging coordination
  - **Performance**: Eliminated timer overhead and reduced message processing complexity

### 🎨 **Bot Profile Picture Fix**
- **Fixed Bot Visual Glitch**: Resolved issue where bot profile pictures would randomly turn into gray boxes mid-game
  - **Issue**: During scoreboard refresh (e.g., player removal), all profiles were reset to default gray texture before restoration
  - **Root Cause**: `refreshPlayerDisplay()` function reset ALL profile prims to default, causing visual flicker
  - **Fix**: Modified refresh logic to only reset unused player slots, preserving active player textures
  - **Enhanced Caching**: Bots now store `TEXTURE_BOT_PROFILE` directly in cache to prevent HTTP requests
  - **Result**: Bot avatars maintain consistent robot icon throughout entire game without gray box flicker

### 🏗️ **Direct Communication Architecture Update**
- **Link Number Reorganization**: Updated all scripts to use new optimized linkset architecture
  - **Scoreboard Manager**: Link 2 → Link 12 (moved to accommodate overlay prims)
  - **Leaderboard Manager**: Link 25 → Link 35 (updated prim range: links 35-82)
  - **Dice Display**: Link 73 → Link 83 (maintained 2-prim dice display)
  - **Affected Scripts**: 11 scripts updated with new link mappings and prim ranges
- **Optimized Prim Architecture**: Enhanced linkset structure for better performance and organization
  - **Overlay Prims**: Added dedicated overlay prims (links 2-11) for elimination markers
  - **Scoreboard Prims**: Profile and hearts prims properly mapped to new link structure
  - **XyzzyText Banks**: Updated leaderboard prim ranges to accommodate new architecture

### 🔧 **Enhanced Game Logic & Bug Fixes**
- **Number Picker Dialog Enhancement**: Improved parsing for mixed number formats
  - **Format Support**: Now handles both CSV ("1,2,3") and semicolon ("1;2;3") separated pick lists
  - **Whitespace Handling**: Added trimming for formats like "5, 6" vs "5,6" for consistent parsing
  - **Bot Integration**: Enhanced bot pick processing to work with avoid lists from human players
- **Bot Manager Improvements**: Enhanced round detection and pick avoidance logic
  - **Round Detection**: Better detection of new rounds through peril player and lives changes
  - **Command Processing**: Improved bot command handling and duplicate pick prevention
  - **Fair Play**: Bots now correctly avoid numbers already picked by human players
- **Message Handler Fixes**: Improved region communication handling
  - **Communication Method**: Updated message broadcasting for better chat integration
  - **Player Feedback**: Enhanced player join/leave notifications

### 🛠️ **Technical Infrastructure**
- **Memory Reporting**: Added standardized memory usage reporting across core scripts
- **Code Quality**: Removed dead code paths and simplified complex functions
- **Error Handling**: Enhanced safety checks and boundary validation
- **Performance**: Reduced inter-script message traffic by eliminating unused communication paths

### 📊 **System Performance Impact**
- **Memory Usage**: Overall reduction in memory consumption across multiple scripts
- **Message Traffic**: Reduced unnecessary link messages between scripts
- **Visual Stability**: Eliminated profile picture flickering and display inconsistencies
- **Code Maintainability**: Cleaner, more focused codebase with reduced complexity
- **Link Architecture**: More organized and scalable linkset structure for future development

### 🎯 **Impact Summary**
- **Before**: Dead code consuming memory, bot profiles flickering, complex but unused systems
- **After**: Leaner memory usage, stable bot visuals, simplified but fully functional architecture
- **Performance**: Measurable memory improvements and cleaner system operation
- **Maintainability**: Easier to understand and modify codebase with eliminated dead code

## [2.8.4] - 2025-09-14

### 🔍 **System-Wide Verbose Logging Toggle**
- **Universal Debug Control**: Implemented comprehensive verbose logging system across all 14 game modules
  - **Owner Menu Integration**: Added "Toggle Verbose Logs" option in Troubleshooting menu for easy access
  - **Real-Time Toggle**: Instantly enable/disable detailed debug messages without script restart
  - **System-Wide Sync**: One toggle affects all modules simultaneously for consistent logging state
  - **Modules Updated**: Main Controller, Game Manager, Floater Manager, Bot Manager, Roll Module, NumberPicker Handler, Message Handler, Game Calculator, System Debugger, Memory Controller, Scoreboard Manager, Leaderboard Communication, Dice Bridge
  - **Clean Production Mode**: When disabled, only essential error messages and public announcements remain
  - **Full Debug Visibility**: When enabled, shows internal operations, sync messages, state changes, and diagnostic info

### 🔧 **Disconnect/Reconnect Recovery System**
- **Smart Player Return Detection**: Fixed major issue where disconnected players couldn't resume their turn
  - **Issue**: Players who disconnected during number picking (like Nooser) would get wrong menu when returning
  - **Before**: Disconnect → Return → Ready menu shown → Required kick to continue game
  - **After**: Disconnect → Return → "Welcome back! Restoring your number picking dialog..." → Game continues normally
- **Enhanced State Recovery**: Automatic detection and repair of corrupted game state from disconnections
  - Compares expected picker (from pick queue) with current picker state
  - Automatically fixes `currentPicker` corruption when players reconnect
  - Works for both number picking and dice rolling phases
- **Owner Emergency Recovery**: If game gets completely stuck, owner can touch board to force-resume
- **Debug Visibility**: Verbose logging shows state detection and recovery actions for troubleshooting

### 🎯 **Number Picker Dialog Protection System**
- **Stale Dialog Prevention**: Enhanced dialog validation to prevent outdated number selections
  - **Protection Against**: Players clicking cached dialog buttons after game state changed
  - **Validation Layers**: Session validation, player validation, number availability checking
  - **Smart Filtering**: Automatically rejects selections for numbers already picked by others
- **Enhanced Dialog Recovery**: Improved system for restoring number picking dialogs after disconnections
- **Session Management**: Better tracking of active dialog sessions to prevent conflicts

### 🔍 **Number Detection & Shield Logic Fixes**
- **Fixed "Numbers Not Showing" Issue**: Resolved major bug where system couldn't see numbers players had picked
  - **Issue**: Game would show "NO SHIELD!" even when players had actually picked the rolled number
  - **Root Cause**: Pick data synchronization issues between modules causing invisible player selections
  - **Solution**: Enhanced pick data validation and sync message reliability across all game modules
  - **Impact**: Shield detection now works correctly - proper "PLOT TWIST!" and shield mechanics restored

### ❌ **Enhanced Elimination Visual Feedback**
- **Red X Elimination Marker**: Added clear visual indicator for eliminated players on scoreboard
  - **Visual Enhancement**: Eliminated players now display a red X overlay on their profile picture
  - **Immediate Feedback**: Red X appears instantly when player reaches 0 lives for clear elimination status
  - **Persistent Display**: Red X remains visible on scoreboard until game reset for historical reference
  - **User Experience**: Players can easily see who has been eliminated without checking heart counts
  - **Credit**: Feature suggested by Pawkaf (pawkaf.lutrova)

### 🛡️ **Game State Desynchronization Fixes**
- **Sync Message Reliability**: Fixed various state sync issues that could cause game confusion
- **Pick Queue Protection**: Enhanced pick queue management to prevent corruption during disconnections
- **Display Consistency**: Fixed cases where different parts of the system showed conflicting game state
- **Race Condition Prevention**: Added proper sequencing for state updates during player disconnections

### 🐛 **Critical Bug Fixes**
- **LSL Syntax Corrections**: Fixed multiple mid-block variable declaration errors that prevented script compilation
  - **Issue**: LSL doesn't support variable declarations in middle of code blocks
  - **Fixed Files**: Main Controller, Floater Manager, Bot Manager, Roll Module, Game Manager, NumberPicker Handler, Message Handler, Game Calculator, System Debugger, Memory Controller, Leaderboard modules
  - **Solution**: Replaced problematic ternary operators and mid-block declarations with proper conditional statements
- **Ternary Operator Removal**: LSL doesn't support `condition ? value1 : value2` syntax - converted to if/else statements
- **Compilation Success**: All scripts now compile without syntax errors

### 🎮 **User Experience Improvements**
- **Seamless Reconnection**: Players can disconnect and return without disrupting game flow
- **Clear Status Messages**: Better feedback when verbose logging is toggled ("ENABLED"/"DISABLED" confirmations)
- **Graceful Recovery**: No more need to kick players just because they disconnected at wrong time
- **Owner Control**: Easy debug toggle access through familiar menu system

### 🔬 **Developer Experience Enhancements**
- **Comprehensive Debug Coverage**: Every major system component now supports verbose logging
- **Consistent Logging Format**: Standardized debug message format across all modules
- **Real-Time Diagnostics**: Live visibility into game state, sync operations, and recovery actions
- **Troubleshooting Tools**: Enhanced ability to diagnose and fix game state issues

### 🎯 **Impact Summary**
- **Before**: Player disconnections could break games, requiring kicks and manual intervention
- **After**: Players disconnect/reconnect seamlessly, games continue automatically  
- **Debug Control**: One-click verbose logging for production vs development modes
- **Stability**: Major reduction in game-breaking state corruption issues
- **Developer Productivity**: Rich diagnostic information available on demand

## [2.8.3] - 2025-09-01

### 🚨 **CRITICAL BUG FIXES** - Major Game Logic Issues Resolved

#### 🛡️ **Shield Detection Logic Fixed**
- **MAJOR BUG FIX**: Corrected shield detection that was incorrectly reporting "NO SHIELD!" when players had picked the rolled number
  - **Issue**: Game said "Nobody picked 1" even when Rebecca had picked "3, 1" - Taylor should have been shielded but took damage instead
  - **Root Cause**: Shield detection was checking if ONLY the peril player picked the number instead of checking if ANYONE picked it
  - **Fix**: Shield detection now correctly uses `matched` flag (anyone picked) instead of `perilPickedIt` flag (only peril player picked)
  - **Impact**: Players will no longer take undeserved damage when others provide proper shields
  - **Logic Update**: 
    - ✅ **NO SHIELD**: Only when nobody picked the rolled number (`!matched`)
    - ✅ **DIRECT HIT**: When peril player picked their own doom (`matched && perilPickedIt`)
    - ✅ **PLOT TWIST**: When someone else picked it but not peril player (handled upstream)

#### 🎯 **Initialization System Overhaul**
- **MAJOR BUG FIX**: Complete fix for "can't join after rez" issue that required manual script reset
  - **Issue**: When rezzing game from inventory, players couldn't join until all scripts were manually reset
  - **Root Cause**: Critical scripts weren't properly resetting their state variables on rez, causing stale data conflicts
  - **Scripts Fixed**: Added comprehensive `on_rez()` handlers to all critical game scripts:
    - 🎯 **Game_Manager.lsl**: Core game logic and state management (20+ variables reset)
    - 🎲 **Roll_ConfettiModule.lsl**: Dice rolling and shield detection logic
    - 🎮 **NumberPicker_DialogHandler.lsl**: Player number selection dialogs
    - 🤖 **Bot_Manager.lsl**: Bot player automation and picking logic
    - 📦 **Floater_Manager.lsl**: Player status floating displays
    - 🎭 **Player_DialogHandler.lsl**: Player and owner menu systems
    - 🧮 **Game_Calculator.lsl**: Dice type and pick requirement calculations
  - **Each Fix Includes**:
    - ✅ Complete state variable reset to initial values
    - ✅ Dynamic channel re-initialization for unique instance communication
    - ✅ Old listener cleanup and fresh listener setup
    - ✅ Stale game data clearing (picks, player lists, dialog sessions)
    - ✅ Critical flag reinitialization (roundStarted, rollInProgress, etc.)
  - **Impact**: **Game is now immediately ready for players after rezzing - NO manual script reset required!**

### 🎮 **Player Experience Improvements**
- **Immediate Playability**: Games rezzed from inventory are instantly ready for player registration
- **Fair Shield Mechanics**: Players providing shields now properly protect the peril player from damage
- **Clean State Guarantee**: Every new game instance starts with completely fresh state
- **Reliable Dialog Systems**: Number picking and menu dialogs work immediately after rez

### 🔧 **Technical Infrastructure**
- **Enhanced Script Coordination**: All scripts now properly coordinate during initialization
- **Channel Isolation**: Each game instance uses unique communication channels
- **Memory Management**: Proper cleanup prevents memory leaks from stale game sessions
- **State Synchronization**: Consistent state across all game components from startup

### 🧪 **Testing and Validation**
- **Shield Detection Testing**: Verified correct shield behavior in various game scenarios
- **Rez Testing**: Confirmed immediate playability after rezzing from inventory
- **State Cleanup Testing**: Validated complete cleanup of previous game sessions
- **Cross-Script Communication**: Verified proper initialization coordination

### 🎯 **Impact Summary**
- **Before**: Required manual "Reset Scripts" + shield detection failed
- **After**: Rez → Immediately playable + shields work correctly
- **User Experience**: Seamless game setup + fair gameplay mechanics
- **Reliability**: 100% successful initialization + accurate damage calculation

## [2.8.2] - 2025-08-21

### 🔥 **Critical Scoreboard Spam Fix**
- **Eliminated Player Sync Loop**: Fixed major bug where eliminated players caused continuous scoreboard update spam
  - Main Controller now properly updates peril player variable immediately after player elimination
  - Prevents stale sync messages containing eliminated player data from being broadcast repeatedly
  - Eliminates infinite scoreboard update loops that occurred when peril player was eliminated
  - Fixed root cause where Main Controller kept sending outdated peril player references in sync messages
- **Peril Player Validation**: Enhanced peril player assignment during elimination sequences
  - Checks if eliminated player is currently the peril player before final sync
  - Assigns new valid living player as peril player or sets to "NONE" if no players remain
  - Ensures updateHelpers() always sends clean game state without stale player references
  - Prevents perpetual "Noose the Bunny" style spam messages after player elimination

### 🎯 **Peril Status Display Fixes (Re-Fixed)**
- **Enhanced Floater Peril Status**: Re-implemented and improved peril status display on floating displays
  - Fixed peril status showing "waiting for game to start" during active gameplay (again)
  - Enhanced peril player detection logic in floater management
  - Improved sync message processing to ensure consistent peril status across all displays
  - Better handling of peril player transitions during plot twist scenarios

### 💖 **Elimination Heart Display Fixes (Re-Fixed)**
- **0 Hearts Before Elimination**: Re-fixed elimination sequence to properly show 0 hearts before player removal
  - Enhanced Main Controller elimination logic to ensure 0 hearts display timing
  - Extended display delay to make 0 hearts clearly visible on both scoreboard and floaters
  - Improved coordination between heart updates and player cleanup processes
  - Fixed race conditions where players were removed before 0 hearts could be displayed
- **Visual Elimination Feedback**: Strengthened elimination experience for better player feedback
  - Players now consistently see their elimination status with 0 hearts before removal
  - Scoreboard and floaters maintain synchronized elimination heart display
  - Enhanced user experience during elimination events with proper visual timing

### 🛠️ **Technical Improvements**
- **Elimination Sequence Enhancement**: Improved coordination between player removal and sync message broadcasting
  - Added peril player validation step before final updateHelpers() call
  - Enhanced elimination handler to prevent sync message corruption during player cleanup
  - Better synchronization between Main Controller state updates and helper script notifications
- **Display System Reliability**: Strengthened display update mechanisms for consistent visual feedback
  - Enhanced floater update triggers during game state changes
  - Improved peril status determination and heart display coordination
  - Better error handling for edge cases during elimination sequences

## [2.8.1] - 2025-08-14

### 🎯 **Peril Status Display Fixes**
- **Fixed Floater Status Updates**: Resolved issue where peril status on floating displays showed "waiting for game to start" during active gameplay
  - Enhanced peril status logic in Floater Manager to properly handle active game states
  - Added clear "YOU ARE IN PERIL!" messaging for the current peril player
  - Improved status display to show "Peril Player: [Name]" for all other players
  - Fixed condition checking for peril player status determination
- **Real-Time Status Synchronization**: Enhanced sync message handling for consistent peril status across all displays
  - Added debug logging to track peril player status changes in Floater Manager
  - Improved floater update triggers during game state changes
  - Enhanced sync message processing to immediately update all floaters when peril status changes
  - Fixed "NONE" placeholder handling in peril player sync messages

### 💖 **Elimination Heart Display Fixes**
- **0 Hearts Before Elimination**: Fixed elimination sequence to properly show 0 hearts before player removal
  - Modified Main Controller elimination logic to set player lives to 0 first
  - Added 1-second display delay to make 0 hearts visible on both scoreboard and floaters
  - Enhanced elimination flow with proper timing between heart display and player cleanup
  - Fixed race condition where players were removed before 0 hearts could be displayed
- **Visual Elimination Sequence**: Improved elimination experience for better player feedback
  - Players now see their elimination status with 0 hearts before floater disappears
  - Scoreboard and floaters show elimination hearts consistently
  - Better coordination between heart updates and player removal
  - Enhanced user experience during elimination events

### 🐛 **Bug Fixes and Improvements**
- **Sync Message Debugging**: Added comprehensive debug logging for peril player status tracking
  - Debug messages show peril player changes from old to new values
  - Enhanced visibility into sync message processing
  - Better troubleshooting capabilities for peril status issues
- **Floater Update Reliability**: Improved floater update system for more consistent status display
  - Enhanced floater update triggers during game state changes
  - Better handling of peril status changes during rounds
  - Improved sync message reliability for real-time status updates
- **Elimination Timing Fixes**: Resolved timing issues in elimination sequence
  - Fixed race condition where elimination cleanup occurred before status display
  - Added proper delays to ensure visual feedback before player removal
  - Enhanced coordination between Main Controller and display systems

### 🛠️ **Technical Improvements**
- **Enhanced Floater Manager Logic**: Improved peril status determination and display
  - Better condition checking for active game states vs. waiting states
  - Enhanced handling of "NONE" and empty peril player values
  - Improved sync message processing for consistent status updates
- **Main Controller Elimination Enhancements**: Better elimination sequence coordination
  - Added explicit 0 hearts setting before player removal
  - Improved helper update timing during elimination
  - Enhanced coordination between elimination logic and display updates
- **Debug Logging Additions**: Added targeted debug messages for key status changes
  - Peril player change tracking in Floater Manager
  - Elimination sequence logging in Main Controller
  - Better visibility into sync message processing

## [2.8.0] - 2025-08-12

### 🔒 **Game Lockout Security System**
- **Owner-Only Access Control**: Implemented comprehensive lockout system allowing game owners to restrict all game functionality to owner only
  - Complete dialog prevention for non-owners when game is locked
  - Visual feedback through floating text showing "🔒 GAME LOCKED" status
  - Clear error messaging to non-owners attempting access during lockout
  - Lock status persists during gameplay and between sessions
- **Dynamic Admin Controls**: Added lock/unlock toggle buttons in categorized owner menu
  - 🔒 Lock Game: Restricts access to owner only
  - 🔓 Unlock Game: Restores normal player access
  - Visual indicators in admin menu show current lock state
- **System Integration**: Lockout state synchronized between Main Controller and Dialog Handler
  - Lock/unlock commands sent via link messages (9001/9002)
  - Floating text updates automatically based on lock state
  - Complete access restriction including dialog generation prevention

### 🔄 **Automatic Reset on Startup System**
- **Clean State Guarantee**: Game automatically resets when critical scripts are updated or rezzed
  - Main Controller triggers reset on `state_entry()` for consistent startup state
  - Game Manager requests reset on startup to handle core game logic updates
  - All game state cleared while preserving historical leaderboard data
- **Smart Reset Logic**: Automatic reset preserves leaderboard while clearing temporary game state
  - Players, lives, picks, ready states cleared on startup
  - Win/loss records maintained in leaderboard system
  - Scoreboard cleared but leaderboard rankings preserved
- **Script Update Protection**: Enhanced reliability when game logic is modified
  - Prevents stale game states from carrying over after script updates
  - Ensures consistent experience for players after system updates
  - Eliminates need for manual resets after deployments

### 👥 **Enhanced Player Management System**
- **Kick Player Functionality**: Complete implementation of owner-controlled player removal
  - New "Kick Player" option in Player Management admin section
  - Smart display name handling with automatic truncation for dialog buttons
  - Complete player removal from all game systems (lists, scoreboard, floaters)
  - Immediate visual feedback on scoreboard when players are kicked
- **Rebuilt Leave Game System**: Complete overhaul of voluntary player departure
  - Fixed state synchronization issues between Controller and Dialog Handler
  - Proper cleanup of player floaters when leaving
  - Automatic removal from ready player lists
  - Scoreboard updates immediately reflect departing players
- **Advanced Name Management**: Enhanced handling of long display names
  - Automatic truncation to fit within 24-character dialog button limits
  - Preservation of original names for game logic while showing truncated versions in UI
  - Proper mapping between display names and actual player identities

### 🎯 **Categorized Admin Interface**
- **Organized Owner Menu**: Complete restructure of admin controls into logical categories
  - **Player Management**: Add Test Player, Kick Player functions
  - **Reset Options**: Game reset, Leaderboard reset, Complete reset
  - **Troubleshooting**: Cleanup floaters, Force floaters creation
  - **Security Controls**: Lock/Unlock game prominently displayed
- **Improved Navigation**: Enhanced menu flow with clear back navigation
  - Consistent "⬅️ Back to Main" options in all sub-menus
  - "⬅️ Back to Game" option to return to player interface
  - Context-sensitive menu options based on current state
- **Enhanced User Experience**: Better organization and discoverability of admin functions
  - Security-first design with lock controls prominently featured
  - Logical grouping of related functions
  - Clear visual indicators for current system state

### 🛠️ **System Reliability and State Management**
- **Enhanced Message Synchronization**: Improved communication reliability between scripts
  - Better coordination between Main Controller and Dialog Handler for player operations
  - Proper message sequencing for kick/leave operations
  - Race condition prevention in player registration and removal
- **State Consistency Improvements**: Enhanced data integrity across all game components
  - All game lists maintain synchronization during player changes
  - Floater cleanup properly coordinated with player removal
  - Ready state management integrated with player lifecycle
- **Error Recovery Enhancement**: Better handling of edge cases and unexpected states
  - Improved validation of player operations
  - Enhanced cleanup procedures for interrupted operations
  - More robust handling of script restart scenarios

### 📊 **Memory Management and Performance**
- **Efficient Data Cleanup**: Proper memory management during player operations
  - Complete cleanup of all player-related data structures
  - Efficient list operations for player removal
  - Proper floater channel management and cleanup
- **Reduced Memory Footprint**: Optimized storage of player state information
  - Efficient mapping between display names and original names
  - Streamlined admin menu data structures
  - Better garbage collection during reset operations

### 🔧 **Technical Infrastructure Updates**
- **Link Message Protocol Extensions**: New message types for enhanced functionality
  - Message 9001: Lock game command from Dialog Handler to Main Controller
  - Message 9002: Unlock game command from Dialog Handler to Main Controller
  - Message -99998: Reset request system for script update coordination
- **Floating Text Management**: Dynamic text updates based on system state
  - Lock/unlock status reflected in floating text
  - Game progress indicators maintained
  - Clear visual feedback for all system states
- **Admin Security Model**: Comprehensive owner verification throughout system
  - All security-sensitive operations validate owner identity
  - Lock/unlock operations restricted to game owner only
  - Consistent security model across all admin functions

### 🎮 **User Experience Improvements**
- **Clear Feedback Systems**: Enhanced messaging for all user interactions
  - Lock status clearly communicated to all users
  - Kick/leave operations provide immediate feedback
  - Error messages are clear and actionable
- **Professional Admin Interface**: Polished owner experience with logical organization
  - Intuitive menu structure follows user workflow
  - Consistent visual design and button labeling
  - Context-appropriate options based on current game state
- **Seamless Player Experience**: Minimal disruption during admin operations
  - Quick player removal without game interruption
  - Smooth ready state management
  - Preserved game flow during player changes

## [2.7.0] - 2025-08-12

### 🏗️ **MAJOR ARCHITECTURAL OVERHAUL - Single Linkset Design**
- **Complete System Consolidation**: Merged all 4 separate objects into single linkset architecture
  - Main Controller + Roll Module: Link 1 (root prim)
  - Game Scoreboard: Links 2-24 (scoreboard background, actions display, player slots)
  - XyzzyText Leaderboard: Links 25-72 (48 prims for text display across 4 banks)
  - Dice Display: Links 73-74 (2 prims for XyzzyText dice results)
  - Total: 74-prim consolidated linkset replacing 4 separate rezzed objects
- **Elimination of Region Chat**: Replaced all `llRegionSay()` communication with `llMessageLinked()`
  - No more channel conflicts or discovery issues between multiple game instances
  - Instant, reliable communication within single linkset
  - Zero risk of cross-talk between multiple game tables
- **Simplified Deployment**: Single object rez instead of complex 4-object positioning system
  - No more Position Controller/Follower scripts needed
  - No more automatic rez positioning coordination
  - Instant setup - rez once and play

### 📡 **Dynamic Channel System Removal**
- **Channel System Elimination**: Removed entire hash-based dynamic channel calculation system
  - No more `calculateChannel(offset)` functions across scripts
  - No more MD5-based hash generation for channel uniqueness
  - No more owner key + object key channel calculations
  - Eliminated ~78000 to ~86000 channel range management
- **Communication Simplification**: All inter-component communication now uses link messages
  - Scoreboard communication via link messages to specific prim numbers
  - Leaderboard updates via link messages to bridge scripts
  - Dice display updates via link messages within linkset
  - Zero external channel dependencies

### 🎯 **Dice Type Synchronization Fixes**
- **Critical Race Condition Resolution**: Fixed major bug where Game Manager and Roll Module independently requested dice types
  - Eliminated inconsistent dice types between human players and bots (e.g., player rolling d6 when expecting d30)
  - Prevented double rolls with different dice types from conflicting module requests
  - Removed duplicate dice type calculation across multiple modules
- **Targeted Communication System**: Calculator sends dice type responses only to requesting module
  - Game Calculator responds directly to sender using link numbers
  - Eliminated `LINK_SET` broadcasts that caused race conditions and stale data
  - Each module requests dice type independently when needed, preventing conflicts

### 🔄 **Clean Module Communication Architecture**
- **Link Message Routing**: Established clear communication paths within linkset
  - Main Controller ↔ Scoreboard: Link 1 → Link 2
  - Scoreboard → Leaderboard Bridge: Link 2 → Link 25
  - Roll Module → Dice Bridge: Link 1 → Link 73
  - All communication uses `llMessageLinked()` with specific link numbers
- **Module Responsibilities**:
  - **Game Calculator**: Calculates dice types on request; sends targeted responses only
  - **Game Manager**: Requests dice type for pick phase coordination and dialog building
  - **Roll Module**: Requests dice type independently when performing actual rolls
  - **Scoreboard Manager**: Handles player display and leaderboard formatting
  - **Bridge Scripts**: Handle XyzzyText display distribution for leaderboard and dice

### 🛠️ **Game Flow Improvements**
- **Win Condition Protection**: Enhanced Game Manager to detect single remaining player and stop rounds
  - Prevents infinite game loops where bot fights itself after human elimination
  - Game properly ends when only one player remains instead of continuing indefinitely
- **Round Completion Logic**: Improved detection of round completion across all scenarios
  - Handles Direct Hit, No Shield, and Plot Twist outcomes correctly
  - Enhanced sync protection against empty pickQueue overwrites during active rounds
- **Pick Dialog Synchronization**: Game Manager uses correct dice type for human pick dialogs
  - Ensures number selection dialogs show appropriate range (1-6 for d6, 1-30 for d30)
  - Maintains consistency between dialog options and actual roll dice type

### 📊 **Display System Integration**
- **Scoreboard Integration**: Scoreboard prims now part of main linkset (Links 3-24)
  - BACKGROUND_PRIM: Link 3, ACTIONS_PRIM: Link 4, FIRST_PLAYER_PRIM: Link 5
  - Player prims span Links 5-24 (20 player slots with profile pictures and hearts)
  - Direct link message communication for instant updates
- **Leaderboard Integration**: XyzzyText leaderboard integrated as Links 25-72
  - 48 prims across 4 banks of 12 characters each for "TOP BATTLE RECORDS" display
  - Formatted leaderboard shows positions 1-11 with wins/losses in "W:X/L:Y" format
  - Communication via Leaderboard Bridge script on Link 25
- **Dice Display Integration**: Dice results display as Links 73-74
  - Real-time dice roll results showing "Player: rolled X" format
  - Victory displays showing "PlayerName|WON" for game winners
  - Communication via Dice Bridge script on Link 73

### 🏃‍♂️ **Performance and Reliability**
- **Zero Channel Conflicts**: Complete elimination of region chat channel issues
- **Instant Communication**: Link messages provide immediate, guaranteed delivery
- **Multi-Instance Support**: Multiple game tables can operate without any interference
- **Simplified Maintenance**: Single object to manage instead of 4-object coordination
- **Memory Efficiency**: Removed channel calculation overhead and hash generation processing

### 🗑️ **Removed Systems**
- **Dynamic Channel Management**: Entire hash-based channel system removed
- **Position Controller/Follower**: No longer needed with single linkset design
- **Automatic Rez Positioning**: Eliminated complex multi-object positioning scripts
- **Region Chat Dependencies**: All `llRegionSay()` calls replaced with `llMessageLinked()`
- **Channel Discovery**: No more channel assignment reporting or debugging tools needed

### 🎮 **User Experience**
- **One-Click Deployment**: Single object rez for complete game setup
- **Reliable Operation**: No communication failures or channel conflicts
- **Clean Console**: No channel debugging messages or communication errors
- **Professional Presentation**: Integrated display components work seamlessly together

## [2.6.0] - 2025-08-09

### 📡 Advanced Channel Management System
- **Dynamic Channel Calculation**: Implemented sophisticated channel assignment system to prevent conflicts
  - Channels calculated using combined hash of owner key + object key for uniqueness
  - Prevents interference between multiple game tables owned by same person
  - Each game instance gets completely unique channel space
  - MD5-based hash generation creates 0-255 range offsets for channel distribution
- **Multi-Instance Support**: Multiple game tables can now operate simultaneously without channel conflicts
- **Automatic Channel Assignment**: 
  - Main Controller: ~-78000 range (CHANNEL_BASE - offset - hash)
  - Dialog Handler: ~-79000 range
  - Roll Module: ~-80000 range  
  - Bot Manager: ~-81000 range
  - Scoreboard: ~-83000 range
  - Leaderboard: ~-84000 range
  - Position System: ~-85000 range
  - Floater Base: ~-86000 range (with per-player offsets)
- **Channel Debugging**: Owner receives detailed channel assignments on startup for troubleshooting

### 🧹 Debug Output Cleanup Campaign
- **Main Controller Noise Reduction**: Removed verbose debug messages causing chat spam
  - Eliminated touch event logging (`"DEBUG: touch_start - sender: X"`)
  - Removed dice type result debug output (`"DEBUG: Roll result: X on dY"`)
  - Cleaned up excessive state change notifications
  - Preserved essential error messages and critical game flow information
- **Floater Manager Debug Cleanup**: Significantly reduced verbose owner messages
  - Removed detailed picks data logging from `getPicksFor()` function calls
  - Eliminated floater cleanup debug messages (channel, index, player data confirmations)
  - Removed sync state debug information showing counts of lives, picks, and names
  - Maintained important error reporting for malformed data and critical issues
- **Professional Operation Standards**: Game now operates with minimal console noise

### 🎯 Enhanced User Experience
- **Reduced Log Spam**: Console output now focuses on meaningful information only
- **Essential Information Preserved**: Error messages and critical game events still logged
- **Clean Monitoring**: Easier to spot actual issues without debug noise overwhelming chat
- **Multi-Table Deployment**: Support for running multiple game instances without interference

### 🛠️ Technical Infrastructure Improvements
- **Performance Enhancement**: Reduced string processing overhead from debug output removal
- **Memory Optimization**: Less memory usage from debug string concatenation and storage
- **Channel Architecture**: Robust system for managing communication channels across components
- **Hash-Based Uniqueness**: Cryptographically sound channel assignment preventing collisions
- **Maintainability**: Cleaner codebase easier to debug when real issues occur

### 🔧 System Reliability
- **Conflict Prevention**: Eliminates channel conflicts that could cause cross-talk between games
- **Instance Isolation**: Each game table operates in completely isolated channel space
- **Debugging Tools**: Built-in channel reporting for troubleshooting communication issues
- **Production Ready**: Professional-grade logging levels suitable for live deployment

### 📋 Implementation Details
- **Channel Calculation Function**: `calculateChannel(offset)` in all major scripts
- **Initialization Reporting**: Detailed channel assignments logged on script startup
- **Cross-Script Consistency**: All components use same channel calculation method
- **Owner Transparency**: Clear visibility into assigned channels for admin purposes

## [2.5.0] - 2025-08-08

### 🛡️ Registration Security Fixes
- **Duplicate Registration Prevention**: Fixed critical bug where players could register multiple times by rapid clicking
  - Added `pendingRegistrations` list to track registration requests in progress
  - Prevents duplicate registration messages from being sent while first registration processes
  - Automatic cleanup of pending registrations after completion or timeout
- **Startup Sequence Protection**: Fixed bug allowing player joins during game initialization
  - Added `gameStarting` flag to block registrations immediately when "Start Game" is clicked
  - Eliminates timing window between game start and `roundStarted` flag activation
  - Maintains owner exception for admin menu access during gameplay

### 🎮 Improved Game Flow Control
- **Enhanced Touch Handler**: Better handling of registration status with user feedback
- **State Management**: Proper cleanup of both `gameStarting` and `pendingRegistrations` during reset
- **User Experience**: Clear messaging when registration attempts are blocked during active periods

### 🐛 Critical Bug Fixes
- **Race Condition Resolution**: Eliminated duplicate player entries from rapid multiple touches
- **Game Disruption Prevention**: Stopped unwanted joins during critical game startup phase
- **Consistent Game State**: All registration paths now properly validate timing and prevent duplicates
- **Duplicate Pick Prevention**: Fixed `continueCurrentRound()` function to properly rebuild `globalPickedNumbers` with uniqueness checks
- **Data Corruption Fix**: Resolved issue where `globalPickedNumbers` could contain duplicates, causing inconsistent bot pick validation
- **Delimiter Handling**: Enhanced parsing to correctly handle both comma (human) and semicolon (bot) pick delimiters
- **Server-Side Pick Validation**: Added robust server-side validation in `Main.lsl` to prevent duplicate picks from being accepted
  - Human picks are now validated against `globalPickedNumbers` before acceptance
  - Invalid picks are rejected with clear error messaging to the player
  - Player receives new dialog with updated available numbers after rejection
  - Eliminates client-side bypass vulnerabilities in duplicate prevention
- **Loss Tracking**: Fixed missing loss records in leaderboard when players are eliminated
  - Added `GAME_LOST|` message broadcast when players are eliminated
  - Eliminated players now properly appear in leaderboard with loss counts
  - Provides complete game statistics showing both wins and losses
- **Enhanced Display Name Handling**: Implemented robust player name resolution with fallback system
  - Added `getPlayerName(key id)` helper function in all scripts (Main.lsl, Dialog Handler, StatFloat)
  - Prioritizes modern `llGetDisplayName()` for better user experience
  - Falls back to legacy `llKey2Name()` when display names are unavailable
  - Handles network issues, offline avatars, and viewer compatibility problems
  - Ensures no player is ever shown as blank or missing name
  - Consistent name handling across all game components and messages

## [2.4.0] - 2025-08-08

### 📍 Position Management System
- **Master-Follower Architecture**: Complete position synchronization system for all game components
- **Position Controller Script**: Main controller object manages movement of scoreboard, leaderboard, and displays
- **Follower Script Template**: Generic follower script that reads position settings from config notecard
- **Config-Based Positioning**: Position offsets and rotations defined in "config" notecard for easy customization
- **Automatic Movement Sync**: When controller moves, all linked objects maintain relative positions
- **Position Reset Tools**: Built-in recalibration system for repositioning knocked-out components
- **Multi-Object Coordination**: Seamless movement of entire game system as single unit

### 🧹 Production Code Cleanup
- **Debug Code Removal**: Complete removal of all debug logging statements and test messages
  - Removed `llOwnerSay("DEBUG: ...)` calls throughout Main.lsl (lines 147, 161, 479, 517, 523, 527, 874, 1163)
  - Eliminated development-time diagnostic messages and empty debug blocks
  - Cleaner, more professional game experience without debug clutter
- **Syntax Error Fixes**: 
  - Fixed critical missing closing brace on line 835 in Main.lsl causing compilation failure
  - Resolved LSL syntax errors that prevented script execution
  - All scripts now compile cleanly without warnings or errors

### 🛠️ Development Quality Improvements
- **Production Readiness**: Scripts optimized for live deployment without development artifacts
- **Performance Enhancement**: Eliminated unnecessary debug output reducing execution overhead
- **Memory Optimization**: Reduced script memory footprint by removing debug string operations
- **Code Maintainability**: Cleaner codebase structure for future development
- **Professional Polish**: Game system ready for production deployment

### 🔧 Technical Improvements
- **LSL Compliance**: All scripts pass Second Life LSL compilation standards
- **Execution Efficiency**: Faster script performance without debug processing overhead
- **Position Synchronization**: Robust communication system for coordinated object movement
- **Config System**: Flexible notecard-based configuration for easy position adjustments
- **Error Resolution**: Fixed all syntax issues preventing proper game operation

### 📚 Documentation Updates
- **Position System Guide**: Comprehensive instructions for setting up position management
- **Reset Tools Documentation**: Step-by-step guide for recalibrating positions
- **Version Tracking**: Updated to semantic versioning 2.4.0
- **Change History**: Detailed tracking of all modifications and improvements

## [2.3.0] - 2025-08-05


### 🏆 Visual Scoreboard System
- **Dynamic Player Grid**: Real-time visual scoreboard displaying all players with profile pictures and heart count
- **Profile Picture Integration**: Automatic fetching of Second Life avatar profile pictures via HTTP requests
- **Heart Texture Display**: Visual life representation using custom heart textures (3, 2, 1, 0 hearts)
- **Bot Profile Support**: Special profile texture for TestBot players
- **Immediate Updates**: Hearts update instantly when lives change, before any dialogs appear

### 🎭 Enhanced Status Display System
- **Visual Status Actions**: Large action prim displaying current game status with custom textures
- **Specific Status Messages**:
  - **Direct Hit**: When peril player picks their own rolled number
  - **No Shield**: When nobody picks the rolled number
  - **Plot Twist**: When peril switches to a new player
  - **Elimination**: When a player is eliminated
  - **Victory**: When someone wins the game
  - **Peril Selected**: When a new peril player is chosen
  - **Title**: Default/idle state

### ⚡ Perfect Status Timing
- **Protected Display Time**: Each status shows for 8 seconds with automatic clearing
- **Strategic Delays**: 2-second delays after status messages prevent overwriting
- **Sequential Flow**: Elimination → 6.4s delay → Victory → 9s delay → Reset
- **Immediate Visual Feedback**: Hearts and status update instantly, delays protect display time

### 🎯 Comprehensive Leaderboard
- **Persistent Win Tracking**: Player victories saved across game sessions
- **XyzzyText Integration**: Three-prim text display system for leaderboard
- **Automatic Sorting**: Top players by win count with formatted display
- **Separate Reset Options**: Game reset vs. leaderboard reset vs. complete reset

### 🎮 Enhanced User Interface
- **Categorized Owner Menus**: Organized into Game Control, Player Management, Reset Options, etc.
- **Dialog Recovery**: Players can recover lost dialogs by touching the controller
- **Admin Menu Access**: Owner can access admin functions during gameplay
- **Improved Menu Flow**: Streamlined navigation with clear categorization

### 🔧 Technical Improvements
- **Multi-Object Architecture**: Scoreboard and leaderboard as separate linked objects
- **HTTP Profile Fetching**: Robust system for retrieving avatar profile pictures
- **Texture Caching**: Profile pictures cached to avoid repeated HTTP requests
- **Region-Based Communication**: Cross-object messaging using `llRegionSay`
- **Elimination Sequence**: Visual 0-hearts display before player removal

### 🐛 Critical Fixes
- **Heart Update Timing**: Fixed hearts not updating until after next-turn dialog
- **Victory Overwriting Elimination**: Added proper delay between elimination and victory status
- **Status Message Conflicts**: All status messages now have protective delays
- **Profile Picture Fallbacks**: Proper handling of failed HTTP requests
- **Scoreboard Reset**: Fixed scoreboard not clearing when game resets

## [2.2.0] - 2025-08-04

### 🎭 Major UX/Presentation Improvements
- **Dramatic Messaging System**: Complete overhaul of game messages with thematic styling
- **Public Announcements**: Key game events now visible to all players in public chat
- **Context-Rich Roll Messages**: Dice rolls now show both dice type and result
- **Split Hit Messages**: Different messages for "picked own doom" vs "no shield" scenarios

### 🎮 Enhanced Player Experience
- **Player Join Messages**: `💀 PlayerName has entered the deadly game! Welcome to your potential doom! 💀`
- **Ready State Messages**: 
  - `👑 PlayerName steps forward as the game master - automatically ready for the deadly challenge! 👑`
  - `⚔️ PlayerName steels themselves for the deadly challenge ahead! ⚔️`
  - `🏃 PlayerName loses their nerve and backs away from the challenge! 🏃`
- **Pick Announcements**: `🎯 PlayerName stakes their life on numbers: 1, 2, 3 🎲`
- **Game Start**: `⚡ ALL PARTICIPANTS READY! THE DEADLY PERIL DICE GAME BEGINS! ⚡`

### 🎲 Improved Roll Messages
- **Main Roll**: `🎲 THE D6 OF FATE! PlayerName rolled a 5 on the 6-sided die! 🎲`
- **Plot Twist**: `⚡ PLOT TWIST! PlayerName picked 5 (rolled on d6) and is now in ULTIMATE PERIL! ⚡`
- **Direct Hit**: `🩸 DIRECT HIT! PlayerName picked their own doom - the d6 landed on 5! 🩸`
- **No Shield**: `🩸 NO SHIELD! Nobody picked 5 - PlayerName takes the hit from the d6! 🩸`

### 🔧 Critical Bug Fixes
- **StatFloat Duplication**: Fixed bug where new StatFloat objects were created on every life loss instead of updating existing ones
- **Duplicate Message Handling**: Removed duplicate `HUMAN_PICKED` handlers that caused double processing
- **Malformed Entry Warnings**: Fixed LSL parsing issues with empty picks entries
- **Cleanup Optimization**: Reduced excessive StatFloat cleanup messages during reset

### 🛠️ Technical Improvements
- **Debug Message Cleanup**: Removed excessive debug output while preserving essential error reporting
- **Message Handler Optimization**: Streamlined communication between scripts
- **LSL Parsing Fixes**: Better handling of trailing empty elements in data parsing
- **Memory Management**: Improved StatFloat lifecycle management

## [2.1.0] - 2025-08-03

### ✨ 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] - 2025-XX-XX

### 🌟 Original Release
- Basic Peril Dice game implementation
- Manual gameplay mechanics
- Simple player tracking
- Basic dice rolling functionality

---

## Development Notes

### Known Issues
- **Debug Output**: Extended games may experience minor lag from comprehensive logging

### Recent Fixes (2025-01-08)
- **Bot Race Condition**: Fixed critical bug where duplicate message handlers prevented proper `globalPickedNumbers` updates
- **Enhanced Bot Logging**: Added detailed pick tracking and duplicate detection in Bot Manager
- **Message Handler Separation**: Separated bot and human pick handling to prevent conflicts

### Future Enhancements  
- 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