Описание
# ⚔️ 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 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 `).
---
## 🛠️ 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 ` | `(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)