UltCombat
Premium combat management for modern Minecraft servers. Everything is toggleable. Everything is configurable. Nothing is hardcoded.
Features
⚔️ Combat Tag
- 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
🛡️ Spawn Kill Prevention
- 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
💫 Respawn Protection
- Temporary protection after every respawn
- Boss bar and action bar countdown
- Removed if player attacks or moves (configurable)
🌱 Newbie Protection
- Protect new players based on playtime, deaths, or first join
- Boss bar countdown
- Admin commands to manually add or remove protection
🩸 Blood Effects
- Cosmetic only — no mods required
- Configurable colour, count, size, offset, speed
- Critical hit multiplier
- Chance system
- Optional sound
🖥️ In-Game Admin GUI
- 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
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> [r] |
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 |
Debug info | OP |
ultcombat.notify |
Update alerts | OP |
ultcombat.bypass.combat |
Skip combat restrictions | false |
ultcombat.bypass.newbie |
Bypass newbie protection | OP |
ultcombat.bypass.respawn |
Bypass respawn protection | false |
ultcombat.bypass.spawn |
Bypass safe zones | OP |
ultcombat.bypass.blood |
No blood shown on player | false |
PlaceholderAPI
| Placeholder | Returns |
|---|---|
%ultcombat_in_combat% |
Yes / No |
%ultcombat_combat_time% |
Seconds left |
%ultcombat_combat_opponent% |
Opponent name |
%ultcombat_has_respawn_protection% |
Yes / No |
%ultcombat_respawn_time% |
Seconds left |
%ultcombat_has_newbie_protection% |
Yes / No |
%ultcombat_newbie_time% |
Seconds left |
%ultcombat_in_safe_zone% |
Yes / No |
%ultcombat_spawn_radius% |
Default radius |
Storage
| Type | Best for |
|---|---|
yaml |
Small servers — no setup |
sqlite |
Medium servers |
mysql |
Large servers / proxy networks |
mariadb |
Large servers / MariaDB |
Set in config.yml → database.type
Proxy Support
Disabled by default. Enable only if behind a proxy.
config.yml
proxy:
enabled: true
type: "velocity"
sync-combat: true
Full server restart required after enabling.
Supported: Velocity · BungeeCord · Waterfall
Soft Dependencies
All optional. Plugin works without any.
| Plugin | Adds |
|---|---|
| PlaceholderAPI | %ultcombat_*% placeholders |
| Vault | Economy punishment on combat log |
| Essentials | Command blocking compatibility |
| WorldGuard | Region flag respect |
| LuckPerms | Advanced permission handling |
Compatibility
| Platform | Status |
|---|---|
| Paper 1.21.x | ✅ |
| Purpur | ✅ |
| Pufferfish | ✅ |
| Leaf | ✅ |
| Folia | ✅ |
| Velocity | ✅ |
| BungeeCord / Waterfall | ✅ |
| Spigot | ❌ |
Made for the Minecraft community
