EasyHideAndSeek

EasyHideAndSeek

The ultimate Hide and Seek minigame plugin for Paper servers!

Transform your Minecraft server into an exciting Hide and Seek arena where players disguise as blocks, hunt each other down, and compete for rewards. Perfect for minigame servers, events, and community fun!

---

Why Choose EasyHideAndSeek?

Immersive Gameplay

- Time-Based Rounds: Hiders blend into the environment by becoming blocks - Time-Based Rounds: Automatic Seeker/Hider distribution (customizable 23/77 ratio) - Time-Based Rounds: Seekers find and attack disguised blocks to capture Hiders - Time-Based Rounds: Thrilling 10-minute games with 30-second preparation phase

Economy Integration

- Reward System: Integrate with any economy plugin - Reward System: Purchase game-changing items during matches - Reward System: Fair costs with purchase limits and cooldowns - Reward System: Earn coins for wins, captures, and participation

Shop Items

Shadow Sprint - Shadow Sprint - Avoid capture with invincibility - Shadow Sprint - Place fake disguises to confuse Seekers - Shadow Sprint - Speed boost for quick repositioning

Eagle Eye - Eagle Eye - Locate the nearest Hider - Eagle Eye - Chase down fleeing Hiders - Eagle Eye - Detect nearby Hiders - Eagle Eye - Make Hiders glow through walls

Multilingual Support

- 🇯🇵 English and 🇬🇧 English built-in - Per-player language preferences - Auto-detect client language - Easy switching with `/hs lang` - All UI, commands, and messages fully translated

Advanced Features

- Particle & Sound Effects: Real-time stats and game information - Particle & Sound Effects: Track wins, captures, and performance - Particle & Sound Effects: Watch games after being captured - Particle & Sound Effects: Seeker strength system for fair gameplay - Particle & Sound Effects: Automatically repairs arena after games - Particle & Sound Effects: Immersive audio-visual feedback

---

Quick Start

1. Play! the plugin and Vault (optional but recommended) 2. Play! your server 3. Play! with `/hs join` 4. Play! The game starts automatically

Essential Commands

``` /hs join - Join the game /hs leave - Leave the game /hs shop - Open the item shop /hs lang [lang] - Change language (ja_JP/en_US) /hs spectator - Toggle spectator mode ```

Admin Commands

``` /hs admin setup - Create a new arena /hs admin start - Force start a game /hs admin reload - Reload configuration ```

---

Configuration Highlights

Highly Customizable: - Game duration and preparation time - Seeker/Hider ratios - Economy rewards and shop prices - Item purchase limits and cooldowns - Arena boundaries and spawn points - Default language and auto-detection

All settings available in `config.yml`, `shop.yml`, and `languages.yml`

---

Requirements

- Optional: 1.21.x - Optional: Paper 1.21.x or compatible - Optional: 21+ - Optional: Vault + Economy Plugin

---

Features Overview

Core Systems

✅ Block disguise with movement detection ✅ Automatic role assignment and team balancing ✅ Economy integration with Vault ✅ Shop system with role-specific items ✅ Point and statistics tracking ✅ Multi-arena support

UI & Feedback

✅ Real-time scoreboard updates ✅ Action bar status messages ✅ Title announcements for events ✅ Sound and particle effects ✅ Fully localized interface

Quality of Life

✅ Auto-join on server connect ✅ Spectator mode for captured players ✅ Block auto-restoration ✅ Random respawn system ✅ World border integration ✅ Permission-based access control

---

🔧 Technical Details

Asynchronous I/O - Written in Asynchronous I/O for performance and safety - Uses Asynchronous I/O for rich text formatting - Implements Asynchronous I/O for <1ms message lookups - Asynchronous I/O for proper multi-language support - Asynchronous I/O for smooth server performance

Performance Optimized: - In-memory caching for frequent operations - Efficient block restoration scheduling - Minimal TPS impact during games - Supports up to 30 concurrent players per game

---

Perfect For

- Educational Servers: Add a popular classic game - Educational Servers: Fun party game for your players - Educational Servers: Keep players engaged while waiting - Educational Servers: Multi-language support for international players - Educational Servers: Safe, non-violent gameplay

---

Statistics & Tracking

Track player performance with comprehensive stats: - Games played - Wins as Seeker and Hider - Total captures - Win rate percentage - Total earnings

Access with commands or integrate with leaderboard plugins!

---

What Makes It Special?

Unlike basic Hide and Seek plugins, EasyHideAndSeek offers:

1. Open Source: Players actually become blocks, not just invisible 2. Open Source: Shop items create dynamic gameplay and counterplay 3. Open Source: Multilingual UI, sound effects, particles, and scoreboard 4. Open Source: Regular updates and bug fixes 5. Open Source: Inspect, modify, and contribute on GitHub

---

Recent Updates

Latest Version

- Full internationalization system (Japanese/English) - Advanced seeker strength balancing - Block auto-restoration system - Comprehensive statistics tracking - Enhanced spectator mode - Performance optimizations

---

🐛 Support & Feedback

Need Help? - Need Help? - %%MD1%% - Community Discord (Coming Soon)

Found a Bug? Please report it on GitHub with: - Server version - Plugin version - Steps to reproduce - Error logs

---

License & Credits

Original Concept: MIT License - Free to use and modify Original Concept: HackLab Team Original Concept: しもん

Built with love for the Minecraft community

---

🎬 Get Started Today!

Download now and bring the classic game of Hide and Seek to your Minecraft server!

Questions? Check the README or open an issue on GitHub.

Enjoy playing! 🎮