UltCombat

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

1. Download UltCombat.jar
2. Place it inside:

/plugins/

1. Start or restart your server.
2. Configure the plugin.
3. 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:

✅ Compatibility

⭐ 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