UltCombat

<div align="center"> (https://img.shields.io/badge/Paper-1.21.x-F96854?style=for-the-badge)](https://papermc.io) (https://img.shields.io/badge/Java-21-blue?style=for-the-badge&logo=openjdk)](https://adoptium.net) (https://img.shields.io/badge/Folia-Compatible-8A2BE2?style=for-the-badge)](https://github.com/PaperMC/Folia) (https://img.shields.io/badge/License-ARR-red?style=for-the-badge)](LICENSE) # UltCombat **Premium combat management for modern Minecraft servers.** Everything is toggleable. Everything is configurable. Nothing is hardcoded. --- </div> Features <details> <summary><b>⚔️ Combat Tag</b></summary> - Configurable tag duration with reset on hit - Boss bar, action bar, title, chat message display - Blocks commands while tagged — full configurable list - Tags on melee, arrows, trident, projectiles, potions, explosions, pets - Combat log punishments — kill, inventory drop, lightning, broadcast, economy fine, console commands - Restrictions — Ender Pearl, Elytra, Chorus Fruit, teleport </details> <details> <summary><b>🛡️ Spawn Kill Prevention</b></summary> - Named zones — supports unlimited zones per server - Two zone types — **radius** (circle) and **cuboid** (two corners) - Block PvP, damage, projectiles, TNT, End Crystals inside zones - Set zones via commands — no config editing needed - Multiple worlds supported </details> <details> <summary><b>💫 Respawn Protection</b></summary> - Temporary protection after every respawn - Boss bar and action bar countdown - Removed if player attacks or moves (configurable) </details> <details> <summary><b>🌱 Newbie Protection</b></summary> - Protect new players based on playtime, deaths, or first join - Boss bar countdown - Admin commands to manually add or remove protection </details> <details> <summary><b>🩸 Blood Effects</b></summary> - Cosmetic only — no mods required - Configurable colour, count, size, offset, speed - Critical hit multiplier - Chance system - Optional sound </details> <details> <summary><b>🖥️ In-Game Admin GUI</b></summary> - Full GUI — zero config editing required - Every option togglable with a click - Adjust values with left/right/shift click - Live updates — saves instantly to config - All slots, titles, lore configurable in gui.yml </details> --- Installation ``` 1. Download UltCombat.jar 2. Drop into /plugins/ 3. Start or restart server 4. Edit /plugins/UltCombat/config.yml 5. Use /uc gui for full in-game management ``` **Requirements:** Paper 1.21.x · Java 21+ --- Configuration Files | File | Purpose | |------|---------| | `config.yml` | Everything — combat, blood, spawn, respawn, newbie, worlds, proxy, database | | `messages.yml` | Every message the plugin sends | | `gui.yml` | GUI titles, button items, lore, slot positions | --- Commands | Command | Description | Permission | |---------|-------------|------------| | `/uc` | Help menu | `ultcombat.use` | | `/uc reload` | Reload configs | `ultcombat.reload` | | `/uc gui` | Open admin GUI | `ultcombat.gui` | | `/uc debug` | Debug info | `ultcombat.debug` | | `/uc version` | Version info | `ultcombat.use` | | `/uc combat tag <player>` | Tag a player | `ultcombat.admin` | | `/uc combat remove <player>` | Remove combat tag | `ultcombat.admin` | | `/uc combat check <player>` | Check combat status | `ultcombat.admin` | | `/uc newbie status` | Own newbie status | `ultcombat.use` | | `/uc newbie add <player>` | Add newbie protection | `ultcombat.admin` | | `/uc newbie remove <player>` | Remove newbie protection | `ultcombat.admin` | | `/uc respawn grant <player>` | Grant respawn protection | `ultcombat.admin` | | `/uc respawn remove <player>` | Remove respawn protection | `ultcombat.admin` | | `/uc spawn corner1 <name>` | Set first corner of zone | `ultcombat.admin` | | `/uc spawn corner2 <name>` | Set second corner, create zone | `ultcombat.admin` | | `/uc spawn setzone <name> ` | Create radius zone at position | `ultcombat.admin` | | `/uc spawn deletezone <name>` | Delete a zone | `ultcombat.admin` | | `/uc spawn listzones` | List all zones | `ultcombat.admin` | | `/uc spawn check` | Check if in safe zone | `ultcombat.use` | | `/uc blood` | Blood status | `ultcombat.admin` | | `/uc proxy` | Proxy status | `ultcombat.admin` | **Alias:** `/uc` = `/ultcombat` --- Spawn Zone Setup **Cuboid zone (two corners):** ``` Stand at first corner → /uc spawn corner1 myzone Stand at second corner → /uc spawn corner2 myzone ``` **Radius zone:** ``` Stand at center → /uc spawn setzone myzone 50 ``` **Multiple zones:** ``` /uc spawn setzone spawn 100 /uc spawn corner1 pvp-arena /uc spawn corner2 pvp-arena /uc spawn listzones ``` --- Permissions | Permission | Description | Default | |------------|-------------|---------| | `ultcombat.use` | Basic commands | Everyone | | `ultcombat.admin` | All admin commands | OP | | `ultcombat.reload` | Reload configs | OP | | `ultcombat.gui` | Admin GUI | OP | | `ultcombat.debug` |