❤️ Hero Hearts
A modern hardcore-inspired hearts system for Minecraft Paper/Purpur servers.
Hero Hearts adds a competitive survival mechanic where players have a limited number of lives (hearts). Every death removes one heart, and once a player reaches zero hearts, they are eliminated from the game world and sent to the lobby.
Perfect for:
- SMP servers
- Hardcore events
- PvP survival
- YouTube challenges
- Story-driven worlds
- Competitive multiplayer
✨ Features
❤️ Custom Heart/Life System
- Configurable starting hearts
- Per-player heart management
- Persistent player data storage
- Hearts are automatically removed when a player dies
- Hearts can be manually managed by administrators
💖 Hero Heart Display
Hero Hearts can be displayed separately from the normal Minecraft health system.
- Shows only the individual Hero Hearts
- No additional "Hero Hearts" text
- Automatically updates when hearts change
- Only displayed inside the configured Game World
- Customizable heart color
- Designed to fit naturally into the Minecraft HUD
Note: The advanced HUD display uses newer Minecraft features and is primarily intended for 1.21.x. The core Hero Hearts system remains compatible with older supported versions.
🎨 Custom Heart Colors
Customize the appearance of your Hero Hearts.
/hearts color red
/hearts color blue
/hearts color green
/hearts color purple
/hearts color #FF3030
The selected color is also used by the heart-loss animation.
💥 Heart-Loss Animation
When a player loses a Hero Heart, a visual heart-loss animation can be displayed.
A large heart appears, moves upward, briefly floats and then bursts into multiple heart fragments.
- Different fragment sizes
- Different flight directions
- Rotation while flying
- Matches the configured heart color
- Automatically disappears after the animation
No fire, smoke or normal explosion effects are used.
Note: The full advanced animation is intended for Minecraft 1.21.x. Older versions may use a simplified or unavailable animation depending on API capabilities.
☠️ Elimination System
- Players lose 1 heart on death
- Players automatically respawn after death
- Players with 0 hearts are eliminated
- Eliminated players are sent to the lobby world
- Eliminated players cannot normally re-enter the game world
- Elimination states are saved persistently
👻 Spectator Mode
Eliminated players can optionally be allowed to return to the Game World as spectators.
/hearts allowspectate on
/hearts allowspectate off
/hearts allowspectate status
When enabled:
- Eliminated players can enter the configured Game World
- They are automatically placed into
SPECTATOR - They cannot return to normal survival gameplay
- Spectators cannot lose additional Hero Hearts
- Works with Multiverse-Core
🌍 Multiverse Support
Hero Hearts works with Multiverse-Core.
Set your Game World and Lobby World directly using commands:
/hearts setgameworld <world>
/hearts setlobbyworld <world>
The configured Game World is also used to determine where Hero Hearts are displayed.
⚙️ Event Command Hooks
Hero Hearts can automatically execute custom commands when:
- A player loses a heart
- A player dies
- A player is eliminated
Perfect for broadcasts, titles, sounds, announcements and custom integrations.
Example:
onElimination:
- "broadcast %player% has been eliminated!"
Supports the %player% placeholder.
🛠️ Admin Commands
Heart Management
/hearts set
/hearts add
/hearts remove
/hearts get
/hearts reset
World Management
/hearts setgameworld
/hearts setlobbyworld
Heart Appearance
/hearts color
Spectator System
/hearts allowspectate on
/hearts allowspectate off
/hearts allowspectate status
💾 Persistent Data
Player hearts and elimination states are automatically saved.
Existing player data is designed to remain compatible between plugin updates.
📦 Requirements
Core Plugin
- Paper or Purpur 1.17–1.21.x
- Java 17 or newer
- Multiverse-Core (recommended, optional)
Advanced Features
The newer visual features use Minecraft's newer client/API capabilities.
For the full Hero Heart HUD and advanced heart animation, Minecraft 1.21.x is recommended.
The core heart, death, elimination, world and spectator systems remain designed for the supported Paper/Purpur versions.
Tested Versions
- Minecraft 1.21.10
- Minecraft 1.20.4
- Minecraft 1.17.1
🚀 Planned Features
- Revival system
- Team hearts
- GUI management
- Database support
- PlaceholderAPI support
- Custom death penalties
📜 Permissions
herohearts.admin
❤️ Created By
Tinemon by Vertex Plugins
