SetItemOption Configuration

This configuration file defines the bonuses granted by set items based on how many pieces of the set are equipped.

File Location#

Data/Item/SetItemOption.xml

Dependencies#

Depends OnPurpose
SetItemType.xmlMaps items to set IDs (OptionIndex)
Item.xmlItem categories and slot definitions

How It Works#

  1. Player equips set items
  2. Server counts pieces that share the same active set ID across all worn slots
  3. For N equipped pieces, applies bonuses from PieceBonus1 through PieceBonus(N-1) cumulatively
  4. When N-1 equals the count of PieceBonus entries that carry a valid option, FullSetBonus is also applied

Structure#

<SetItemOptionList>
    <Set Index="1" Name="Warrior">
        <PieceBonus1 OptionIndex1="136" OptionValue1="10" OptionIndex2="-1" OptionValue2="-1"/>
        <PieceBonus2 OptionIndex1="134" OptionValue1="10" OptionIndex2="-1" OptionValue2="-1"/>
        <PieceBonus3 OptionIndex1="103" OptionValue1="20" OptionIndex2="-1" OptionValue2="-1"/>
        <PieceBonus4 OptionIndex1="131" OptionValue1="5" OptionIndex2="-1" OptionValue2="-1"/>
        <PieceBonus5 OptionIndex1="83" OptionValue1="20" OptionIndex2="-1" OptionValue2="-1"/>
        <PieceBonus6 OptionIndex1="137" OptionValue1="10" OptionIndex2="-1" OptionValue2="-1"/>
        <FullSetBonus OptionIndex1="84" OptionValue1="5" OptionIndex2="92" OptionValue2="5"
                      OptionIndex3="136" OptionValue3="25" OptionIndex4="-1" OptionValue4="-1"
                      OptionIndex5="-1" OptionValue5="-1"/>
    </Set>
</SetItemOptionList>

Attributes#

Set Element#

AttributeTypeDescription
IndexintSet ID (1-254, referenced by SetItemType.xml)
NamestringSet name (used for display and logs, up to 31 characters)

PieceBonus1-6#

Each PieceBonus node holds up to two option entries. Missing attributes default to -1.

AttributeTypeDescription
OptionIndex1intFirst bonus type (-1 = none, see Option Types below)
OptionValue1intFirst bonus value
OptionIndex2intSecond bonus type (-1 = none)
OptionValue2intSecond bonus value

FullSetBonus#

Single node with up to five option entries, applied once when the full set is worn.

AttributeTypeDescription
OptionIndex1 - OptionIndex5intBonus types (-1 = none)
OptionValue1 - OptionValue5intBonus values

Option Types#

Set bonuses draw from the same option pool as per-item options - the values listed in OptionIndex Reference (80-161). Anything the server can apply to an item it can also apply as a set bonus, including PvP damage/defense, Max SD, SD recovery, experience rate, damage reflect/reduction and attack/wizardry speed (option 97). There is no movement-speed option in the shared pool - movement speed cannot be granted as a set bonus.

Display text for each option comes from ItemOptionNames.xml Type 0.

Commonly used ids for sets:

OptionIndexEffect
136 / 137 / 138 / 139 / 140Strength / Agility / Vitality / Energy / Command
128 / 129Min / Max physical damage
80Physical damage (min and max)
96+% wizardry damage
130+% attack success rate
83Defense
119 / 120Max HP / Max MP
103 / 131Max AG / AG recovery
84 / 132Critical damage rate / critical damage
92 / 133Excellent damage rate / excellent damage
134Skill damage
116 / 102Double damage rate / ignore defense rate
141 / 142+% defense with a shield / +% damage with a two-handed weapon
143-147Damage or defense scaled by a stat (Stat / value)
148-154Ice / Poison / Lightning / Fire / Earth / Wind / Water resistance

Examples#

<Set Index="1" Name="Warrior">
    <!-- 2 pieces: +10 STR -->
    <PieceBonus1 OptionIndex1="136" OptionValue1="10" OptionIndex2="-1" OptionValue2="-1"/>
    <!-- 3 pieces: +10 Skill Damage -->
    <PieceBonus2 OptionIndex1="134" OptionValue1="10" OptionIndex2="-1" OptionValue2="-1"/>
    <!-- 4 pieces: +20 Max AG -->
    <PieceBonus3 OptionIndex1="103" OptionValue1="20" OptionIndex2="-1" OptionValue2="-1"/>
    <!-- 5 pieces: +5 AG Recovery -->
    <PieceBonus4 OptionIndex1="131" OptionValue1="5" OptionIndex2="-1" OptionValue2="-1"/>
    <!-- 6 pieces: +20 Defense -->
    <PieceBonus5 OptionIndex1="83" OptionValue1="20" OptionIndex2="-1" OptionValue2="-1"/>
    <!-- 7 pieces: +10 AGI -->
    <PieceBonus6 OptionIndex1="137" OptionValue1="10" OptionIndex2="-1" OptionValue2="-1"/>
    <!-- Full set: +5% Crit Rate, +5% Exc Rate, +25 STR -->
    <FullSetBonus OptionIndex1="84" OptionValue1="5" OptionIndex2="92" OptionValue2="5"
                  OptionIndex3="136" OptionValue3="25" OptionIndex4="-1" OptionValue4="-1"
                  OptionIndex5="-1" OptionValue5="-1"/>
</Set>

Important Behavior#

Common Issues#

Last updated August 20, 2026