CombatLOG

PvP combat-logging prevention for Paper/Purpur 1.21.x

Version 1.0.0 · Minecraft 1.21.x · Java 21 · Server-side

CombatLOG stops players from escaping PvP by disconnecting. When two players fight, both become combat tagged for a configurable time (refreshed on each hit). While tagged, players see a countdown boss bar, titles and chat messages, and cannot run configured commands (like /tpa or /home). If a tagged player disconnects, they are killed and their items drop where they logged out.

Features

• Combat tagging on melee and (optionally) projectile hits, refreshed on every hit.
• Disconnect punishment: tagged players who log out are killed via a normal vanilla death (setHealth(0)) — no manual drop/clear, so no dupe window, and totems cannot save the logout death.
• Countdown boss bar with configurable color and overlay.
• Titles and chat messages on tag start/end, plus optional periodic countdown reminders.
• Blocked commands while tagged, with namespace stripping (e.g. essentials:tpa is matched as tpa).
• combatlog.bypass permission for staff/VIP who should not be tagged.
• World and mode filters: ignore configured worlds, and optionally skip creative-mode players.
• Broadcast when a player combat logs.
• Multi-language (English, Portuguese, French) with optional per-player language via PlayerSettings.
• Developer API (CombatLogApi via the services manager) plus combat tag/end/log events.

Commands

Command	Description	Permission
/combatlog reload (aliases /clog, /cl)	Reload the configuration	combatlog.admin
/combatlog status	Show your combat status	—
/combatlog version	Show plugin version	—

Permissions

Node	Description	Default
combatlog.admin	Reload the plugin	op
combatlog.bypass	Not combat tagged	false

Configuration

language: en_US               # en_US | pt_PT | fr_FR

combat:
  tag-seconds: 30
  apply-to-projectiles: true
  apply-in-creative: false
  ignore-worlds: []

punishment:
  kill-on-disconnect: true
  broadcast: true

bossbar:
  enabled: true
  color: RED                  # PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
  overlay: PROGRESS           # PROGRESS, NOTCHED_6/10/12/20
  title: "&c⚔ Combat &7| &f{time}s"   # {time} = remaining seconds
  update-ticks: 2

titles:
  on-tag-start: true
  on-tag-end: true

chat:
  tag-start: true
  tag-end: true
  countdown:
    enabled: false
    interval-seconds: 5

blocked-commands:
  enabled: true
  list: [tpa, tpaccept, tpahere, spawn, home, sethome, warp, back, rtp]

Per-language boss bar titles live in lang/*.yml (bossbar.title); the bossbar.title in config.yml is a fallback.

Installation

1. Requires Paper or Purpur 1.21.x and Java 21.
2. Drop the JAR into plugins/ and start the server once to generate config.yml.
3. Adjust combat, punishment and blocked-commands, then run /combatlog reload.

Dependencies

• PlayerSettings (optional) — per-player language selection, if installed.

No hard dependencies.

Notes

Combat tags are kept in memory and are not persisted across restarts. The blocked-commands list stops configured commands but not non-command escapes (ender pearls, teleport GUIs, unlisted aliases). Best suited to melee/bow PvP; indirect PvP (end crystals, TNT, beds/anchors) is not tagged in this release.

Support / Source

Source code: https://github.com/henriquescrrrr/carrageis-combatlog