CountdownData

Version support

Version	Status
v92	Full
v90	-
v86	-

---

CountdownData.xml defines countdown timers: template entries with a total duration and a sequence of countdown steps, each specifying display text, visual style, and sound effects.

---

DSL support

Entity: countdownData Operations: create, update, delete, upsert, updateWhere File organization: SingleFile — CountdownData.xml

---

Quick recipes

Create

spec:
  version: "1.0"
  schema: v92

countdownData:
  create:
    - countdownTemplateId: 1001
      totalSecond: 30
      countdowns:
        - second: 10
          string: "10 seconds remaining"
          style: "warning"
          effectSoundId: 5001
        - second: 5
          string: "5 seconds remaining"
          style: "critical"
          effectSoundId: 5002

Update

spec:
  version: "1.0"
  schema: v92

countdownData:
  update:
    - countdownTemplateId: 1001
      changes:
        totalSecond: 60
        countdowns:
          - second: 10
            string: "Hurry up!"
            style: "critical"
            effectSoundId: 5003

Delete

spec:
  version: "1.0"
  schema: v92

countdownData:
  delete:
    - 1001

Upsert

spec:
  version: "1.0"
  schema: v92

countdownData:
  upsert:
    - countdownTemplateId: 1001
      totalSecond: 30
      countdowns:
        - second: 10
          string: "10 seconds remaining"
          style: "warning"
          effectSoundId: 5001

UpdateWhere

Batch-update countdown templates matching filter criteria. See Filters for syntax details.

spec:
  version: "1.0"
  schema: v92

countdownData:
  updateWhere:
    - filter:
        totalSecond: 30
      changes:
        totalSecond: 45

---

Properties reference

CountdownTemplate attributes

Attribute	Type	Since	Required	Description
countdownTemplateId	int	v92	Yes	Countdown template identifier (entity key)
totalSecond	int	v92	No	Total duration of the countdown in seconds
countdowns	list[Countdown]	v92	No	Countdown step entries. See Countdown.

---

Nested elements

Countdown

Defines a single step within a countdown timer sequence.

Attribute	Type	Since	Required	Description
second	int	v92	Yes	Second at which this countdown step triggers
string	string	v92	Yes	Display text for this countdown step
style	string	v92	No	Visual style for the countdown display
effectSoundId	int	v92	No	Sound effect ID to play at this step

---

XML structure

CountdownData.xml
└── CountdownData
    └── CountdownTemplate (0..∞)
        @id (required)
        @totalSecond (required)
        └── Countdown (0..∞)
            @second (required)
            @string (required)
            @style (optional)
            @effectSoundId (optional)

---

Common pitfalls

• No config operation. Unlike some other SingleFile schemas (e.g., DailyQuest), CountdownData has no config operation. All modifications target individual CountdownTemplate entries.
• Step ordering. Countdown steps are defined by their second value. Ensure steps don’t overlap or duplicate the same second within a template.
• updateWhere scope. The updateWhere operation applies to all matching CountdownTemplate entries in CountdownData.xml. Use filters carefully to avoid unintended bulk changes.