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, license-key, worldguard, 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

# ============================================================
# 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.

license-key: ""             # BuiltByBit license key (leave blank for free SpigotMC build).

worldguard:
  respect-pvp-flag: true    # Skip tagging inside WG regions with pvp=deny.

# ============================================================
# 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