Skill Data

Overview

SkillData defines combat skills across three YAML sections—npcSkills, userSkills, and commonSkills—sharing a common property model. NPC skills are zone-partitioned by huntingZoneId, while User and Common skills are category-partitioned by class/race combination.

Version Support

Version	Status
v92	Supported

DSL Support

Section	Entity	Key	File Organization
`npcSkills`	NpcSkill	`huntingZoneId` + `templateId` + `skillId`	`SkillData_{huntingZoneId}.xml`
`userSkills`	UserSkill	`category` + `id`	`UserSkillData_{category}.xml`
`commonSkills`	CommonSkill	`category` + `id`	`UserSkillData_{category}.xml`

Supported operations: create, update, delete, upsert

Quick Recipes

Create NPC Skill

npcSkills:
  create:
    - huntingZoneId: 456
      templateId: 1000
      skillId: 10100
      name: "Basic Attack"
      totalAtk: 100
      attackRange: 50

Create User Skill

userSkills:
  create:
    - category: Warrior_Human_M
      id: 10100
      name: "Combo Attack"
      totalAtk: 150
      attackRange: 40

Create Common Skill

commonSkills:
  create:
    - category: Common
      id: 10100
      name: "Resurrection"

Update

npcSkills:
  update:
    - huntingZoneId: 456
      templateId: 1000
      skillId: 10100
      changes:
        totalAtk: 200
        attackRange: 60

Delete

npcSkills:
  delete:
    - huntingZoneId: 456
      templateId: 1000
      skillId: 10100

Upsert

userSkills:
  upsert:
    - category: Warrior_Human_M
      id: 10100
      name: "Combo Attack"
      totalAtk: 200

Top-Level Properties

NPC-Only Properties

Attribute	Type	Since	Description
`huntingZoneId`	`int`	v92	Hunting Zone Id
`templateId`	`int`	v92	Template Id

Shared Properties

Attribute	Type	Since	Description
`abnormalityTargetIsOwner`	`bool`	v92	Abnormality Target Is Owner
`adjAtkByNpcHp`	`bool`	v92	Adj Atk By Npc Hp
`adjAtkByTargetHp`	`string`	v92	Adj Atk By Target Hp
`aiRotateThreshold`	`int`	v92	Ai Rotate Threshold
`allDirectionDefence`	`bool`	v92	All Direction Defence
`applyAttackAnimRate`	`bool`	v92	Apply Attack Anim Rate
`applyDistanceDamageRate`	`bool`	v92	Apply Distance Damage Rate
`attackRange`	`int`	v92	Attack Range
`autoUse`	`bool`	v92	Auto Use
`canUseOnCombatMode`	`bool`	v92	Can Use On Combat Mode
`canUseOnRide`	`bool`	v92	Can Use On Ride
`category`	`string`	v92	Category
`changeDirMethodOnSkillEnd`	`string`	v92	Change Dir Method On Skill End
`changeDirOnSkillEnd`	`bool`	v92	Change Dir On Skill End
`changeDirToCenter`	`bool`	v92	Change Dir To Center
`changeDirection`	`bool`	v92	Change Direction
`ignoreAir`	`bool`	v92	Ignore Air
`ignoreDefence`	`string`	v92	Ignore Defence
`ignoreLos`	`bool`	v92	Ignore Los
`ignoreShield`	`bool`	v92	Ignore Shield
`isPlayArmorSound`	`bool`	v92	Is Play Armor Sound
`name`	`string`	v92	Name
`needWeapon`	`bool`	v92	Need Weapon
`nextSkill`	`string`	v92	Next Skill
`pushtarget`	`string`	v92	Pushtarget
`switchInfo`	`string`	v92	Switch Info
`timeRate`	`decimal`	v92	Time Rate
`totalAtk`	`int`	v92	Total Atk
`type`	`string`	v92	Type

Nested Elements

Element	Type	Sections	Description	Reference
`actions`	list	All	Actions	Action
`aggro`	nested	All	Aggro	Aggro
`anger`	nested	All	Anger	Anger
`balanceRef`	nested	NPC	Balance Ref	BalanceRef
`bullet`	nested	All	Bullet	Bullet
`defence`	nested	All	Defence	Defence
`direction`	nested	All	Direction	Direction
`drain`	nested	All	Drain	Drain
`drainBack`	nested	All	Drain Back	DrainBack
`precondition`	nested	All	Precondition	Precondition
`projectile`	nested	All	Projectile	Projectile
`property`	nested	All	Property	Property
`resistance`	nested	All	Resistance	Resistance
`targetingLists`	list	All	Targeting Lists	TargetingList
`teleport`	nested	All	Teleport	Teleport

XML Structure

Skill (root)
├─ Property
├─ Direction
├─ Bullet
├─ Defence
├─ Aggro
├─ Anger
├─ Resistance
├─ Teleport
├─ Drain
├─ DrainBack
├─ Precondition
│  ├─ Cost
│  └─ ExclusiveAbnormality
├─ Projectile
├─ BalanceRef (NPC-only)
├─ Action [multiple]
│  ├─ HitInvincible
│  ├─ MoveInvincible
│  ├─ NoReaction
│  ├─ Pending
│  ├─ Cancel
│  ├─ ChangeDir
│  ├─ CameraType
│  └─ Stage [multiple]
│     ├─ StageProperty
│     ├─ AnimSeq [multiple]
│     └─ CameraShake [multiple]
└─ TargetingList [multiple]
   └─ Targeting [multiple]
      ├─ TargetingCost
      └─ Area [multiple]
         ├─ Reaction
         ├─ HitEffect [multiple]
         ├─ TargetCondition
         └─ Effect
            ├─ HpDiff
            ├─ MpDiff
            ├─ AggroDiff
            ├─ AngerDiff
            ├─ Rebirth
            ├─ AbnormalityOnCommon
            └─ DynamicSpawn

Enum Reference

AdjustTargetingPos

Value
`normal`
`notUse`
`toTarget`
`toTargetWithGeo`

AnimControlType

Value
`move`
`move_with_skill`
`normal`
`sync_move`

AreaPurpose

Value
`attack`
`byType`
`notAttack`

CameraShakeStartCondition

Value
`allHit`
`firstHit`
`skillEnd`
`skillStart`
`stageStart`

CameraShakeTargetType

Value
`all`
`me`
`meAndTarget`

CameraTypeKind

Value
`none`
`delay`
`delay_align`
`follow_animation`

ChangeDirMethod

Value
`dir`
`dist`

HitEffectType

Value
`animationDamage`
`none`
`notShow`
`notShowAll`
`nothing`
`noting`
`notshow`
`notshowall`
`onlyAnimation`
`show`

PushTarget

Value
`pass`
`push`
`pushall`
`stop`

ReactionPendingType

Value
`normal`
`allTimeLine`
`immediateCancel`
`rearCancel`

ReactionType

Value
`air`
`mini`
`none`

SelectMethod

Value
`Dist`
`ReverseDist`
`dir`
`hpLess`
`hpMore`
`no`
`random`

SkillPendingType

Value
`normal`
`allTimeLine`
`disable`
`hotkeyrearCancelOnly`
`immediateCancel`
`immediawateCancel`
`rearCancel`
`rearCancelOnly`
`superCancel`

TargetingMethod

Value
`target`
`self`
`lockOn`
`normal`
`nomal`
`collect`
`marked`
`autoLockOn`
`rangelockon`
`real_forward`
`spiritAttack`
`spiritFollow`
`teleport`

WeaponStatus

Value
`@in`
`@out`