Lifesteal2: The Ultimate Lifesteal Plugin
Lifesteal2 is a modern, performance-focused, and fully configurable lifesteal system for Minecraft servers. It includes advanced heart mechanics, configurable items, custom GUI systems, PlaceholderAPI support, and complete customization through config and message files. Every system can be tuned to match any SMP, factions, or survival setup.
Features
Fully Configurable
All mechanics, recipes, limits, and options are stored in the configuration file. You can toggle natural heart loss, limit maximum hearts, adjust revive behavior, and fine-tune item crafting or GUI settings easily.
Custom Items
Heart Item – crafted using your configurable recipe, adds one heart when right-clicked. Revive Tool – opens an interactive revive GUI listing players who lost all hearts, allowing them to be brought back with a configurable amount of hearts.
Revive GUI
The revive menu lists all players banned for losing their last heart. Each appears with their player head, hover tooltip, and click-to-revive function. Supports multiple pages with configurable slot counts. The system can also be disabled or simplified through config.
Configurable Recipes
Both Heart and Revive Tool recipes are fully editable in the configuration file. Recipes are written left-to-right, top-to-bottom, corresponding to a 3x3 crafting table.
Data Storage
Every player’s heart count and ban status are saved securely and persist through restarts. Data is stored in playerdata.yml within the plugin folder.
Message Customization
All plugin messages are stored in messages.yml. This includes every chat message, help section, and even leaderboard formatting—giving complete control over how the plugin looks and feels.
PlaceholderAPI Support
The plugin includes built-in placeholders for use in scoreboards, sidebars, or GUIs:
%lifesteal2_hearts% — shows the player’s current heart count
%lifesteal2_is_banned% — shows if a player is lifebanned
%lifesteal2_rank% — shows their leaderboard position
Configurable Heart Limits and Punishments
Enable or disable maximum heart limits.
Set the maximum allowed heart count.
Define punishments when a player reaches zero hearts, including permanent or timed bans and custom commands.
Indirect Kill Detection
When a player kills another using indirect methods (such as end crystals or TNT), the kill is still correctly attributed to the attacker whenever possible.
Leaderboard and Status Commands
Check top players with /heartleaderboard or verify plugin functionality with /statuslifesteal. Leaderboard layout can be customized in messages.yml.
Update Checker
When the server starts, the console checks for new Lifesteal2 versions and notifies you if an update is available.
Tab Completion
All commands include tab completion for players and arguments.
Commands
Command Description Permission
/hearts [player] Show your or another player’s hearts lifesteal.hearts, lifesteal.hearts.others
/giveheart
max-hearts: enabled: true limit: 20
revive: hearts-after-revive: 3 gui-enabled: true gui-size: 54
punishment: type: "ban" duration: "7d" # or "permanent"
crafting: heart-recipe:
- DIAMOND
- NETHERITE_INGOT
- DIAMOND
- EMERALD_BLOCK
- NETHER_STAR
- EMERALD_BLOCK
- DIAMOND
- NETHERITE_INGOT
- DIAMOND
revive-recipe:
- NETHERITE_INGOT
- DIAMOND
- NETHERITE_INGOT
- ENCHANTED_GOLDEN_APPLE
- NETHER_STAR
- ENCHANTED_GOLDEN_APPLE
- NETHERITE_INGOT
- DIAMOND
- NETHERITE_INGOT
(If the generated config differs from this example, it is due to markdown formatting.)
Technical Details
Built for Minecraft 1.21 and higher
Requires Java 25 or higher
Compatible with Spigot, Paper, and Purpur
Player data stored in /plugins/Lifesteal2/playerdata.yml
Config regenerates automatically if deleted
Supports PlaceholderAPI out of the box
Permissions lifesteal.hearts lifesteal.hearts.others lifesteal.giveheart lifesteal.takehearts lifesteal.sethearts lifesteal.withdrawhearts lifesteal.withdrawhearts.others lifesteal.heartrecipe lifesteal.revivetoolrecipe lifesteal.status lifesteal.leaderboard lifesteal.helplifesteal
Credits
Developed by waffleboiii
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 7h ago | 1 | ||||
| 7h ago | 1 | ||||
| 7h ago | 1 | ||||
|
R
1.0
|
7h ago | 1 |
- Fixes**
- Recipes now register on startup (no more "status error" + broken crafting).
/setheartsand/giveheartnow use their own messages with correct values.- Fixed orphaned
heart-consume.cooldown-secondsconfig path.
- Changes**
- Revive tool: right-click now prompts for a username in chat and opens the GUI directly on that player's page.
- Ban/kick reason is now capitalized and customizable in
messages.yml. - New
heart-consumeconfig: toggle healing on/off and full-heal vs. +1 heart.
- New**
- World whitelist/blacklist for heart mechanics.
- Configurable kill broadcasts (PvP + natural).
- Anti-farm cooldown to block repeat kills on the same victim.
- Sound + particle effects on heart consume and heart drop.
- Lifesteal2 – Bug Fix Update
- Changes**
- Fixed an issue where players killed on their final heart in PvP were punished before a Heart item could drop. A Heart now always drops on the ground before the punishment is applied.
- Fixed /revivetoolrecipe not working for non-OP players. The command now works with default permissions, consistent with /heartrecipe.
- When a player gains hearts, their health is now fully restored to the new maximum. Newly added hearts are no longer left empty.
- Improved /sethearts behavior when exceeding the maximum heart limit. Values above the limit now set the player to the maximum instead of ignoring the command, with proper feedback.
- Max heart limit is now functional
- Revive tool is now functional
I recommend you download this version because it fixes many game-breaking bugs and will provide you with a better expirience compared to previous versions.
## Major Additions ##
- Custom message system: All plugin messages can now be fully configured in messages.yml, including leaderboard formatting and help menus.
- PlaceholderAPI integration: Added %lifesteal2_hearts%, %lifesteal2_is_banned%, and %lifesteal2_rank% placeholders for use in scoreboards and sidebars.
- Configurable heart limits: Added max and min heart values with the option to enable or disable the limit system.
- Revive system improvements: Added configurable heart count after revival and support for multi-page GUIs with customizable slot sizes.
- Punishment system: Players can now be temporarily banned or have custom commands executed upon reaching zero hearts.
- Indirect kill tracking: Kills from explosions or projectiles now correctly attribute the attacker where possible.
- Update checker: The console now notifies the server owner if a new plugin version is available.
## Fixes and Improvements ##
1. Fixed banned players incorrectly appearing with one heart on the leaderboard.
2. Improved message prefix handling and color formatting consistency.
