Configuration

This page walks through config.yml, the main settings file. After any change, run /ls reload or restart the server. All color values accept hex codes in the &#RRGGBB or <#RRGGBB> format.

Core mechanics

core:
  check-same-ip: true
  hearts-lost-per-death: 1.0
  max-hearts: 40.0
  initial-hearts: 10.0
  hearts-on-revive: 10.0
  drop-physical-heart: true
  zero-heart-action: "ban"

Key	Default	What it does
`check-same-ip`	true	Blocks heart gain when the killer and victim share an IP, to stop alt farming
`hearts-lost-per-death`	1.0	Hearts moved from victim to killer per death
`max-hearts`	40.0	Highest heart count a player can reach
`initial-hearts`	10.0	Hearts a new player starts with
`hearts-on-revive`	10.0	Hearts a revived player returns with
`drop-physical-heart`	true	Drop a heart item on death
`zero-heart-action`	ban	What happens at zero hearts: `ban`, `spectator`, or `none`

Zero heart options

zero-heart-options:
  spectator-mode:
    enabled: true
    respawn-timer: 15
    respawn-firework: true
  ban-mode:
    enabled: true
    ban-duration: "1h"
    ban-command: "ban %player% You ran out of hearts! You are banned for {ls_bantimer}."
    unban-command: "unban %player%"

This block sets the details for whichever zero-heart-action you chose. See Elimination for how the ban and spectator modes behave.

Display

display:
  hearts-out-of-20: false

false shows hearts as 10.0, 9.5, 9.0.
true shows them as 20, 19, 18 like the vanilla health number.

Heart and golden heart items

heart-item:
  material: "REDSTONE"
  name: "&cHeart"
  glow: true
  fire-resistant: true
  custom-model-data: 0
  lore:
    - "&7A fragment of a player's life."
golden-heart-item:
  material: "GOLD_NUGGET"
  name: "&6Golden Heart"
  enabled: true
  custom-model-data: 0
  hearts-to-give: 2.0

Key	What it does
`material`	The base item material
`name` and `lore`	The display name and tooltip lines
`glow`	Adds an enchant glow
`fire-resistant`	The item survives fire and lava
`custom-model-data`	Texture override for a resource pack (`0` is off)
`golden-heart-item.enabled`	Whether a killer gets a golden heart on a last-life kill
`golden-heart-item.hearts-to-give`	Hearts a golden heart gives when consumed

Both items have a consume-effects block. Those effects only fire when custom-model-data is above 0. See Resource pack.

Death features

death:
  drop-player-head: true
  head-drop-chance: 0.25
  drop-on-non-player-death: true

Key	What it does
`drop-player-head`	Drop the victim's head on death
`head-drop-chance`	Chance of a head drop, `0.25` is 25 percent
`drop-on-non-player-death`	Drop a heart on deaths with no killer, like fall damage

Revive

revive:
  revive-cooldown-enabled: true
  revive-cooldown-time: 3600
  revive-beacon-cost: 3.0
  shop-drop-if-full: false

See Revive for what each of these does.

Crafting

The crafting-recipe and beacon-crafting blocks set the heart and beacon recipes. See Crafting.

Return celebration

return-celebration:
  enabled: true
  fireworks: true
  sound: "ENTITY_ENDER_DRAGON_GROWL"

Plays fireworks and a sound when a player returns from a ban exile.

Messages

Every player-facing message lives under messages. See Messages for the placeholders you can use.

Metrics

zLifeSteal reports anonymous usage stats through bStats (plugin id 32009). You can turn this off globally in plugins/bStats/config.yml.

On this page