EzLifesteal

A full-featured lifesteal plugin for Minecraft built for Paper servers. EzLifesteal gives server owners precise control over heart gain and loss, a complete heart item economy, seasonal resets, anti-abuse systems, and a revive beacon subsystem - all in one lightweight, highly configurable jar.

Gameplay Features

• Per-world heart rules - set default, minimum, and maximum hearts; configure kill rewards and death penalties; choose zero-heart ban or respawn behaviour; define per-world overrides in lifesteal-worlds.yml.
• Mob heart drops - let mobs drop hearts on death with per-entity permission nodes and world allow/deny lists.
• Kill streak rewards - trigger money payouts (Vault), console commands, item grants, and server broadcasts at configurable milestone streaks.
• Heart item economy - physical heart objects with custom materials, textures, and optional NBT. Players give, trade, auction, or consume them to gain hearts. Configured in hearts.yml.
• Heart shop - configurable shop GUI where players can spend in-game currency on hearts.
• Combat logout protection - tags PvP sessions for a configurable window and punishes quitters so duels stay fair.
• Leaderboards & overlays - action-bar / boss-bar overlays, a self-updating /lifesteal hologram place leaderboard, /lifesteal top rankings, and live PlaceholderAPI data for scoreboards.
• Smurf detection - monitors farm loops and rotating kill rings; alerts staff holding lifesteal.alert; stores full history for review.
• Admin controls - define staff by ops, permission node, UUID, or name; optionally bypass heart gain or loss for admins; smurf alerts can be kept admin-only.
• Seasonal resets - install EzSeasons for automated season scheduling, countdown broadcasts, and automatic heart resets. No extra bridge jars required.
• 8 built-in translations - English, German, Spanish, French, Dutch, Portuguese, Russian, and Chinese. All messages editable in languages/<locale>.yml.

Revive Beacon

Banned players can be restored by a teammate who right-clicks a beacon block with a configurable voucher item.

• Whitelist existing beacons with /lifesteal beacon add, or let the plugin place and manage beacons automatically.
• Beacon spawn subsystem - places BEACON blocks at random or specified coordinates on a schedule or on demand.
• Full lifecycle: placement → optional WorldGuard protection region → optional EzCountdown warm-up timer → available → auto-expiry.
• When a beacon becomes claimable, the plugin fires a server-wide broadcast, title overlay, particles, and fireworks - fully configurable under revive-beacon.spawn.availability-event. -- Beacon commands: /beacon spawn [world x y z], /beacon despawn <id|all>, /beacon spawns.

Screenshots

Heart Objects

Physical heart items that players can hold, trade, and consume to gain hearts.

• Define any number of heart tiers in hearts.yml with custom materials, player head textures, and optional NBT data.
• Use /lifesteal giveheart <player> <id|tier> [amount] to hand them out. Items drop at the player's feet if inventory is full.
• Use cases: loot drops on kill, auction-house trading, rare collectible hearts, heart-based economy.

Optional Integrations

EzLifesteal runs standalone. All integrations are soft dependencies, the plugin starts normally if any of them are absent.

Integration	Purpose
PlaceholderAPI	Player and leaderboard placeholders for scoreboards, tab lists, and other plugins
Vault	Economy payouts for kill streak rewards
EzSeasons	Automated season scheduling and heart resets
WorldGuard	Protection region around each plugin-spawned beacon
EzCountdown	Visible countdown timer during beacon warm-up (falls back to built-in Bukkit task)
TeamsAPI	Skip heart transfers between teammates (team-kill-bypass-with-teams-api in lifesteal-core.yml)

Configuration Presets

Casual SMP

Raise the heart floor and disable zero-heart bans so everyone keeps playing.

# lifesteal-core.yml
default-hearts: 12.0
min-hearts: 6.0
max-hearts: 30.0
hearts-per-kill: 1.0
hearts-lost-on-death: 1.0
ban-when-zero-hearts: false

Hardcore Grind

Every fight counts - lose two hearts on death, gain half a heart on kills, with tougher rules in the Nether.

# lifesteal-core.yml
default-hearts: 8.0
min-hearts: 1.0
max-hearts: 16.0
hearts-per-kill: 0.5
hearts-lost-on-death: 2.0
ban-when-zero-hearts: true

# lifesteal-worlds.yml
world-overrides:
  world_nether:
    hearts-per-kill: 0.25
    hearts-lost-on-death: 3.0

PlaceholderAPI Placeholders

Install PlaceholderAPI and the expansion registers automatically.

• %ezlifesteal_hearts% / %ezlifesteal_current_hearts% - stored heart count for a player.
• %ezlifesteal_default_hearts%, %ezlifesteal_min_hearts%, %ezlifesteal_max_hearts%
• %ezlifesteal_top_<n>_hearts%, %ezlifesteal_top_<n>_current_hearts%, %ezlifesteal_top_<n>_name%, %ezlifesteal_top_<n>_uuid%

Commands & Permissions

Scope	Examples
Player	/lifesteal, /lifesteal top, /lifesteal transfer, /lifesteal shop
Staff	/lifesteal give, /lifesteal revive, /lifesteal reload, /lifesteal test
Beacon	`/beacon add

Permission bundles: lifesteal.player · lifesteal.mod · lifesteal.admin

See the full Commands reference and Permissions list.

Storage & Reliability

• YAML (default) - one file per player at data/players/<uuid>.yml; auto-migrates legacy players.yml on first load.
• MySQL - table created on startup using ON DUPLICATE KEY UPDATE for safe concurrent saves.
• All I/O runs off the main thread. Use /lifesteal reload to switch backends without restarting.

Quick Start

1. Place the jar in your server's plugins/ folder and start the server.
2. Pick YAML or MYSQL storage in storage.yml, set your language in config.yml, and tune heart rules in lifesteal-core.yml.
3. Configure world overrides in lifesteal-worlds.yml and overlays in features.yml. Install EzSeasons if you want season resets.
4. Review admin.yml to define staff and bypass rules.
5. Use /lifesteal reload after config changes. Run /lifesteal test <kill|death> to validate flows before going live.

---

Need help or want to request a feature? Join our Discord. Source: GitHub repository