ExcellentOptionRate Configuration

This configuration file defines which excellent option bits can be applied to which item index ranges. Without this file properly configured, excellent items will not receive any excellent options.

File Location#

Data/Item/ExcellentOptionRate.xml

Dependencies#

Depends OnPurpose
Item.xmlItem definitions by index
Depended On ByPurpose
ItemOptionRate.xmlExcOptions section determines COUNT, this file determines WHICH
ItemDrop.xmlExcOption index triggers excellent generation
MapManager.xmlExcItemDropRate triggers random excellent chance

How It Works#

When an item spawns with excellent options enabled:

  1. ItemOptionRate.xml determines HOW MANY excellent options to roll
  2. For each option to add, the server picks one at random weighted by Rate
  3. All entries whose index range contains the item's index are collected
  4. Entries whose OptionIndex bit is already set on the item are skipped (prevents duplicates)
  5. One option is randomly selected from the remaining pool using Rate weights
  6. The option bit is OR-ed into the item's option byte
  7. Repeat until the requested count is reached or the pool runs out

Structure#

<ExcellentOptionRateList>
    <Option OptionIndex="1" ItemMinIndex="0" ItemMaxIndex="511"
            Rate="1000" Name="Exc Dmg Rate"/>
    <Option OptionIndex="2" ItemMinIndex="0" ItemMaxIndex="511"
            Rate="1000" Name="Level Dmg"/>
    ...
</ExcellentOptionRateList>

Attributes#

AttributeTypeDescription
OptionIndexintExcellent option bit (1, 2, 4, 8, 16, 32)
ItemMinIndexintMinimum item index (inclusive)
ItemMaxIndexintMaximum item index (inclusive)
RateintWeight for random selection (higher = more likely)
NamestringDescription (for documentation only)

Item Index Calculation#

ItemIndex = Category * 512 + Index
CategoryItem TypeIndex Range
0Swords0 - 511
1Axes512 - 1023
2Maces/Scepters1024 - 1535
3Spears1536 - 2047
4Bows/Crossbows2048 - 2559
5Staffs2560 - 3071
6Shields3072 - 3583
7Helms3584 - 4095
8Armors4096 - 4607
9Pants4608 - 5119
10Gloves5120 - 5631
11Boots5632 - 6143
12Wings/Capes6144 - 6655
13Rings/Pendants/Pets6656 - 7167

Excellent Option Bits#

Weapons (Categories 0-5)#

BitValueEffect
10x01Excellent Damage Rate +10%
20x02Increase Damage +level/20
40x04Increase Damage +2%
80x08Increase Wizardry Damage +level/20 (or Attack Speed +7)
160x10Increase Life after killing monster +life/8
320x20Increase Mana after killing monster +mana/8

Armor and Accessories (Categories 6-13)#

BitValueEffect
10x01Increase Zen after monster +40%
20x02Defense success rate +10%
40x04Reflect damage +5%
80x08Damage decrease +4%
160x10Increase Max Mana +4%
320x20Increase Max HP +4%

Special Items with Limited Options#

Some items have a maximum option count that caps the number of rolls regardless of the requested count:

ItemMax Options
2nd Wings (Cat 12, Index 3-6, 42, 49)3
Cape of Lord (Cat 13, Index 30)4
3rd Wings (Cat 12, Index 36-40, 43, 50)4
Monster Wings (Cat 12, Index 262-265)2
Wings of Conqueror (Cat 12, Index 266)3
Wings of Angel and Devil (Cat 12, Index 267)3
Dinorant (Cat 13, Index 3)3
Fenrir (Cat 13, Index 37)3
All other itemsUses the requested count, capped at 6 total bits

Examples#

All options have equal weight (1000 each = ~16.7% chance per option):

<!-- Swords: All 6 options equally likely -->
<Option OptionIndex="1"  ItemMinIndex="0" ItemMaxIndex="511" Rate="1000" Name="Exc Dmg Rate"/>
<Option OptionIndex="2"  ItemMinIndex="0" ItemMaxIndex="511" Rate="1000" Name="Level Dmg"/>
<Option OptionIndex="4"  ItemMinIndex="0" ItemMaxIndex="511" Rate="1000" Name="Inc Dmg 2%"/>
<Option OptionIndex="8"  ItemMinIndex="0" ItemMaxIndex="511" Rate="1000" Name="Wiz Dmg"/>
<Option OptionIndex="16" ItemMinIndex="0" ItemMaxIndex="511" Rate="1000" Name="Life After Kill"/>
<Option OptionIndex="32" ItemMinIndex="0" ItemMaxIndex="511" Rate="1000" Name="Mana After Kill"/>

Important Behavior#

Common Issues#

See Also#

  • ItemOptionRate.xml - Controls how many excellent options roll (ExcOptions section)
  • ItemDrop.xml - Drop table entries that trigger excellent generation
  • Item.xml - Base item definitions by Category and Type
  • ItemOption.xml - Standard level-based option stat bonuses

Last updated April 20, 2026