Advanced Lifesteal

A Paper plugin that turns hearts into physical items. Players steal hearts by killing each other, withdraw their own hearts as tradeable items, and revive banned players through a Beacon GUI. Requires Paper 1.21+.

---

Features

Heart Stealing

• Killing a player steals hearts.per-kill HP from the victim and gives it to the killer (default: 2.0 HP = 1 heart).
• When a victim drops to hearts.min, they are automatically banned with a configurable reason.
• Killer hearts are capped at hearts.max.
• Lifesteal can be enabled or disabled per world via worlds.enabled.

Heart

• Red bold display name "Heart", with lore describing its uses.
• Right-click to consume: if the player is below hearts.max, the item is consumed and they gain exactly 1 max heart. If they are at hearts.max, the item is not consumed and a message is sent.

Heart Recipe

N D N| N = Netherite Ingot ×4 D S D| D = Diamond Block ×3 N A N| A = Enchanted Golden Apple ×1 | S = Nether Star ×1

= 1 Heart.

Revival Beacon

• Custom item based on LODESTONE, placeable as a block.
• Recipe matches the vanilla Beacon layout, with a Heart in place of the Nether Star: G G G | G= Glass G H G | H= Heart O O O | O= Obsidian

= 1 Revival Beacon.

/withdraw Command

• /withdraw <amount> converts hearts from the player's max-health pool into physical Heart items.
• Refuses if the action would drop the player below hearts.min.
• Refuses if the player's inventory cannot hold the resulting items.
• Rejects zero, negative, and non-numeric inputs.
• Alias: /wd.

Commands

Command	Description	Permission
/lifesteal help	Subcommand list	adlifesteal.command
/lifesteal reload	Reload config	adlifesteal.admin
/lifesteal hearts <player>	View a player's hearts	adlifesteal.command
/lifesteal ban <player>	Manually ban a player	adlifesteal.admin
/lifesteal unban <player>	Manually unban a player	adlifesteal.admin
/hearts [player]	Check hearts	adlifesteal.hearts
/revive <player>	Revive a banned player	adlifesteal.revive
/withdraw <amount>	Withdraw hearts	adlifesteal.withdraw

All commands support tab completion.

Run /lifesteal reload after editing the config.

Requirements Paper 1.21 or newer

Java: 21 or newer

PlaceholderAPI — exposes heart count placeholders for scoreboards, tab lists, and chat.

Vault — economy hook, available for use if you add a Heart shop.

LuckPerms — advanced permission checks.

WorldGuard — region protection for placed Revival Beacons.

These aren't required at all

Support

Report bugs and request features on the project's issue tracker. Include the server version, plugin version, and a full stack trace for any errors.