🕊️ Kindred Souls v1.06 — Major API & Stability Update

This update marks a major milestone for Kindred Souls, introducing a stable addon API, new quality-of-life improvements, and critical bug fixes for multiplayer and cross-dimensional gameplay.

---

🌟 Major Features

🔮 Ability & Addon API (v1.0)

The long-awaited Kindred Souls API has arrived, enabling mod developers to create custom extensions and gameplay systems.

• Ability Registry

  • Introduced the IKindredSoulsAPI and AbilityRegistry, allowing external mods to define new Ability Types (e.g. “Fire Guardian”, “Shadow Ward”).
  • Each ability can include its own name, description, and icon for full creative flexibility.

• Ability Selection GUI

  • After two players soulbind, they are now presented with a refined Ability Selection Screen.
  • The GUI lists all available Ability Types for each role. If only the default type exists, it’s auto-assigned.

• Forge Event Hooks

  • The API fires a comprehensive suite of events for custom logic integration:
    • SoulbindHurtEvent — Triggered when a bound player takes damage. Addons can modify or cancel damage-sharing.
    • SoulbindHealEvent — Triggered when healing occurs. Addons can adjust healing distribution.
    • SoulbindPlayerTickEvent — Fires once per second for each bound player, ideal for passive buffs, effects, or monitoring.
    • SoulbindActiveAbilityEvent — A foundational event for keybind-activated custom abilities.

---

✨ Quality-of-Life Improvements

• 🧭 Action Bar Soulmate Tracker

  • Your soulmate’s location and dimension now display in the action bar, updating every second:
    • Guardians see: Ward is at X, Y, Z in [Dimension]
    • Wards see: Guardian is at X, Y, Z in [Dimension]
  • If your partner is offline, it will clearly state so.

• ⚔️ Lethal Bond Enhancement

  • The soul link between Guardian and Ward is now truly fatal.
  • If a Ward dies, their Guardian immediately shares their fate — a message will notify the Guardian of the loss.

---

🐛 Bug Fixes & Stability

• ✅ Fixed: Cross-Dimensional Sync

  • Soulbind mechanics (damage, healing, and death link) now function flawlessly across all dimensions — including custom worlds.

• ✅ Fixed: Dedicated Server Startup Crash

  • Resolved an issue causing crashes on dedicated servers.
  • Client-only code (GUIs, keybinds, etc.) is now safely restricted with @OnlyIn(Dist.CLIENT).
  • Network packet handling has been fully refactored for proper side separation.

• ✅ Fixed: Request GUI Player List Crash

  • A crash caused by null player names in the “Send New Request” screen has been resolved.
  • The player list now safely filters invalid entries and handles dynamic updates correctly.

---

🧩 Developer Note

• This version solidifies Kindred Souls as both a gameplay experience and a modding platform. Future updates will expand the API with visual effects, sound hooks, and advanced ability customization tools.