Banner

LifestealSMP 🔪❤️

LifestealSMP is a highly configurable and fully featured Lifesteal plugin designed for modern Minecraft SMP servers.
It offers a complete hearts-based survival system, revive mechanics, advanced crafting, multi-language support, and full administrative control.

Operation in Minecraft 1.21+

🔧 Core Features

✅ Heart System: Fully configurable heart loss and gain based on deaths, PvP, or environment.
✅ Heart Items: Withdraw hearts into physical items that can be traded or consumed.
✅ Heart Tiers: 5 tiers of heart items allow restoring from +1 up to +5 hearts.
✅ Custom Crafting Recipes: Create your own crafting recipes for heart items and revive beacon.
✅ Revive System: Revive banned players using special Revive Beacons via a chat-based confirmation system.
✅ Rare Revive Beacon Recipe: Uses expensive materials like Netherite Blocks, Nether Stars, Wither Skulls, Enchanted Golden Apples & Totems.
✅ Ban System: Players get automatically banned upon reaching 0 hearts.
✅ Admin Control: Powerful /lifestealadmin system with full server control.
✅ Command Hiding: Commands are hidden dynamically for players without permission.
✅ Database Support: MySQL and SQLite database options for scalable player data.
✅ Multi-Language Support: Fully translatable through external language files.
✅ Configuration Reloading: Reload configuration and language files live using /reloadlifesteal.
✅ Safe Bukkit API Design: Compatible with Bukkit, Spigot, Paper & Purpur.
✅ Recipe viewer: Players can explore available recipes through an interactive inventory GUI.
✅ Revenge system: The Revenge Thread system gives defeated players an opportunity to retaliate.
✅ Anti-farming protection system: Prevent players from repeatedly farming one another for hearts.

🎯 Commands

Main Commands:

Command	Description	Permission
`/withdrawheart`	Withdraw one heart into a physical item	`lifesteal.withdraw`
`/withdrawheart <amount>`	Withdraw multiple hearts in one command	`lifesteal.withdraw`
`/recipeview`	Open the recipe overview	`lifesteal.recipeview`
`/recipeview heart`	Browse heart crafting recipes	`lifesteal.recipeview`
`/recipeview heart <tier>`	View a specific heart-tier recipe	`lifesteal.recipeview`
`/recipeview beacon`	View the Revive Beacon recipe	`lifesteal.recipeview`
`/recipeview all`	Open the complete recipe overview	`lifesteal.recipeview`
`/reloadlifesteal`	Reload plugin configuration and language data	`lifesteal.reload`

Admin Subcommands (`/lifestealadmin`)

Subcommand	Description
`set <player> <amount>`	Set hearts
`add <player> <amount>`	Add hearts
`remove <player> <amount>`	Remove hearts
`giveheart <player> [tier] [amount]`	Give heart items (Tier 1-5)
`revivebeacon <player>`	Give Revive Beacon
`unban <player>`	Unban player
`purgebans`	Unban everyone
`setmax <amount>`	Set maximum hearts
`resetall`	Reset hearts for all players
`banlist`	List all banned players
`reload`	Reload config & language

🎯 Permissions

Permission	Description	Default
`lifesteal.admin`	Grants access to Lifesteal administrative commands	`OP`
`lifesteal.reload`	Allows plugin configuration and language reloads	`OP`
`lifesteal.withdraw`	Allows players to withdraw hearts into items	`true`
`lifesteal.revive`	Allows players to activate Revive Beacons	`true`
`lifesteal.recipeview`	Allows access to the recipe viewer	`true`
`lifesteal.bypasslimit`	Bypasses selected gameplay-limit checks without violating the hard heart-storage cap	`OP`

🔁 PlaceholderAPI Support

LifestealSMP includes built-in PlaceholderAPI expansion for dynamic integration with scoreboards, tab lists, nametags, holograms, and other placeholder-compatible systems. You can display player-specific data across your server in real-time.

Placeholder	Description
`%lifesteal_hearts%`	Shows the player’s current heart count. Returns an empty value when the player’s heart data is unavailable.
`%lifesteal_hearts_left%`	Shows how many additional hearts the player can gain before reaching the configured maximum.
`%lifesteal_max_hearts%`	Returns the configured maximum heart count.
`%lifesteal_starting_hearts%`	Returns the configured starting heart count for new players.
`%lifesteal_online_count%`	Displays the current number of online players.
`%lifesteal_database_connected%`	Returns `"true"` or `"false"` depending on whether the configured database backend is connected.
`%lifesteal_database_type%`	Displays the active database backend, such as `"mysql"` or `"sqlite"`.
`%lifesteal_language%`	Displays the currently active language code, such as `"en"`, `"de"`, or `"es"`.
`%lifesteal_prefix%`	Inserts the plugin’s configured and color-formatted message prefix.
`%lifesteal_online%`	Returns `"true"` or `"false"` depending on whether the requested player is currently online.
`%lifesteal_banned%`	Returns `"true"` or `"false"` depending on whether the player is Lifesteal-banned.
`%lifesteal_ban_reason%`	Displays the player’s Lifesteal ban reason when available.
`%lifesteal_revenge_active%`	Returns `"yes"` or `"no"` depending on whether the player currently has an active Revenge Thread.
`%lifesteal_revenge_target%`	Displays the username of the player’s current Revenge Thread target. Returns an empty value when no target exists.
`%lifesteal_revenge_time_left%`	Displays the remaining Revenge Thread duration in a readable format, such as `"2m 14s"`.
`%lifesteal_revenge_time_left_seconds%`	Returns the remaining Revenge Thread duration as a whole number of seconds.
`%lifesteal_revenge_progress%`	Returns the Revenge Thread progress as a percentage from `0` to `100`.

These placeholders allow server owners and developers to deeply customize their user experience, creating rich, dynamic interfaces that reflect each player's lifesteal status in real-time.