Soul Link Challenge Runs

Cooperative challenge runs for Fabric dedicated servers and integrated single-player/LAN worlds, inspired by the Soul Link format and similar co-op challenges. Shared health, hunger, and saturation are enabled by default and can be disabled for future runs; defeating the Ender Dragon wins.

Each run uses fresh, seeded Overworld, Nether, and End worlds while players stay connected in a persistent lobby. Terra Rasa handles world preparation and replacement and is bundled in Soul Link's mod jar. Its README explains how canonical replacement keeps vanilla's world behavior intact.

Features

• Shared vitality: all active participants share one health, food, and saturation pool. Damage and food changes add together; simultaneous healing only applies the largest individual heal, so the team cannot multiply regeneration.
• Optional unlinked vitality: operators can use /soullink rules sharedVitality false to let players keep their own health, food, and saturation in the next run. This leaves world preparation and swaps active.
• Run outcomes: with shared vitality enabled, any participant death or an empty shared health pool ends the run in defeat. With it off, normal worlds allow vanilla respawns; vanilla hardcore ends after every participant is eliminated. Operators can enable Soul Link Hardcore to end on the first death regardless of shared vitality. Killing the Ender Dragon wins. After victory, players remain in the world and can use vanilla's exit portal and credits.
• Fresh worlds without reconnecting: a persistent lobby holds players during the swap. Runs use new seeds and vanilla dimension identities; world generation and modded biomes work through the normal registries.
• Background preparation: the next run's spawn area and optional pregeneration work are prepared while the current run is played. /soullink start and /soullink reset do not wait for the full pregeneration radius.
• Run timer and records: the timer counts only while a participant is online. Run count, victories, and best victory time persist with the world.
• Late join and restart recovery: by default, a new player joining a live run is reset to its baseline and enters that run. Existing participants resume their run after a disconnect or server restart.
• Optional shared potions: when enabled, ongoing effect gains, upgrades, removals, and expirations are mirrored to teammates. Instant healing and damage already flow through shared vitality.
• Optional half-heart runs: limit participants and the shared health pool to one health point, with player max health restored when they return to the lobby.
• Operator controls: pause the run timer without pausing gameplay, toggle vanilla natural regeneration, and configure optional pregeneration.
• Server-owned gameplay: the host needs Soul Link installed for dedicated or integrated servers. LAN guests can connect with vanilla clients.

Playing

All mod commands are grouped under /soullink. Machine-readable status is available through /soullink debug lifecycle when debugCommands is enabled. Players can read the gameplay guide for the lobby, run states, shared-pool rules, joining, and end conditions.

Configuration

config/soullink.json is created on first start. These are its default settings:

See the configuration guide for valid ranges, custom dimensions, and which settings can change while the server is running.