Configuration reference
This is the config.yml CombatLogger writes on first start, comments included. Every key you see here is the key the plugin reads; there are no hidden ones. Change a value, reload, and it applies.
Top-level sections: language, combat, combat-hud, npc, penalty, worldguard, safe-zone, notifications.
# ============================================================
# CombatLogger — config.yml
# ============================================================
# Combat tagging on PvP/PvE damage, command blocking while tagged,
# and (since v1.1.0) a per-player BossBar HUD with countdown.
#
# Reload with /combatlog reload after any change.
# ============================================================
# Active language. ISO-639-1 two-letter code (lowercase).
# Bundled out of the box: es (Spanish), en (English).
# Missing keys fall back to en automatically. Operators can drop extra
# lang/<code>.yml files in plugins/CombatLogger/lang/.
language: en
combat:
duration-seconds: 15 # Seconds a player stays tagged after taking damage.
pvp-enabled: true # Tag on player-vs-player damage.
pve-enabled: true # Tag on player-vs-mob damage.
blocked-commands: # Commands silently denied while a player is tagged.
- tp
- tpa
- home
- spawn
- warp
- fly
- gamemode
- rtp # SafeRTP
- back # SmartHomes
- sethome # SmartHomes
- trade # TradeForge
- shop # ShopForge
# ============================================================
# COMBAT HUD (v1.1.0)
# ============================================================
# Boss bar shown while in combat, counting the tag down. When it runs
# out without the player dying, they get an "Out of combat" action bar.
# Turning this off changes nothing else — the plugin behaves exactly
# as in v1.0.0 (no HUD, no extra overhead).
combat-hud:
enabled: true
bossbar-color: RED # RED, PURPLE, BLUE, YELLOW, GREEN, WHITE, PINK
bossbar-style: SOLID # SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
bossbar-text: "<red>⚔ In combat <gray>· <white>{seconds}s"
exit-actionbar: "<green>✓ Out of combat</green>"
npc:
duration-seconds: 30 # How long the Citizens ghost lingers after disconnect.
hologram-text: "<red>[Combat Logger] <name>"
death-broadcast: "<gold><player></gold> <red>was killed while logged out!"
penalty:
mode: kill # kill | clear — what happens to the owner on re-login if the NPC died.
worldguard:
respect-pvp-flag: true # Skip tagging inside WG regions with pvp=deny.
# ============================================================
# SAFE-ZONE WALL (v1.6.0)
# ============================================================
# A player tagged in a fight cannot run into a safe zone to end it.
# Safe zones are WorldGuard regions with pvp=deny and, when it is
# installed, DominionForge's spawn (its SAFEZONE).
# - A step over the border is refused and the player pushed back.
# - Near the border they see a wall of glass, sent to them alone and
# never placed in the world. The glass is only a sign: the refusal is
# done by the server, so hacked clients cannot walk through it.
# - Ender pearls and chorus fruit into the zone are refused.
# - Whoever still gets in (a glitch, a vehicle...) is taken back to the
# last spot they stood outside and punished there.
safe-zone:
enabled: true
pvp-tag-only: true # Only a tag from another player counts, not one from mobs.
block-pearls: true
knockback: 0.6 # How hard the border pushes back. 0 = no push.
breach-penalty: kill # kill | teleport-back — kill drops the loot outside, where the opponent can take it.
wall:
enabled: true
material: RED_STAINED_GLASS
radius: 8 # How close to the border the wall appears, in blocks (1-32).
below: 1 # Rows drawn under the player's feet...
above: 3 # ...and above them.
# ============================================================
# STAFF NOTIFICATIONS (v1.2.0)
# ============================================================
# Broadcast a message to staff (combatlogger.notify) when a player
# combat-logs. Disable to suppress the broadcast entirely.
notifications:
staff-broadcast: true