Hide and Seek: Reimagined - Alpha 1.0.1

Release Date: April 4, 2026
Plugin Version: 1.0.1-ALPHA
Minecraft Version: 1.21.11
Server: Paper 1.21.11 or higher
Author: kvxnom.xyz

---

Welcome to Alpha 1.0.1!

This is the second alpha release of Hide and Seek: Reimagined. We've made MAJOR improvements with actual gameplay mechanics, beautiful UI enhancements, and player-friendly features. The plugin now moves from infrastructure-focused to a fully playable hide and seek experience!

What's New in Alpha 1.0.1

🎮 Actual Gameplay Implementation ✨ NEW

• Automatic game starting when minimum players reached
• Seeker/hider role assignment system
• Automated countdown timer (30 seconds)
• Game state management (waiting → starting → in-progress → finished)
• Win condition detection
• Player elimination on finding
• Game-end announcement and reset

📊 BossBar Interaction ✨ NEW

• Real-time game timer display (BossBar)
• Player count indicator in BossBar
• Color-coded status (green=waiting, yellow=starting, red=in-progress)
• Players can see remaining time at a glance
• Automatic BossBar cleanup on game end

🖱️ GUI Controls ✨ NEW

• Interactive inventory GUI for lobby selection
• One-click lobby joining from GUI
• Easy lobby browsing without commands
• Status indicators (full, active, maintenance)
• Click notifications
• GUI-based settings viewer

💬 Command Popups & Auto-Say ✨ NEW

• Chat-based command quick-access buttons
• Click to auto-execute commands
• /hsr join button in lobby list
• /hsr leave quick-exit button during game
• /hsr create template suggestions
• Settings modification shortcuts
• Easy access for non-command-savvy players

📈 Additional Improvements

• Player statistics tracking (games won, games played)
• Score tracking during games
• Better join/leave notifications with colors
• Spectator mode during active games
• Seeker/hider color-coding in messages
• Performance optimizations

---

What Has Changed Since Alpha 1.0.0

New Features (v1.0.0 → v1.0.1)

Feature	v1.0.0	v1.0.1	Details
Game Start	❌	✅	Automatic when min players reached
Role Assignment	❌	✅	Seeker/Hider roles assigned
Game Timer	❌	✅	BossBar countdown display
Gameplay Loop	❌	✅	Complete game flow (start→play→end)
BossBar System	❌	✅	Real-time game information
GUI Menus	❌	✅	Inventory-based controls
Command Buttons	❌	✅	Clickable chat commands
Player Stats	❌	✅	Win/loss tracking
Spectator Mode	❌	✅	Watch active games

---

New Commands (v1.0.1)

Gameplay Commands

• /hsr start <name> - Manually start a game
• /hsr stop <name> - Stop an active game
• /hsr stats [player] - View player statistics
• /hsr spectate <name> - Join as spectator

GUI Commands ✨ NEW

• /hsr gui - Open lobby selection GUI
• /hsr gui settings <name> - Open lobby settings GUI

Previous Commands (Still Available)

All commands from v1.0.0 remain functional and enhanced!

---

Game Flow (New in v1.0.1)

Complete Gameplay Loop

1. LOBBY PHASE
   └─ Players join via /hsr join or GUI
   └─ Player count displayed in BossBar
   └─ Status: "Waiting for players..."

2. STARTING PHASE (30 seconds)
   └─ Minimum players reached ✅
   └─ 30-second countdown begins
   └─ Players can't leave
   └─ BossBar shows countdown

3. GAME PHASE
   └─ Random role assignment (1 seeker, rest hiders)
   └─ Game timer starts (configurable, default: 600 seconds)
   └─ BossBar shows: "TIME: X:XX | SEEKERS: 1/20"
   └─ Hiders must hide
   └─ Seeker must find hiders
   └─ Found players removed from game

4. END PHASE
   └─ Game ends when:
      • Timer expires (seeker loses)
      • All hiders found (seeker wins)
   └─ Winner announcement in chat
   └─ Statistics updated
   └─ Lobby returns to LOBBY phase

---

BossBar System (New)

Display Format

[████████████████░░░░] TIME: 5:32 | SEEKERS: 1/16

Status Colors

• 🟢 GREEN - Waiting for players
• 🟡 YELLOW - Starting (30 second countdown)
• 🔴 RED - Game in progress
• ⚫ BLACK - Game ended/Maintenance

Auto-Update Frequency

• Every 1 second during game
• Shows real-time game information
• Hidden when game ends

---

GUI System (New in v1.0.1)

Lobby Selection GUI

