Skill

Inherits: Item < RefCounted

Inherited By: ActiveSkill

Abstract base class for all skills in the game. Extends Item.

Skills are composed of Component instances that define their behavior (damage, healing, range, costs, critical stats, etc.).

Execution pipeline:

skill.duplicate(owner_id) → start_skill() → use_skill(target)

start_skill() runs the 3-phase mod pipeline via entity signals (PRE/MAIN/FINAL_SKILL_MODS), where equipped passives, gear, and runes write into each component’s _mod_component snapshot.

use_skill() applies the effect: PRE_EFFECT signal → target defense → effect → VFX → POST_EFFECT signal.

Skills are always duplicated before execution; the original is never modified.

Properties

int	skill_source_id
int	level	1
Resistance.ElementTypes	element_type
Skill.SkillTags[]	skill_tags
Rune	rune_socket
Component.Type	components	{}
int	skill_owner_id	-1

Methods

void	start_skill()
void	use_skill(target: Entity) abstract
Skill	duplicate(own: int = -1)
void	floating_skill_vfx(target: Entity)

---

Property Descriptions

int skill_source_id 🔗

Unique identifier of the original skill instance. Set at construction; preserved across duplicates to identify the skill.

---

int level = 1 🔗

Current skill level.

---

Resistance.ElementTypes element_type 🔗

Element type.

---

Skill.SkillTags[] skill_tags 🔗

Tags categorizing this skill.

---

Rune rune_socket 🔗

Rune socketed into this skill. Activated in start_skill().

Can be equipped/unequipped via UI (see RuneInventoryUI).

---

Component.Type components = {} 🔗

The list of Component instances that define this skill’s behavior.

Populated in _init_components() at construction.

---

int skill_owner_id = -1 🔗

Instance ID of the owning entity (or NO_OWNER if unowned).

---

Method Descriptions

void start_skill() 🔗

Prepares the skill for execution: connects the rune if socketed, then runs the 3-phase mod pipeline (PRE/MAIN/FINAL_SKILL_MODS) on the owner entity’s signals.

Must be called before use_skill().

---

void use_skill(target: Entity) abstract 🔗

Applies the skill’s effect to target.

Called after start_skill() in the execution pipeline.

---

Skill duplicate(own: int = -1) 🔗

Creates a deep copy of this skill with a new owner.

The new instance has fresh components but retains the rune_socket and skill_source_id.

---

void floating_skill_vfx(target: Entity) 🔗

Shows a floating VFX icon above the target entity.