Lifesteal999

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.