maxHearts
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...
Автор: MyceliumMind7424обновлён 8 дек. 2025 г.
ПриключенияМеханики игрыУтилиты
Описание
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
- Place
MaxHearts.jarinto yourplugins/folder - Restart the server
- Edit
config.ymlto enable or disable whichever systems you want - Use
/maxheartscommands 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
Галерея
Последние версии
Все версии →release
maxHearts 1.2.0
1.2.08 дек. 2025 г.623Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10paper, purpur, spigot
Что нового
# Changelog
## v1.2.0 – Major Feature Overhaul
This update is a full upgrade of MaxHearts, adding advanced systems while improving stability, configurability, and compatibility.
### New Systems
- Added full **lifesteal system** with:
- PvP lifesteal
- Projectile & tamed-mob lifesteal
- **Trap lifesteal** (TNT, lava, falling dripstone)
- Daily caps, cooldowns, bypass permissions, and opt-out mode
- Added **revive system**, including:
- Craftable Revive Tokens (custom recipe, name, lore, model data)
- Token requirement toggle
- Offline-safe unbanning & restoration
- Added **death penalty system**:
- Configurable heart loss
- Floor actions: block / clamp / kick / ban
- Offline-safe pending application
- Added **heart shard and consumable heart item** crafting recipes
- Customizable names, lore, and model data
- Added optional **Vault integration** for heart purchases
- Supports flat or progressive price models
- Daily caps & cooldowns
- Added **combat tag system**
- Enter/leave combat notifications
- Optional logout protection
### Improvements
- Fully rewritten killer-resolution engine
- Detects TNT, dripstone, and lava owners reliably
- Compatible with “Last Stand” plugins
- Offline-player handling improved
- Tab completion rewritten and permission-aware
- Auto-prunes old daily counters
- Added safe merge logic for config upgrades
### Fixes
- Prevented Revive Token spoofing
- Fixed item-dupe edge cases during death/ban
- Correct absorption restoration after early bed exit
- Corrected tamed-mob and projectile lifesteal behavior
- Fixed various cooldown, floor-action, and pending-heart issues
---
If you are upgrading from older versions, your existing config will automatically merge with new keys.
release
maxHearts 1.1.0
1.1.021 сент. 2025 г.72Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8paper, purpur, spigot
Что нового
I know we only have 3 downloads so far but I couldn't help picking over my code.
MaxHearts v1.1.0 — Changes and Improvements
1. UUID-based storage
- Player max hearts are now stored by UUID, not username.
- Prevents issues if a player changes their name.
- Last-known name is still tracked for display purposes.
2. New data.yml file
- Player data is stored in plugins/MaxHearts/data.yml.
- config.yml is now only for defaults and bounds.
- Admins no longer have to manage overrides in config.yml.
3. Legacy migration
- Any overrides: section in config.yml is automatically migrated into data.yml.
- Migrated once on startup; config.yml is cleaned up afterward.
4. Configurable bounds
- Added minHearts and maxHearts in config.yml.
- All set/give/take/transfer operations are clamped to these values.
5. Event handling cleanup
- Switched from MONITOR to NORMAL priority in event listeners.
- Still applies heart updates on the next tick for safety.
6. Command flexibility
- Commands accept both player names and UUIDs.
- Transfers can target pending names (applied once that player joins).
- Sources must be actual players with UUIDs (to prevent ghost transfers).
7. Runtime data management
- data.yml is created and updated automatically by the plugin.
- Admins should not edit data.yml manually.
Overall result:
- Safer, more reliable storage of heart data.
- Cleaner config file for admins.
- Improved protection against edge cases (name changes, invalid values).
- Better code semantics for long-term maintainability.
release
MaxHearts 1.0.0
1.0.019 сент. 2025 г.47Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8paper, purpur, spigot
Что нового
First rendition of MaxHearts, full 1.21.x support and I dont plan on going anywhere.