LStealR by Sadzz

LStealR
LStealR is a lightweight, high-performance Lifesteal core built from the ground up for Paper, Purpur, and Leaf 1.21+ servers. Designed to handle high-traffic PvP environments without TPS drops, it combines fluid heart-stealing mechanics with built-in exploit prevention and anti-alt protections that most other lifesteal plugins leave unaddressed.

Core Mechanics

• Fluid Heart Stealing: Players gain hearts on PvP kills and lose them on death. Natural death penalties (fall damage, void, mobs) can be toggled independently from PvP deaths.
• Configurable Limits: Define default starting hearts, minimum elimination thresholds, and maximum health caps.
• Rank-Based Heart Limits: Grant donor ranks higher maximum heart caps dynamically using permission nodes (lstealr.maxhearts.<amount>).
• Elimination System: Players reduced to zero hearts are eliminated and temporarily banned for a configurable duration (default 24 hours).
• Heart Withdrawal: Players can convert their active health into physical items via /withdraw [amount]. Includes safeguards preventing players from accidentally withdrawing their final heart.

Anti-Alt & Exploit Prevention Engine
Public Lifesteal servers often suffer from players farming their own alternate accounts to gain free hearts. LStealR includes a dedicated anti-alt subsystem configurable directly in-game:

• Same-IP Detection: Prevents heart transfers between accounts sharing the same IP address.
• Victim Cooldowns: Restricts killers from repeatedly gaining hearts from the same target within a set window.
• Daily Target Kill Limits: Caps the maximum number of hearts a killer can take from a specific player per day.
• Minimum Playtime Requirement: Victims must have logged a minimum amount of active server playtime before their deaths drop or transfer hearts.
• Duplication Safeguards: Heart and beacon items are strictly protected against item frame dupes, anvil renaming exploits, grindstones, and illegal recipe crafting matrices.

Custom Items & Revive System

• Heart of the Fallen: A physical textured head item bound by persistent data containers. Right-clicking redeems the heart directly into the player's max health pool.
• Revive Beacon: A special item used in tandem with /revive <player> to bring eliminated teammates back to life.
• Configurable Revive Parameters: Control whether beacons are consumed on use, the starting health of revived players, player revive cooldowns, and the maximum number of revives allowed per life.

Interactive Information GUI
Players can run /lsr info (or /lsr without admin permissions) to open a clean chest interface displaying:

• Real-time personal statistics (current hearts, max hearts, hearts stolen, lost, and consumed, kills, and deaths).
• Interactive visual recipe displays for the Heart item and Revive Beacon.
• Server rules and heart withdrawal requirements.

Commands
Player Commands

• /lsr or /lsr info - Opens the interactive LStealR information and recipe GUI.
• /withdraw <amount> - Withdraws active hearts into physical items.
• /revive <player> - Revives an eliminated player using a Revive Beacon.

Admin Commands (lstealr.admin)

• /lsr reload - Reloads config.yml.
• /lsr set <player> <hearts> - Sets a player's exact heart count.
• /lsr add <player> <hearts> - Adds hearts to a player.
• /lsr remove <player> <hearts> - Removes hearts from a player.
• /lsr giveheart <player> [amount] - Spawns Heart of the Fallen items directly.
• /lsr giverevive <player> [amount] - Spawns Revive Beacon items directly.
• /lsr setmax <hearts> - Updates the global maximum heart limit.
• /lsr setwithdraw <minutes> - Changes the minimum withdrawal playtime requirement.
• /lsr antialt - Opens the interactive anti-alt configuration interface in chat.

Permissions

• lstealr.admin - Grants access to all administrative commands (default: op).
• lstealr.withdraw - Allows players to use /withdraw (default: true).
• lstealr.revive - Allows players to use /revive (default: true).
• lstealr.bypass.withdraw-playtime - Bypasses the minimum playtime requirement for heart withdrawal.
• lstealr.bypass.loss - Prevents the player from losing hearts on death.
• lstealr.bypass.elimination - Prevents the player from being tempbanned upon reaching 0 hearts.
• lstealr.bypass.anti-alt - Bypasses anti-alt checks.
• lstealr.maxhearts.<amount> - Sets custom maximum heart caps per rank (LuckPerms compatible).

PlaceholderAPI Integration
The plugin registers the %lstealr% expansion with comprehensive player and server metrics:

Player Placeholders

• %lstealr_hearts% - Current hearts.
• %lstealr_max_hearts% - Maximum heart cap for the player.
• %lstealr_hearts_collected% - Total hearts stolen via kills.
• %lstealr_hearts_lost% - Total hearts lost on death.
• %lstealr_hearts_consumed% - Total heart items redeemed.
• %lstealr_kills% - Tracked lifesteal kills.
• %lstealr_deaths% - Tracked lifesteal deaths.

Server-Wide Placeholders

• %lstealr_server_total_gained% - Total hearts gained across the entire server.
• %lstealr_server_total_lost% - Total hearts lost server-wide.
• %lstealr_server_total_consumed% - Total heart items consumed server-wide.
• %lstealr_server_total_kills% - Total server kills.
• %lstealr_server_total_deaths% - Total server deaths.
• %lstealr_server_total_eliminations% - Total eliminations issued.

Technical Requirements

• Server Software: Paper, Purpur, or Leaf 1.21+
• Java Version: Java 21 or higher
• Optional Dependencies: PlaceholderAPI, LuckPerms, Vault