Configuration reference

This is the config.yml BetterDeathMessages 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: config-version, language, last-words, global-broadcast, first-death-of-day, kill-streaks, first-blood, broadcast, death-sound.

# BetterDeathMessages Configuration
# Death message templates and UI strings are in lang/es.yml (or the active locale).
config-version: 3

# 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/BetterDeathMessages/lang/.
language: en

# ============================================================
# LAST WORDS  (v1.1.0)
# ============================================================
# Captures a player's last public message and drops it into the death
# message through the {last_words} token in lang/<locale>.yml.
#
# Public chat only — whispers and private channels are ignored and never
# reach the cache. A cached message is cleared automatically after
# cache-seconds.
#
# To use it, edit your templates in lang/<locale>.yml and put
# {last_words} wherever you want the quote to appear.
last-words:
  enabled: true
  cache-seconds: 60
  fallback: ""

# ============================================================
# GLOBAL BROADCAST
# ============================================================
# Deaths from these causes are broadcast to all online players.
# Valid values: pvp, ENDER_DRAGON, WITHER (or any EntityType name).
# hover-stats = true adds a hover tooltip with the victim's KDR.
global-broadcast:
  enabled-causes: [ENDER_DRAGON, WITHER, pvp]
  hover-stats: true

# ============================================================
# FIRST DEATH OF THE DAY
# ============================================================
# Broadcasts a special message for the first player to die each day.
# The message template lives in lang/<locale>.yml under first-death-of-day.message.
first-death-of-day:
  enabled: true

# ============================================================
# KILL STREAKS
# ============================================================
# Broadcast when a player reaches a kill streak milestone.
# Thresholds: list of consecutive kills that trigger a broadcast.
# Message templates in lang/<locale>.yml under kill-streak.<n>.
kill-streaks:
  enabled: true
  thresholds: [3, 5, 10, 20]

# ============================================================
# FIRST BLOOD
# ============================================================
# Broadcast when the first PvP kill of the day happens.
# Message template in lang/<locale>.yml under first-blood.message.
first-blood:
  enabled: true

# ============================================================
# BROADCAST RADIUS
# ============================================================
# -1  = send death message to ALL players online (default).
# >0  = only players within this many blocks in the same world see it.
broadcast:
  radius: -1

# ============================================================
# DEATH SOUND
# ============================================================
# Plays a sound to nearby players when someone dies.
# sound: any Paper Sound enum name.
death-sound:
  enabled: true
  sound: ENTITY_PLAYER_DEATH
  radius: 50
  volume: 1.0
  pitch: 1.0