Reset System Configuration

The Reset System allows characters to reset their level in exchange for rewards, creating an extended progression system beyond the level cap.

File Location#

Data/Plugins/Characters/ResetSystem.xml

Reset Types#

Configuration Structure#

<ResetSystem Enabled="true">
    <Settings>
        <!-- What happens during reset -->
    </Settings>
    <ItemRequirements>
        <!-- Items consumed during reset -->
    </ItemRequirements>
    <Rewards>
        <!-- What players receive -->
    </Rewards>
    <Requirements>
        <!-- Conditions to perform reset -->
    </Requirements>
</ResetSystem>

Sections#

Root Element#

<ResetSystem Enabled="true">

Settings#

Defines what happens when a reset is performed.

<Setting Index="0" ResetStats="true" ResetCommand="true"
         ResetLevelUpPoints="true" TeleportToBaseMap="true" />

ItemRequirements#

Defines items that must be consumed for reset.

<ItemReq Index="0" ItemType="-1" Count="0" />
<ItemReq Index="1" ItemType="14" ItemIndex="13" Count="10" />

Example: ItemType="14" ItemIndex="13" = Jewel of Bless

Rewards#

Defines what players receive after reset.

<Reward Index="0" PointsType="LEVEL_POINTS_MULTI_RESET"
        LevelUpPoints="500" GrandResetBonusPoints="15000"
        WCoins="500" BagIndex="100" />

PointsType Values#

Example Calculations:

Regular Reset:

• Settings: PointsType="LEVEL_POINTS_MULTI_RESET", LevelUpPoints="500", GrandResetBonusPoints="15000"
• Player performing their 10th regular reset (going from 9→10) with 2 existing Grand Resets:
  • Base points: 500 × 10 = 5,000
  • Grand Reset bonus: 15000 × 2 = 30,000
  • Total: 35,000 points

Grand Reset:

• Settings: PointsType="LEVEL_POINTS_MULTI_GRAND_RESET", LevelUpPoints="15000"
• Player performing their 2nd Grand Reset (going from 1→2) with 100 regular resets:
  • Base points: 15000 × 2 = 30,000
  • Grand Reset bonus: 0 (not applied to Grand Reset type)
  • Total: 30,000 points
  • Note: Regular reset count is zeroed AFTER the rewards are calculated

Requirements#

Defines conditions and costs for performing resets.

<Requirement Index="0" Type="RESET" AccountLevel="*"
             SettingsIndex="0" RequiredLevel="400"
             ResetRange="000-999" ZenType="REMOVE_MULTI" ZenValue="100000"
             ItemReqIndex="1" RewardIndex="0" />

AutoReset#

Optional top-level <AutoReset> block. Enabled is the master switch that allows or disallows the automatic-reset feature. When it is on, players can turn on auto reset from the Reset window in the client (there is an auto-reset button alongside the manual reset and stat-distribution controls), and each character's tick handler attempts a reset on its own once the character qualifies. This block also controls how often that attempt runs.

<AutoReset Enabled="true" TickIntervalMs="5000" JitterMs="2000">
    <AccountLevel Index="0" Allowed="1" />
    <AccountLevel Index="1" Allowed="1" />
    <AccountLevel Index="2" Allowed="1" />
    <AccountLevel Index="3" Allowed="1" />
</AutoReset>

The <AccountLevel> children gate which account tiers may toggle AutoReset on. Index is the AccountLevel (0 = Free, 1-3 = VIP tiers). Allowed="0" rejects the toggle with result 2 for that tier. Unspecified tiers default to allowed.

When AutoReset is on, the per-character tick re-runs the same ExecuteReset pipeline that /reset uses, so all <Requirements> / <Caps> checks still apply.

Stat allocation (Points or Percent)#

Each character sets in the Reset window how the points of a reset are spread over STR / AGI / VIT / ENE / CMD (CMD only for Dark Lord). There are two modes, picked per character:

The allocation runs after an automatic reset and after the panel's "Reset Now" button for a normal reset. Grand and master resets do not run it. Every stat is still capped by the max stat and by the points left; anything not given stays as unspent points.

Caps#

Top-level <Caps> block. One entry per reset type — the cap applies to every <Requirement> of that Type, no matter how many AccountLevel / ResetRange slices are defined.

