⚔️ 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)

1. Native Radius: Configurable protection radius around the World Spawn (No dependencies required!).
2. Region List: Block specific WorldGuard regions via config.yml.
3. 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

1. Download the .jar file.
2. Drop it into your server's plugins folder.
3. (Optional) Install WorldGuard for advanced region management.
4. Restart your server.

Requirements:

• Java 21
• Minecraft 1.21+ (For older versions, use v1.4)