SMP Lifesteal v1.1.2

---

What is SMP Lifesteal?

SMP Lifesteal is a production-ready Minecraft LifeSteal plugin built for server owners who want a serious heart economy, not a tiny kill/death script.

Players gain and lose lives through PvP, deaths, heart items, revives, rebirths, and admin actions. Staff get clean commands, logs, PlaceholderAPI support, Discord notifications, storage options, migration tools, and protection against common LifeSteal abuse such as duplicated hearts and alt-account farming.

If you run a LifeSteal SMP, hardcore survival server, Donut-like server, PvP survival network, or custom competitive SMP, this plugin gives you the complete core.

---

Core LifeSteal Gameplay

• Kill-based heart gain — attackers can gain lives when they kill players.
• Death-based heart loss — victims can lose lives on player deaths, entity deaths, or natural deaths.
• Configurable death causes — control player kills, projectiles, mobs, tamed animals, natural deaths, and safe regions.
• Life-bans — players who reach the minimum playable life threshold can be life-banned for a configurable duration.
• Automatic unban behavior — configure lives after unban and ban duration behavior.
• First-join protection — protect new players from instantly losing lives while they start playing.
• Health sync — lives apply to player max health through a compatibility-safe health bridge.

---

Heart Item Economy

• /withdraw support — players can withdraw lives into physical heart items.
• Death heart drops — player, entity, and natural death hearts can use different item templates.
• Consumable hearts — players can consume heart items to recover lives.
• Custom item templates — configure material aliases, legacy data, display name, lore, flags, glow, custom model data, stack size, cooldown, and recipe.
• Custom recipes — define shaped recipes for heart items and revive items.
• Anti-rename protection — prevent players from renaming protected custom items in anvils.
• AxAuctions protection — optionally block protected heart items from being sold through AxAuctions.

No resource pack required. Custom model data is supported if you want to add custom textures yourself.

---

Anti-Dupe Protection

LifeSteal servers live or die by heart item integrity. SMP Lifesteal includes a dedicated anti-dupe system instead of trusting item names or lore alone.

• Unique heart identities — heart items are tracked with unique IDs.
• NBT-based item tags — uses NBT item tagging where available.
• Configurable fallback behavior — optional lore fallback when NBT is unavailable.
• Unknown heart handling — deny and confiscate invalid heart items if configured.
• Duplicate heart handling — deny and confiscate duplicated hearts if configured.
• Pending-use cooldown — prevents rapid repeat-use race conditions.
• Staff alerts — notify staff when duplicate or unknown hearts are blocked.

---

Anti-Alt Farming Protection

Alt abuse is one of the most common LifeSteal exploits. SMP Lifesteal includes related-account detection and transfer controls.

• IP-hash identity tracking — detect related accounts without requiring raw IP storage.
• Related kill protection — block life gain between related accounts.
• Related heart-drop protection — block heart drops between related accounts.
• Related heart-use protection — optionally block heart use from related victim transfers.
• Staff notifications — alert staff when related-account abuse is detected.
• Bypass permissions — trusted accounts can bypass anti-alt rules if needed.

---

Rebirth System

Give long-term players a progression loop beyond basic heart stealing.

• /rebirth command — players can rebirth when they meet the configured requirements.
• Permanent max-life increase — rebirth can increase the player's maximum lives.
• Configurable starting lives after rebirth
• Vault money requirement support
• Permission-based rebirth limits — give donors, ranks, or events different caps.
• PlaceholderAPI support — show rebirth status in scoreboards and menus.

---

Revive System

Bring life-banned players back into the server economy with controlled revive items.

• Revive items — configurable revive item template.
• Bind revive target — bind an item to a life-banned player.
• Revive GUI — let players select eligible banned targets through a menu.
• Placement revive — optionally revive the bound target when the item is placed.
• Consume-on-success — control whether revive items are consumed after a successful revive.
• Revive events — developer events for custom integration.

---

Admin Control

