SpiritLinks v3.0.0 for Minecraft 1.20.1

SpiritLinks has been fully ported from 1.12.2 to 1.20.1!

This is a ground-up rewrite of every file in the mod to work with modern Forge. All the ghost mechanics, Spirit Healers, inventory snapshots, breadcrumb trails, and revive protection you know from 1.12.2 are here — plus a bunch of fixes and a new feature.

Requires Java 17+ and Forge 47.2.20+. Works on Mohist and Arclight hybrid servers.

What's New

LucsemporiumRPG Death Penalties

If you're running LucsemporiumRPG alongside SpiritLinks, dying now has consequences beyond just running back to your corpse:

• Reviving at your corpse costs a small amount of RPG XP (2%, scaling up to 10% if you keep dying)
• Using a Spirit Healer or cemetery costs more (5%, scaling up to 20%)
• Your XP will never drop below your current level — you won't lose a level, just progress toward the next one
• Items take a small durability hit on revive (configurable)
• If LucsemporiumRPG isn't installed, none of this applies — SpiritLinks works fine standalone

Everything is configurable in spiritlinks-common.toml under [rpgPenalty].

What's Fixed

The Big Ones

• Items could duplicate if you logged out while ghost and logged back in. Fixed — inventory is now safely cleared when you become a ghost (your items are stored in the snapshot and restored on revive as always).
• Creative mode players could get stuck as ghosts. Fixed — creative and spectator players no longer enter ghost state on death. If a ghost somehow switches to creative, they're forced back to adventure mode.
• Revive protection was lost on server crash. Fixed — protection is now saved to disk the moment it's applied, not just when you log out.
• Race conditions in the ghost state maps could cause rare crashes under heavy load. All internal maps are now thread-safe.

Smaller Fixes

• Healer confirmation offers no longer leak memory if players ignore them (auto-cleaned after 30 seconds)
• The healer click sound can't be spammed anymore (1 second cooldown)
• All cooldown data is properly cleaned up on logout and on revive
• Forged rescue packets with impossible coordinates are now rejected server-side
• Error handling now actually logs what went wrong instead of silently swallowing exceptions

Under the Hood (for the technically curious)

The entire mod was rewritten for 1.20.1 APIs:

• Dimensions are now stored as strings ("minecraft:overworld") instead of integers
• Teleportation uses the modern ServerPlayer.teleportTo() API
• Networking uses SimpleChannel with the messageBuilder pattern
• Commands use Brigadier (same /spirit, /ghost, /reclaim aliases)
• Config is now ForgeConfigSpec (generates spiritlinks-common.toml)
• Save data uses the new SavedData factory pattern
• Baubles support replaced with Curios API (via reflection, no hard dependency)
• Stale Spirit Healer entries are periodically cleaned from the save data
• Resurrection cost tracking auto-prunes inactive players

Requirements

Just drop spiritlinks-1.20.1-3.0.0.jar into your mods/ folder. Config generates on first run.

Ported from SpiritLinks 1.12.2 by Luc Bellefeuille.