# ⚔️ UHC Plugin - Complete Ultra Hard Core Solution Welcome to the ultimate **UHC Plugin** for Minecraft! Whether you're a streamer looking to engage your audience or a server owner wanting to host epic events, this plugin has everything you need. --- ## ✨ Features ### 🎮 **Core Game Mechanics** - **⏱️ PvP Timer** - 25 minutes of preparation, then PvP enables automatically - **🌍 Border Control** - World border shrinks from 10,000 to 20 blocks over 40 minutes - **❤️ Regeneration System** - Natural regen disables after 25 minutes (only golden apples & potions) - **👁️ Final Glow Effect** - All players glow 8 minutes after border reaches minimum ### 🍎 **Player Heads System** - Heads drop ONLY when a player is killed by another player - Right-click a head to restore **+10 HP** - Cannot be used at full health (configurable) - Customizable head name and lore in config ### 🗳️ **Voting System** - Interactive GUI with player heads - Vote for who you think will win - Real-time vote counting - Top 3 announced at game start - Perfect for streamer engagement! ### 💫 **Donation Revive** - Revive dead players with `/revive <player>` - Spectacular lightning effect on revive - Full health and food restoration - Configurable messages ### 💬 **Chat Management** - Custom chat format: `• Steve: message` - Mute system with temporary and permanent mutes - Commands: `/mute <player> <time> [reason]` and `/unmute <player>` - Time formats: 10s, 5m, 2h, 1d, 0 (permanent) ### 🔧 **Admin Tools** - `/inv <player>` - View any player's inventory - Full game control: `/uhc start`, `/uhc stop`, `/uhc status` - Border info: `/uhc borderinfo` - Reload config: `/uhc reload` --- ## 🌐 **Multi-Language Support** The plugin comes with **English** and **Russian** language files out of the box. You can easily switch between them in `config.yml`: ```yaml language: "en" # or "ru" ``` All messages, placeholders, and GUI texts are fully translatable! --- ## ⚙️ **Full Configuration** Every aspect of the plugin is customizable through `config.yml`: ```yaml # Example: Change PvP time to 30 minutes game: pvp-time: 1800 # 30 minutes in seconds # Example: Heads heal 15 HP instead of 10 heads: heal-amount: 15.0 ``` **What you can configure:** - ⏱️ All timers (PvP, border, regen, glow) - 🌍 Border size and damage - 🍎 Head mechanics - 💬 Chat format and mute messages - 🗳️ Voting GUI texts - 💫 Revive messages - 👁️ Glow effect - 📢 All chat messages --- ## 📋 **Commands Overview** | Command | Description | Permission | |---------|-------------|------------| | `/uhc start` | Start the UHC game | `uhc.admin` | | `/uhc stop` | Stop the current game | `uhc.admin` | | `/uhc status` | Show game status | `uhc.admin` | | `/uhc borderinfo` | Show border information | `uhc.admin` | | `/uhc voteopen` | Open voting manually | `uhc.admin` | | `/uhc voteclose` | Close voting | `uhc.admin` | | `/uhc reload` | Reload config and languages | `uhc.admin` | | `/revive <player>` | Revive a player | `uhc.revive` | | `/vote` | Open voting GUI | `uhc.vote` | | `/mute <player> <time> [reason]` | Mute a player | `uhc.admin` | | `/unmute <player>` | Unmute a player | `uhc.admin` | | `/inv <player>` | View player inventory | `uhc.admin` | --- ## 🔐 **Permissions** | Permission | Description | Default | |------------|-------------|---------| | `uhc.admin` | Full admin access | `op` | | `uhc.revive` | Can revive players | `op` | | `uhc.vote` | Can vote in GUI | `true` | | `uhc.mute` | Can mute/unmute | `op` | --- ## 📦 **Installation** 1. Download the latest `UHCPlugin.jar` 2. Place it in your server's `plugins/` folder 3. Restart the server 4. Configure `plugins/UHCPlugin/config.yml` to your liking 5. Start your first UHC with `/uhc start` **Requirements:** - ✅ Paper 1.21+ (recommended) - ✅ PlaceholderAPI (optional, for placeholders) --- ## 🎯 **Placeholders (with PlaceholderAPI)** | Placeholder | Description | |-------------|-------------| | `%uhc_players_left%` | Number of alive players | | `%uhc_spectators%` | Number of spectators | | `%uhc_border_size%` | Current border size | | `%uhc_border_x%` | Border X coordinates (min/max) | | `%uhc_border_z%` | Border Z coordinates (min/max) | | `%uhc_status%` | Game status (Waiting/Preparation/Battle) | | `%uhc_pvp%` | PvP status | | `%uhc_regen%` | Regen type (Normal/Food/Golden) | | `%uhc_timer%` | Game timer (mm:ss) | | `%uhc_player_kills%` | Player kills | --- ## 🐛 **Support & Feedback** Found a bug? Have a suggestion? Feel free to: - Contact me on Discord: igromania_ --- **Happy UHC gaming!** ⚔️