# MaxHearts<\/p>\n
MaxHearts is a fully-featured heart management system for Paper\/Spigot servers.
\nIt permanently adjusts a player\u2019s 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.<\/p>\n
Every feature in MaxHearts is fully configurable.
\nYou can run it as a lightweight \u201cset\/give\/take hearts\u201d plugin, or enable its advanced systems like lifesteal, traps, revive tokens, combat tagging, Vault purchasing, and more.<\/p>\n
All features work together seamlessly \u2014 or you can toggle off anything you don\u2019t want. You’ll want to visit the config.yml file on this one.<\/p>\n
<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Core Heart System
\n– Set, give, take, donate, transfer, or withdraw hearts
\n– Supports offline players, UUID-based storage, and custom floors\/limits
\n– Persistent values survive restarts, deaths, and relogs<\/p>\n
### Lifesteal (Multiple Layers)
\n– Basic PvP lifesteal
\n– Projectile lifesteal (toggleable)
\n– Tamed-mob lifesteal (toggleable)
\n– **Trap Lifesteal:** TNT, lava traps, and falling pointed dripstone properly credit the true killer
\n– Full cooldown, per-day cap, opt-out bypass, and permission controls<\/p>\n
### Death Penalties
\n– Configurable heart loss on death
\n– Floor actions: block \/ kick \/ ban \/ clamp
\n– Supports \u201cLast Stand\u201d style plugins without conflict
\n– Offline-safe \u2014 pending heart changes apply cleanly on next login<\/p>\n
### Revive System
\n– Craftable **Revive Token** (fully configurable recipe, name, lore, model data)
\n– Required or optional for reviving banned players
\n– Prevents item duping\/spoofing via PDC tagging
\n– Restores players from MaxHearts bans with configurable heart amount<\/p>\n
### Economy Integration (Vault)
\n– Players can buy hearts using money
\n– Supports flat or progressive pricing
\n– Daily caps & cooldowns
\n– Works through commands, menus, shops, or NPCs<\/p>\n
### Heart Items
\n– Configurable **Heart Shard** crafting
\n– Configurable **Heart Item** consumable for gaining hearts
\n– Optional Survival-only use
\n– Custom display name, lore, and model data<\/p>\n
### Combat Tagging
\n– Lightweight combat tagging system
\n– Chat notifications for entering & leaving combat
\n– Optional PvP logout protection
\n– Fully configurable timing & messages<\/p>\n
### Offline & Scale-Safe
\n– No database required
\n– Efficient UUID\/YAML storage
\n– Safe for large servers
\n– Auto-cleans old daily counters
\n– Compatible with last stand plugins<\/p>\n
—<\/p>\n
## Why MaxHearts?<\/p>\n
– Extremely customizable \u2014 every feature can be toggled independently
\n– Zero dependencies required (Vault & PAPI optional)
\n– Offline-player support by default
\n– Perfect for survival, hardcore, lifesteal SMPs, factions, RPG, and quest servers
\n– Lightweight and easy to integrate with other plugins, datapacks, or scripts <\/p>\n
—<\/p>\n
## Commands & Permissions<\/p>\n
| Command | Permission | Description | _Default: OPs have all permissions. All permissions are configurable._<\/p>\n —<\/p>\n ## Installation<\/p>\n 1. Place `MaxHearts.jar` into your `plugins\/` folder —<\/p>\n ## Notes<\/p>\n – Works on Paper\/Spigot 1.21.x <\/p>\n","protected":false},"excerpt":{"rendered":" MaxHearts is a fully customizable health plugin that adds permanent hearts, player progression, lifesteal, death-loss, revive tokens, heart items, trap (TNT, lava, dripstone), combat tagging, economy heart purchases, and offline support & more…<\/p>\n","protected":false},"featured_media":98858,"template":"","meta":{"_minecraft_slug":"maxhearts","_minecraft_project_id":"2CbID0MU","_minecraft_author":"MyceliumMind","_minecraft_license":"Apache-2.0","_minecraft_downloads":360,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"maxhearts.zip","_minecraft_size_bytes":77893,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T11:17:59.747303Z","_minecraft_date_created":"2025-09-20T11:12:27.810278Z","_minecraft_date_modified":"2025-12-08T08:02:49.791332Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/maxhearts","_minecraft_icon_attachment_id":98858,"_minecraft_imported_at":"2026-06-05T16:19:49+00:00","_minecraft_import_hash":"d71beddc481f00c3daed36d1d33d2a5a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,43,89,122,126,866,127,128,129,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-98857","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-cursed","mod_category-game-mechanics","mod_category-magic","mod_category-management","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|——–|————|————-|
\n| `\/maxhearts set
\n| `\/maxhearts give
\n| `\/maxhearts take
\n| `\/maxhearts donate
\n| `\/maxhearts transfer
\n| `\/maxhearts withdraw
\n| `\/maxhearts revive
\n| `\/maxhearts buy
\n| `\/maxhearts lifesteal on\/off` | maxhearts.lifesteal | Toggle lifesteal participation |
\n| `\/maxhearts combat` | maxhearts.combat | Check remaining combat tag time |<\/p>\n
\n2. Restart the server
\n3. Edit `config.yml` to enable or disable whichever systems you want
\n4. Use `\/maxhearts` commands to begin managing hearts<\/p>\n
\n– Requires Java 21+
\n– Safe for upgrades from older versions (missing config keys regenerate automatically)
\n– Fully compatible with combat, sleep, RPG, and hardcore plugins
\n– Will add SQL support in a future update<\/p>\n