Lifesteal

LifeSteal

Features:

• Heart stealing: lose a permanent heart when you die, take one when you get a kill.
• Inspired by the LifeSteal SMP made popular by YouTubers with very flexible configuration.
• Server-authoritative and persistent: hearts are stored safely and survive restarts, reconnects, and name changes.
• Two kill-reward styles to choose from: instantly transfer a heart from victim to killer, or drop a Heart item at the death location for anyone to pick up.
• Eliminate at zero hearts: reach 0 and you’re banned from the server until revived.
• Revive Beacon system: craft a beacon, right-click it, type the eliminated player’s name in chat, then confirm to bring them back with a fresh set of hearts.
• Heart and Crafted Heart items let you top up your permanent hearts outside of combat, each with its own usable limit.
• Withdraw command lets you convert your own permanent hearts back into physical Heart items if you want to trade them.
• Fully custom crafting recipes for every item, toggleable individually without a server restart.
• Admin toolkit to check, set, add, remove, ban, and unban player hearts, plus a paginated list of every eliminated player.
• No client-side mod required: works with any vanilla client.

Installation:

• Download the .jar file.
• Install Fabric Loader and Fabric API on your server.
• Place the .jar file in your server’s mods folder.
• Start the server once to generate the config files, then edit them as needed.
• Keep in mind that changing the config files directly will require a restart or the use of the /reload command.

Config:

| Name | Description | Value | Type |
| — | — | — | — |
| starter_hearts | Hearts a player starts with on first join | 10 | Number |
| maximum_hearts | Highest number of hearts a player can hold | 20 | Number |
| minimum_hearts | Hearts floor. Once a player reaches this amount, dying no longer costs them a heart, effectively disabling elimination for them unless they use /withdraw to go lower themselves (use 3 if you want the lifesteal world experience as it is) | 0 | Number |
| revival_hearts | Hearts a player comes back with after being revived | 3 | Number |
| drop_heart_on_non_player_death | Whether a Heart item drops when a player dies to something other than another player | true | True/False |
| player_kill_reward_mode | How a killer is rewarded: direct heart transfer or a dropped Heart item | DIRECT_TRANSFER | DIRECT_TRANSFER or DROP_ITEM |
| crafted_heart_usage_limit | Heart count below which a Crafted Heart can still be used | 20 | Number |
| items.heart.base_item | Vanilla item used as the base for the Heart item | minecraft:nether_star | Text |
| items.crafted_heart.base_item | Vanilla item used as the base for the Crafted Heart item | minecraft:nether_star | Text |
| items.revive_beacon.base_item | Vanilla item used as the base for the Revive Beacon item | minecraft:beacon | Text |
| administration.banned_list_page_size | Entries shown per page in the eliminated players list | 10 | Number |
| bans.source | Label shown as the source of a LifeSteal ban | LifeSteal | Text |

Recipes, item names, lore, and every player-facing message are also fully editable in the files messages.json and recipes.json.

Commands:

• /lifesteal hearts get|set|add|remove <player> [amount] : check or adjust a player’s hearts.
• /lifesteal recipe status|enable|disable <recipe> : check or toggle a recipe on the fly.
• /lifesteal banned list|check|ban|unban <player> : manage eliminated players and profile bans.
• /withdraw <amount> : convert your own permanent hearts into Heart items.
• All /lifesteal commands require server operator permissions. /withdraw is open to every player.

Compatibility:

• Server-side Fabric mod, no client installation needed.
• Minecraft 1.21.11 1.21.10 1.21 1.21.1 1.21.2.

Notes:

• SFX are remaining, id also modify the default config values later on.
• A custom resource pack is on the works
• I used some type of AI help to write this description and assist with coding.