⚔️ CombatGuard

A lightweight and configurable combat tag plugin for Minecraft SMP servers. Prevent combat logging and track player stats with a clean and simple system.

---

✨ Features

⚔️ Combat Tag System

When two players fight, both are tagged for a configurable duration. A progress bar displayed on the action bar shows the remaining combat time in real time.

🚪 Combat Logout Punishment

If a tagged player disconnects, they are automatically punished. Choose between an instant kill, a temporary ban, or both — all configurable.

📊 Stats Tracking

Every kill, death and combat logout is tracked per player and saved in individual JSON files. Stats are persistent across restarts.

🗂️ Tab List Stats

Optionally display each player's kills and deaths directly in the tab list — toggleable in the config.

⚙️ Full Config Support

Customize the prefix, combat duration, punishment type, ban duration, and tab stats display. Reload without restarting with /combatguard reload.

---

📋 Commands

Command	Description
/stats <player>	Display a player's combat stats
/combatguard reload	Reload the config

---

🔐 Permissions

Permission	Description
combatguard.admin	Access to /combatguard reload

---

⚙️ Config

# Plugin prefix
prefix: "CombatGuard "

# Combat tag duration in seconds
combat-duration: 15

# Punishment on combat logout: kill | ban | both
punishment: kill

# Ban duration in seconds (only if punishment is "ban" or "both")
ban-duration: 300

# Show kills/deaths in the tab list
tab-stats: true

---

📦 Installation

Drop the .jar into your plugins/ folder and restart your server. No dependencies required.

---

🔧 Compatibility

• ✅ Spigot / Paper
• ✅ Minecraft 1.21.x

---

Made with ❤️ by Gregwll