🌙 Kindred Souls

A Minecraft mod about eternal bonds between two connected spirits.

---

🕊 Overview

Kindred Souls explores the sacred connection known as soulbinding — a supernatural bond linking two players, the Guardian and the Ward.
Their lives are intertwined, their pain and healing shared. When one suffers, the other feels it.

This mod is designed for multiplayer or Essential singleplayer, where cooperation and trust shape your destiny.
Your strength lies not in solitude — but in your bond.

---

💞 Gameplay

When you first join a world, you’ll face a divine choice:

✨ Choose Your Role

• Guardian – The protector. When your Ward is harmed, you share their pain.
• Ward – The protected. Your life is linked to your Guardian, your strength flowing through the bond.

Once bonded:

• Damage Sharing: When the Ward takes damage, the Guardian also takes equal damage.
• Healing Sharing: When the Ward heals, the Guardian heals too.
• Lethal Bond: If the Ward dies, their Guardian dies as well — but the Ward survives if the Guardian falls.
  • If both are bound using /soulboundtwoway, their fates become mutually fatal.

Your destinies are forever intertwined — two souls, one heartbeat.

---

🔮 Ability & Addon System (New!)

Inspired by the Origins mod, Kindred Souls introduces an expandable Ability System that allows for endless creativity and personalization.

• Ability Registry:
  A brand-new system lets developers register their own Ability Types (e.g. “Flame Guardian”, “Shadow Ward”, “Spirit Weaver”) — each with custom names, icons, and abilities.

• Ability Selection GUI:
  After two players soulbind, a sleek Ability Selection Screen appears, letting them choose from all available Ability Types for their role.
  If only one type exists, it’s assigned automatically.

• Forge Event Hooks:
  The API introduces a powerful set of events for mod developers to expand gameplay:

  • SoulbindHurtEvent – Triggered when a Ward takes damage.
  • SoulbindHealEvent – Triggered when shared healing occurs.
  • SoulbindPlayerTickEvent – Fires once per second for each bound player; great for passives or effects.
  • SoulbindActiveAbilityEvent – Base event for keybind-triggered custom abilities.

🧩 Our ability framework takes inspiration from the beloved Origins mod, but reimagines it through the lens of shared souls rather than individual powers.

---

🧭 Soulmate Tracker (New HUD Feature)

A new action bar HUD now displays your soulmate’s location and dimension, 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 clearly displays "[Offline]".

---

⚙️ Compatibility

Kindred Souls fully supports:

• Multiplayer servers
• Singleplayer with Essential (for friend-based connections)

⚠️ Playing entirely solo defeats the purpose — Kindred Souls is about connection, not isolation.

---

🧙 Admin / Dev Commands

Command	Description
/soulbound unbind	Breaks an existing soul link.
/soulboundtwoway (Bugged)({playername}	Creates a two-way soulbind — both players act as Guardian and Ward, making the bond mutually fatal.
/soulbound {playername}	Binds you as the specified player's Ward.

---

new command /skills ADMIN only command. is useless in base mod and really only works if an addon registers some custom skills

🧩 Configuration

Customize how bonding works through the configuration file:

• randomSelection = true **

  • Displays a role selection GUI on first world join (Guardian or Ward).

• randomSelection = false (default)

  • Disables automatic selection and enables manual soulbinding requests instead.
    (Note: visibility improvements for pending invites are planned in a future update.)

---

🛠️ Technical Notes

• Cross-Dimensional Support: Soulbind mechanics (damage, healing, and death link) now function flawlessly across all dimensions, including modded ones.
• Server-Safe Design: All client code (GUIs, keybinds, visuals) is properly separated to prevent crashes on dedicated servers.
• Addon-Ready API: Built for modders — create, register, and expand the Kindred Souls system with ease.

---

Two souls, bound by trust. When the Ward falls, the Guardian follows — but their courage endures beyond death.