LifeSteal Lite

# -----------------------------------------------------------------------------
# LifeSteal Lite - Configuration File
# A lightweight, performance-focused heart system designed to preserve the vanilla feel.
# -----------------------------------------------------------------------------

settings:
  # The number of hearts a new player starts with. (1 Heart = 2 HP)
  starting-hearts: 10

  # The maximum number of hearts a player can achieve.
  # Players cannot use heart items if they reach this limit.
  max-hearts: 20

  # The minimum number of hearts a player can drop to.
  # Players cannot withdraw hearts if it would put them below this limit.
  min-hearts: 1

  # What action should be taken when a player loses all their hearts (or reaches the min limit)?
  # Options:
  #   NONE      - Nothing happens (Vanilla behavior).
  #   BAN       - The player is banned for the duration specified below.
  #   SPECTATOR - The player is put into spectator mode.
  min-health-action: NONE

  # If 'BAN' is selected above, how many minutes should the ban last?
  ban-duration-minutes: 60

# -----------------------------------------------------------------------------
# Crafting System (Dynamic)
# -----------------------------------------------------------------------------
recipe:
  # Enable or disable the crafting recipe for Heart Capsules.
  enabled: true

  # The crafting shape (3 lines).
  # Use characters to represent items defined in the 'ingredients' section below.
  # Space " " counts as an empty slot.
  shape:
    - "DGD"
    - "GTG"
    - "DGD"

  # Define what item each character represents.
  # Use valid Bukkit Material names (e.g., DIAMOND_BLOCK, TOTEM_OF_UNDYING, NETHERITE_INGOT).
  ingredients:
    T: TOTEM_OF_UNDYING
    D: DIAMOND_BLOCK
    G: GOLD_BLOCK

# -----------------------------------------------------------------------------
# Gameplay Mechanics
# -----------------------------------------------------------------------------
gameplay:
  # If true, players will lose a heart from environmental deaths (lava, fall damage, drowning).
  # If false, players only lose hearts when killed by another player (PvP).
  environment-heart-loss: false

  # If true, players drop their inventory when they die (Vanilla style).
  # If false, keep-inventory is enabled for deaths.
  drop-items-on-death: true

  # Security measure to prevent players from killing the same player repeatedly to farm hearts.
  prevent-farming: true

  # The cooldown time (in seconds) before a player can gain a heart from the same victim again.
  farm-cooldown-seconds: 300

# -----------------------------------------------------------------------------
# Item Customization
# -----------------------------------------------------------------------------
item:
  # The display name of the heart item. Supports color codes (&).
  heart-item-name: "&c&lHeart Capsule"

  # The material of the heart item. (e.g., RED_DYE, NETHER_STAR, APPLE)
  heart-item-material: RED_DYE

  # Should the item have an enchantment glow effect?
  heart-item-glow: true

# -----------------------------------------------------------------------------
# Language & Messages
# Supports legacy color codes (&a, &c, &l, etc.)
# -----------------------------------------------------------------------------
messages:
  # Gameplay Messages
  heart-gained: "&a[+1 Heart] &7You defeated an opponent!"
  heart-lost: "&c[-1 Heart] &7You lost a heart..."
  withdraw-success: "&aHeart withdrawn successfully!"
  withdraw-fail: "&cYou do not have enough health to withdraw!"
  max-hearts-reached: "&eYou have reached the maximum heart limit."

  # BAN Messages
  ban-reason: "&c&lGAME OVER\n\n&7Your final heartbeat has faded into the void.\nThe LifeSteal curse has consumed your soul.\n\n&cYou are no longer welcome among the living."
  ban-remaining: "&e&lRemaining Time: &f{time}"

  # Admin & Error Messages
  no-permission: "&cYou don't have permission to do this."
  player-not-found: "&cPlayer not found."
  reload-success: "&aConfiguration reloaded successfully!"
  reset-success: "&aPlayer's health has been reset to default."
  give-success: "&aYou gave {amount} heart(s) to {player}."
  give-received: "&aYou received {amount} heart(s) from an admin!"

  # Unban & Purge Messages
  unban-success: "&aPlayer {player} has been unbanned."
  unban-fail: "&cCould not unban {player}. Are they banned?"
  purge-success: "&aAll bans have been purged! Everyone can join."

  # Recipe Toggle Messages
  recipe-enabled: "&aHeart crafting recipe has been ENABLED!"
  recipe-disabled: "&cHeart crafting recipe has been DISABLED!"

  # Help Menu
  help-header: "&8&m--------&c LifeSteal Lite &8&m--------"
  help-withdraw: "&7/ls withdraw <amount> &8- &fWithdraw hearts."
  help-give: "&7/ls give <player> <amount> &8- &fGive heart items (Admin)."
  help-reset: "&7/ls reset <player> &8- &fReset player's health (Admin)."
  help-unban: "&7/ls unban <player> &8- &fUnban a specific player (Admin)."
  help-purgebans: "&7/ls purgebans &8- &fUnban everyone (Admin)."
  help-recipe: "&7/ls recipe &8- &fToggle crafting recipe (Admin)."
  help-reload: "&7/ls reload &8- &fReload config (Admin)."