ItemOptionRate Configuration

This configuration file defines the probability tables used when picking item option values (level, skill flag, luck flag, JoL value, excellent count, set tier, socket count) during item generation.

File Location#

Data/Item/ItemOptionRate.xml

Dependencies#

Related Option Tables#

• ExcellentOptionRate.xml - per-excellent-option weighting once ExcOptions has chosen the count
• SetItemOption.xml - ancient bonuses keyed by SetOptions tier
• SocketItemOption.xml - socket seed / bonus / package rolls on sockets produced by SocketOptions
• JewelOfHarmonyOption.xml - JoH options (independent of JoL)

How It Works#

When an item is generated, the server:

1. Looks up the Index for the source (monster drop, chaos mix, event bag, moss merchant, etc.).
2. Uses weighted random selection over the section's rate array.
3. Writes the selected value into the appropriate item field.

Configuration Sections#

LevelOptions#

Controls item enhancement level (+0 to +15) when an item is generated.

<LevelOptions>
    <Level Index="0" Rate0="7000" Rate1="1500" Rate2="1000" Rate3="500"
           Rate4="0" ... Rate15="0" Name="Level Option (Common)"/>
</LevelOptions>

Rows 60-62 also exist in other sections for the MonsterAffix loot affixes (picked with the affix LevelIdx, SkillIdx, LuckIdx, JoLIdx, ExcIdx, SocketIdx attributes):

Example - common drop distribution:

<Level Index="0" Rate0="7000" Rate1="1500" Rate2="1000" Rate3="500"
       Rate4="0" Rate5="0" ... Name="Level Option (Common)"/>

• 70% chance for +0
• 15% chance for +1
• 10% chance for +2
• 5% chance for +3
• 0% for +4 through +15

SkillOptions#

Controls whether an item is generated with the skill flag set (for weapons / books / staves).

<SkillOptions>
    <Skill Index="0" Rate0="9400" Rate1="600" Name="Skill Option (Common)"/>
</SkillOptions>

Shipped defaults include:

• Index 0 (Common): 94% no skill, 6% has skill
• Index 1 (Exc): 100% has skill
• Index 2 (Set): 100% has skill
• Index 3 (ChaosItemMix): 75% / 25%

LuckOptions#

Controls whether an item is generated with the luck flag set (+5% critical damage rate plus LuckJoSRate / LuckChaosMixRate from ItemOption.xml).

<LuckOptions>
    <Luck Index="0" Rate0="9600" Rate1="400" Name="Luck Option (Common)"/>
</LuckOptions>

JoLOptions#

Controls the Jewel of Life additional option value (0-7).

<JoLOptions>
    <JoL Index="0" Rate0="9600" Rate1="150" Rate2="100" Rate3="50"
         Rate4="0" Rate5="0" Rate6="0" Rate7="0" Name="JoL Option (Common)"/>
</JoLOptions>

ExcOptions#

Controls how many excellent options an item rolls (0-6).

<ExcOptions>
    <Exc Index="1" Rate0="0" Rate1="7500" Rate2="2500" Rate3="0"
         Rate4="0" Rate5="0" Rate6="0" Name="Exc Option (Exc)"/>
</ExcOptions>

For the shipped Index="1" (excellent generation): 75% chance for 1 excellent option, 25% for 2.

SetOptions#

Controls ancient set tier when a set item is generated.

<SetOptions>
    <Set Index="2" Rate0="0" Rate1="8000" Rate2="2000" Name="Set Option (Set)"/>
</SetOptions>

Exactly 3 rate slots.

SocketOptions#

Controls socket count for socket weapons / armors and for pentagram items.

<SocketOptions>
    <Socket Index="3" Rate0="0" Rate1="8400" Rate2="1550" Rate3="50"
            Rate4="0" Rate5="0" Name="Socket Option (OneHand)"/>
</SocketOptions>

Index Reference (per section)#

Each section maintains its own Index map. The same Index number can mean different things in different sections, depending on which generator code passes that Index to that section's lookup. Typical meanings in the shipped data:

Custom indices (for example Exc Index="100" in the shipped data for Aida) are fully supported: any system that calls the generator with that index pulls the matching row.

Examples#

<!-- More common +3 to +5 drops -->
<Level Index="0" Rate0="4000" Rate1="2500" Rate2="1500" Rate3="1000"
       Rate4="500" Rate5="500" Rate6="0" ... Name="Level Option (Common)"/>

<!-- Higher luck chance -->
<Luck Index="0" Rate0="9000" Rate1="1000" Name="Luck Option (Common)"/>

<!-- Almost all drops are +0 -->
<Level Index="0" Rate0="9500" Rate1="400" Rate2="100" Rate3="0"
       Rate4="0" ... Name="Level Option (Common)"/>

<!-- Very rare luck -->
<Luck Index="0" Rate0="9900" Rate1="100" Name="Luck Option (Common)"/>

<!-- Guaranteed +7 to +9 items (EventItemBag range index) -->
<Level Index="41" Rate0="0" Rate1="0" ... Rate7="3334" Rate8="3333"
       Rate9="3333" ... Name="Level Option (EventItemBag) (7~9)"/>

<!-- Always 2-3 excellent options. Use a custom Index that no generator currently calls,
     or override the existing entry for the EventItemBag tier you want to retune. -->
<Exc Index="22" Rate0="0" Rate1="0" Rate2="5000" Rate3="5000"
     Rate4="0" Rate5="0" Rate6="0" Name="Exc Option (EventItemBag) (2~3)"/>

Common Issues#