Hide and Seek: Reimagined

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 2. Spectator Features 3. Economy System 4. Glow Effects 5. Voting System 6. Lobby Management 7. 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 auto-focuses on the seeker 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 <lobby_name> ``` 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

- Repeat: Configured interval (default: 60 seconds into game) - Repeat: All hiders glow for 5 seconds (configurable) - Repeat: 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 <lobby_name> ``` - Initiator automatically votes YES - Timer starts (30 seconds by default)

2. Players Vote ``` /hsr voteyes # Support game start /hsr voteno # Oppose game start ```

3. Rejected - Rejected: 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 <lobby_name> [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 <lobby_name> <attribute> <value> ```

| 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 <status> <lobby_name> ```

Statuses: - `ACTIVE` - Normal gameplay allowed - `MAINTENANCE` - Disabled (admins only) - `DISABLED` - Closed to all players

Viewing Lobby Info

``` /hsr info <lobby_name> /hsr lobby info [lobby_name] (when in lobby) ```

Displays all current settings and player count.

---

Admin Tools

Game Management

Stop Active Game ``` /hsr stop <lobby_name> ``` - Ends game immediately - Returns players to lobby - Generates final report

Delete Lobby ``` /hsr delete <lobby_name> ``` - Removes lobby and all settings - Disconnects all players - Cannot be undone

Change Status ``` /hsr status <ACTIVE|MAINTENANCE|DISABLED> <lobby_name> ``` - 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 <lobby_name> ``` - 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 <command> <player_name> ``` - 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

---

Version: March 2026 | Version: 1.1.0-BETA