Spectral Thread

🌌 Spectral Thread: Diegetic Pathfinding & Stasis Recovery

Tired of losing your valuable gear and XP to 5-minute despawn timers or aggressive server ClearLag sweeps?
Spectral Thread completely re-engineers Minecraft death recovery with an immersive, lore-friendly, and 100% lag-proof system.

✨ Key Features

🛡️ 1. 100% ClearLag & Ground Sweeper Immunity
* Unlike vanilla drops or standard grave mods, your items NEVER scatter onto the ground as ItemEntity.
* All inventory items and XP are safely sealed inside an indestructible Stasis Core (BlockEntity) anchored at your death site.
* Completely immune to /kill @e[type=item], ClearLag sweeps, item purgers, lava burning, and creeper/TNT explosions!

🧭 2. Diegetic HUD & Action Bar Elevation Compass
* Displays a real-time HUD right above your hotbar:
✦ Spectral Thread: 1,420m North-East [↗] [▼ 85m below] to Stasis Core
* 8-Way Cardinal Compass: Visual arrows ([⬆], [↗], [➡], [↘], [⬇], [↙], [⬅], [↖]) guide your exact heading across biomes.
* **Elevation Indicator:** Instantly tells you if items are deep underground in a cave ([▼ below]) or up on a mountain ([▲ above]).

🌟 3. The Sky Pillar (Spectral Beacon)
* When you arrive within 192 blocks of your core, a majestic ethereal pillar of white stars and soul fire shoots straight up from the ground into the clouds!
* If you died in a deep cavern, the pillar projects from the surface terrain directly above your core so you can spot the location from mountain ridges or tree canopies.

👣 4. Soul Ribbon Trail (Cave Pathfinding)
* The mod passively records your exploration breadcrumbs.
* Near your death site, a glowing ethereal ribbon of soul flames floats above the ground, retracing the exact steps you took before dying through confusing cave branches and ravines.

🔮 5. Multi-Death Safety & Soul Consolidation
* Died multiple times trying to retrieve your items? No problem!
* The mod tracks all your cores. If you exceed the maximum core limit (default: 3), the oldest core's items and XP automatically merge into your newest core.
* Zero items or XP are ever lost!

💤 6. Dormant State (Zero-Lag Ambient Sleep)
* When you are >64 blocks away or offline, Stasis Cores enter complete dormancy (0 particles, 0 server ticks).
* Keeps server CPU and bandwidth footprint at 99.9% efficiency even in massive multiplayer worlds.

⚡ 7. Instant Proximity Recovery
* Simply step within 3 blocks of your Stasis Core:

1. All items are directly injected back into your inventory.
2. Armor automatically equips to your armor slots.
3. Your XP is restored.
4. Resonant celestial chimes ring out!

⚙️ Server Configuration (config/spectral_thread.properties)
Every single mechanic is fully customizable:
* dormantDistance (default: 64.0) - Wake-up distance for core particles.
* skyPillarEnabled (default: true) - Toggles the vertical sky beacon.
* skyPillarDistance (default: 192.0) - Distance where the sky pillar becomes visible.
* proximityCollectionRadius (default: 3.0) - Auto-retrieval radius.
* maxActiveCoresPerPlayer (default: 3) - Maximum cores before auto-consolidation.
* autoConsolidateExcessCores (default: true) - Auto-merges oldest death items into newest core.
* xpPreserveRatio (default: 0.85) - Percentage of XP preserved (85%).
* autoEquipArmor (default: true) - Automatically puts armor back on upon recovery.
* respectKeepInventory (default: true) - Preserves standard behavior if keepInventory gamerule is on.