SpiritLinks v3.2.0

Bugfix and quality-of-life release. Focuses on the "can't break blocks after revive" bug, item duplication, Spirit Healer behavior, ghost audio/visuals, and new admin tools.

Bug Fixes

Can't Break Blocks After Revive

The #1 reported issue — players permanently locked out of breaking/placing blocks after dying and reviving. Took three layers of fixes to fully solve:

• Stale protection data was reloading from disk every event, recreating expired protection
• Protection now only loads from disk once on login — in-memory state is authoritative after that
• Protection is force-cleared at the end of every revive
• A 10-second safety net fires after every revive and runs a full ghost state cleanup automatically — even if something gets stuck, players can always interact after 10 seconds
• Players see a chat message when protection ends: "Revive protection ended. You can interact normally."

Item Duplication on Death

• Vanilla inventory items were dropping on the ground AND stored in the ghost snapshot, creating duplicates on revive. Fixed — inventory is cleared immediately after snapshot.
• Curios/Relics/Artifacts (rings, amulets, etc.) were also duplicating because Curios slots weren't being cleared after snapshot. Fixed — all Curios slots are now wiped after the snapshot is taken.

Ghost Music Not Playing

The ghost ambient loop and Spirit Healer click sound weren't working. The sound system was looking up sounds in the Forge registry, but they were only defined in sounds.json. Fixed — now creates dynamic SoundEvents that work with sounds.json without explicit registration.

New Features

Ghost Screen Overlay

When you die and become a ghost, you now see:

• A dark blue-black vignette around the screen edges with a slow breathing pulse
• "You are a ghost..." text fading in and out at the top of the screen
• Combined with the existing invisibility, glowing outline, and night vision effects for a proper ghostly atmosphere

Spirit Healer Movement

Spirit Healers are no longer frozen statues:

• CustomNPC healers keep their full AI — pathfinding, scripts, and animations work normally
• Vanilla mob healers wander naturally within 1-2 blocks of where they were placed, with a leash that gently teleports them back if they stray too far
• All healers remain invulnerable and persistent

Admin Commands

Two new commands for unsticking players:

• /spirit clearprotection — clears revive protection (fixes "can't break blocks")
• /spirit clearghost — nuclear option: removes all ghost state, effects, and saved data

Both require OP permission.

Requirements

• Minecraft 1.20.1
• Forge 47.2.20+
• Java 17+
• Optional: LucsemporiumRPG (RPG XP death penalties)
• Optional: Curios API (curio items included in death snapshots)