Heartbound Lives

Quickstart

1. Enter the world to receive 4 lives.
2. Play normally, but remember that every death costs 1 life. A death caused by another player transfers that life to the killer.
3. To test the items in Creative or with commands, use:
   • /give @s com_heartbound_lives_l7yr4ood:life_heart
   • /give @s com_heartbound_lives_l7yr4ood:reviver
4. Hold a Life Heart and use it to restore 1 life. It is consumed, and you cannot exceed 4 lives.
5. Craft a Reviver, then hold it and use it when a player reaches 0 lives. Select an eliminated player from the menu to restore them to 1 life.

Overview

Heartbound Lives turns player survival into a shared life economy. Every player starts with 4 lives. Deaths reduce the victim's total, while player-versus-player kills can reward the killer.

Players who reach 0 lives are eliminated and kicked from the world. Another player must use a Reviver to bring them back.

What It Adds

• A persistent 4-life system for every player
• Life loss on death
• Life rewards for player kills
• Life Hearts, which can restore a life or be used to craft Revivers
• Revivers, which restore eliminated players
• Optional Bounty Hunter, Warden Fight, and Juggernaut Run events
• Configurable Nether and End access
• Configurable world borders

How To Use

Tracking Lives

Your life total is saved in the world and remains associated with your player name.

• New players begin with 4 lives.
• Any death removes 1 life.
• A player death caused by another player gives the killer 1 life, unless the killer already has 4.
• A killer at 4 lives receives a Life Heart instead.
• Life totals cannot exceed 4.
• Deaths without a credited player killer do not transfer a life.

Using a Life Heart

1. Place the Life Heart in your hand.
2. Use the item.
3. If you have fewer than 4 lives, the Life Heart is consumed and restores 1 life.
4. If you already have 4 lives, the item is not consumed.

Life Hearts can stack up to 64.

Using a Reviver

1. Keep the Reviver in your hand.
2. Use it to open the Reviver menu.
3. Select a player listed at 0 lives.
4. The Reviver is consumed and the selected player returns with 1 life.

If no players are eliminated, the menu reports that nobody is waiting for revival. If another player revives the target first, the Reviver is not consumed.

Crafting And Obtaining

Life Heart

Life Hearts are awarded when:

• You kill a player while already at 4 lives.
• You complete an event reward while already at 4 lives.

They can also be obtained through Creative inventory or the /give command.

Reviver

A Reviver is crafted from Life Hearts, gold ingots, and a Nether Star.

A Reviver can be obtained through Creative inventory or with /give @s com_heartbound_lives_l7yr4ood:reviver.

Abilities And Mechanics

Elimination

When your lives reach 0:

• You are marked as eliminated.
• You are kicked from the world.
• Rejoining does not restore you; you are kicked again until someone revives you.
• A player using a Reviver can restore you to 1 life.

A Reviver may be used for an eliminated player who is offline, so a teammate can restore them before they rejoin.

Player Kill Rewards

When a player is killed by another player, the victim loses 1 life and the killer receives the corresponding reward:

This makes player combat a way to gain lives, but also gives players at maximum lives a supply of Life Hearts.

Events

Heartbound Lives includes three optional events. Open the configuration menu with:

/tag @s add com_heartbound_lives_l7yr4ood_config_request

Choose Start an Event, then select an available event. Only one event of a given type can run at a time, and a player cannot start another event while already participating in one.

Bounty Hunter

• Requires at least two online players who have at least 1 life.
• Each eligible player receives a random player target.
• Hunters receive regular target-location updates.
• Claiming your target rewards you with 1 life, or a Life Heart if you are already at 4 lives.
• The event lasts up to 5 minutes.

Warden Fight

• Summons a Warden at an ancient city near world spawn.
• Teleports all online players to the fight location.
• Players receive 25 seconds of powerful Resistance and Blindness preparation effects.
• Defeat the Warden before the event timer ends.
• The player who starts and completes the event receives 1 life, or a Life Heart at 4 lives.
• The event lasts up to 5 minutes.

Juggernaut Run

• Spawns a Ravager near the player who starts the event.
• Survive for 3 minutes.
• The starting player receives 1 life, or a Life Heart at 4 lives, for completing the run.
• Start it in a safe, open area so the Ravager can spawn properly.

World Controls

The configuration menu also controls dimension access and world borders.

Dimension Access

The Nether and The End can each be opened or closed. Players entering a closed dimension are returned to the Overworld at approximately 0, 80, 0.

World Borders

A separate border can be configured for the Overworld, Nether, and The End.

• Borders are centered at 0, 0.
• The configured size is the diameter in blocks.
• Players who move outside the Overworld border are returned inside it.
• Each dimension's border can be enabled, disabled, or resized from the configuration menu.

Progression And Strategy

• Protect your first 4 lives; environmental deaths are still costly.
• Avoid fighting players who can safely claim your remaining life.
• Use Life Hearts before taking unnecessary risks, unless you need them for a Reviver.
• Keep at least one Reviver available for important teammates.
• If you are at 4 lives, Life Hearts are more valuable than additional life rewards because they can be stored or converted into Revivers.
• Coordinate event participation carefully: the Warden Fight affects every online player, while Bounty Hunter can expose player locations.
• Revive eliminated teammates before they attempt to rejoin, so they can return to the world normally.