🌙 Kindred Souls API & Skills Update – Changelog

This update introduces a major new Skill & Progression System and a vastly expanded API for addon developers.
Players can now unlock new skills tied to their chosen roles, while mod makers can define entirely new ability types, skills, and even custom “classes” for Guardians and Wards.

---

🧭 Major New Features

Skill Tree System

A full progression and unlock system has been implemented. Players can now earn and invest skill points to enhance their chosen ability path.

New Skill Tree GUI

• Accessed via a new keybind (default: N).
• Features a pannable, advancement-style interface with tabs for each available IAbilityType (e.g., Guardian, Ward).
• Skills are displayed as nodes connected by dependency lines.
• Hovering over a skill displays:
  • Skill name and description
  • Unlock cost and dependency requirements
• Unlocking a skill prompts a confirmation pop-up.
• Player progression is now saved to world data, ensuring persistence across sessions.

---

⚔️ New Gameplay Mechanic

Skill-based progression now defines how powerful your Guardian or Ward can become. Unlock passive buffs, defensive triggers, or special cooperative effects tied to your bond.

Note:
By default, the standard Guardian and Ward roles do not have any skills.
However, this new API makes it easy for any addon or mod to add skill trees, new ability types, or progression systems to them.
This ensures complete flexibility for addon creators to define how their unique Guardian or Ward subclasses evolve.

---

🧩 New API for Addon Developers

The IKindredSoulsAPI has been significantly expanded for addon creators.
Developers can now register new abilities, skills, unlock conditions, and integrate seamlessly with the new Skill Tree system.

New Registries

• getSkillRegistry() — Register new ISkill objects.
  Addons can inject their skills into any ability tab, including the defaults or those from other mods.
• getSkillUnlockRegistry() — Register new ISkillUnlockCondition types.
  Allows defining unique unlock logic for any skill (e.g., XP cost, item cost, quest completion).

---

New API Interfaces

ISkill

Defines a skill node in the progression system.

• Requires:
  • Unique ID
  • Parent Ability Tab
  • Name, description, and icon
  • GUI coordinates (x, y)
  • Dependency list for skill chaining

ISkillUnlockCondition

Defines how a skill is unlocked.

• canUnlock(player, skill): Server-side validation (e.g., "has 5 XP levels?")
• applyCost(player, skill): Applies the cost (e.g., removes XP)
• getCostDescription(player, skill): Returns descriptive text for the UI (e.g., "Cost: 5 Levels")

---

New API Methods

• isSkillUnlocked(player, skillId) — Check if a player has a specific skill unlocked.

---

🔥 Event Enhancements

• SoulbindHurtEvent and SoulbindHealEvent are now Cancelable.
  Addons can now intercept, modify, or cancel the default soulbinding damage and healing logic.

• SoulbindPlayerTickEvent — Fires once per second for every bound player.
  Perfect for implementing passive or timed skill effects.

---

🧑‍💻 New Commands (Admins & Developers)

• /skill grant <player> <skill_id>
  Grants a skill to a player directly, bypassing dependencies or costs.
  Includes tab-completion for all registered skills.

• /skill revoke <player> <skill_id>
  Removes a skill from a player.
  Includes tab-completion for skills currently unlocked by the target.

---

🧠 Summary

The Kindred Souls API now provides:

• Full Skill Tree customization
• Extendable Skill and Unlock registries
• Deep event hooks for damage, healing, and ticking logic
• Developer tools for testing and integration
• Freedom for addons to define their own Guardian/Ward skill systems

Download mdk to develop addons