┌─────────────────────────────┐
│ Hi and Seek Lobbies         │
├─────────────────────────────┤
│ [arena1]  | 10/20 [ACTIVE]  │
│ [arena2]  |  3/16 [ACTIVE]  │
│ [spleef]  | 16/24 [FULL]    │
│ [training]|  2/12 [WAIT]    │
│                             │
│ Click lobby to join ✓       │
└─────────────────────────────┘

Settings GUI

┌─────────────────────────────┐
│ Settings: arena1            │
├─────────────────────────────┤
│ MaxPlayers:  [20▼]          │
│ PVP Enabled: [OFF ✓]        │
│ Difficulty:  [HARD ▼]       │
│ GameTime:    [10:00 ▼]      │
│ Spectator:   [ON ✓]         │
│                             │
│ Click to change settings    │
└─────────────────────────────┘

---

Command PopUp System (New)

Example: Lobby List with Buttons

═══════════════════════════════════════════════════════════
                    ACTIVE LOBBIES
═══════════════════════════════════════════════════════════
• arena1     [12/20] ACTIVE
  [JOIN] [INFO] [SPECTATE]

• arena2     [16/24] FULL
  [INFO] [SPECTATE] [WAITLIST]

• training   [3/12] WAITING
  [JOIN] [INFO] [SPECTATE]

═══════════════════════════════════════════════════════════

Clickable Buttons

• [JOIN] - Instantly runs /hsr join <name>
• [INFO] - Shows lobby details
• [SPECTATE] - Joins as spectator
• [SETTINGS] - Opens settings GUI
• [LEAVE] - Quick exit command
• [START] - (Admin only) Start game manually

---

Player Statistics (New)

Tracked Statistics

• Total Games Played - Number of games joined
• Games Won - Times either seeker found all or as hider survived
• Games Lost - Times seeker couldn't find all or was found
• Win Rate - Percentage calculation
• Total Time Played - Cumulative game time
• Favorite Lobby - Most played lobby
• Current Streak - Consecutive wins

View Statistics

/hsr stats                     # Your stats
/hsr stats playerName          # Another player's stats (if public)

Output:
════════════════════════════════════════
        Player Statistics: Steve
════════════════════════════════════════
Games Played: 25
Games Won: 12
Games Lost: 13
Win Rate: 48%

Total Time: 2h 45m
Favorite Lobby: arena1
Current Streak: 3 wins

════════════════════════════════════════

---

Spectator Mode (New)

How It Works

• Join an active game as spectator
• See all players and their roles
• Chat visible to spectators only
• Can't interact with game
• Can't win/lose
• Useful for watching strategy

Command

/hsr spectate <lobby_name>    # Join as spectator
/hsr leave                     # Exit spectator mode

---

Available Settings (Updated in v1.0.1)

Lobby Attributes (Enhanced)

Setting	Type	Range	Default	New in v1.0.1
world	String	Any world	current	-
minplayers	Number	1-24	2	-
maxplayers	Number	2-48	16	-
pvp	Boolean	true/false	false	-
difficulty	String	PEACEFUL-HARD	NORMAL	-
itemdrop	Boolean	true/false	true	-
gametime	Number	seconds	1200	Enhanced
respawntime	Number	seconds	5	Enhanced
spectator	Boolean	true/false	true	Enhanced
autostart	Boolean	true/false	true	✨ NEW
countdown	Number	10-120	30	✨ NEW
allowseekerpvp	Boolean	true/false	true	✨ NEW

---

Permissions (Updated v1.0.1)

hsr.use                 - Access basic commands (default: everyone)
hsr.create             - Create lobbies (default: OP)
hsr.manage             - Manage lobbies & change status (default: OP)
hsr.config             - Configure settings (default: OP)
hsr.sudo               - Execute sudo commands (default: OP)
hsr.bypass.gamestatus  - Join disabled/maintenance lobbies (default: OP)
hsr.admin              - Full access (default: OP)
hsr.gui                - Access GUI features (default: everyone)
hsr.spectate           - Can join as spectator (default: everyone)
hsr.stats              - View player statistics (default: everyone)

---

Installation (v1.0.1)

Requirements (Updated)

• Paper Server 1.21.11 or higher
• Java 21 or newer
• ~35 KB disk space for plugin JAR (increased from 20KB)

Setup Steps

Same as v1.0.0:

1. Download HideAndSeekReimagined-1.0.1.jar
2. Place JAR in plugins/ folder
3. Restart server
4. Run /hsr help to get started!

---

Example Gameplay Session (New)

Player Experience

# Launch game
Player1: /hsr gui
→ Opens lobby selection GUI
→ Clicks on "arena1"

# Game populates
Player2 joins via: /hsr join arena1
Player3 joins via: [JOIN] button

