Soul Link: Shared Inventory

Soul Link

Linked players share, in real time:

• one inventory: inventory, hotbar, armor and offhand;
• one hunger bar;
• one health bar;
• one experience bar.

What one player picks up shows up for the others. If one gets hit, everyone loses health. If one eats, everyone fills up. If one enchants, everyone pays the levels. If one dies, everyone dies.

By default everyone on the server is linked. With /soullink group you can split players into separate groups: 2 and 2, 3 and 1, or however you like.

What is shared

• Creative and spectator players share the inventory, but not health, hunger or experience.
• Experience adds up in points, not levels, so collecting orbs together is as good as one player collecting them all. Enchanting, anvils and /xp affect everyone.
• Death: when one dies, everyone dies at the same moment. Items and orbs drop only once, next to whoever took the final hit. With keepInventory nothing is lost, but everyone still dies.
• Everything is saved in the world, not per player: if someone logs off with low health, whoever joins next starts with that health.
• Adding it to an existing world: the first player to join brings their items and hunger. Nobody else loses anything: the first time they join, their items appear in a chest next to them, and their experience is added to the shared bar.

Groups

Everyone is linked by default. To split players up (operator commands):

/soullink group red Ana Beto      Ana and Beto are linked to each other
/soullink group blue Caro Dani    Caro and Dani, to each other
/soullink group remove Beto       Beto goes back to the players without a group
/soullink groups                  shows who is in each group (anyone can use it)

• Each group is independent: its own inventory, hunger, health, experience and attempts. If one group dies, the others keep playing.
• Players without a group are linked to each other, as if there were no groups. A group of one plays solo.
• Switching groups doesn't bring anything along: you get the new group's things, and yours stay with your old group.
• You can name up to 8 players at once, or use a selector like @a[team=red].

Swap places

/swap [player] (or /intercambiar) swaps your position with your partner's, even across dimensions. No operator needed.

Stats

Every time the group dies, an attempt ends. The mod keeps count of the attempts and of what each player did:

• /soullink shows your group's current attempt, how long it has lasted, the record, one line per player and the latest deaths with their cause. /soullink stats <group> shows another group's.
• When a group dies, the chat says which group, which attempt ended, how long it lasted, whose fault it was and the record.
• Sidebar: off by default. Set barraLateral in the config (or in Mod Menu) to show deaths caused, or any other stat, on the right side of the screen. It uses regular scoreboard objectives, so it works without the mod on the client.
• /soullink stats reset (operators) sets everything back to zero.

Configuration

config/soullink.json is created the first time the server starts:

/soullink reload (operators) applies it without restarting. With Mod Menu you can also edit it in-game. Inventory, hunger and health can't be turned off: they are shared from the moment a player joins, and changing that with people online would duplicate or delete items.

Languages

Each player sees the messages in their game language: English or Spanish. Commands exist in both (/swap and /intercambiar, /soullink group and /soullink grupo…).

Installation

All the logic runs on the server: players don't need to install anything. On the client the mod is optional and only adds the Mod Menu settings. For singleplayer or LAN, install it on the client that opens the world.

Requires Minecraft 26.3, Fabric Loader 0.19.5+, Fabric API and Java 25.

Works well with

• Hero's Forge (0.14.0 or newer): stat points belong to each linked group. With an older Hero's Forge, Soul Link 3 won't start: update both.
• Bloodmoon & Bosses and Mythic Loot: no conflicts. Mythic Loot's healing affixes heal the whole group.

License: MIT. Feel free to use it in modpacks.