Lifesteal999

Battle for survival in this customizable lifesteal plugin featuring heart stealing mechanics, hardcore elimination, combat logging protection, and full configuration control

Features

Hearts

  • Every player has a number of hearts that sets their maximum health.
  • New players start with a configurable number of hearts.
  • There is a configurable maximum number of hearts a player can reach.
  • Players can withdraw hearts, turning them into tradeable heart items.
  • Players can consume heart items to raise their maximum health.
  • Heart items can be crafted with a fully configurable recipe.
  • Normal enchanted golden apples are never affected — only the plugin's own heart items are special.

Losing hearts

  • Hearts can be lost on every death, only on player kills, or never.
  • You can restrict heart loss to specific worlds.
  • Void deaths never cost a heart.
  • A configurable protection period can prevent heart loss right after joining or being revived.

Elimination and revival

  • When a player loses their last heart they can be eliminated.
  • The elimination punishment is configurable: send them to spectator, kick them, ban them for a set time (or permanently), or drop their inventory.
  • Eliminated players stay eliminated even after the server restarts.
  • A craftable revival item lets players bring the eliminated back.
  • Right-clicking a revival item opens a menu of every eliminated player.
  • The menu is paged, with arrows to move between pages, and clicking a player revives them.
  • Operators can revive a player instantly without spending an item.
  • Regular players can revive a player by using one of their own revival items.
  • Operators can hand out revival items directly.

Trading and gifting

  • Players can trade items with each other through a dedicated trade window.
  • Players can gift hearts to each other.
  • Trade requests expire after a configurable time.
  • Cooldowns can be set for gifting hearts and withdrawing hearts.

Heart shop

  • A heart shop lets players buy and sell hearts using server currency.
  • The shop is disabled by default and only works when Vault is installed.
  • Buying and selling can be enabled or disabled independently.
  • Prices, amounts per purchase, maximum hearts and minimum hearts to keep are all configurable.

Messages and placeholders

  • Every message in the plugin is fully customizable.
  • Heart information can be shown with PlaceholderAPI.

Commands

Command Description Permission
/lifesteal Shows the list of available subcommands. —
/lifesteal reload Reloads the configuration and messages. lifesteal.admin
/lifesteal give <player> <amount> Gives heart items to a player. lifesteal.admin
/lifesteal giverevive <player> [amount] Gives revival items to a player. lifesteal.admin
/lifesteal revive <player> Revives an eliminated player instantly. lifesteal.admin
/lifesteal stats [player] Shows heart statistics for yourself or, with permission, another player. lifesteal.admin when viewing another player
/lifesteal giveheart <player> <amount> Gifts your own hearts to another player. lifesteal.giveheart
/lifesteal trade <player> Sends a trade request. lifesteal.trade
/lifesteal trade accept Accepts a pending trade request. lifesteal.trade
/lifesteal shop Opens the heart shop. lifesteal.shop
/withdraw [amount] Withdraws hearts as heart items. lifesteal.withdraw
/revive <player> Revives an eliminated player using one of your revival items. lifesteal.revive
/adminrevive <player> Revives an eliminated player without using an item. lifesteal.admin

Permissions

Permission Default Description
lifesteal.admin Operators Access to all administrative commands.
lifesteal.withdraw Everyone Allows withdrawing hearts.
lifesteal.revive Everyone Allows reviving others with a revival item.
lifesteal.trade Everyone Allows trading with other players.
lifesteal.giveheart Everyone Allows gifting hearts.
lifesteal.shop Everyone Allows opening the heart shop.

Placeholders

When PlaceholderAPI is installed, the following placeholders are available:

Placeholder Description
%lifesteal_hearts% The player's current hearts.
%lifesteal_max_hearts% The maximum hearts allowed on the server.
%lifesteal_withdrawn% How many hearts the player has withdrawn.
%lifesteal_consumed% How many hearts the player has consumed.
%lifesteal_eliminated% true if the player is eliminated, otherwise false.
%lifesteal_status% alive or eliminated.

Configuration

All settings live in the configuration file. Messages live in the messages file and use & colour codes with {placeholder} values.

General

Setting What it does
default-hearts How many hearts a new player starts with and how many hearts a player is revived with.
max-hearts The highest number of hearts any player can reach.
enabled-worlds The worlds where losing hearts applies. Leave it empty to apply everywhere.
lose-hearts When hearts are lost. true always, false never, pvp only when killed by another player.
grace-period-seconds Seconds of protection from heart loss after joining or being revived. 0 disables it.

Elimination

Setting What it does
elimination.enabled Whether players can be eliminated. When disabled, players can never fall below one heart.
elimination.punishment What happens on elimination: SPECTATOR, KICK, BAN or DROP.
elimination.kick-message The message shown to a kicked or banned eliminated player.
elimination.ban-duration-seconds Ban length in seconds. 0 makes the ban permanent. Only used with BAN.
elimination.drop-inventory Also drops the eliminated player's inventory. Useful when keeping items on death is enabled.
elimination.broadcast Whether a server-wide message is sent when a player is eliminated.

Heart item

Setting What it does
heart-item.name The display name of the heart item.
heart-item.lore The lore lines of the heart item.
heart-item.hearts-per-item How many hearts are gained by consuming one heart item.

Heart recipe

Setting What it does
recipe.enabled Whether the heart crafting recipe is active.
recipe.shape.1, .2, .3 The three rows of the crafting shape.
recipe.A … recipe.F The ingredient used for each character in the shape.

Revival item

Setting What it does
revive-item.enabled Whether the revival item and its recipe are active.
revive-item.material The base material of the revival item.
revive-item.name The display name of the revival item.
revive-item.lore The lore lines of the revival item.
revive-item.recipe.enabled Whether the revival item recipe is active.
revive-item.recipe.shape.1, .2, .3 The three rows of the revival item's crafting shape.
revive-item.recipe.A … E The ingredient used for each character in the revival shape.

Trading

Setting What it does
trade.request-timeout-seconds How long a trade request stays valid before it expires.
trade.giveheart-cooldown-seconds Cooldown between gifting hearts. 0 disables it.
trade.withdraw-cooldown-seconds Cooldown between withdrawing hearts. 0 disables it.

Economy and shop

Setting What it does
economy.enabled Master switch for the heart shop. Requires Vault.
economy.shop.buy.enabled Whether players can buy hearts.
economy.shop.buy.amount How many hearts are bought per click.
economy.shop.buy.price-per-heart The cost of a single heart when buying.
economy.shop.buy.max-hearts The maximum hearts a player may own after buying. 0 uses the main maximum.
economy.shop.sell.enabled Whether players can sell hearts.
economy.shop.sell.amount How many hearts are sold per click.
economy.shop.sell.price-per-heart The money received for a single heart when selling.
economy.shop.sell.min-hearts The number of hearts a player must keep after selling.

Lifesteal999 Team

profile avatar
  • 2
    Followers
  • 40
    Projects
  • 21.6K
    Downloads

More from Erik9994857View all