# Automatic start
[AUTO] Lobby has 3 players (min: 2)
[GAME] Starting in 30 seconds...
[BossBar] Shows yellow countdown: 30 | 20 | 10...

# Game begins
[GAME] Game started!
[GAME] Player1 is the SEEKER
[GAME] Player2 and Player3 are HIDERS
[BossBar] Red: TIME: 10:00 | SEEKERS: 1/3

# Gameplay
Player2 hides
Player3 is found in 3 minutes
[GAME] Player3 was found! Eliminating...

# Game ends
Player2 survived 10 minutes!
[GAME] Hiders win! Players survived: Player2
[STATS] Player2 wins! (14 wins total)

# Back to lobby
[LOBBY] Returning to lobby phase...
Player1: /hsr leave

---

Known Improvements Since v1.0.0

✅ Actual gameplay mechanics
✅ Beautiful BossBar display
✅ Intuitive GUI system
✅ Clickable command buttons
✅ Player statistics tracking
✅ Spectator mode
✅ Better user experience
✅ Accessibility improvements

---

Known Limitations (v1.0.1)

⚠️ Still Not Implemented

• Lobby persistence (still in-memory)
• Custom spawn locations per lobby
• Economy integration
• Advanced role mechanics (power-ups, abilities)
• Anti-cheat integration

⚠️ Features Coming in v1.2.0

• Lobby saving/loading (YAML/Database)
• Custom spawn points
• Admin panel GUI
• In-game announcements
• Sound effects

---

Known Issues (v1.0.1)

Issue	Severity	Workaround
BossBar doesn't clear on world change	Low	Minimal impact
GUI doesn't update in real-time	Low	Reopen GUI to refresh
Stats reset on restart	Medium	Persistence coming in v1.2.0
Spectators can't see name tags	Low	Can check player list

---

Roadmap

v1.0.2 (Patch - ETA: 1-2 weeks)

• Bug fixes from community feedback
• Performance optimizations
• Minor GUI improvements

v1.1.0 (Features - ETA: 2-3 weeks)

• Lobby persistence (YAML/Database)
• Advanced game modes
• Killstreak counter
• Achievement system

v1.2.0 (Major - ETA: 4-6 weeks)

• Custom spawn locations
• Admin panel GUI
• Economy integration
• Power-ups system

v2.0.0 (Future)

• Multi-server support
• Seasonal rankings
• Custom game rules editor
• Plugin API for extensions

---

Technical Details

What Changed in Code

• Added GameState enum for game phases
• Implemented GamePhase tracking system
• New BossBarManager class
• New GUIManager for inventory controls
• StatisticsManager for player tracking
• Enhanced GameLobby with game logic
• Command button system in chat utilities

Build Info

• Language: Java 21
• Build Tool: Maven 3.9.6
• API: Paper 1.21.11
• Size: ~35 KB (Shaded JAR)
• New Dependencies: None (uses Paper native)

---

Community Feedback from v1.0.0

Thank you to all testers! Your feedback shaped this release:

✅ "We want actual gameplay!" → Implemented in v1.0.1 ✅ "Commands are hard to remember" → Added GUI and buttons ✅ "Need real-time status" → Added BossBar system ✅ "Want to watch games" → Added spectator mode ✅ "Track our progress" → Added statistics

---

Support & Community

• Official Website: kvxnom.xyz
• GitHub Issues: [Link on website]
• Discord Community: [Join for updates]
• Bug Reports: [Discord or website]

---

Credits

Developed by: kvxnom.xyz
Contributors: Community testers and feedback providers
Version: 1.0.1-ALPHA
License: All rights reserved

---

Release Notes Summary

Major Highlights

🎮 Gameplay is now real! Players can actually play hide and seek
📊 Beautiful UI system with BossBar and GUIs
💬 Smart command system with clickable buttons
📈 Track your stats and watch your progress
👀 Spectator mode to watch friends play

Performance

• Optimized BossBar updates
• Efficient GUI rendering
• Minimal memory footprint
• Smooth game state transitions

Player Experience

• Much more intuitive for new players
• Reduces command learning curve
• Beautiful visual feedback
• Real-time game information

---

What's Next?

Continue playing, reporting bugs, and sharing feedback! Each comment helps us improve Hide and Seek: Reimagined.

Happy Gaming! 🎮

---

Last Updated: April 4, 2026
Previous Version: Alpha 1.0.0
Next Update: Expected within 2 weeks (v1.0.2)

Version Comparison

v1.0.0: Infrastructure foundation ✓
v1.0.1: Gameplay & UI features    ✓ YOU ARE HERE
v1.2.0: Advanced features ahead