⚔️ SimpleCombatLog
The modern, high-performance solution to stop combat loggers.
SimpleCombatLog is a robust Paper/Spigot plugin designed to ensure fair PvP on modern servers. It utilizes the latest Minecraft 1.21 features (Text Displays, Boss Bars) to provide a premium experience without lag.
⚠️ Compatibility Note:
- Minecraft 1.21+: Use the latest version (v2.0+).
- Minecraft 1.12 - 1.20: Please download Version 1.4 from the "Versions" tab.
✨ Key Features
💀 Punishment & Kill Attribution
- Instant Kill: Combat loggers die immediately and drop their loot.
- True Kill Credit: The plugin ensures the attacker gets credit for the kill.
- Compatible with: Ranked SMP, AuraSkills, Stats plugins, and Economy kill rewards.
📊 Visual Timers (New!)
- Action Bar: A clean countdown above the hotbar.
- Boss Bar: A highly visible progress bar at the top of the screen.
- Customizable: Configure colors, styles, and text. Use one or both!
🏰 Safezone Protection (3 Methods)
- Native Radius: Configurable protection radius around the World Spawn (No dependencies required!).
- Region List: Block specific WorldGuard regions via
config.yml.
- Custom Flag: Use
/rg flag <region> combat-entry deny to easily mark any region as a safezone.
- Effect: Players are physically pushed back if they try to enter these areas while tagged.
🛑 Movement & Item Control
- Elytra Anti-Takeoff: Tagged players cannot jump-start their Elytra. (Players already flying can land safely).
- Pearl Limiter: Restrict how far players can teleport with Ender Pearls (default 32 blocks).
- Smart Cooldowns: Apply visual cooldowns to items on combat start (does not reset on every hit).
- Hard Block: Totally ban specific items (e.g., Rockets) during combat.
🏆 Holographic Leaderboards
- Public Shaming: Display a floating "Top 10 Combat Loggers" leaderboard in your lobby.
- Modern Tech: Uses Text Displays (1.20+) for crisp text and zero entity lag.
- Stats Tracking: Keep a permanent record of how many times a player has combat logged (
/scl stats <player>).
🛠️ Configuration
The config.yml is fully commented and easy to edit.
Click to view Default Configuration
```yaml
# ==========================================
# SimpleCombatLog Configuration
# ==========================================
--- General Settings ---
cooldown-seconds: 15
kill-on-quit: true
--- Display Settings ---
display:
Show the timer above the hotbar
action-bar: true
Show a Boss Bar at the top of the screen
boss-bar:
enabled: true
title: "&cCombat Mode: &e%time%s"
color: RED
style: SOLID
--- Safezone Protection ---
denied-regions:
spawn-protection:
enabled: true
radius: 16
--- Combat Restrictions ---
1. Pearl Range Limit
max-pearl-range: 32
2. Elytra Control (Block takeoff)
block-elytra-activation: true
3. Command Blocking
blocked-commands:
4. Item Blocking (Total Prevention)
blocked-items:
- "ELYTRA"
- "FIREWORK_ROCKET"
5. Item Cooldowns (Visual Timer)
Applies a cooldown when combat starts.
item-combat-cooldowns:
- "ENDER_PEARL:15"
- "CHORUS_FRUIT:10"
- "GOLDEN_APPLE:5"
--- Leaderboard & Stats ---
leaderboard-loc: null
leaderboard-uuid: null
--- Sounds ---
sounds:
tagged: "ENTITY_EXPERIENCE_ORB_PICKUP"
untagged: "ENTITY_EXPERIENCE_ORB_PICKUP"
--- Messages ---
messages:
tagged: "&c&lCOMBAT! &7You are now in combat! Do not log out!"
untagged: "&a&lSAFE! &7You are no longer in combat."
broadcast-log: "&c%player% combat logged and was killed!"
actionbar: "&cCombat: &e%time%s"
region-denied: "&c&lSTOP! &7You cannot enter this region during combat!"
´´´
📜 Commands & Permissions
| Command |
Permission |
Description |
/scl reload |
simplecombatlog.admin |
Reloads config and stats. |
/scl setleaderboard |
simplecombatlog.admin |
Spawns the "Top Loggers" hologram at your location. |
/scl stats <player> |
(none) |
Check how many times a player has combat logged. |
🚀 Installation
- Download the
.jar file.
- Drop it into your server's
plugins folder.
- (Optional) Install WorldGuard for advanced region management.
- Restart your server.
Requirements:
- Java 21
- Minecraft 1.21+ (For older versions, use v1.4)
