Extra Heart

Extra heart item configuration.

Template

heartItem:
  enabled: true/false
  name: "Your Extra Heart Item Name"
  material: "PAPER"
  lore:
    - "Line 1"
    - "Line 2"
  loseChance: number between 0-100
  addLimit: number
  withdraw-enabled: true/false

enabled

Determines if the extra heart item is usable.

name

You can put any name here that Minecraft allows. Of course colors are supported.

material

This is where you define what extra heart item should be. You have to take name of the "material" from spigot documentation. Please note that the names are case sensitive.

lore

Here you can add a description to the item extra heart the way Minecraft allows. Colors are supported.

loseChance

When using an extra heart, you may face a case where you fail to use it. This setting defines the chance of losing a heart when you fail to use the extra heart item.

addLimit

Sets the limit of hearts that can be obtained using the extra heart item.

withdraw-enabled

Determines if the withdrawal system is enabled.

mode

There are 3 modes.

always - Heart will always drop out of a killed player, it will not be added immediately to killer's maximum life.

limit_exceeded - Heart will be immediately added to killer's maximum health, except if killer exceeds heart limit, then, heart drops out of killed player.

never - Heart will immediately be added to killer's maximum life, but if killer exceeds limit, heart from killed player is gone.