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	❌

---