Skip to content
DataSheetLang

Ranking Dungeon

Version support

Section titled “Version support”
VersionStatus
v92Full
v90-
v86-

RankingDungeon.xml defines ranking dungeon entries and UI leaderboard settings for rank display limits.

Dungeon entries are identified by dungeonId. Configuration targets the UISetting element.

DSL support

Section titled “DSL support”

Entity: rankingDungeons Operations: create, update, delete, upsert, config File organization: SingleFile — RankingDungeon.xml

Quick recipes

Section titled “Quick recipes”

Create

Section titled “Create”
spec:
  version: "1.0"
  schema: v92


rankingDungeons:
  create:
    - dungeonId: 9095
    - dungeonId: 9201
      type: "dbRecord"

Update

Section titled “Update”
spec:
  version: "1.0"
  schema: v92


rankingDungeons:
  update:
    - dungeonId: 9201
      changes:
        type: "weekly"

Delete

Section titled “Delete”
spec:
  version: "1.0"
  schema: v92


rankingDungeons:
  delete:
    - dungeonId: 9095

Upsert

Section titled “Upsert”
spec:
  version: "1.0"
  schema: v92


rankingDungeons:
  upsert:
    - dungeonId: 9300
      type: "dbRecord"

Config (UI settings)

Section titled “Config (UI settings)”
spec:
  version: "1.0"
  schema: v92


rankingDungeons:
  config:
    resultMaxRank: 100
    boardMaxRank: 50
    boardMaxSeason: 10
    boardHallmaxRank: 20

Properties reference

Section titled “Properties reference”

Dungeon attributes

Section titled “Dungeon attributes”
AttributeTypeSinceRequiredDescription
dungeonIdintv92YesUnique dungeon identifier
typestringv92NoDungeon type classification (e.g., "dbRecord")

Config attributes

Section titled “Config attributes”
AttributeTypeSinceRequiredDescription
resultMaxRankintv92NoMaximum rank shown in results screen
boardMaxRankintv92NoMaximum rank shown on leaderboard
boardMaxSeasonintv92NoMaximum number of seasons shown on board
boardHallmaxRankintv92NoMaximum rank shown in hall of fame

XML structure

Section titled “XML structure”
RankingDungeon.xml
├── UISetting
│   @result_maxRank @board_maxRank @board_maxSeason @board_hallmaxRank
└── Dungeon (0..∞)
    @id (key) @type

Common pitfalls

Section titled “Common pitfalls”
  • Config vs entity operations: Use config: for UISetting attributes. Use create/update/delete/upsert for Dungeon entries.
  • Underscore XML attributes: The UISetting element uses underscore-separated attribute names in XML (result_maxRank, board_maxRank). The DSL uses camelCase (resultMaxRank, boardMaxRank).
  • Optional type: The type attribute is optional. When omitted, no type attribute is written to the XML element.
  • Partial config updates: Only specified config attributes are updated. Unspecified attributes retain their original values.