add-hero-trait

Use when adding hero trait mod implementations in hero-trait-mods.ts - guides reading trait descriptions, creating mod factories, adding stackables/config, and wiring up the calculation engine (project)

الانتقال إلى التثبيت

المستودع: aclinia/torchlight-of-building
آخر نشاط في المصدر: ١٥ فبراير ٢٠٢٦ في ٢٠:١٩
لغة SKILL.md المكتشفة: الإنجليزية
النجوم: ٤٠
التفرعات: ٢٩

خيارات التثبيت

يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.

التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.

يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.

npx skills add https://github.com/aclinia/torchlight-of-building --skill add-hero-trait

يبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.

تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.

مراجعة ملفات المصدر

اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.

SKILL.md

تعليمات المصدر · معاينة للقراءة فقط

العودة إلى البحث العودة إلى التثبيت

add-mod-resolver

Use when adding new push* resolver functions inside resolveModsForOffenseSkill to handle mod-based combat mechanics like tangles, debuffs, or conditional damage bonuses (project)

2026-02-17

adding-support-mod-parsers

Use when adding support mod parsers to convert support skill affix strings to typed SupportMod objects - guides the template-based parsing pattern (project)

2026-02-17

adding-mod-parsers

Use when adding new mod parsers to convert game mod strings to typed Mod objects - guides the template-based parsing pattern (project)

2026-02-15

عرض الكل من هذا المستودع

name	add-hero-trait
description	Use when adding hero trait mod implementations in hero-trait-mods.ts - guides reading trait descriptions, creating mod factories, adding stackables/config, and wiring up the calculation engine (project)

Adding Hero Trait Mods

Overview

Hero traits are implemented as mod factories in src/tli/hero/hero-trait-mods.ts. Each factory takes a level index (0-4) and returns an array of Mod objects. The trait's description in src/data/hero-trait/hero-traits.ts is the source of truth for what mods and values to produce.

When to Use

Implementing a hero trait that isn't yet in heroTraitModFactories
Adding calculation support for a hero trait's mechanics

Step 0: Read the Trait Description

Always start here. Look up the trait in src/data/hero-trait/hero-traits.ts and read its affix field. This determines:

What mods to create and their types
The per-level values (formatted as (v1/v2/v3/v4/v5) for levels 1-5)
Whether it's a player buff or enemy debuff ("damage taken by the enemy" = isEnemyDebuff: true)
Whether it stacks and the max stack count
Any conditions for activation

Project File Locations

Purpose	File Path
Trait descriptions (source of truth)	`src/data/hero-trait/hero-traits.ts`
Trait mod factories	`src/tli/hero/hero-trait-mods.ts`
Mod type definitions	`src/tli/mod.ts`

Pattern	Example Trait	Implementation
Simple constant buff	Frostbitten Heart	`() => [{ type: "DmgPct", ... }]`
Level-scaled value	Deepfreeze	`(i) => [{ ..., value: [v1,v2,v3,v4,v5][i] }]`
Per-stack with config	Dance of Frost	`per: { stackable: "x", limit: N }` + config + normalize
Conditional activation	Frostbitten Heart	`cond: "condition_name"` + config boolean
Flag mod (enables mechanic)	Wind Stalker	`{ type: "WindStalker" }` (object mod)
Override limit	Deepfreeze	`{ type: "MaxFrostbiteRatingLimitOverride", value: X }`

Mistake	Fix
Not reading the trait description first	Always check `src/data/hero-trait/hero-traits.ts` for the `affix` field
Guessing values instead of reading description	Values come from the `(v1/v2/v3/v4/v5)` format in the affix
Missing `isEnemyDebuff: true`	"damage taken by the enemy" = enemy debuff, not player buff
Forgetting `limit` on per-stackable	"stacks up to N times" needs `limit: N`
Not adding `normalize()` for new stackables	Per-stackable mods won't resolve without `normalize()` in offense.ts
Placing config UI in wrong section	Hero-specific config goes near other hero fields
Trait name doesn't match data	Key must exactly match `name` in `hero-traits.ts` (typed as `HeroTraitName`)

add-hero-trait

خيارات التثبيت

مراجعة ملفات المصدر

Adding Hero Trait Mods

Overview

When to Use

Step 0: Read the Trait Description

Project File Locations

Adding Hero Trait Mods

Overview

When to Use

Step 0: Read the Trait Description

Project File Locations

Implementation Checklist

1. Add Mod Factory (`src/tli/hero/hero-trait-mods.ts`)

2. Add New Mod Types (if needed, `src/tli/mod.ts`)

3. Add New Stackable (if needed, `src/tli/mod.ts`)

4. Add New Condition (if needed, `src/tli/mod.ts`)

5. Add Configuration Field (if needed)

6. Wire Up in Calculation Engine (`src/tli/calcs/offense.ts`)

7. Verify

Common Trait Patterns

Common Mistakes

add-hero-trait

معلومات المصدر

خيارات التثبيت

مراجعة ملفات المصدر

المزيد من هذا المستودع

Adding Hero Trait Mods

Overview

When to Use

Step 0: Read the Trait Description

Project File Locations

المزيد من هذا المستودع

Adding Hero Trait Mods

Overview

When to Use

Step 0: Read the Trait Description

Project File Locations

Implementation Checklist

1. Add Mod Factory (src/tli/hero/hero-trait-mods.ts)

2. Add New Mod Types (if needed, src/tli/mod.ts)

3. Add New Stackable (if needed, src/tli/mod.ts)

4. Add New Condition (if needed, src/tli/mod.ts)

5. Add Configuration Field (if needed)

6. Wire Up in Calculation Engine (src/tli/calcs/offense.ts)

7. Verify

Common Trait Patterns

Common Mistakes

1. Add Mod Factory (`src/tli/hero/hero-trait-mods.ts`)

2. Add New Mod Types (if needed, `src/tli/mod.ts`)

3. Add New Stackable (if needed, `src/tli/mod.ts`)

4. Add New Condition (if needed, `src/tli/mod.ts`)

6. Wire Up in Calculation Engine (`src/tli/calcs/offense.ts`)