MintCombatLog
MintCombatLog is a simple combat logging plugin for Paper & Folia 1.21.x.
It stops players from escaping PvP by logging out or using commands while in combat, and lets admins track offenders through a command.
Support
For help, bug reports, or suggestions:
Features
- PvP combat tagging
- Configurable combat timer
- Blocks commands while in combat (with whitelist support)
- Kills players who log out during combat
- Tracks combat log history
- Admin lookup command (supports offline players)
- Action bar countdown above the hotbar
- Configurable final-seconds warning sound
- WorldGuard support (disable combat tagging per region)
- Works with Paper and Folia
- Bypass support for admins and permissions
How It Works
When a player is hit by another player:
- Both players are placed into combat
- The combat timer starts (or refreshes on each hit)
- A countdown is shown above the hotbar
- Most commands are blocked (unless whitelisted)
- They cannot safely log out
- They are instantly killed
- A broadcast message is sent
- The incident is recorded
- The combat tag is removed
- Everything returns to normal
Commands
/combatlog check <player>
View a player’s combat log history (supports offline players)
/combatlog reload
Reload all config files
Permissions
mintcombatlog.check
Allows use of /combatlog check
mintcombatlog.reload
Allows reloading the plugin
mintcombatlog.bypass
Bypasses all combat log restrictions
Config
Everything is configurable:- Combat timer (15s, 5m, 1h, etc)
- Blocked commands + whitelist
- Action bar messages
- Countdown sounds
- Bypass settings
- Plugin Messages
WorldGuard Support
If you are using WorldGuard, MintCombatLog adds a custom region flag:
Code:
mintcombatlog-combat-tagYou can disable combat tagging in specific areas like spawn, safe zones, or warps.
Example:
Code:
/rg flag <region> mintcombatlog-combat-tag denyWhen this flag is set to deny:
- players inside that region will NOT be combat tagged
- if a player enters the region while already tagged, their combat tag is cleared
- command blocking and logout punishment will not apply inside that region
This makes it easy to create safe zones where combat logging is not enforced.
