Achievement Category Info

Overview

AchievementCategoryInfo.xml defines the achievement category hierarchy used for UI navigation, with main categories containing sub-categories that group related achievements.

Version support

Version	Status
v92	Full
v90	-
v86	-

---

DSL support

Entity: achievementCategories Operations: create, update, delete, upsert File organization: SingleFile — AchievementCategoryInfo.xml

---

Quick recipes

Create

spec:
  version: "1.0"
  schema: v92

achievementCategories:
  create:
    - id: 900
      name: "@Achievement:99900001"
      priority: 10
      normalImage: "normalBtn_up"
      overImage: "normalBtn_over"
      pressImage: "normalBtn_click"
      subCategories:
        - id: 901
          name: "@Achievement:99901001"
        - id: 902
          name: "@Achievement:99902001"

Update

spec:
  version: "1.0"
  schema: v92

achievementCategories:
  update:
    - id: 900
      changes:
        priority: 5
        name: "@Achievement:99900002"
        subCategories:
          - id: 901
            name: "@Achievement:99901002"
            excludeAlmost: true

Delete

spec:
  version: "1.0"
  schema: v92

achievementCategories:
  delete:
    - 900

Upsert

spec:
  version: "1.0"
  schema: v92

achievementCategories:
  upsert:
    - id: 900
      name: "@Achievement:99900001"
      priority: 10
      normalImage: "normalBtn_up"
      overImage: "normalBtn_over"
      pressImage: "normalBtn_click"

---

Properties reference

Main category attributes

Attribute	Type	Since	Required	Description
id	int	v92	Yes	Main category identifier
name	string	v92	No	Category name (string table reference)
priority	int	v92	No	Display order priority
normalImage	string	v92	No	Button image for normal state
overImage	string	v92	No	Button image for hover state
pressImage	string	v92	No	Button image for pressed state
isSummary	bool	v92	No	Whether this is a summary category
summaryId	int	v92	No	ID of the summary to display
isSummaryCounting	bool	v92	No	Whether to count towards summary
isGrade	bool	v92	No	Whether this category has grade tiers
isCompensation	bool	v92	No	Whether this category has grade compensation
excludeAlmost	bool	v92	No	Whether to exclude from “almost complete” filter
str1	string	v92	No	Additional string reference 1
str2	string	v92	No	Additional string reference 2
str3	string	v92	No	Additional string reference 3
subCategories	list[SubCategory]	v92	No	Sub-category definitions

Sub-category (nested element)

Attribute	Type	Since	Required	Description
id	int	v92	Yes	Sub-category identifier
name	string	v92	Yes	Sub-category name (string table reference)
excludeAlmost	bool	v92	No	Whether to exclude from “almost complete” filter
absolutelyHidden	bool	v92	No	Whether the sub-category is completely hidden
referStr	string	v92	No	Reference string for reward type filtering
referType	string	v92	No	Reference type for categorization

---

XML structure

AchievementCategoryInfo.xml
└── AchievementList
    └── CategoryInfo
        └── MainCategory (0..9)
            @id @name @priority @normalImage @overImage @pressImage
            @isSummary? @summaryId? @isSummaryCounting?
            @isGrade? @isCompensation? @excludeAlmost?
            @str1? @str2? @str3?
            └── SubCategory (0..8)
                @id @name @excludeAlmost? @absolutelyHidden?
                @referStr? @referType?

---

Common pitfalls

• Wrapper element: The XML structure has a CategoryInfo wrapper element between the root AchievementList and MainCategory elements. This is handled transparently by the pipeline — the YAML operates directly on main categories.
• Root element name: Despite the file being named AchievementCategoryInfo.xml, the root XML element is AchievementList (not AchievementCategoryInfo). This is a server convention.
• Clear-and-replace: Sub-categories use clear-and-replace semantics. Providing a subCategories list on update replaces all existing sub-category children.
• Category ID mapping: The id values here correspond to the categoryId attribute on Achievement List entries. Each achievement belongs to exactly one sub-category.