• /lives — view your status.
• /lives see [player] — inspect another player's life stats.
• /withdraw [amount] — withdraw hearts into physical items.
• /rebirth — rebirth when eligible.
• /lives set <player|@a> lives|maxlives <amount>
• /lives add <player|@a> lives|maxlives <amount>
• /lives remove <player|@a> lives|maxlives <amount>
• /lives ban <player|@a> [duration] [reason]
• /lives unban <player|@a>
• /lives giveitem <player|@a> Heart-Item [amount]
• /lives convert <source> [--dry-run]
• /lives logs [player]
• /lives cleanup [time]
• /lifesteal admin reload

Bulk target support with @a is included for supported admin actions.

---

Logs and Staff Visibility

• Life logs — track important life, heart, ban, revive, anti-dupe, and anti-alt events.
• Logs GUI — view logs in-game through an inventory menu.
• Console log pages — staff can inspect logs from console.
• Configurable cleanup — remove old logs using configured retention or manual cleanup.
• Discord webhook sink — send important events to Discord.

---

Storage Built for Real Servers

SMP Lifesteal supports simple local servers and larger networks.

• YAML storage — default local files, zero database setup.
• SQLite storage — local SQL database for single-server deployments.
• MySQL storage — remote SQL database for larger setups.
• Local YAML shadow — keep local YAML backup while using SQL.
• SQL fallback — use local YAML when SQL is temporarily unavailable if configured.
• Retry queue — failed writes can be retried instead of silently lost.
• Save queue — batched player-data writes for better runtime stability.
• SQLite WAL mode — better SQLite durability/performance defaults.

---

Cross-Server Network Support

• Redis sync — propagate important state across servers.
• Redis lock service — coordinate cross-server operations.
• Message ID cache — deduplicate cross-server messages.
• Disabled by default — no Redis connection unless you enable it.

---

Folia, Paper, Spigot, Bukkit, Purpur

SMP Lifesteal is built as an all-version Bukkit-family plugin, not a modern-only experiment.

• All Versions support — designed around compatibility bridges instead of hardcoded version logic.
• Folia-aware scheduling — player/entity work, region work, global work, and async work are routed through the scheduler bridge.
• Reflective compatibility — avoids hard dependency on modern-only APIs in legacy paths.
• Java 8 target — suitable for legacy server ecosystems.
• Adventure/MiniMessage text bridge — modern messages with legacy-compatible output boundaries.
• Material and sound alias system — handles legacy and modern names cleanly.

---

Integrations

• PlaceholderAPI — native SMP Lifesteal placeholders.
• ZelSteal placeholder compatibility — existing %zelsteal_*% scoreboard layouts can keep working.
• Vault — optional rebirth economy requirements.
• WorldGuard — region-based behavior hooks.
• AxAuctions — protect heart items from auction abuse.
• Discord webhooks — send deaths, kills, withdraws, rebirths, bans, unbans, anti-dupe, anti-alt, revive, and admin-change notifications.
• Redis — optional cross-server sync.

---

PlaceholderAPI Placeholders

• %smplifesteal_lives% — current lives.
• %smplifesteal_max_lives% — maximum lives.
• %smplifesteal_rebirths% — rebirth count.
• %smplifesteal_can_rebirth% — readable rebirth eligibility.
• %smplifesteal_can_rebirth_raw% — true/false rebirth eligibility.
• %smplifesteal_is_banned% — readable life-ban status.
• %smplifesteal_is_banned_raw% — true/false life-ban status.
• %smplifesteal_remaining_ban_time% — remaining life-ban time.
• %smplifesteal_remaining_first_join_protection% — remaining first-join protection time.
• %smplifesteal_life_hearts% — compatibility life value.
• %smplifesteal_health_points% — max-health value based on lives.
• %smplifesteal_identity_component% — identity component for anti-alt relation logic.

ZelSteal-compatible placeholders are also available:

• %zelsteal_lives%
• %zelsteal_max_lives%
• %zelsteal_rebirths%
• %zelsteal_can_rebirth%
• %zelsteal_is_banned%
• %zelsteal_remaining_ban_time%

---

Migration Tools

Already using another LifeSteal plugin? SMP Lifesteal includes migration paths so you do not have to restart your server economy from zero.

• ZelSteal SQLite import
• ZelSteal MySQL import
• LifestealCore JSON import
• LifestealCore SQLite import
• CSV import
• Manual SQL mapping source
• Dry-run mode — preview imports before applying them.
• Backup/report workflow — safer migration process for production servers.

