CompetitionDungeon

Version support

Version	Status
v92	Full
v90	-
v86	-

---

CompetitionDungeon.xml defines dungeon competition entries: ranked dungeon configurations with season scheduling, class-based competition modes, and ranking calculation rules.

---

DSL support

Entity: competitionDungeons Operations: create, update, delete, upsert, updateWhere, config File organization: SingleFile — CompetitionDungeon.xml

---

Quick recipes

Create

spec:
  version: "1.0"
  schema: v92

competitionDungeons:
  create:
    - id: 9001
      active: true
      classCompetition: "warrior"
      minRecordRank: 1
      seasonOut: false

Update

spec:
  version: "1.0"
  schema: v92

competitionDungeons:
  update:
    - id: 9001
      changes:
        minRecordRank: 5
        seasonOut: true

Delete

spec:
  version: "1.0"
  schema: v92

competitionDungeons:
  delete:
    - 9001

Upsert

spec:
  version: "1.0"
  schema: v92

competitionDungeons:
  upsert:
    - id: 9001
      active: true
      classCompetition: "warrior"
      minRecordRank: 1
      seasonOut: false

updateWhere

Bulk-update all entries matching a filter. All schema attributes are filterable.

spec:
  version: "1.0"
  schema: v92

competitionDungeons:
  updateWhere:
    - filter:
        active: true
      changes:
        seasonOut: true

    - filter:
        classCompetition: ["warrior", "lancer"]
      changes:
        minRecordRank: 10

Filter values can be a single value or a list. A list matches any entry whose attribute equals one of the listed values.

Config (RankingRule settings)

spec:
  version: "1.0"
  schema: v92

competitionDungeons:
  config:
    seasonPeriod: 7
    calcDay: "Monday"
    calcHour: 6

---

Properties reference

Dungeon attributes

Attribute	Type	Since	Required	Description
id	int	v92	Yes	Dungeon identifier (entity key)
active	bool	v92	Yes	Whether the dungeon competition is active
classCompetition	string	v92	Yes	Class-based competition mode
minRecordRank	int	v92	Yes	Minimum rank required to record
seasonOut	bool	v92	No	Whether the dungeon is out of season

Config attributes

Attribute	Type	Since	Required	Description
seasonPeriod	int	v92	No	Duration of a competition season
calcDay	string	v92	No	Day when rankings are calculated
calcHour	int	v92	No	Hour when rankings are calculated

---

XML structure

CompetitionDungeon.xml
└── CompetitionDungeon
    ├── RankingRule
    │   @seasonPeriod (required)
    │   @calcDay (required)
    │   @calcHour (required)
    └── Dungeon (0..7)
        @id (required)
        @active (required)
        @classCompetition (required)
        @minRecordRank (required)
        @seasonOut (optional)

---

Common pitfalls

• Config vs entity operations: Use config: for RankingRule settings (seasonPeriod, calcDay, calcHour). Use create/update/delete for individual Dungeon entries.
• updateWhere filter syntax: Filters match against entity attributes. Use a list value to match multiple values (e.g., classCompetition: ["warrior", "lancer"]). See Filters for details.
• SingleFile organization: All dungeon competition entries live in a single CompetitionDungeon.xml file. There is no per-entity file partitioning.