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 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 <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:

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

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

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. 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

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

---

Last Updated: March 2026 | Version: 1.1.0-BETA