# Hide and Seek: Reimagined - Feature Guide Complete documentation of all features in Hide and Seek Reimagined v1.1.0-BETA. --- ## 📋 Table of Contents 1. [Game Reporting System](#game-reporting-system) 2. [Spectator Features](#spectator-features) 3. [Economy System](#economy-system) 4. [Glow Effects](#glow-effects) 5. [Voting System](#voting-system) 6. [Lobby Management](#lobby-management) 7. [Admin Tools](#admin-tools) --- ## Game Reporting System ### Overview Automatically tracks all completed games with statistics for replay and analysis. ### What's Tracked - **Game Metadata** - Lobby name - Seeker UUID and name - Game start timestamp - Total game duration - **Player Statistics** - Total players in game - Number of kills by seeker - Number of surviving hiders - Full list of participant names - **Game Results** - All found player UUIDs - Winner determination (all found = seeker wins) - Economic rewards earned ### Viewing Reports **For Player:** ``` /hsr lobby report [lobby_name] ``` Shows the last 5 completed games in that lobby with formatted results. **For Admin:** ``` /hsr reports [limit] ``` View all stored reports (default 10, max 50). ### Storage - Maximum 100 reports stored per server session - Reports include formatted timestamps - Older reports automatically pruned when limit reached ### Example Report Output ``` [HSR] Lobby: Arena1 | Seeker: PlayerX | Kills: 7/8 | Survivors: 1 | Duration: 18m 45s | Time: 2026-03-22 12:30:15 ``` --- ## Spectator Features ### Auto-Spectate on Death When a hider is found/killed: 1. Player automatically enters **Spectator Mode** 2. Camera **auto-focuses on the seeker** 3. Player can freely look around in spectator perspective 4. Notification sent: "You were found! Spectating the seeker..." ### Benefits - Eliminated players stay engaged watching the game - See the seeker's strategy and tactics - Reduces disconnections from frustrated players - Educational for newer players ### Technical Implementation - Uses Bukkit `setGameMode(GameMode.SPECTATOR)` - Applies `setSpectatorTarget(seeker)` for camera focus - Gracefully falls back if methods unavailable ### Manual Spectate ``` /hsr spectate ``` Join a running game as spectator without playing. --- ## Economy System ### Overview Vault-based currency rewards for winners and kill bonuses. **Completely optional** - works with Vault, degrades gracefully without it. ### Reward Structure #### Seeker Rewards - **Base Reward**: 500 currency (configurable) - Earned for winning (killing all hiders before time expires) - **Kill Bonus**: 10 currency per player found (configurable) - Added for each hider eliminated - **Time Penalty**: -50 currency per 2 minutes under threshold - Applies if game ends too quickly (default < 5 minutes) - Discourages overpowered seeker configurations #### Example Calculation ``` Game: 7 kills in 4 minutes Base: 500 Kills: 7 × 10 = 70 Penalty: -50 (under 5 min threshold) Total: 500 + 70 - 50 = 520 currency ``` #### Hider Rewards - **Survival Bonus**: Configurable (optional) - Earned for surviving full game duration ### Configuration Edit `config.yml`: ```yaml economy: seeker-base-reward: 500 # Base winning reward bonus-per-kill: 10 # Per player found penalty-minimum-time: 5 # Minutes before penalty applies penalty-per-2min: 50 # Currency deducted per 2 minutes under time ``` ### Without Vault If Vault is not installed: ``` [WARNING] Vault not found! Economy rewards disabled. ``` - Plugin still works fully - All commands function normally - No currency exchanges occur - No errors or crashes ### Recommended Economy Plugins - EssentialsX (most popular) - GriefPrevention - LiteBans - Towny - McMMO --- ## Glow Effects ### Overview Periodic visual indicator for hiders during late-game phases to increase difficulty and excitement. ### How It Works - **Trigger**: Configured interval (default: 60 seconds into game) - **Activation**: All hiders glow for 5 seconds (configurable) - **Duration**: 5-second glow period - **Repeat**: Automatically resets at interval ### Configuration ```yaml mechanics: glow-interval: 60 # Seconds between glow activations glow-duration: 5 # Duration of glow in seconds ``` ### Gameplay Impact - Helps dynamic games by preventing indefinite hiding - Makes late-game more challenging - Visual cue for extended games - Can be disabled by setting duration to 0 ### Disabled Glow ```yaml mechanics: glow-interval: 0 # Disables glow entirely ``` --- ## Voting System ### Overview Democratic game start with configurable vote thresholds. ### Voting Flow 1. **Initiate Vote** ``` /hsr start ``` - Initiator automatically votes YES - Timer starts (30 seconds by default) 2. **Players Vote** ``` /hsr voteyes # Support game start /hsr voteno # Oppose game start ``` 3. **Vote Outcome** - **Approved**: If YES votes ≥ threshold % → Game starts - **Rejected**: If time expires without threshold → Vote canceled 4. **Game Starts** - All players teleported to spawn - Seeker selected randomly - Count-down begins ### Configuration ```yaml mechanics: start-vote-percentage: 30 # % of players needed to approve (70% need yes) ``` ### Vote Information - Can view vote status with `/hsr voteyes` response - Shows current yes/no votes and total needed - Only one vote per player - Re-voting overwrites previous choice --- ## Lobby Management ### Creating Lobbies ``` /hsr create [world_name] ``` - Creates new isolated lobby instance - World defaults to player's current world - Lobby owner has special privileges ### Lobby Settings #### Per-Lobby Configuration ``` /hsr settings ``` | Attribute | Example | Description | |-----------|---------|-------------| | `minplayers` | 2 | Minimum players to start | | `maxplayers` | 16 | Maximum capacity | | `gametime` | 1200 | Game duration in seconds | | `respawntime` | 30 | Spectator respawn delay | | `pvp` | true | Enable/disable PVP | | `difficulty` | HARD | Difficulty level | | `itemdrop` | false | Allow item drops | | `spectator` | true | Allow spectators | #### Example Setup ``` /hsr settings arena1 minplayers 4 /hsr settings arena1 maxplayers 12 /hsr settings arena1 gametime 1800 (30 minutes) /hsr settings arena1 pvp false ``` ### Lobby Status ``` /hsr status ``` **Statuses:** - `ACTIVE` - Normal gameplay allowed - `MAINTENANCE` - Disabled (admins only) - `DISABLED` - Closed to all players ### Viewing Lobby Info ``` /hsr info /hsr lobby info [lobby_name] (when in lobby) ``` Displays all current settings and player count. --- ## Admin Tools ### Game Management **Stop Active Game** ``` /hsr stop ``` - Ends game immediately - Returns players to lobby - Generates final report **Delete Lobby** ``` /hsr delete ``` - Removes lobby and all settings - Disconnects all players - Cannot be undone **Change Status** ``` /hsr status ``` - ACTIVE: Normal play - MAINTENANCE: Admins only - DISABLED: No access ### View Game Reports ``` /hsr reports [limit] ``` - View up to 50 stored game reports - Shows formatted statistics - Default displays 10 latest - Includes total report count ### View Lobby Reports ``` /hsr lobby report ``` - Shows game history for specific lobby - Displays last 5 games - Formatted with timestamps ### Global Configuration ``` /hsr config reload /hsr config debug ``` - `reload` - Reload config files - `debug` - Toggle debug logging ### Execute Commands As Player ``` /hsr sudo ``` - Run command from another player's perspective - Useful for troubleshooting - Requires `hsr.sudo` permission --- ## Statistics & Tracking ### Player Statistics ``` /hsr stats [player_name] ``` Displays: - Total games played - Wins as seeker - Wins as hider - Total kills - Kill/death ratio - Longest survival time ### Report Statistics Each report includes: - Participant list with UUIDs and names - Kill count and survivor count - Game duration - Timestamp with date and time --- ## Best Practices ### For Server Owners 1. ✅ Install Vault for full economy features 2. ✅ Configure economy settings in `config.yml` 3. ✅ Set reasonable game times (10-30 minutes) 4. ✅ Adjust glow effects for difficulty balance 5. ✅ Monitor `/hsr reports` for game balance ### For Lobbyowners 1. ✅ Set appropriate min/max player counts 2. ✅ Customize world for each lobby theme 3. ✅ Adjust game time based on world size 4. ✅ Disable PVP if hiders shouldn't fight back 5. ✅ Test settings before opening to players ### For Event Hosts 1. ✅ Use `/hsr sudo` to demo for spectators 2. ✅ Review reports to track progression 3. ✅ Adjust penalties/bonuses for difficulty 4. ✅ Set spectator mode to true for viewers 5. ✅ Use lobby reports to show game history --- ## Troubleshooting Features ### Reports Not Appearing - Wait for game to complete naturally - Check lobby is set to ACTIVE - Use `/hsr reports` (requires hsr.admin) ### Spectators Not Auto-Focusing - Verify setSpectatorTarget() method available - Check Player is valid and online - Try manual `/hsr spectate` command ### Economy Not Working - Ensure Vault plugin installed - Check config.yml settings - Verify server economy plugin linked to Vault ### Glow Effects Too Frequent - Increase glow-interval value in config - Reduce glow-duration for shorter pulses - Set interval to 0 to disable --- **Last Updated**: March 2026 | **Version**: 1.1.0-BETA

kvxnom