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

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