Abnormality

Version support

Version	Status
v92	Full
v90	-
v86	-

Abnormality.xml defines buffs and debuffs: status effects applied to entities with attributes controlling type, duration, stacking, visibility, and nested effect children that define stat modifications and visual effects.

Abnormality data is organized across regional variant XML files:

Suffix	File
(base)	`Abnormality.xml`
`_CN`	`Abnormality_CN.xml`
`_EP`	`Abnormality_EP.xml`
`_JP`	`Abnormality_JP.xml`
`_KR`	`Abnormality_KR.xml`
`_NAEU`	`Abnormality_NAEU.xml`
`_RUS`	`Abnormality_RUS.xml`
`_THA`	`Abnormality_THA.xml`
`_TW`	`Abnormality_TW.xml`

DSL support

Entity: abnormalities Operations: create, update, delete, upsert

Quick recipes

Create

spec:
  version: "1.0"
  schema: v92

abnormalities:
  create:
    - id: 100001
      name: "CritDamageBoost"
      kind: 1
      isBuff: true
      level: 10
      time: 30000
      priority: 1
      isShow: "True"

Create with effects

spec:
  version: "1.0"
  schema: v92

abnormalities:
  create:
    - id: 100002
      name: "DefenseAura"
      kind: 2
      isBuff: true
      level: 5
      time: 60000
      priority: 2
      isShow: "True"
      effects:
        - type: 3
          method: 1
          value: "200"
        - type: 5
          method: 2
          value: "500"
          min: 10.5
          max: 20.5

Update

spec:
  version: "1.0"
  schema: v92

abnormalities:
  update:
    - id: 100001
      changes:
        time: 60000
        level: 20

Update with effects (clear-and-replace)

Providing effects in an update replaces all existing effect children.

spec:
  version: "1.0"
  schema: v92

abnormalities:
  update:
    - id: 100002
      changes:
        effects:
          - type: 10
            method: 3
            value: "999"

Upsert

Creates the entry if it doesn’t exist, or updates it if it does.

spec:
  version: "1.0"
  schema: v92

abnormalities:
  upsert:
    - id: 100003
      name: "SpeedBuff"
      isBuff: true
      time: 15000

Delete

spec:
  version: "1.0"
  schema: v92

abnormalities:
  delete:
    - 100001

Properties reference

Identification

Property	Type	Required	Since	Description
`id`	`int`	Yes	v92	Unique abnormality identifier
`name`	`string`	No	v92	Internal abnormality name
`kind`	`int`	No	v92	Abnormality kind classification
`category`	`string`	No	v92	Content category string
`property`	`int`	No	v92	Property type code (1-4)
`group`	`AbnormalityGroup`	No	v92	Abnormality group classification

Status

Property	Type	Required	Since	Description
`isBuff`	`boolean`	No	v92	Whether this is a buff (true) or debuff (false)
`level`	`int`	No	v92	Abnormality level
`priority`	`int`	No	v92	Display and override priority
`isShow`	`AbnormalityIsShow`	No	v92	UI visibility mode
`mobSize`	`AbnormalityMobSize`	No	v92	Target mob size filter
`elementType`	`int`	No	v92	Element type code

Duration

Property	Type	Required	Since	Description
`time`	`int`	No	v92	Duration in milliseconds
`infinity`	`boolean`	No	v92	Whether duration is infinite. Structural default: `false`.
`realTime`	`boolean`	No	v92	Whether to use real time instead of game time
`maintainTime`	`boolean`	No	v92	Whether to maintain time across zone changes
`accumulateTime`	`boolean`	No	v92	Whether duration accumulates across applications
`accumulateTimeId`	`int`	No	v92	Shared accumulation group ID
`maxAccumulateTime`	`int`	No	v92	Maximum accumulated duration

Stacking

Property	Type	Required	Since	Description
`maxStackCount`	`int`	No	v92	Maximum stack count
`clearStack`	`boolean`	No	v92	Whether to clear stacks on reapplication. Structural default: `false`.
`infinityStack`	`boolean`	No	v92	Whether stacks are unlimited
`startStackCount`	`int`	No	v92	Initial stack count on first application
`stackCountShareId`	`int`	No	v92	Shared stack count group ID

