HolyCombat
The Ultimate Combat Tag Plugin for Minecraft 1.20 - 1.21.8
✨ FEATURES ✨
✅ Action Bar Progress Bar – █░░ orange/gold countdown timer while in combat. Shows remaining seconds visually.
✅ Flame Particles – FLAME particles appear around tagged players every 2 seconds. Highly customizable.
✅ Combat Sounds – Custom sounds when tagged, untagged, and when commands are blocked. Supports all Minecraft sounds.
✅ Punish on Quit – If a player disconnects during combat, they die automatically. Prevents combat logging completely.
✅ Punish on Teleport – Cancel any teleport (plugin-triggered or command) during combat.
✅ Blocked Commands – Fully configurable list of blocked commands during combat (config.yml). Block /spawn, /home, /tpa, etc.
✅ Projectile Support – Arrows, snowballs, eggs, ender pearls, and any projectile trigger combat tag. Full ranged combat support.
✅ Elytra & Flight Disabler – Automatically closes Elytra and disables flight on tag. No more flying away from fights.
✅ Ender Pearl Cooldown/Block – Set a separate cooldown for ender pearls during combat, or block them entirely.
✅ Combat-Log Loot Rewards – Forward dropped inventory or economy bounty to the attacker who caused the tag.
✅ Broadcast on Combat-Log – Warn the entire server when someone tries to escape.
✅ Anti-Cheat Compatible – Works perfectly with HolyAnticheat, AAC, Matrix, Spartan, and any other anti-cheat.
✅ Lightweight & Fast – No lag, even on 500+ player servers. Zero performance impact.
✅ Customizable Tag Duration – Set how many seconds combat tag lasts in config.yml.
✅ World Whitelist/Blacklist – Enable combat tag only in specific worlds (e.g., PvP arenas).
✅ Action Bar & Chat Alerts – Choose between action bar, chat messages, or both for combat notifications.
✅ PlaceholderAPI Support – Use %holycombat_tagged% and %holycombat_timeleft% in any plugin.
✅ Metrics & Updates – bStats for analytics, automatic update checker (can be disabled).
COMMANDS & PERMISSIONS
/combat or /holycombat – Show help menu (holycombat.use)
/combatcheck [player] – Check combat status of yourself or another player (holycombat.use)
/combatlist – List all currently tagged players (holycombat.admin)
/ctag <player> – Manually tag a player (holycombat.admin)
/cuntag <player> – Manually untag a player (holycombat.admin)
/hcreload – Reload config.yml and messages.yml without restarting server (holycombat.admin)
⚙️ CONFIGURATION FILES ⚙️
All settings are fully customizable. Below are the default contents of config.yml and messages.yml:
config.yml
Code (YAML):
# ╔══════════════════════════════════════════════════════════╗
# ║ HolyCombat — config.yml ║
# ║ Plugin by BoyHoly | holyland.top/holycombab ║
# ╚══════════════════════════════════════════════════════════╝
# ─────────────────────────────────────────────────────────────
# GENERAL
# ─────────────────────────────────────────────────────────────
# Prefix for all chat messages (&-colour codes supported)
prefix
:
"&6[&fHoly&6Combat&f]&r "
# Seconds a player stays in combat after the last hit received
combat-duration
: 20
# ─────────────────────────────────────────────────────────────
# TELEPORT PROTECTION
# ─────────────────────────────────────────────────────────────
# Cancel any teleport (plugin-triggered or command) during combat
punish-on-teleport
: true
# ─────────────────────────────────────────────────────────────
# COMBAT-LOG (disconnect while tagged)
# ─────────────────────────────────────────────────────────────
punish-on-quit
:
# Kill the player when they disconnect during combat
enabled
: true
# ─────────────────────────────────────────────────────────────
# COMBAT-LOG REWARDS
# Rewards the last attacker when a player logs out to escape.
# ─────────────────────────────────────────────────────────────
combat-log-reward
:
# Enable the entire reward system
enabled
: true
# Transfer the logger's full inventory directly to their last attacker
# (overflow items drop at the attacker's feet).
# If the attacker is offline, items drop at the logger's location instead.
drop-inventory-to-attacker
: true
# Broadcast a message to the whole server when someone combat-logs
broadcast
: true
# Give the attacker an economy bounty via Vault (set 0.0 to disable).
# Requires Vault + an economy plugin (e.g. EssentialsX, CMI).
economy-bounty
: 0.0
# ─────────────────────────────────────────────────────────────
# FLIGHT & ELYTRA
# ─────────────────────────────────────────────────────────────
flight
:
# Instantly cut creative/allowed-flight when a player is tagged
disable-flight-on-tag
: true
# Instantly close an active Elytra glide when a player is tagged
disable-elytra-on-tag
: true
# ─────────────────────────────────────────────────────────────
# ENDER PEARL
# ─────────────────────────────────────────────────────────────
ender-pearl
:
# Completely block Ender Pearl throws during combat
# (overrides cooldown-seconds if true)
block
: false
# Enforce a cooldown (seconds) between Ender Pearl throws during combat.
# Set to 0 to disable the cooldown (use 'block: true' for a hard ban).
cooldown-seconds
: 5
# ─────────────────────────────────────────────────────────────
# ACTION BAR
# ─────────────────────────────────────────────────────────────
action-bar
:
# Display the countdown progress bar above the hotbar
enabled
: true
# ─────────────────────────────────────────────────────────────
# SOUNDS
# ─────────────────────────────────────────────────────────────
sounds
:
# Play sounds on tag-start, tag-end, and blocked actions
enabled
: true
# ─────────────────────────────────────────────────────────────
# PARTICLES
# ─────────────────────────────────────────────────────────────
particles
:
# Spawn flame particles around tagged players every 2 seconds
enabled
: true
# ─────────────────────────────────────────────────────────────
# BLOCKED COMMANDS
# Commands listed here cannot be used while in combat.
# Write only the base command (no slash, no arguments).
# ─────────────────────────────────────────────────────────────
blocked-commands
:
- tp
- teleport
- spawn
- home
- sethome
- warp
- tpa
- tpaccept
- tpdeny
- wild
- rtp
- back
- lobby
- hub
- server
- leave
- quit
- disconnect
- pay
- baltop
messages.yml
Code (YAML):
# ╔══════════════════════════════════════════════════════════╗
# ║ HolyCombat — messages.yml ║
# ║ Plugin by BoyHoly | holyland.top/holycombab ║
# ╚══════════════════════════════════════════════════════════╝
#
# Colour codes: use & followed by a code (0-9, a-f, k-o, r)
# Hex colours: &#RRGGBB (1.16+ clients only)
#
# Placeholders (where shown):
# {player} — name of the relevant player
# {attacker} — name of the attacker
# {cmd} — the command that was blocked
# {secs} — seconds remaining in combat / on cooldown
# ─────────────────────────────────────────────────────────────
# Sent to a player when they first enter combat
tagged
:
"&6⚔ You have entered &fCOMBAT&6!"
# Sent when combat timer expires naturally
untagged
:
"&6✔ You are no longer in combat."
# Sent when a command is blocked during combat
blocked-command
:
"&fYou cannot use &6/{cmd}&f while in combat! &7(&6{secs}s &7remaining)"
# Sent when a teleport is cancelled during combat
no-teleport
:
"&fYou cannot teleport while in combat!"
# Sent when an Ender Pearl throw is fully blocked
no-enderpearl
:
"&fYou cannot throw Ender Pearls during combat!"
# Sent when an Ender Pearl is on cooldown (shows remaining seconds)
pearl-cooldown
:
"&fEnder Pearl on cooldown: &6{secs}s"
# Sent when flight is cut on tag
flight-disabled
:
"&fYour flight was disabled for entering combat."
# Sent when Elytra glide is stopped on tag
elytra-disabled
:
"&fYour Elytra was closed for entering combat."
# Broadcast to ALL players when someone combat-logs
combat-log-broadcast
:
"&f{player} &6tried to escape combat — &fpunished!"
# Sent to the attacker who receives the logger's inventory
combat-log-loot
:
"&6⚔ &fYou received &6{player}&f's inventory for combat logging."
# Generic permission-denied message
no-permission
:
"&fYou do not have permission to use this command."
# Used by /combatcheck when target is not found
player-not-found
:
"&fPlayer not found or is offline."
# Sent to admin on /hcreload
reload-success
:
"&6Config &fand &6messages.yml &freloaded successfully."
# Sent to admin after /ctag
tag-admin
:
"&6{player} &fhas been combat-tagged."
# Sent to admin after /cuntag
untag-admin
:
"&6{player}&f's combat tag has been removed."
# /combatcheck — player IS in combat
in-combat-status
:
"&f{player} &6is in combat! &f{secs}s &6remaining."
# /combatcheck — player is NOT in combat
not-in-combat-status
:
"&f{player} &6is currently NOT in combat."
# Header line for /combatlist
list-header
:
"&6═══ &fPlayers In Combat &6═══"
# Each entry row for /combatlist
list-entry
:
"&6• &f{player} &7— &6{secs}s"
# Shown when /combatlist is empty
list-empty
:
"&7No players are currently in combat."
INSTALLATION
1️⃣ Download HolyCombat.jar from the top of this page
2️⃣ Drop the file into your server's /plugins folder
3️⃣ Restart your server (do NOT use /reload, it's unsafe)
4️⃣ Edit config.yml and messages.yml to customize all settings
5️⃣ Run /hcreload after saving changes to apply instantly
⚙️ REQUIREMENTS ⚙️
• Java 17 or higher (Java 21 recommended for best performance)
• Spigot / Paper / Purpur 1.20, 1.20.6, 1.21, 1.21.8
• (Optional) PlaceholderAPI for placeholders
• (Optional) Vault for economy rewards
• (Optional) HolyAnticheat for best anti-cheat integration
❓ FAQ ❓
Q: Does the Elytra drop work with other flight plugins?
A: Yes. It disables any form of creative flight, Elytra, and even custom flight from plugins like Essentials or CMI.
Q: Can players still use ender pearls if I set cooldown?
A: Yes, but only after the cooldown ends. They cannot spam pearls to escape.
Q: How does the combat-log reward work with economy?
A: Requires Vault. The bounty amount is taken from the server's economy and given to the attacker. No money is taken from the logger.
Q: Does this work with 1.8.8 or older versions?
A: No. This version is for 1.13 and above. For older versions, contact me for a legacy build.
Q: Can I disable the action bar and keep only chat messages?
A: Yes. Set `action-bar.enabled: false` in config.yml. Chat messages are controlled separately.
SUPPORT
For help, suggestions, bug reports, or custom features, contact me directly on Spigot (PM) or join my Discord server. I usually respond within 24 hours. Premium support includes priority responses and direct Discord access.
⭐ Don't forget to leave a positive rating if you enjoy HolyCombat! ⭐
❤️ HolyCombat is actively maintained. Updates come with every new Minecraft version.