---

🔑 License

This plugin requires a valid license key to run.
Without a valid key, the plugin will refuse to enable.

License Key: 25Z8VM-UGXHD5

Enter your key in config.yml under license.key before starting your server.
To purchase additional license keys, visit dxlifesteal.dev.

---

✨ What is DxLifeStealCore?

DxLifeStealCore is a feature-rich, SMP-ready LifeSteal plugin built for competitive Minecraft servers. It goes far beyond basic heart stealing — with tiered heart items, cinematic elimination effects, a full revive system, server events, Discord webhook integration, kill streaks, and a paginated revive GUI.

Whether you're running a public LifeSteal SMP or a private friend group server, DxLifeStealCore gives you complete control over every mechanic.

---

💡 Core Features

❤ Heart System

• Players start with a configurable number of hearts (default: 10)
• Killing a player steals hearts from the victim and gives them to the killer
• Hearts have a configurable minimum and maximum — players can grow up to 20 hearts!
• Steal chance is configurable — make it 100% or add RNG
• Optional heart loss on mob death or natural death
• Per-world heart settings support — different heart caps per world
• Heart economy: withdraw hearts to items, deposit items back, pay hearts to other players

🎴 Tiered Heart Items

Three tiers of craftable heart consumables, each with unique designs, lore, and effects:

Item	Tier	Hearts	Rarity	Recipe Center
❤ Heart Shard	Tier I	+1 ❤	Common	Nether Star + Golden Swords
💎 Heart Crystal	Tier II	+2 ❤❤	Rare	Diamond Blocks + End Crystal
✦ Heart Gem	Tier III	+3 ❤❤❤	Legendary	Emerald Blocks + Netherite Block

Plus the classic Stolen Heart (craftable with Gold Blocks, Nether Stars & Beacon) and the Heart Shield (Totem of Undying + Ghast Tears + Diamond Block) that blocks one heart loss on death.

⚰ Elimination System

When a player's hearts reach zero, they are eliminated. Choose from four elimination modes:

• BAN — Temporarily bans the player for a configurable duration (e.g. 3d, 12h)
• SPECTATOR — Converts the player to spectator mode
• KICK — Kicks the player from the server
• COMMAND — Executes a custom console command on elimination

Elimination comes with cinematic effects — a dark particle tornado, lava drips, skull cracks, wither sounds, and a dramatic death firework. The killer gets a golden sparkle celebration with victory fireworks and sounds.

🔄 Revive System

Eliminated players can be brought back by spending hearts:

• Configurable cost in hearts to revive (default: 5)
• Works for online and offline players
• Revive immunity after being revived — brief grace period
• Revive Book — craftable item (Emerald Blocks + Totems + Written Book)
• Paginated Revive GUI — browse up to 45 eliminated players per page with skull heads, status info, and one-click reviving
• Global toggle to enable/disable revives without restarting
• Server-wide broadcast on successful revive
• Discord webhook notification on revive

🔥 Kill Streak Bonuses

Players on a killing streak earn bonus hearts:

Kill Streak	Bonus Hearts
3 kills	+1 ❤
5 kills	+2 ❤❤
10 kills	+3 ❤❤❤

Streak thresholds and rewards are fully configurable.

🎉 Server Events

Activate limited-time events with a single command:

• Double Hearts Event — All heart gains are multiplied. Comes with a live BossBar countdown visible to all players.
• Heart Rain Event — All online players receive free hearts at a set interval for the event duration.

Events are started/stopped with /dxlifesteal event and run on a background task ticker.

📊 Leaderboards

Full leaderboard support with /dxlifesteal top:

• Sort by hearts, kills, deaths, or eliminations
• Configurable leaderboard size
• Auto-refresh interval for live ranking updates

🔗 Discord Webhook Integration

Get notified in your Discord server for key events:

• Player killed (heart stolen)
• Player death
• Player eliminated
• Player revived

Enable and configure via config.yml — just plug in your webhook URL.

📦 PlaceholderAPI Support

Full PAPI integration with the %dxls_<placeholder>% prefix:

