The Simple Combat Log

# ⚔️ 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. <details> <summary>Click to view Default Configuration</summary> ```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!" ´´´</details> --- ## 📜 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)