# Heartbound<\/p>\n
A Paper plugin for Minecraft 1.21.x that implements a shared health pool across all players with automatic world reset on death. Includes a full speedrun timer and scoreboard system.<\/p>\n
## Features<\/p>\n
– **Shared Health Pool**: All players share a single health pool. When any player takes damage, it affects the global health.
\n– **Shared Hunger & Saturation**: Food and saturation are synced across all players. Hunger depletion and eating benefits apply to everyone equally.
\n– **Shared Healing**: Healing is applied to the shared pool and divided by player count to prevent multiplication exploits.
\n– **Automatic World Reset**: When the shared health reaches 0, the world automatically resets after a configurable delay.
\n– **Speedrun Timer**: Live timer tracks the duration of each attempt.
\n– **Ender Dragon Goal**: Main goal is defeating the Ender Dragon \u2014 timer stops when the dragon is killed.
\n– **Best Time Tracking**: Automatically saves your best dragon kill time.
\n– **Attempt History**: Keeps track of your last 3 attempts with times and outcomes.
\n– **Sidebar Scoreboard**: Always-visible sidebar showing:
\n – Current timer (updates live every second)
\n – Attempt number
\n – Best time (if dragon was killed)
\n – Last 3 attempt times with success\/fail indicators
\n– **Limbo World**: Players are safely teleported to a void world during reset.
\n– **Spawn Chunk Preloading**: Configurable radius of chunks to preload around spawn for smoother starts.
\n– **Configurable**: All settings can be customized via config file.<\/p>\n
## Commands<\/p>\n
All commands require OP. Use `\/heartbound` or `\/hb`:<\/p>\n
| Command | Description | ## Scoreboard Display<\/p>\n The sidebar scoreboard displays:<\/p>\n “` A Paper plugin for Minecraft 1.21.x that implements a shared health pool across all players with automatic world reset on death. Includes a full speedrun timer and scoreboard system.<\/p>\n","protected":false},"featured_media":80159,"template":"","meta":{"_minecraft_slug":"heartbound","_minecraft_project_id":"e8xdAqsT","_minecraft_author":"AlmostX","_minecraft_license":"Apache-2.0","_minecraft_downloads":123,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"heartbound.zip","_minecraft_size_bytes":54838,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:06:50.934347Z","_minecraft_date_created":"2026-01-05T23:26:39.278673Z","_minecraft_date_modified":"2026-01-03T20:26:44.015289Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/heartbound","_minecraft_icon_attachment_id":80159,"_minecraft_imported_at":"2026-06-04T14:51:08+00:00","_minecraft_import_hash":"9e90d71ae086d8c234244845d0679d75","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,866,127,159],"mod_loader":[132],"minecraft_version":[78],"class_list":["post-80158","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_category-worldgen","mod_loader-paper","minecraft_version-1-21-5"],"yoast_head":"\n
\n|———|————-|
\n| `\/hb trigger` | Manually trigger a world reset |
\n| `\/hb attempts` | Show current attempt count |
\n| `\/hb reset-counter` | Reset attempt counter to 0 (clears history and best time) |
\n| `\/hb set-counter
\n| `\/hb health` | Show current global health |
\n| `\/hb sethealth
\n| `\/hb status` | Show full status (timer, health, attempts, best time, reset status) |
\n| `\/hb timer` | Show current timer status |
\n| `\/hb timer-start` | Manually start\/restart the timer |
\n| `\/hb timer-stop` | Manually stop the timer |
\n| `\/hb best` | Show best dragon kill time |
\n| `\/hb history` | Show last 3 attempt times |
\n| `\/hb reload` | Reload configuration |<\/p>\n
\n Speedrun
\n\u23f1 12:34 <- Current timer (updates live)\n\nAttempt #5 <- Current attempt number\nBest: 45:23.456 <- Best dragon kill time\n\nLast Attempts: <- History of last 3 attempts\n\u2713 #4 45:23 <- Green checkmark = dragon killed\n\u2717 #3 23:45 <- Red X = failed attempt\n\u2717 #2 12:34\n```\n\n## Configuration\n\nConfig file is located at `plugins\/Heartbound\/config.yml`:\n\n```yaml\n# Reset delay in milliseconds after death\nreset-delay-ms: 3000\n\n# Seed mode: \"random\" or \"fixed\"\nseed-mode: random\n\n# Fixed seed to use when seed-mode is \"fixed\"\nfixed-seed: 12345\n\n# Enable limbo world during reset\nlimbo-enabled: true\n\n# Maximum shared health\nmax-health: 20.0\n\n# Which dimensions to reset\nreset-overworld: true\nreset-nether: true\nreset-end: true\n\n# Spawn chunk preloading (overworld only)\n# Radius in chunks around spawn to preload and keep loaded\n# A radius of 3 = 7x7 = 49 chunks, radius of 5 = 11x11 = 121 chunks\nspawn-preload-radius: 3\n\n# Messages (supports & color codes)\nmessages:\n prefix: \"&c[Heartbound]&r \"\n death: \"&4All players have fallen! Resetting world in {delay} seconds...\"\n reset-start: \"&6World reset in progress... Please wait.\"\n reset-complete: \"&aWorld reset complete! Attempt #{attempt} begins!\"\n limbo: \"&7You are in limbo while the world resets...\"\n\n# Silent mode - disable all messages\nsilent-mode: false\n\n# Show speedrun scoreboard on sidebar\nshow-attempts-sidebar: true\n```\n\n## Installation\n\n1. Install Paper 1.21.x server\n2. Place the plugin JAR in the server's `plugins\/` folder\n3. Start the server\n4. (Optional) Edit `plugins\/Heartbound\/config.yml` and restart\n\n## How It Works\n\n1. **Timer Start**: Timer begins when the server starts or after each reset.\n2. **Separate Game Worlds**: The plugin creates separate `game_world`, `game_nether`, and `game_end` worlds for gameplay.\n3. **Damage Sharing**: All player damage is routed through a shared health pool.\n4. **Hunger Sharing**: Food level, saturation, and exhaustion are synced across all players every tick.\n5. **Healing Normalization**: Healing is divided by player count so multiple players regenerating health doesn't multiply the effect.\n6. **Death Prevention**: Individual player deaths are prevented; only global death triggers reset.\n7. **Dragon Detection**: When the Ender Dragon is killed in `game_end`, the timer stops with success.\n8. **Reset Sequence**:\n - Timer is stopped and attempt is recorded\n - Players teleported to limbo world (set to spectator mode)\n - Game worlds are unloaded and deleted\n - New worlds are created with a new seed\n - Spawn chunks are preloaded\n - Players returned to new spawn (set to survival mode)\n - Health and hunger reset to full\n - Attempt counter incremented\n - Timer starts for new attempt\n\n## Data Storage\n\nAttempt data is saved to `plugins\/Heartbound\/attempts.yml` and includes:\n- Total attempt count\n- Last 3 attempt records (time, success\/fail, timestamp)\n- Best dragon kill time\n<\/p>\n","protected":false},"excerpt":{"rendered":"