⚔️ 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"
"safezone"

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:

"/spawn"
"/tpa"
"/home"

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)

The Simple Combat Log