# \ud83c\udf19 Kindred Souls
\n*A Minecraft mod about eternal bonds between two connected spirits.*<\/p>\n
—<\/p>\n
## \ud83d\udd4a Overview
\n**Kindred Souls** explores the sacred connection known as **soulbinding** \u2014 a supernatural bond linking two players, the **Guardian** and the **Ward**.
\nTheir lives are intertwined, their pain and healing shared. When one suffers, the other feels it.<\/p>\n
This mod is designed for **multiplayer** or **Essential singleplayer**, where cooperation and trust shape your destiny.
\nYour strength lies not in solitude \u2014 but in your bond.<\/p>\n
—<\/p>\n
## \ud83d\udc9e Gameplay
\nWhen you first join a world, you\u2019ll face a divine choice:<\/p>\n
### \u2728 Choose Your Role
\n– **Guardian** \u2013 The protector. When your Ward is harmed, you share their pain.
\n– **Ward** \u2013 The protected. Your life is linked to your Guardian, your strength flowing through the bond.<\/p>\n
Once bonded:
\n– **Damage Sharing:** When the Ward takes damage, the Guardian also takes equal damage.
\n– **Healing Sharing:** When the Ward heals, the Guardian heals too.
\n– **Lethal Bond:** If the **Ward** dies, their **Guardian** dies as well \u2014 but the Ward survives if the Guardian falls.
\n – If both are bound using `\/soulboundtwoway`, their fates become *mutually fatal.*<\/p>\n
Your destinies are forever intertwined \u2014 **two souls, one heartbeat.**<\/p>\n
—<\/p>\n
## \ud83d\udd2e Ability & Addon System (New!)
\nInspired by the *Origins* mod, **Kindred Souls** introduces an expandable **Ability System** that allows for endless creativity and personalization.<\/p>\n
– **Ability Registry:**
\n A brand-new system lets developers register their own *Ability Types* (e.g. \u201cFlame Guardian\u201d, \u201cShadow Ward\u201d, \u201cSpirit Weaver\u201d) \u2014 each with custom names, icons, and abilities.<\/p>\n
– **Ability Selection GUI:**
\n After two players soulbind, a sleek **Ability Selection Screen** appears, letting them choose from all available Ability Types for their role.
\n If only one type exists, it\u2019s assigned automatically.<\/p>\n
– **Forge Event Hooks:**
\n The API introduces a powerful set of events for mod developers to expand gameplay:
\n – `SoulbindHurtEvent` \u2013 Triggered when a Ward takes damage.
\n – `SoulbindHealEvent` \u2013 Triggered when shared healing occurs.
\n – `SoulbindPlayerTickEvent` \u2013 Fires once per second for each bound player; great for passives or effects.
\n – `SoulbindActiveAbilityEvent` \u2013 Base event for keybind-triggered custom abilities.<\/p>\n
> \ud83e\udde9 *Our ability framework takes inspiration from the beloved Origins mod, but reimagines it through the lens of shared souls rather than individual powers.*<\/p>\n
—<\/p>\n
## \ud83e\udded Soulmate Tracker (New HUD Feature)
\nA new **action bar HUD** now displays your soulmate\u2019s location and dimension, updating every second:<\/p>\n
– Guardians see:
\n `Ward is at X, Y, Z in [Dimension]`
\n– Wards see:
\n `Guardian is at X, Y, Z in [Dimension]`<\/p>\n
If your partner is offline, it clearly displays **”[Offline]”**.<\/p>\n
—<\/p>\n
## \u2699\ufe0f Compatibility
\nKindred Souls fully supports:
\n– **Multiplayer servers**
\n– **Singleplayer with Essential** (for friend-based connections)<\/p>\n
> \u26a0\ufe0f Playing entirely solo defeats the purpose \u2014 Kindred Souls is about connection, not isolation.<\/p>\n
—<\/p>\n
## \ud83e\uddd9 Admin \/ Dev Commands
\n| Command | Description |
\n|———-|————-|
\n| `\/soulbound unbind` | Breaks an existing soul link. |
\n| `\/soulboundtwoway (Bugged)({playername}` | Creates a two-way soulbind \u2014 both players act as Guardian *and* Ward, making the bond mutually fatal. |
\n| `\/soulbound {playername}` | Binds you as the specified player’s Ward. |<\/p>\n
—<\/p>\n
new command \/skills ADMIN only command. is useless in base mod and really only works if an addon registers some custom skills<\/p>\n
## \ud83e\udde9 Configuration
\nCustomize how bonding works through the configuration file:<\/p>\n
– `randomSelection = true` **
\n – Displays a **role selection GUI** on first world join (Guardian or Ward).<\/p>\n
– `randomSelection = false` *(default)*
\n – Disables automatic selection and enables **manual soulbinding requests** instead.
\n *(Note: visibility improvements for pending invites are planned in a future update.)*<\/p>\n
—<\/p>\n
## \ud83d\udee0\ufe0f Technical Notes
\n– **Cross-Dimensional Support:** Soulbind mechanics (damage, healing, and death link) now function flawlessly across all dimensions, including modded ones.
\n– **Server-Safe Design:** All client code (GUIs, keybinds, visuals) is properly separated to prevent crashes on dedicated servers.
\n– **Addon-Ready API:** Built for modders \u2014 create, register, and expand the Kindred Souls system with ease.<\/p>\n
—<\/p>\n
*Two souls, bound by trust. When the Ward falls, the Guardian follows \u2014 but their courage endures beyond death.*<\/p>\n","protected":false},"excerpt":{"rendered":"
Protect or be protected<\/p>\n","protected":false},"featured_media":90411,"template":"","meta":{"_minecraft_slug":"kindred-souls","_minecraft_project_id":"Ts7vjhVc","_minecraft_author":"SaphicDeveloper","_minecraft_license":"CC-BY-4.0","_minecraft_downloads":328,"_minecraft_follows":3,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"kindred-souls.zip","_minecraft_size_bytes":859792,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-15T16:50:49.892065Z","_minecraft_date_created":"2025-11-02T07:41:25.682397Z","_minecraft_date_modified":"2025-11-06T20:17:57.594470Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/kindred-souls","_minecraft_icon_attachment_id":90411,"_minecraft_imported_at":"2026-06-05T03:52:36+00:00","_minecraft_import_hash":"aa2eae8fe541e9fe5c5a403a28c8af0f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,104,122,867],"mod_loader":[106],"minecraft_version":[36],"class_list":["post-90410","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-forge","mod_category-magic","mod_category-social","mod_loader-forge","minecraft_version-1-20-1"],"yoast_head":"\n