MaxHearts

MaxHearts is a fully-featured heart management system for Paper/Spigot servers.
It permanently adjusts a player’s true maximum health attribute (not just temporary effects), so hearts display correctly on the HUD, persist across sessions, and work with any survival or RPG server.

Every feature in MaxHearts is fully configurable.
You can run it as a lightweight “set/give/take hearts” plugin, or enable its advanced systems like lifesteal, traps, revive tokens, combat tagging, Vault purchasing, and more.

All features work together seamlessly — or you can toggle off anything you don’t want. You'll want to visit the config.yml file on this one.

---

Features

Core Heart System

• Set, give, take, donate, transfer, or withdraw hearts
• Supports offline players, UUID-based storage, and custom floors/limits
• Persistent values survive restarts, deaths, and relogs

Lifesteal (Multiple Layers)

• Basic PvP lifesteal
• Projectile lifesteal (toggleable)
• Tamed-mob lifesteal (toggleable)
• Trap Lifesteal: TNT, lava traps, and falling pointed dripstone properly credit the true killer
• Full cooldown, per-day cap, opt-out bypass, and permission controls

Death Penalties

• Configurable heart loss on death
• Floor actions: block / kick / ban / clamp
• Supports “Last Stand” style plugins without conflict
• Offline-safe — pending heart changes apply cleanly on next login

Revive System

• Craftable Revive Token (fully configurable recipe, name, lore, model data)
• Required or optional for reviving banned players
• Prevents item duping/spoofing via PDC tagging
• Restores players from MaxHearts bans with configurable heart amount

Economy Integration (Vault)

• Players can buy hearts using money
• Supports flat or progressive pricing
• Daily caps & cooldowns
• Works through commands, menus, shops, or NPCs

Heart Items

• Configurable Heart Shard crafting
• Configurable Heart Item consumable for gaining hearts
• Optional Survival-only use
• Custom display name, lore, and model data

Combat Tagging

• Lightweight combat tagging system
• Chat notifications for entering & leaving combat
• Optional PvP logout protection
• Fully configurable timing & messages

Offline & Scale-Safe

• No database required
• Efficient UUID/YAML storage
• Safe for large servers
• Auto-cleans old daily counters
• Compatible with last stand plugins

---

Why MaxHearts?

• Extremely customizable — every feature can be toggled independently
• Zero dependencies required (Vault & PAPI optional)
• Offline-player support by default
• Perfect for survival, hardcore, lifesteal SMPs, factions, RPG, and quest servers
• Lightweight and easy to integrate with other plugins, datapacks, or scripts

---

Commands & Permissions

Command	Permission	Description
/maxhearts set <player> <hearts>	maxhearts.set	Set a player’s hearts
/maxhearts give <player> <amount>	maxhearts.give	Give hearts
/maxhearts take <player> <amount>	maxhearts.take	Remove hearts
/maxhearts donate <player> <amount>	maxhearts.donate	Donate hearts
/maxhearts transfer <from> <to> <amount>	maxhearts.transfer	Transfer hearts between players
/maxhearts withdraw <amount>	maxhearts.withdraw	Turn hearts into a shard item
/maxhearts revive <player> [hearts]	maxhearts.revive	Revive & unban a player (requires token if enabled)
/maxhearts buy <amount>	maxhearts.buy	Buy hearts with Vault
/maxhearts lifesteal on/off	maxhearts.lifesteal	Toggle lifesteal participation
/maxhearts combat	maxhearts.combat	Check remaining combat tag time

Default: OPs have all permissions. All permissions are configurable.

---

Installation

1. Place MaxHearts.jar into your plugins/ folder
2. Restart the server
3. Edit config.yml to enable or disable whichever systems you want
4. Use /maxhearts commands to begin managing hearts

---

Notes

• Works on Paper/Spigot 1.21.x
• Requires Java 21+
• Safe for upgrades from older versions (missing config keys regenerate automatically)
• Fully compatible with combat, sleep, RPG, and hardcore plugins
• Will add SQL support in a future update