# \u2764\ufe0f LifestealSwapper<\/p>\n
A Paper plugin that adds configurable lifesteal mechanics:<\/p>\n
– Killer gains hearts and victim loses hearts on PvP kills.
\n– Players drop their own head on death.
\n– Placing a player’s head triggers configurable heart swapping behavior.
\n– Optional tab-list formatting to show each player’s max hearts.<\/p>\n
## Features<\/p>\n
– Fully configurable heart bounds (`min`, `max`, `starting`).
\n– Configurable kill transfer values (`killer-gain`, `victim-loss`).
\n– Head swap modes:
\n – `FULL_SWAP`
\n – `TRANSFER_FROM_OWNER`
\n – `TRANSFER_TO_OWNER`
\n– Configurable messages and sounds.
\n– `\/lifesteal reload` command.
\n– Admin heart management commands.<\/p>\n
## Commands<\/p>\n
– `\/lifesteal reload` – reload plugin config. ## Permissions<\/p>\n – `lifesteal.admin` – allows all `\/lifesteal` admin commands.<\/p>\n ## Configuration<\/p>\n Edit `src\/main\/resources\/config.yml` (or the generated `plugins\/LifestealSwapper\/config.yml` on your server).<\/p>\n Key sections:<\/p>\n – `hearts` – global heart limits and starting hearts ## Config File:<\/p>\n “` hearts: lifesteal: heads: head-swap: join: tab-list: messages: sounds: permissions: “`<\/p>\n<\/details>\n","protected":false},"excerpt":{"rendered":" This Plugin adds a highly customizable Lifesteal Plugin with the main feature being able to swap harts with the person you kill.<\/p>\n","protected":false},"featured_media":93695,"template":"","meta":{"_minecraft_slug":"lifesteal++","_minecraft_project_id":"UrtZ8tjJ","_minecraft_author":"EternalFrost","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":80,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"lifesteal++.zip","_minecraft_size_bytes":29898,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:10:32.939265Z","_minecraft_date_created":"2026-03-10T00:03:33.085791Z","_minecraft_date_modified":"2026-03-09T17:06:50.104332Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/lifesteal++","_minecraft_icon_attachment_id":93695,"_minecraft_imported_at":"2026-06-05T08:38:01+00:00","_minecraft_import_hash":"23d8bcbc2b3531d3d432e35df450322f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[88,89,122,127,128,129,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-93694","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-equipment","mod_category-game-mechanics","mod_category-magic","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/lifesteal hearts get
\n– `\/lifesteal hearts set
\n– `\/lifesteal hearts add
\n– `\/lifesteal hearts remove
\n– `\/lifesteal hearts reset
\n– `lifesteal` – kill-based heart transfers
\n– `heads` – death head drops and item appearance
\n– `head-swap` – behavior when placing a player head
\n– `tab-list` – optional tab display of hearts
\n– `messages` \/ `sounds` – UX tuning
\n– `permissions` – permission nodes<\/p>\nSpoiler<\/summary>\n
\n# LifestealSwapper configuration
\n# 1 heart = 2 health points in Minecraft internals.<\/p>\n
\n starting: 10
\n min: 1
\n max: 20<\/p>\n
\n enabled: true
\n killer-gain: 1
\n victim-loss: 1
\n require-player-killer: true
\n allow-self-kill: false<\/p>\n
\n drop-on-death: true
\n display-name: “&c%player%’s Head”
\n lore:
\n – “&7Place this head to trigger a heart swap.”<\/p>\n
\n enabled: true
\n mode: FULL_SWAP # FULL_SWAP | TRANSFER_FROM_OWNER | TRANSFER_TO_OWNER
\n transfer-amount: 1
\n remove-placed-head-block: true
\n require-owner-online: true
\n allow-self-use: false<\/p>\n
\n apply-starting-hearts-to-new-players: true<\/p>\n
\n enabled: true
\n update-ticks: 40
\n format: “&7%name% &c%hearts%\u2764”<\/p>\n
\n prefix: “&8[&cLifesteal&8] ”
\n reload-success: “&aConfiguration reloaded.”
\n no-permission: “&cYou do not have permission.”
\n player-only: “&cOnly players can use this.”
\n owner-offline: “&cThat head owner must be online to swap hearts.”
\n self-head-blocked: “&cYou cannot use your own head.”
\n kill-victim: “&cYou lost %victim_loss% heart(s).”
\n kill-killer: “&aYou stole %killer_gain% heart(s) from %victim%.”
\n swap-placer: “&aYou used %owner%’s head and swapped hearts.”
\n swap-owner: “&e%placer% placed your head and swapped hearts with you.”<\/p>\n
\n enabled: true
\n kill-victim: ENTITY_WITHER_HURT
\n kill-killer: ENTITY_PLAYER_LEVELUP
\n swap-placer: ENTITY_ENDERMAN_TELEPORT
\n swap-owner: ENTITY_ENDERMAN_TELEPORT<\/p>\n
\n admin: lifesteal.admin<\/p>\n