SimpleCombatLog
Lightweight, feature-rich combat logging for PvP servers
Lightweight, feature-rich combat logging for PvP servers
Supports Paper • Spigot • Folia | Minecraft 1.13 - 1.21+ | WorldGuard optional
Overview
SimpleCombatLog tags players when they enter PvP combat and punishes those who try to disconnect to escape a fight. It's lightweight, highly configurable, and built to work on everything from small survival servers to large Folia-powered networks.
Features
⚔ Combat System
- Tags attacker and victim on PvP damage (including projectiles)
- Configurable combat timer (cooldown-seconds)
- Kills tagged players who disconnect (kill-on-quit)
- Attacker is credited with the kill on combat log
- Broadcast message on combat log
🖥 Display
- Action bar countdown while in combat
- BossBar countdown with configurable color, style, and title
🛡 Safezone Protection
- Blocks tagged players from entering WorldGuard regions (via denied-regions list or the custom combat-entry flag)
- Spawn protection radius prevents tagged players from entering spawn
- Ender pearl teleports into safe zones are cancelled and the pearl is returned
- Ender pearl range limit during combat (max-pearl-range)
- Safezone wall - shows a client-side barrier of configurable blocks at region boundaries while in combat
- Blocked commands list - prevent players from running commands while tagged
- Blocked items list - prevent players from using specific items while in combat
- Per-item combat cooldowns - apply item cooldowns automatically when tagged
- Elytra activation blocked during combat
- Tracks combat log count per player in stats.yml
- /scl stats <player> - check any player's log count
- Hologram leaderboard via TextDisplay entities (requires 1.20+)
- Place with /scl setleaderboard - updates automatically
⚙ Admin & Developer
- Full tab completion on all /scl subcommands
- Native Folia support - region-aware scheduling throughout
- WorldGuard is fully optional - plugin loads and runs without it
- Modrinth update checker - notifies ops on join
- bStats metrics (ID 29195)
Commands
- /scl - Show plugin info & help
- /scl reload - Reload config and stats
- /scl stats <player> - View a player's combat log count
- /scl setleaderboard - Place the hologram leaderboard at your location
Permissions
- simplecombatlog.admin - Access to reload and setleaderboard (default: op)
Configuration Highlights
cooldown-seconds: 15
kill-on-quit: true
blocked-commands:
- /home
- /tp
blocked-items:
- ENDER_PEARL
item-combat-cooldowns:
- GOLDEN_APPLE:30
max-pearl-range: 64
block-elytra-activation: true
spawn-protection:
enabled: true
radius: 16
denied-regions:
- spawn
- safezone
display.action-bar: true
display.boss-bar.enabled: false
display.boss-bar.color: RED
safezone-wall.enabled: false
safezone-wall.material: RED_STAINED_GLASS
Compatibility
- Platforms: Paper, Spigot, Folia
- Versions: 1.13 - 1.21+ (hologram leaderboard requires 1.20+)
- Soft dependencies: WorldGuard (optional)
Found a bug or have a suggestion? Open an issue on the project page.
