LifeSteal Lite

LifeSteal Lite is a lightweight, performance-focused plugin designed for SMP servers. It brings the popular "steal hearts on kill" mechanic without the bloat of databases or complex setups.

<div align="center"> <img src="https://cdn.modrinth.com/data/cached_images/105f69463e82a336937c8bf7e98fdbc9db89dc20.png" alt="Crafting Recipe Example" /> </div>

⚡ Features

* 🛡️ Anti-Abuse: Zero database requirements. Uses native Minecraft files for maximum speed. * 🛡️ Anti-Abuse: Kill players to gain hearts, lose hearts on death. * 🛡️ Anti-Abuse: Fully configurable crafting recipes for Heart Capsules (via `config.yml`). * 🛡️ Anti-Abuse: Automatically bans players when they run out of hearts using the vanilla ban system. * 🛡️ Anti-Abuse: Configurable ban duration with live countdown timer on login attempt. * 🛡️ Anti-Abuse: Farming prevention system to stop players from exploiting kills.

<div align="center"> <img src="https://cdn.modrinth.com/data/cached_images/d8e56f8c85d88d4002c8083c13fb0190809d151e.png" alt="LifeSteal Gameplay" /> </div>

---

📜 Commands

| Command | Description | Permission | | :--- | :--- | :--- | | `/ls withdraw <amount>` | Withdraw hearts into physical items. | `lifesteal.use` | | `/ls give <player> <amount>` | Give heart items to a player. | `lifesteal.admin` | | `/ls reset <player>` | Reset a player's health to default. | `lifesteal.admin` | | `/ls unban <player>` | Unban a player and restore their hearts. | `lifesteal.admin` | | `/ls purgebans` | Unban everyone (Server Wipe). | `lifesteal.admin` | | `/ls recipe` | Toggle the crafting recipe on/off instantly. | `lifesteal.admin` | | `/ls reload` | Reload the configuration file. | `lifesteal.admin` |

📸 Preview

---

🔧 Config

Everything is customizable! You can change: * Starting hearts & Max hearts. * Ban duration & Ban messages. * Crafting recipe shape & ingredients. * Heart item name & material.

Ready to start your SMP? Download LifeSteal Lite now!

📜 Default Config

<details> <summary>Click to view config.yml</summary>

```yaml

-----------------------------------------------------------------------------

LifeSteal Lite - Configuration File

A lightweight, performance-focused heart system designed to preserve the vanilla feel.

-----------------------------------------------------------------------------

settings:

The number of hearts a new player starts with. (1 Heart = 2 HP)

starting-hearts: 10

The maximum number of hearts a player can achieve.

Players cannot use heart items if they reach this limit.

max-hearts: 20

The minimum number of hearts a player can drop to.

Players cannot withdraw hearts if it would put them below this limit.

min-hearts: 1

What action should be taken when a player loses all their hearts (or reaches the min limit)?

Options:

NONE - Nothing happens (Vanilla behavior).

BAN - The player is banned for the duration specified below.

SPECTATOR - The player is put into spectator mode.

min-health-action: NONE

If 'BAN' is selected above, how many minutes should the ban last?

ban-duration-minutes: 60

-----------------------------------------------------------------------------

Crafting System (Dynamic)

-----------------------------------------------------------------------------

recipe:

Enable or disable the crafting recipe for Heart Capsules.

enabled: true

The crafting shape (3 lines).

Use characters to represent items defined in the 'ingredients' section below.

Space " " counts as an empty slot.

shape: - "DGD" - "GTG" - "DGD"

Define what item each character represents.

Use valid Bukkit Material names (e.g., DIAMOND_BLOCK, TOTEM_OF_UNDYING, NETHERITE_INGOT).

ingredients: T: TOTEM_OF_UNDYING D: DIAMOND_BLOCK G: GOLD_BLOCK

-----------------------------------------------------------------------------

Gameplay Mechanics

-----------------------------------------------------------------------------

gameplay:

If true, players will lose a heart from environmental deaths (lava, fall damage, drowning).

If false, players only lose hearts when killed by another player (PvP).

environment-heart-loss: false

If true, players drop their inventory when they die (Vanilla style).

If false, keep-inventory is enabled for deaths.

drop-items-on-death: true

Security measure to prevent players from killing the same player repeatedly to farm hearts.

prevent-farming: true

The cooldown time (in seconds) before a player can gain a heart from the same victim again.

farm-cooldown-seconds: 300

-----------------------------------------------------------------------------

Item Customization

-----------------------------------------------------------------------------

item:

The display name of the heart item. Supports color codes (&).

heart-item-name: "&c&lHeart Capsule"

The material of the heart item. (e.g., RED_DYE, NETHER_STAR, APPLE)

heart-item-material: RED_DYE

Should the item have an enchantment glow effect?

heart-item-glow: true

-----------------------------------------------------------------------------

Language & Messages

Supports legacy color codes (&a, &c, &l, etc.)

-----------------------------------------------------------------------------

messages:

Gameplay Messages

heart-gained: "&a[+1 Heart] &7You defeated an opponent!" heart-lost: "&c[-1 Heart] &7You lost a heart..." withdraw-success: "&aHeart withdrawn successfully!" withdraw-fail: "&cYou do not have enough health to withdraw!" max-hearts-reached: "&eYou have reached the maximum heart limit."

BAN Messages

ban-reason: "&c&lGAME OVERnn&7Your final heartbeat has faded into the void.nThe LifeSteal curse has consumed your soul.nn&cYou are no longer welcome among the living." ban-remaining: "&e&lRemaining Time: &f{time}"

Admin & Error Messages

no-permission: "&cYou don't have permission to do this." player-not-found: "&cPlayer not found." reload-success: "&aConfiguration reloaded successfully!" reset-success: "&aPlayer's health has been reset to default." give-success: "&aYou gave {amount} heart(s) to {player}." give-received: "&aYou received {amount} heart(s) from an admin!"

Unban & Purge Messages

unban-success: "&aPlayer {player} has been unbanned." unban-fail: "&cCould not unban {player}. Are they banned?" purge-success: "&aAll bans have been purged! Everyone can join."

Recipe Toggle Messages

recipe-enabled: "&aHeart crafting recipe has been ENABLED!" recipe-disabled: "&cHeart crafting recipe has been DISABLED!"

Help Menu

help-header: "&8&m--------&c LifeSteal Lite &8&m--------" help-withdraw: "&7/ls withdraw <amount> &8- &fWithdraw hearts." help-give: "&7/ls give <player> <amount> &8- &fGive heart items (Admin)." help-reset: "&7/ls reset <player> &8- &fReset player's health (Admin)." help-unban: "&7/ls unban <player> &8- &fUnban a specific player (Admin)." help-purgebans: "&7/ls purgebans &8- &fUnban everyone (Admin)." help-recipe: "&7/ls recipe &8- &fToggle crafting recipe (Admin)." help-reload: "&7/ls reload &8- &fReload config (Admin)."