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 - **Block Disguise System**: Hiders blend into the environment by becoming blocks - **Smart Role Assignment**: Automatic Seeker/Hider distribution (customizable 23/77 ratio) - **Capture Mechanics**: Seekers find and attack disguised blocks to capture Hiders - **Time-Based Rounds**: Thrilling 10-minute games with 30-second preparation phase ### Economy Integration - **Full Vault Support**: Integrate with any economy plugin - **Strategic Shopping**: Purchase game-changing items during matches - **Balanced Pricing**: Fair costs with purchase limits and cooldowns - **Reward System**: Earn coins for wins, captures, and participation ### Shop Items **Hider Arsenal:** - **Escape Pass** - Avoid capture with invincibility - **Decoy Block** - Place fake disguises to confuse Seekers - **Shadow Sprint** - Speed boost for quick repositioning **Seeker Tools:** - **Tracking Compass** - Locate the nearest Hider - **Speed Boost** - Chase down fleeing Hiders - **Area Scan** - Detect nearby Hiders - **Eagle Eye** - Make Hiders glow through walls ### Multilingual Support - 🇯🇵 **Japanese (日本語)** 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 - **Live Scoreboard**: Real-time stats and game information - **Statistics System**: Track wins, captures, and performance - **Spectator Mode**: Watch games after being captured - **Auto-Balancing**: Seeker strength system for fair gameplay - **Block Restoration**: Automatically repairs arena after games - **Particle & Sound Effects**: Immersive audio-visual feedback --- ## Quick Start 1. **Install** the plugin and Vault (optional but recommended) 2. **Restart** your server 3. **Join** 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 - 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 - **Minecraft**: 1.21.x - **Server**: Paper 1.21.x or compatible - **Java**: 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 **Built with Modern Technology:** - Written in **Kotlin** for performance and safety - Uses **Adventure Components** for rich text formatting - Implements **2-layer caching** for <1ms message lookups - **UTF-8 native** 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 - **Minigame Servers**: Add a popular classic game - **Community Events**: Fun party game for your players - **Hub Attractions**: Keep players engaged while waiting - **Server Networks**: 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. **True Disguise System**: Players actually become blocks, not just invisible 2. **Strategic Depth**: Shop items create dyn