VIP System

Version support

Version	Status
v92	Full
v90	-
v86	-

VIPSystem.xml defines global VIP system configuration: feature toggles, level thresholds, grade definitions, and mail templates for level-up and VIP gift notifications.

This is a singleton config — there are no keyed entities. All operations target the single VipSetting element.

DSL support

Entity: vipSystem Operations: config File organization: SingleFile — VIPSystem.xml

Quick recipes

Config (update settings)

spec:
  version: "1.0"
  schema: v92

vipSystem:
  config:
    vipSystemOn: true
    maxGrade: 12
    shopOpenLevel: 65
    dungeonOpenLevel: 65
    rewardOpenLevel: 65
    tokenTemplateId: 89001
    dailyTokenResetHour: 7
    vipDungeon: 9070
    vipGiftLevel: 10

Config with grades

spec:
  version: "1.0"
  schema: v92

vipSystem:
  config:
    maxGrade: 3
    grades:
      - level: 1
        totalExp: 0
        iconGrade: 1
      - level: 2
        totalExp: 1000
        iconGrade: 2
      - level: 3
        totalExp: 5000
        iconGrade: 3

Config with mail templates

spec:
  version: "1.0"
  schema: v92

vipSystem:
  config:
    lvUpMail:
      sender: "VIP System"
      title: "VIP Level Up"
      body: "Congratulations on reaching a new VIP level!"
      addItemTemplateId: 89010
      addItemAmount: 1
    vipGiftMail:
      sender: "VIP System"
      title: "VIP Gift"
      body: "Here is your VIP gift."
      addItemTemplateId: 89020
      addItemAmount: 5

Properties reference

Config attributes

Attribute	Type	Since	Required	Description
`vipSystemOn`	`bool`	v92	No	Whether the VIP system is enabled
`maxGrade`	`int`	v92	No	Maximum VIP grade
`shopOpenLevel`	`int`	v92	No	Character level required to access VIP shop
`dungeonOpenLevel`	`int`	v92	No	Character level required to access VIP dungeon
`rewardOpenLevel`	`int`	v92	No	Character level required to access VIP rewards
`tokenTemplateId`	`int`	v92	No	Item template ID for VIP tokens
`dailyTokenResetHour`	`int`	v92	No	Hour of day (0-23) when daily tokens reset
`vipDungeon`	`int`	v92	No	Dungeon ID for the VIP dungeon
`vipGiftLevel`	`int`	v92	No	Level at which VIP gift is granted
`grades`	`list[Grade]`	v92	No	Grade definitions. See Grade.
`lvUpMail`	`VipMail`	v92	No	Mail sent on VIP level up. See VipMail.
`vipGiftMail`	`VipMail`	v92	No	Mail sent with VIP gift. See VipMail.

Nested elements

Grade

Defines a VIP grade level. When grades is specified, all existing grades are replaced (clear-and-replace).

Attribute	Type	Since	Required	Description
`level`	`int`	v92	No	Grade level number
`totalExp`	`int`	v92	No	Total experience required to reach this grade
`iconGrade`	`int`	v92	No	Icon grade for UI display

VipMail

Defines a mail template used for VIP notifications. Used by both lvUpMail and vipGiftMail.

Attribute	Type	Since	Required	Description
`sender`	`string`	v92	No	Mail sender name
`title`	`string`	v92	No	Mail subject line
`body`	`string`	v92	No	Mail body text
`addItemTemplateId`	`int`	v92	No	Attached item template ID
`addItemAmount`	`int`	v92	No	Attached item quantity

XML structure

VIPSystem.xml
└── VIPSetting
    ├── VipSetting
    │   @vipSystemOn @maxGrade @shopOpenLevel @dungeonOpenLevel
    │   @rewardOpenLevel @tokenTemplateId @dailyTokenResetHour
    │   @vipDungeon @vipGiftLevel
    ├── Grade (0..∞)
    │   @level @totalExp @iconGrade
    └── VipMail
        ├── LvUpMail
        │   @sender @title @body @addItemTemplateId @addItemAmount
        └── VipGiftMail
            @sender @title @body @addItemTemplateId @addItemAmount

Common pitfalls

Config-only schema: VipSystem has no entity CRUD operations. Use config: exclusively.
Grade replacement: Specifying grades replaces all existing grade elements. Partial grade updates are not supported — always provide the full list.
Mail wrapper: In XML, LvUpMail and VipGiftMail are nested under a VipMail wrapper element. The DSL flattens this — specify lvUpMail and vipGiftMail directly under config.
Partial updates: Only specified attributes are written. Unspecified attributes retain their original XML values.