Achievement List

Overview

AchievementList.xml defines achievement entries: goals that players can complete to earn titles, items, money, and other rewards.

Version support

Version	Status
v92	Full
v90	-
v86	-

---

DSL support

Entity: achievements Operations: create, update, delete, upsert File organization: RegionalVariants — AchievementList.xml, AchievementList_{region}.xml

---

Quick recipes

Create

spec:
  version: "1.0"
  schema: v92

achievements:
  create:
    - id: 99001
      name: "@Achievement:99001001"
      description: "@Achievement:99001002"
      iconName: "Icon_Achievement.Icon_Achievement_Title_dungeon_Tex"
      categoryId: 608
      grade: 1
      point: 20
      active: true
      compare: true
      compareId: 6024
      conditionCheckMethod: "AND"
      classes: "common"
      serverUnique: "none"
      hidden: false
      mailSender: "@Achievement:99001005"
      detail: "@Achievement:99001003"
      conditions:
        - id: 0
          templateId: 4023
          type: "check"
          string: "@Achievement:99001004"
          value1: 1
      rewards:
        - rewardType: "title"
          title: "@Achievement:99001501"

Update

spec:
  version: "1.0"
  schema: v92

achievements:
  update:
    - id: 99001
      changes:
        active: false
        point: 30
        grade: 2

Delete

spec:
  version: "1.0"
  schema: v92

achievements:
  delete:
    - 99001

Upsert

spec:
  version: "1.0"
  schema: v92

achievements:
  upsert:
    - id: 99001
      name: "@Achievement:99001001"
      description: "@Achievement:99001002"
      iconName: "Icon_Achievement.Icon_Achievement_Title_dungeon_Tex"
      categoryId: 608
      grade: 1
      point: 20
      active: true
      compare: true
      compareId: 6024
      conditionCheckMethod: "AND"
      classes: "common"
      serverUnique: "none"

---

Properties reference

Required attributes

Attribute	Type	Since	Description
id	int	v92	Unique achievement identifier
name	string	v92	Display name (string table reference)
description	string	v92	Description text (string table reference)
iconName	string	v92	Achievement icon texture name
categoryId	int	v92	Category this achievement belongs to
grade	int	v92	Achievement grade/tier (0-based)
point	int	v92	Points awarded on completion
active	bool	v92	Whether the achievement is active
compare	bool	v92	Whether the achievement is comparable
compareId	int	v92	ID used for comparison logic
conditionCheckMethod	string	v92	How conditions are evaluated (AND or OR)
classes	string	v92	Class restriction (common for all classes)
serverUnique	string	v92	Server uniqueness constraint (none, region codes)

Optional attributes

Attribute	Type	Since	Description
hidden	bool	v92	Whether the achievement is hidden from the list
hasTitle	bool	v92	Whether the achievement grants a title
detail	string	v92	Detailed description (string table reference)
sortGroup	string	v92	Grouping key for sort order
isDailyPlayGuide	bool	v92	Whether shown in daily play guide
notifyLevel	int	v92	Notification priority level
mailSender	string	v92	Mail sender name for reward delivery
withoutMsgClasses	string	v92	Classes excluded from achievement messages
withoutRewardClasses	string	v92	Classes excluded from receiving rewards

---

Nested elements

Condition

Achievement completion conditions. Multiple conditions are combined using conditionCheckMethod.

Attribute	Type	Since	Required	Description
id	int	v92	Yes	Condition identifier (0 for single conditions)
templateId	int	v92	Yes	Condition template defining the check type
type	string	v92	No	Condition type (check, count)
max	int	v92	No	Maximum count for count-type conditions
string	string	v92	No	Display string (string table reference)
value1	int	v92	No	Condition parameter 1
value2	int	v92	No	Condition parameter 2
value3	int	v92	No	Condition parameter 3
value4	int	v92	No	Condition parameter 4
value5	int	v92	No	Condition parameter 5
value6	int	v92	No	Condition parameter 6

Reward

Achievement rewards. Each reward has a rewardType discriminator that determines which attributes apply.

Attribute	Type	Since	Required	Description
rewardType	RewardType	v92	Yes	Discriminator for reward type

Reward types

rewardType	Required attributes	Optional attributes
title	title	directApply
item	templateId, amount	desc
money	amount	—
special	type, desc	targetId, targetType, value
ability	abilityId	—
awaken	grade	—

Reward attributes

Attribute	Type	Since	Description
title	string	v92	Title string (string table reference)
directApply	bool	v92	Whether title is applied automatically
templateId	int	v92	Item template ID
amount	int	v92	Item count or money amount
desc	string	v92	Reward description
type	string	v92	Special reward type (extendInven, etc.)
targetId	string	v92	Special reward target ID
targetType	string	v92	Special reward target type (npc, etc.)
value	decimal	v92	Special reward value
abilityId	int	v92	Ability reward ID
grade	int	v92	Awaken reward grade

---

Enum types

RewardType

Value	Since	Description
title	v92	Grants a title
item	v92	Grants an item
money	v92	Grants gold
special	v92	Grants a special reward (inventory expansion, etc.)
ability	v92	Grants an ability
awaken	v92	Grants an awaken grade

---

XML structure

AchievementList.xml
└── AchievementList
    └── Achievement (0..∞)
        @id @name @description @iconName @categoryId @grade @point
        @active @compare @compareId @conditionCheckMethod @classes
        @serverUnique @hidden? @hasTitle? @detail? @sortGroup?
        @isDailyPlayGuide? @notifyLevel? @mailSender?
        @withoutMsgClasses? @withoutRewardClasses?
        ├── Condition (0..∞)
        │   @id @templateId @type? @max? @string?
        │   @value1? @value2? @value3? @value4? @value5? @value6?
        └── RewardList (0..1)
            ├── TitleReward      @title @directApply?
            ├── ItemReward       @templateId @amount @desc?
            ├── MoneyReward      @amount
            ├── SpecialReward    @type @desc @targetId? @targetType? @value?
            ├── AbilityReward    @id
            └── AwakenReward     @grade

---

Common pitfalls

• Regional variants: Achievement files use regional suffixes (_KR, _JP, _NAEU, etc.). Regional files contain only the achievements that differ from the base AchievementList.xml.
• String table references: name, description, detail, mailSender, and condition string values are string table references (format @Achievement:{id}{suffix}), not literal text.
• Condition values: The meaning of value1 through value6 depends on the templateId. Refer to the condition template definitions for the correct parameter mapping.
• Reward discrimination: Each reward entry requires rewardType to determine which attributes are valid. Using attributes from the wrong reward type is silently ignored.
• Clear-and-replace: Conditions and rewards use clear-and-replace semantics. On update, providing a new conditions or rewards list replaces the entire set — partial updates of individual conditions/rewards are not supported.