Placeholder	Description
%dxls_hearts%	Current hearts
%dxls_max_hearts%	Max hearts
%dxls_kills%	Total kills
%dxls_deaths%	Total deaths
%dxls_eliminations%	Total eliminations
%dxls_streak%	Current kill streak
%dxls_best_streak%	Best kill streak ever
%dxls_status%	Active / Eliminated / Frozen / Bypassed
%dxls_is_eliminated%	true / false
%dxls_event_double%	Double hearts event active?
%dxls_event_rain%	Heart rain event active?

---

🛠 Commands

Command	Description	Permission
/dxlifesteal help	Show help menu	—
/dxlifesteal status [player]	View heart stats	dxlifesteal.status
/dxlifesteal top [type]	View leaderboard	dxlifesteal.top
/dxlifesteal withdraw <amount>	Withdraw hearts to item	dxlifesteal.withdraw
/dxlifesteal deposit	Deposit heart items	dxlifesteal.deposit
/dxlifesteal pay <player> <amount>	Pay hearts to player	dxlifesteal.pay
/dxlifesteal streak [player]	View kill streak	dxlifesteal.streak
/dxlifesteal revive <player>	Revive eliminated player	dxlifesteal.revive
/dxlifesteal set <player> <amount>	Set player hearts	dxlifesteal.set
/dxlifesteal add <player> <amount>	Add hearts to player	dxlifesteal.add
/dxlifesteal remove <player> <amount>	Remove hearts	dxlifesteal.remove
/dxlifesteal eliminate <player>	Force eliminate player	dxlifesteal.eliminate
/dxlifesteal freeze <player>	Freeze/unfreeze player	dxlifesteal.freeze
/dxlifesteal giveitem <player> <item> <amount>	Give heart item	dxlifesteal.giveitem
/dxlifesteal event <type> <duration>	Start/stop events	dxlifesteal.event
/dxlifesteal reload	Reload plugin	dxlifesteal.reload
/dxlifesteal backup	Backup player data	dxlifesteal.backup
/dxlifesteal inspect <player>	Inspect player data	dxlifesteal.inspect

Aliases: /dxls, /lsc, /lifesteal

---

🔐 Permissions

Permission	Default	Description
dxlifesteal.admin	OP	Full admin access (inherits all below)
dxlifesteal.status	All	Check heart status
dxlifesteal.withdraw	All	Withdraw hearts
dxlifesteal.deposit	All	Deposit heart items
dxlifesteal.pay	All	Pay hearts to others
dxlifesteal.top	All	View leaderboards
dxlifesteal.streak	All	View kill streaks
dxlifesteal.recipes	All	View recipes GUI
dxlifesteal.bypass	OP	Bypass heart steal
dxlifesteal.multiplier.2x	false	2x heart steal (VIP)
dxlifesteal.multiplier.3x	false	3x heart steal (VIP)
dxlifesteal.maxhearts.bonus	false	Bonus max hearts (VIP)

---

⚙ Configuration Highlights

hearts:
  starting: 10       # Starting hearts for new players
  minimum: 2         # Can never go below this
  maximum: 20        # Cap on max hearts
  steal-amount: 1    # Hearts stolen per kill
  steal-chance: 100  # % chance to steal (RNG support)
  pvp-only: true     # Only steal in PvP kills

elimination:
  mode: BAN          # BAN / SPECTATOR / KICK / COMMAND
  ban-duration: "3d" # Supports d, h, m

revive:
  enabled: true
  cost-hearts: 5
  immunity-seconds: 30

streak:
  enabled: true
  rewards:
    3: 1   # 3 kills = +1 heart
    5: 2
    10: 3

---

📥 Installation

1. Drop DxLifeStealCore.jar into your /plugins folder
2. Start the server once to generate config.yml
3. Open config.yml and set your license key:

   license:
     key: "25Z8VM-UGXHD5"
   

4. Configure hearts, elimination mode, revive settings, and Discord webhook as desired
5. Restart the server — you're good to go!

Soft Dependencies: PlaceholderAPI (optional), Vault (optional)

---

🧩 Compatibility

Server Software	Supported
Paper 1.20–1.21.x	✅
Spigot 1.20–1.21.x	✅
Purpur	✅
Folia	❌

Requires Java 17 or higher.

---

📜 Data & Storage

• YML-based per-player data storage — no database setup required
• Auto-save every minute (configurable)
• Full backup and export command support
• Kill, death, steal, elimination, and revive history logging per player

---