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:

Download HideAndSeekReimagined-1.0.1.jar
Place JAR in plugins/ folder
Restart server
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

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

Hide and Seek: Reimagined

Tags

Creators

Details

1.0.1

Compatibility

Changes

Hide and Seek: Reimagined - Alpha 1.0.1

Welcome to Alpha 1.0.1!

What's New in Alpha 1.0.1

🎮 Actual Gameplay Implementation ✨ NEW

📊 BossBar Interaction ✨ NEW

🖱️ GUI Controls ✨ NEW

💬 Command Popups & Auto-Say ✨ NEW

📈 Additional Improvements

What Has Changed Since Alpha 1.0.0

New Features (v1.0.0 → v1.0.1)

New Commands (v1.0.1)

Gameplay Commands

GUI Commands ✨ NEW

Previous Commands (Still Available)

Game Flow (New in v1.0.1)

Complete Gameplay Loop

BossBar System (New)

Display Format

Status Colors

Auto-Update Frequency

GUI System (New in v1.0.1)

Lobby Selection GUI

Settings GUI

Command PopUp System (New)

Example: Lobby List with Buttons

Clickable Buttons

Player Statistics (New)

Tracked Statistics

View Statistics

Spectator Mode (New)

How It Works

Command

Available Settings (Updated in v1.0.1)

Lobby Attributes (Enhanced)

Permissions (Updated v1.0.1)

Installation (v1.0.1)

Requirements (Updated)

Setup Steps

Example Gameplay Session (New)

Player Experience

Known Improvements Since v1.0.0

Known Limitations (v1.0.1)

Known Issues (v1.0.1)

Roadmap

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

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

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

v2.0.0 (Future)

Technical Details

What Changed in Code

Build Info

Community Feedback from v1.0.0

Support & Community

Credits

Release Notes Summary

Major Highlights

Performance

Player Experience

What's Next?

Version Comparison

Developer information

Maven coordinates:

Version ID:

build.gradle: