⚔️ CombatLogPlugin

A lightweight combat logging plugin for Minecraft Paper servers that prevents players from escaping fights unfairly.

CombatLogPlugin tags players when they fight, shows an action bar countdown, and punishes players who log out while still in combat.

---

Features

• 🗡️ Combat tagging when players hit each other
• 🏹 Supports melee, bows, and tridents
• ⏳ Action bar countdown timer
• 🚫 Punishes players who log out during combat
• 💬 Clean messaging with less spam
• ☠️ Combat ends when the tagged player dies
• 🛫 Can block Elytra usage while in combat
• ⚙️ Configurable settings
• 🔄 Reload command support
• 🧩 Compatible with TogglePVPCustom combat checks
• 🧱 Current release support for Paper 26.1+

---

Version Support

The current version of CombatLogPlugin supports Paper 26.1+ and should be built or used with Java 25.

Target	Java	Status
Paper 26.1+	Java 25	Current version
Paper 1.21+ / 1.21.11	Java 21	Check release 1.2.1

For Paper 1.21+ / 1.21.11 support, download release 1.2.1 here:

https://github.com/Frwostella/CombatLogPlugin/releases/tag/1.2.1

The output should show Java version 25.

---

Installation

1. Download or build the latest .jar file.
2. Put it in your server's plugins folder.
3. Start or restart your server.
4. Configure config.yml to your liking.
5. Use /combatlog reload after editing the config.

---

Commands

Command	Description
/combatlog reload	Reloads the plugin configuration

---

Permissions

Permission	Description	Default
combatlog.reload	Allows use of the reload command	OP

---

Configuration

Example config.yml:

combat-time: 15
logout-action: "kill"
logout-command: "kill %player%"

messages:
  tagged: "&cYou are now in combat! Do not log out."
  safe: "&aYou are no longer in combat."
  actionbar: "&cCombat: &e%time%s"

Config options may vary depending on your current plugin version.

---

TogglePVPCustom Support

CombatLogPlugin can be used with Frwostella's TogglePVPCustom plugin:

https://github.com/Frwostella/TogglePVPCustom

When TogglePVPCustom's CombatLog hook is enabled, players cannot disable PvP while they are combat tagged.

---

Requirements

• Paper 26.1+
• Java 25

---