Behavior

Property	Type	Required	Since	Description
`noRefresh`	`boolean`	No	v92	Whether reapplication does not refresh duration
`noOverwrite`	`boolean`	No	v92	Whether existing instance cannot be overwritten
`cancelCondition`	`string`	No	v92	Condition that cancels the abnormality
`cancelConditionProb`	`int`	No	v92	Cancel condition probability
`cancelConditionValue`	`string`	No	v92	Cancel condition threshold value
`bySkillCategory`	`string`	No	v92	Required skill category to trigger
`judgmentOnce`	`boolean`	No	v92	Whether effect triggers only once
`isStance`	`boolean`	No	v92	Whether this is a stance-type abnormality
`saveImmediate`	`boolean`	No	v92	Whether to save state immediately
`canHold`	`boolean`	No	v92	Whether effect can be held
`isTransform`	`boolean`	No	v92	Whether this is a transformation effect
`switchOffSkillTemplateId`	`int`	No	v92	Skill template ID to deactivate

Visibility

Property	Type	Required	Since	Description
`hideBuffFailMessage`	`boolean`	No	v92	Whether to hide buff application failure messages. Structural default: `false`.
`isHideOnRefresh`	`boolean`	No	v92	Whether to hide icon on duration refresh. Structural default: `false`.
`isHideOnRaid`	`boolean`	No	v92	Whether to hide in raid UI
`showParty`	`boolean`	No	v92	Whether to show on party frames
`showOtherUsers`	`boolean`	No	v92	Whether to show on other players
`useDamageFont`	`boolean`	No	v92	Whether to use damage font for values
`hitEffectTargetType`	`string`	No	v92	Hit effect visual target type
`isBlockOtherSpecialShader`	`boolean`	No	v92	Whether to block other special shaders

Combat

Property	Type	Required	Since	Description
`notCareBattleField`	`boolean`	No	v92	Whether to persist across battlefields
`notCareDeath`	`boolean`	No	v92	Whether to persist through death. Structural default: `false`.
`skipByReaction`	`boolean`	No	v92	Whether to skip reaction checks. Structural default: `false`.
`balancedByTargetCount`	`boolean`	No	v92	Whether effect scales by target count
`peaceOnly`	`boolean`	No	v92	Whether effect applies only in peace zones. Structural default: `false`.
`isKeepingWorldChange`	`boolean`	No	v92	Whether to keep across world changes
`isSameInvokerPartyAndWorld`	`boolean`	No	v92	Whether invoker must be in same party and world
`needHaveAbnormalId`	`int`	No	v92	Required prerequisite abnormality ID

Level constraints

Property	Type	Required	Since	Description
`levelOver`	`int`	No	v92	Minimum character level required
`levelUnder`	`int`	No	v92	Maximum character level allowed

Effects

Property	Type	Required	Since	Description
`effects`	`list[nested]`	No	v92	List of AbnormalityEffect children. See effect properties below.

Effect properties

Each effect in the effects list defines a stat modification or visual effect.

Core

Property	Type	Required	Since	Description
`type`	`int`	Yes	v92	Effect type code
`method`	`int`	Yes	v92	Application method code
`value`	`string`	Yes	v92	Effect value
`min`	`decimal`	No	v92	Minimum value. Structural default: `0`.
`max`	`decimal`	No	v92	Maximum value. Structural default: `0`.
`variation`	`decimal`	No	v92	Value variation range. Structural default: `0`.
`tickInterval`	`decimal`	No	v92	Tick rate in milliseconds. Structural default: `0`.
`defenceBonusRate`	`int`	No	v92	Defence bonus rate modifier

Visual effects

Property	Type	Required	Since	Description
`effectId`	`int`	No	v92	Primary effect ID
`effectPart`	`string`	No	v92	Body part for effect attachment
`overlayEffectId`	`int`	No	v92	Overlay effect ID
`appearEffectId`	`int`	No	v92	Effect played on appear
`disappearEffectId`	`int`	No	v92	Effect played on disappear
`damageEffectId`	`int`	No	v92	Effect played on damage tick
`effectTime`	`int`	No	v92	Effect duration override
`attackEffectId`	`int`	No	v92	Effect played on attack
`arcaneFxId`	`int`	No	v92	Arcane FX system ID

