UltCombat

Premium combat management for modern Minecraft servers. Everything is toggleable. Everything is configurable. Nothing is hardcoded.

⚔ Features

⚔ Combat Tag

Configurable combat tag duration
Timer resets every time players are hit
Boss Bar, Action Bar, Title and Chat notifications
Fully configurable command blocking while in combat
Supports:
- Melee
- Arrows
- Tridents
- Projectiles
- Splash Potions
- Explosions
- Pets
Combat logging punishments:
- Kill player
- Drop inventory
- Lightning strike
- Broadcast message
- Economy fine (Vault)
- Execute console commands
Optional restrictions:
- Ender Pearls
- Elytra
- Chorus Fruit
- Teleportation

🛡 Spawn Kill Prevention

Create unlimited safe zones.

Supports:

Radius (circular) zones
Cuboid (two-corner) zones
Multiple worlds
PvP blocking
Damage prevention
Projectile blocking
TNT prevention
End Crystal prevention

Create and manage zones entirely in-game.

💫 Respawn Protection

Temporary invulnerability after respawning
Boss Bar countdown
Action Bar countdown
Optional removal when:
- Moving
- Attacking

🌱 Newbie Protection

Protect new players using configurable conditions:

First join
Playtime
Death count

Features:

Boss Bar countdown
Admin commands
Fully configurable duration

🩸 Blood Effects

Pure cosmetic effects.

No mods required
Configurable particle color
Particle amount
Particle size
Particle speed
Offsets
Critical hit multiplier
Chance system
Optional sounds

🖥 In-Game Admin GUI

Manage the plugin without editing configs.

Features:

Toggle every option
Live configuration editing
Left / Right / Shift Click controls
Instant saving
Fully customizable via gui.yml

📦 Installation

Download UltCombat.jar
Place it inside:

/plugins/

Start or restart your server.
Configure the plugin.
Open the admin GUI using:

/uc gui

Requirements

Java 21+
Paper 1.21.x

📁 Configuration Files

config.yml

Contains:

Combat
Spawn Protection
Respawn Protection
Newbie Protection
Blood Effects
Database
Proxy
World Settings

messages.yml

Every plugin message is configurable.

gui.yml

Customize:

Titles
Icons
Slots
Lore
Buttons

⌨ Commands

/uc
/uc reload
/uc gui
/uc debug
/uc version

/uc combat tag <player>
/uc combat remove <player>
/uc combat check <player>

/uc newbie status
/uc newbie add <player>
/uc newbie remove <player>

/uc respawn grant <player>
/uc respawn remove <player>

/uc spawn corner1 <name>
/uc spawn corner2 <name>
/uc spawn setzone <name> [radius]
/uc spawn deletezone <name>
/uc spawn listzones
/uc spawn check

/uc blood
/uc proxy

Alias:

/ultcombat

🛡 Spawn Zone Setup

Cuboid Zone

/uc spawn corner1 myzone
/uc spawn corner2 myzone

Radius Zone

/uc spawn setzone myzone 50

Example

/uc spawn setzone spawn 100

/uc spawn corner1 pvp-arena
/uc spawn corner2 pvp-arena

/uc spawn listzones

🔑 Permissions

ultcombat.use
ultcombat.admin
ultcombat.reload
ultcombat.gui
ultcombat.debug
ultcombat.notify

ultcombat.bypass.combat
ultcombat.bypass.newbie
ultcombat.bypass.respawn
ultcombat.bypass.spawn
ultcombat.bypass.blood

📦 PlaceholderAPI

%ultcombat_in_combat%
%ultcombat_combat_time%
%ultcombat_combat_opponent%

%ultcombat_has_respawn_protection%
%ultcombat_respawn_time%

%ultcombat_has_newbie_protection%
%ultcombat_newbie_time%

%ultcombat_in_safe_zone%
%ultcombat_spawn_radius%

💾 Storage

Supported storage methods:

YAML
SQLite
MySQL
MariaDB

Select the storage type inside:

database:
  type: sqlite

🌐 Proxy Support

Supports:

Velocity
BungeeCord
Waterfall

Example configuration:

proxy:
  enabled: true
  type: velocity
  sync-combat: true

A full server restart is required after enabling proxy support.

🔌 Soft Dependencies

UltCombat works perfectly without any dependencies.

Optional integrations:

Plugin	Adds
PlaceholderAPI	Placeholders
Vault	Economy punishments
Essentials	Command compatibility
WorldGuard	Region support
LuckPerms	Advanced permission handling

✅ Compatibility

Platform	Supported
Paper 1.21.x	✅
Purpur	✅
Pufferfish	✅
Leaf	✅
Folia	✅
Velocity	✅
BungeeCord	✅
Waterfall	✅
Spigot	❌

⭐ Why UltCombat?

Modern Paper 1.21.x support
Folia compatible
Proxy ready
Fully configurable
In-game admin GUI
Zero hardcoded values
Lightweight and optimized
Production-ready for servers of every size

❤️ Made for the Minecraft Community