DungeonNewbieBonus

Overview

DungeonNewbieBonus.xml defines newbie protective buff configurations for dungeons: check conditions, common abnormalities, per-dungeon bonus lists, and dynamic abnormality scaling data.

Version support

Version	Status
v92	Full
v90	-
v86	-

---

DSL support

Section: dungeonNewbieBonuses Sub-entities: dungeon entries (CRUD), config Operations: create, update, delete, upsert, config File organization: SingleFile — DungeonNewbieBonus.xml Sync: Server-only — no client DataCenter folder exists.

---

Quick recipes

Create

spec:
  version: "1.0"
  schema: v92

dungeonNewbieBonuses:
  create:
    - dungeonId: 9001
      name: "custom_dungeon"
      bonuses:
        - target: "self"
          bonusAbnormal: 44010001
        - target: "party"
          bonusAbnormal: 44010002
      dynamicAbnormalities:
        - minCount: 1
          maxCount: 3
          abnormalityStackCount: 5
          addAbnormalityIdList: "44020001,44020002"

Update

dungeonNewbieBonuses:
  update:
    - dungeonId: 9001
      changes:
        name: "renamed_dungeon"
        bonuses:
          - target: "self"
            bonusAbnormal: 44010003

Delete

dungeonNewbieBonuses:
  delete:
    - 9001

Upsert

dungeonNewbieBonuses:
  upsert:
    - dungeonId: 9001
      name: "custom_dungeon"
      bonuses:
        - target: "self"
          bonusAbnormal: 44010001

Config

dungeonNewbieBonuses:
  config:
    clearCount: 10
    commonAbnormalityId: "44000001"

---

Properties reference

Dungeon entry attributes

Attribute	Type	Since	Required	Description
dungeonId	int	v92	Yes	Dungeon identifier (entity key)
name	string	v92	No	Internal dungeon name
bonuses	list[Bonus]	v92	No	Per-dungeon bonus abnormality list
dynamicAbnormalities	list[DynamicAbnormality]	v92	No	Dynamic abnormality scaling entries

Config attributes

Attribute	Type	Since	Description
clearCount	int	v92	Clear count threshold for newbie check
commonAbnormalityId	string	v92	Common abnormality applied to all newbie dungeons

---

Nested elements

Bonus

Attribute	Type	Since	Required	Description
target	string	v92	Yes	Buff target (self, party)
bonusAbnormal	int	v92	Yes	Abnormality ID to apply

DynamicAbnormality

Attribute	Type	Since	Required	Description
minCount	int	v92	Yes	Minimum player count threshold
maxCount	int	v92	Yes	Maximum player count threshold
abnormalityStackCount	int	v92	Yes	Abnormality stack count to apply
addAbnormalityIdList	string	v92	Yes	Comma-separated abnormality IDs

---

XML structure

DungeonNewbieBonus.xml
└── DungeonNewbieBonus
    @clearCount @commonAbnormalityId
    └── Dungeon (0..∞)
        @id @name?
        ├── Bonus (0..∞)
        │   @Target @BonusAbnormal
        └── DynamicAbnormality (0..∞)
            @MinCount @MaxCount @AbnormalityStackCount @AddAbnormalityIdList

---

Common pitfalls

• Config vs entity operations: Use config: for root-level settings (clearCount, commonAbnormalityId). Use create/update/delete for individual Dungeon entries.
• Clear-and-replace: Bonuses and dynamic abnormalities use clear-and-replace semantics. Providing a bonuses or dynamicAbnormalities list on update replaces the entire set.
• Server-only: This file has no client DataCenter equivalent. It is used exclusively by the server.