---

ZelSteal Compatibility Layer

SMP Lifesteal is designed as a clean replacement path for servers coming from ZelSteal-style behavior.

• ZelSteal-style permission aliases — smplifesteal., lifesteal., and zelsteal.* roots are supported.
• ZelSteal-compatible placeholders — keep existing scoreboard/chat layouts with less migration work.
• ZelSteal API shim — plugins using the ZelSteal API package can be supported through the compatibility layer.
• Config import support — includes mapping logic for known ZelSteal config paths.
• Command grammar compatibility — supports familiar /lives-style admin workflows.

---

Developer API and Events

For custom networks and addon developers, SMP Lifesteal exposes API surfaces instead of forcing everything through commands.

• SMPLifestealApi — get player state, set/add lives, set/add max lives, ban/unban, create heart items, read heart IDs, create revive items, and revive players.
• Provider access — access the active API through the provider.
• Life events — listen to life changes, pre-life changes, rebirths, life-bans, heart creation, heart consumption, anti-alt blocks, anti-dupe blocks, revive binding, and revive execution.
• CompletionStage API methods — storage-backed operations can be composed cleanly by external plugins.

---

Configuration Philosophy

Everything important is configurable.

• Default lives and max lives.
• Minimum playable lives.
• Health points per life.
• Ban duration and unban lives.
• Death behavior by player, entity, and natural cause.
• Withdraw limits and item template.
• Rebirth requirements and rewards.
• First-join protection.
• Anti-alt rules.
• Anti-dupe actions.
• Storage backend and fallback strategy.
• Redis sync.
• Discord notifications.
• Sounds.
• Menus.
• Messages with MiniMessage formatting.
• Item templates, recipes, cooldowns, lore, glow, flags, and custom model data.

---

Why Choose SMP Lifesteal?

• Not just kill = heart — full LifeSteal economy with heart items, rebirths, revives, bans, logs, and storage.
• Built for abuse resistance — anti-dupe and anti-alt systems target the two biggest LifeSteal failure modes.
• Built for migration — import from ZelSteal, LifestealCore, CSV, and SQL-based sources.
• Built for networks — MySQL, Redis sync, webhooks, placeholders, and API events.
• Built for compatibility — All Versions support through Bukkit-family compatibility bridges.
• Built for staff — admin commands, bulk operations, logs GUI, cleanup, and Discord alerts.

---

FAQ

What kind of server is this for?
SMP, LifeSteal SMP, PvP survival, hardcore survival, Factions-lite, Donut-like servers, and competitive survival networks.

Does it support All Versions?
Yes. The plugin is designed as an All Versions Bukkit-family LifeSteal plugin with compatibility bridges for legacy and modern server behavior.

Does it support Folia?
Yes. Folia support is handled through scheduler/teleport bridges so entity, region, global, and async work are routed correctly.

Can I migrate from ZelSteal?
Yes. SMP Lifesteal includes ZelSteal SQLite/MySQL import paths, ZelSteal permission aliases, ZelSteal placeholders, and a ZelSteal API shim.

Can I migrate from LifestealCore?
Yes. LifestealCore JSON and SQLite import paths are included.

Can behavior be changed?
Yes. Core lives, max lives, death behavior, anti-alt, anti-dupe, storage, messages, item templates, recipes, sounds, webhooks, menus, and integrations are configurable.

Does it require MySQL?
No. YAML is the default storage mode. SQLite and MySQL are available when you need them.

Does it require Redis?
No. Redis is optional and disabled by default. Use it only when you want cross-server synchronization.

Does it require PlaceholderAPI?
No. PlaceholderAPI is optional, but supported.

---

---

SEO keywords: lifesteal, lifesteal plugin, minecraft lifesteal plugin, lifesteal smp plugin, heartsteal, hearts plugin, heart item plugin, SMP lifesteal, Paper lifesteal, Folia lifesteal, Spigot lifesteal, Bukkit lifesteal, Purpur lifesteal, PlaceholderAPI lifesteal, MySQL lifesteal, SQLite lifesteal, anti-dupe lifesteal, anti-alt lifesteal, ZelSteal alternative, ZelSteal migration, LifestealCore migration.