DungeonRookieEvent

Overview

DungeonRookieEvent.xml defines time-limited rookie promotional dungeon events: rookie conditions, parcel rewards, sample event schedules, and event dialogs.

Version support

Version	Status
v92	Full
v90	-
v86	-

---

DSL support

Section: dungeonRookieEvent Operations: config File organization: SingleFile — DungeonRookieEvent.xml Sync: Server-only — no client DataCenter folder exists.

---

Quick recipes

Config

spec:
  version: "1.0"
  schema: v92

dungeonRookieEvent:
  config:
    clearCount: 5
    parcel:
      sender: "@DungeonRookieEvent:sender"
      title: "@DungeonRookieEvent:title"
      msg: "@DungeonRookieEvent:msg"
    sampleEvents:
      - dungeonId: 3001
        startTime: "2025-01-01T00:00:00"
        endTime: "2025-03-01T00:00:00"
        rewardItems:
          - templateId: 80001
            amount: 5
          - templateId: 80002
            amount: 10
    eventDialogs:
      - name: "welcome"
        dialogId: 90001
      - name: "complete"
        dialogId: 90002

---

Properties reference

Config attributes

Attribute	Type	Since	Description
clearCount	int	v92	Clear count threshold for rookie condition
parcel	Parcel	v92	Reward parcel mail configuration
sampleEvents	list[SampleEvent]	v92	Sample dungeon event schedules
eventDialogs	list[EventDialog]	v92	Event dialog definitions

---

Nested elements

Parcel

Attribute	Type	Since	Required	Description
sender	string	v92	Yes	Mail sender name (string table reference)
title	string	v92	Yes	Mail title (string table reference)
msg	string	v92	Yes	Mail body message (string table reference)

SampleEvent

Attribute	Type	Since	Required	Description
dungeonId	int	v92	Yes	Target dungeon identifier
startTime	string	v92	Yes	Event start time (ISO 8601 format)
endTime	string	v92	Yes	Event end time (ISO 8601 format)
rewardItems	list[RewardItem]	v92	No	Reward items for this event

RewardItem

Attribute	Type	Since	Required	Description
templateId	int	v92	Yes	Item template ID
amount	int	v92	Yes	Item count

EventDialog

Attribute	Type	Since	Required	Description
name	string	v92	Yes	Dialog name identifier
dialogId	int	v92	Yes	Dialog template ID

---

XML structure

DungeonRookieEvent.xml
└── DungeonRookieEvent
    @clearCount
    ├── Parcel (0..1)
    │   @sender @title @msg
    ├── SampleEvent (0..∞)
    │   @dungeonId @startTime @endTime
    │   └── RewardItem (0..∞)
    │       @templateId @amount
    └── EventDialog (0..∞)
        @name @dialogId

---

Common pitfalls

• Config-only entity: DungeonRookieEvent has no keyed entries. All modifications use the config: operation to set root-level attributes and nested elements.
• Clear-and-replace: Sample events, reward items, and event dialogs all use clear-and-replace semantics. Providing any of these lists replaces the entire set.
• Server-only: This file has no client DataCenter equivalent. It is used exclusively by the server.