Tethered Hearts
One life, shared. Every player on the server — or every player on the same /team — shares a single health bar and hunger bar. When one of you gets hurt, everyone loses those hearts. When the shared health runs out, the whole team falls together.
Made for co-op challenge runs, hardcore servers and team-vs-team events.
Server-side only: install it on the server and you're done. Players join with a normal, unmodded Minecraft client.
Features
Two ways to share
- Global mode: the whole server shares one life.
- Team mode: each vanilla /team shares its own life. Red team and blue team each have their own health bar, so teams can race or fight each other. You can make as many teams as you like, in any of Minecraft's 16 team colors.
What is shared
- Health: damage and healing affect everyone in the group.
- Hunger: food level, saturation and exhaustion. One player eats, everyone is fed. (Can be turned off.)
- Absorption (yellow hearts): one player eats a golden apple, everyone gets the yellow hearts. (Can be turned off.)
Fair rules, so a bigger team isn't stronger or weaker by accident
- Only the biggest hit per tick counts. If several players are hurt in the same game tick (falling together, the same explosion), only the biggest hit is taken from the shared health instead of all of them added up.
- The team heals like one body. Natural regeneration happens once for the whole team, not once per player. Only the strongest Regeneration effect in the team counts (a beacon on four teammates doesn't heal four times as fast). A splash potion of Healing that hits several teammates heals once. Yellow hearts never go higher than the strongest Absorption effect in the team.
- Damage is calculated after the victim's armor and enchantments.
- Teammates feel it. When someone is hurt, the others see the red flash and hear the hurt sound, but don't get knocked back.
Death
- When the shared health reaches zero, everyone in the group dies together. The normal death message is shown for the player who took the final hit, followed by "The whole team fell together." The vanilla showDeathMessages gamerule is respected.
- Damage summary: after a team death, chat shows how much damage each player took during that life, so you can see who doomed the team.
- Totem of Undying: if the player taking the fatal hit is holding a totem, it saves the whole team.
- No escaping by logging out: a player who was offline when their team fell dies too when they come back. (Can be turned off.)
- After respawning, the shared health and hunger start full again.
Who takes part
- Only players in survival or adventure mode. Creative and spectator players are left out and keep their own health. Switching back to survival copies the current shared health.
- New players and players who log back in get the current shared health.
- Players in different dimensions still share.
- Everything is saved in the world, so the shared health survives server restarts.
Team tools (team mode)
- Team flags: every team member's name gets a ⚑ flag in the team's color, shown on name tags, in the tab list and in chat. Players without the mod see it too.
/tetheredhearts shuffle <teams...>: splits the online players randomly and evenly into the teams you list. Handy at the start of a game.- Players can pick their own team (optional): an operator opens team selection with
/tetheredhearts open <teams...>, and players join with/tetheredhearts join <team>. To stop team-hopping:- you can only pick a team if you don't have one yet (only an operator can move you after that),
- you can only pick from the teams the operator opened,
- you can't join a team that has more players than the others,
/tetheredhearts closelocks the teams when the game starts.
Messages in the player's language
Chat messages from this mod are sent in each player's game language: English, Simplified Chinese or Japanese (everything else gets English).
Installation
- Install Minecraft Forge 1.20.1 (47.1.0 or newer) on your server.
- Put
tetheredhearts-1.0.0+forge-1.20.1.jarin the server's mods folder. - Start the server.
config/tetheredhearts.jsonis created on first start.
Players do not need to install anything. Vanilla clients and Forge clients without the mod can both join.
Also works in singleplayer and on LAN worlds (only the host needs the mod).
Commands
All commands need operator permission (level 2), except join.
| Command | What it does |
|---|---|
/tetheredhearts status |
Shows the mode, each shared life (health, yellow hearts, hunger) and who is online in it. |
/tetheredhearts reset |
Refills health and hunger for every shared life used by the current mode. |
/tetheredhearts reset <team> |
Refills one team. |
/tetheredhearts reload |
Reloads the config file. If the file has mistakes, you're told which settings fell back to their defaults. |
/tetheredhearts shuffle <team1> <team2> [...] |
Randomly and evenly splits online survival/adventure players into these teams (up to 8). These teams start with full health. Players in other teams (for example a staff team) aren't touched. |
/tetheredhearts open <team1> [...] |
Lets players pick one of these teams themselves. |
/tetheredhearts close |
Stops players from picking teams. |
/tetheredhearts join <team> |
For everyone, while team selection is open. Normal players only see this command while selection is open. |
Teams themselves are made with the vanilla /team command, for example:
/team add red
/team modify red color red
/team join red Steve
Configuration
config/tetheredhearts.json:
{
"mode": "global",
"players_without_team": "solo",
"share_hunger": true,
"share_absorption": true,
"only_biggest_hit_per_tick": true,
"announce_group_death": true,
"damage_summary_on_death": true,
"team_flag": true,
"offline_players_share_death": true
}
| Setting | Default | Meaning |
|---|---|---|
mode |
"global" |
"global": the whole server shares one life. "team": each /team shares its own life. |
players_without_team |
"solo" |
Team mode only. "solo": players without a team keep their own health. "global": all players without a team share one life together. |
share_hunger |
true |
Share food level, saturation and exhaustion. |
share_absorption |
true |
Share yellow hearts. |
only_biggest_hit_per_tick |
true |
When several players are hurt in the same tick, only the biggest hit counts. |
announce_group_death |
true |
Show "The whole team fell together." |
damage_summary_on_death |
true |
Show how much damage each player took during that life. |
team_flag |
true |
Team mode only. Show a ⚑ flag in the team color before team members' names. |
offline_players_share_death |
true |
A player who was offline when their team died also dies when they log back in. |
A broken config file never crashes the server: settings that can't be read use their defaults, a warning is written to the log, and your file is left as it is so you can fix it. Use /tetheredhearts reload to apply changes without restarting.
Tips for server owners
- Friendly fire: vanilla teams allow friendly fire by default, so teammates hitting each other hurt their own team. Turn it off with
/team modify <team> friendlyFire false. - Public servers: in global mode, anyone who jumps into lava takes the whole server with them. That's the point of the mod, but on public servers team mode is usually the better choice.
- Your own team prefixes are safe: the flag is only added to teams with an empty prefix. If you set a prefix yourself (
/team modify <team> prefix ...), it's left alone. The flags are removed when the server stops, so nothing is left behind if you uninstall the mod. - Hardcore servers and keepInventory work as usual: everyone in the group dies a normal death.
Supported versions
| Minecraft | Loader | Status |
|---|---|---|
| 1.20.1 | Forge 47.1.0+ | ✅ Supported |
| 1.21.1 | NeoForge | Not yet |
Works great with: Dimension Hardcore
Check out Dimension Hardcore, my other mod: hardcore mode for chosen dimensions. Die in the Nether (or any dimension you pick) and you become a spectator for good, while deaths elsewhere are normal.
The two mods fit together for challenge servers: share one life with your team, and when the team falls, everyone who was inside a hardcore dimension at that moment is out for good. Players eliminated by Dimension Hardcore become spectators, so Tethered Hearts automatically stops counting them. Please check Dimension Hardcore's page for the loaders and versions it supports.
The code for this mod was written by AI (Claude). I came up with the idea, made the design decisions, and tested it in game.
License: MIT