⚔️ 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:

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:

# 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! ⚔️