PvP

CombatLog

No more players logging out mid-fight: when a player hits or gets hit a timer starts with a boss bar. Logging out before it ends kills them, drops their items and gives the kill to the opponent. While fighting, escape commands, teleports and flying are blocked.

Buy a license Paper, Spigot, Bukkit 1.20 – 1.21 · Java 17+

Installation

Download the file from the customer area and copy it into your server's plugins folder.
Start the server once: the plugin folder with config.yml is created.
Paste your license under license: and restart the server.

Commands

Aliases: /ct, /combattag

Command	Permission	Description
`/combat`	`—`	Shows if you are in combat and for how long
`/combatlog reload`	`combatlog.admin`	Reloads configuration and languages

Permissions

Permission	Default	Description
`combatlog.bypass`	false	Never put in combat (for staff)
`combatlog.admin`	op	Reload the plugin

Blocked commands

With commands.mode: blacklist only the listed commands are blocked (spawn, home, tpa...). With whitelist, on the other hand, ONLY the listed commands can be used in combat. Write them without the /.

Who gets punished

Players who log out during the timer die and drop their items; when they come back they get a message. If staff kicks them they are not punished (logout.punish-when-kicked). Ender pearls stay allowed because they are part of PvP. Works with LandClaims: if PvP is off in a claim, hits don't start combat.

Configuration files

config.yml

# Your license key (you received it privately from our Discord bot).
license: "PASTE-YOUR-LICENSE-HERE"

# Message language: "en" (English) or "it" (Italiano). Files are in /lang and can be edited freely.
language: en
# When true, each player sees the messages in their own game language (when a file for it exists).
use-client-language: true

combat:
  # Seconds a player stays in combat after hitting or being hit by another player.
  seconds: 15
  # true = being hit by a mob also puts you in combat.
  tag-on-mob-damage: false

display:
  # Timer at the top of the screen.
  boss-bar: true
  # Colors: PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE. Styles: SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
  boss-bar-color: RED
  boss-bar-style: SOLID
  # Timer above the hotbar too.
  action-bar: false

logout:
  # Players who log out while in combat die and drop their items. The kill goes to the last player who hit them.
  kill: true
  # When a staff member kicks a player in combat, punish them anyway?
  punish-when-kicked: false
  # Tell everyone who logged out in combat.
  broadcast: true

commands:
  # "blacklist" = the commands below are blocked in combat. "whitelist" = ONLY the commands below are allowed.
  mode: blacklist
  list:
    - spawn
    - home
    - homes
    - tpa
    - tpahere
    - tpaccept
    - tpyes
    - warp
    - warps
    - back
    - rtp
    - wild
    - tp
    - ec
    - enderchest
    - fly
    - hub
    - lobby

restrictions:
  # Block teleports from commands, plugins and portals while in combat.
  block-teleports: true
  # Ender pearls and chorus fruit are still allowed (they are part of PvP).
  allow-ender-pearls: true
  # Turn off /fly when a player enters combat.
  disable-flight: true
  # Block flying with an elytra while in combat.
  block-elytra: false

# Worlds where nobody is put in combat.
disabled-worlds: []

# Sound names from https://minecraft.wiki/w/Sounds.json  ->  "name:volume:pitch"  ("none" = no sound)
sounds:
  tagged: "entity.player.attack.strong:1:0.8"
  combat-over: "block.note_block.pling:1:1.5"