<Caps>
  <Reset       MaxTotal="10000" MaxPerDay="-1" MaxPerWeek="-1" MaxPerMonth="-1" />
  <GrandReset  MaxTotal="-1"    MaxPerDay="-1" MaxPerWeek="-1" MaxPerMonth="-1" />
  <MasterReset MaxTotal="-1"    MaxPerDay="-1" MaxPerWeek="-1" MaxPerMonth="-1" />
</Caps>

Period counters live per-character in dbo.ResetSystemSettings together with a per-type last-reset timestamp. On every cap check (and at login) the plugin compares the stored timestamp against the current local time and zeroes any counter whose backing period has rolled over.

To unlock more lifetime resets server-wide, raise MaxTotal on the matching <Caps> child and reload. No per-character cleanup needed — the lifetime check reads the existing Reset / GrandReset / MasterReset count on the character row.

ZenType Values#

ResetRange#

Format: MIN-MAX

Limits which reset counts this requirement applies to:

• 000-099 - Applies to resets 0-99
• 100-999 - Applies to resets 100+

Important Behavior#

Examples#

<ResetSystem Enabled="true">
    <Settings>
        <Setting Index="0" ResetStats="true" ResetCommand="true"
                 ResetLevelUpPoints="true" TeleportToBaseMap="true" />
    </Settings>
    <ItemRequirements>
        <ItemReq Index="0" ItemType="-1" Count="0" />
    </ItemRequirements>
    <Rewards>
        <Reward Index="0" PointsType="LEVEL_POINTS_MULTI_RESET"
                LevelUpPoints="500" WCoins="100" />
    </Rewards>
    <Requirements>
        <Requirement Index="0" Type="RESET" AccountLevel="*"
                     SettingsIndex="0" RequiredLevel="400"
                     ResetRange="000-999" ZenType="REMOVE_MULTI"
                     ZenValue="100000" RewardIndex="0" />
    </Requirements>
</ResetSystem>

<ResetSystem Enabled="true">
    <Settings>
        <Setting Index="0" ResetStats="true" TeleportToBaseMap="true" />
    </Settings>
    <ItemRequirements>
        <ItemReq Index="0" ItemType="-1" Count="0" />
        <ItemReq Index="1" ItemType="14" ItemIndex="13" Count="10" />
    </ItemRequirements>
    <Rewards>
        <Reward Index="0" PointsType="LEVEL_POINTS_MULTI_RESET"
                LevelUpPoints="500" GrandResetBonusPoints="15000" />
        <Reward Index="1" PointsType="LEVEL_POINTS_MULTI_GRAND_RESET"
                LevelUpPoints="15000" WCoins="500" BagIndex="101" />
    </Rewards>
    <Requirements>
        <!-- Regular Reset -->
        <Requirement Index="0" Type="RESET" SettingsIndex="0"
                     RequiredLevel="400" ResetRange="000-999"
                     ZenType="REMOVE_MULTI" ZenValue="100000"
                     ItemReqIndex="1" RewardIndex="0" />
        <!-- Grand Reset at 100 resets -->
        <Requirement Index="10" Type="GRAND_RESET" SettingsIndex="0"
                     RequiredResets="100" ResetResetsOnGrandReset="true"
                     ZenType="NO_REMOVE" RewardIndex="1" />
    </Requirements>
</ResetSystem>

<Requirements>
    <!-- Free players: harder requirements -->
    <Requirement Index="0" Type="RESET" AccountLevel="AL0"
                 RequiredLevel="400" ZenType="REMOVE_MULTI"
                 ZenValue="200000" RewardIndex="0" />

    <!-- VIP players: easier requirements -->
    <Requirement Index="1" Type="RESET" AccountLevel="AL1"
                 RequiredLevel="350" ZenType="REMOVE_MULTI"
                 ZenValue="100000" RewardIndex="1" />
</Requirements>

Common Issues#

Chat Commands#

Command matching is case-insensitive and requires an exact match (no arguments after the command). A client-side Reset Panel window can also trigger the same pipeline without a chat command.

Related Configuration#

• common.dat - provides the AccountLevel values matched by AccountLevel="AL0".."AL3"
• command.dat - Command (Leadership) stat baseline restored when ResetCommand="true"
• Item configuration - item identity used by ItemReq ItemType/ItemIndex