Shaders

Property	Type	Required	Since	Description
`shaderOnMy`	`string`	No	v92	Shader applied on self
`shaderOnOther`	`string`	No	v92	Shader applied on enemies
`shaderOnAlly`	`string`	No	v92	Shader applied on allies
`appearShader`	`string`	No	v92	Shader played on appear
`disappearShader`	`string`	No	v92	Shader played on disappear

Post-processing

Property	Type	Required	Since	Description
`postProcessId`	`int`	No	v92	Post-process effect ID
`postProcessEffectIds`	`int`	No	v92	Additional post-process effect IDs
`postProcessAppearTime`	`int`	No	v92	Post-process appear transition time
`postProcessDisappearTime`	`int`	No	v92	Post-process disappear transition time
`isStartPostProcessEffect`	`boolean`	No	v92	Whether to start post-process on apply

Link effects

Property	Type	Required	Since	Description
`linkEffectResource`	`string`	No	v92	Linked effect resource path
`linkEffectDuration`	`decimal`	No	v92	Linked effect duration
`isEnemyCheck`	`int`	No	v92	Enemy check type code

Enum types

AbnormalityIsShow

Value	Since	Description
`True`	v92	Show icon and system message
`False`	v92	Hidden from UI
`OnlyIcon`	v92	Show icon only, no system message
`OnlySystemMessage`	v92	Show system message only, no icon
`OnlyIconNoCoolTime`	v92	Show icon without cooldown display

AbnormalityMobSize

Value	Since	Description
`all`	v92	All mob sizes
`any`	v92	Any mob size
`player`	v92	Player-sized targets only
`large`	v92	Large mobs only
`medium`	v92	Medium mobs only
`small`	v92	Small mobs only

AbnormalityGroup

Value	Since	Description
`skill`	v92	Skill-related abnormality
`etc`	v92	Miscellaneous abnormality
`doping`	v92	Consumable buff
`none`	v92	No group

AbnormalityProperty

Value	Since	Description
`1`	v92	Property type 1
`2`	v92	Property type 2
`3`	v92	Property type 3
`4`	v92	Property type 4

XML structure

Abnormality.xml
└── Abnormality (root)
    └── Abnormal (0..∞)
        @id (required)
        @name?
        @kind?
        @category?
        @property?
        @isBuff?
        @level?
        @time?
        @infinity (structural default: false)
        @hideBuffFailMessage (structural default: false)
        @isHideOnRefresh (structural default: false)
        @notCareDeath (structural default: false)
        @clearStack (structural default: false)
        @peaceOnly (structural default: false)
        @skipByReaction (structural default: false)
        @... (53 total attributes)
        └── AbnormalityEffect (0..∞)
            @type (required)
            @method (required)
            @value (required)
            @min (structural default: 0)
            @max (structural default: 0)
            @variation (structural default: 0)
            @tickInterval (structural default: 0)
            @... (30 total attributes)

Common pitfalls

Effects use clear-and-replace: Providing effects in an update removes all existing effect children and creates new ones. Omitting effects preserves existing children.
Effect required fields: Each effect requires type, method, and value. Missing any produces an error.
Structural defaults on create: Seven boolean attributes are set to false automatically: hideBuffFailMessage, infinity, isHideOnRefresh, notCareDeath, clearStack, peaceOnly, skipByReaction.
Effect structural defaults: Four decimal attributes are set to 0 on each effect: min, max, variation, tickInterval.
String-typed enums: isShow, mobSize, and group are string values, not integers. Values are matched case-insensitively, so isShow: true, isShow: True, and isShow: "True" are all accepted.
Regional variants: Data is spread across regional variant files. The pipeline resolves the correct file automatically.
ID uniqueness: Abnormality IDs must be unique within each XML file.
Companion schema: AbnormalityIconData uses the same abnormality IDs for icon mappings.