OptionIndex Reference

This is the complete list of OptionIndex values used in ItemOption.xml and SetItemOption.xml. Both files draw from one shared option pool, so any effect available as a per-item option is also available as an ancient set bonus.

File Location#

This reference documents values used in:

Data/Item/ItemOption.xml

Related Option Tables#

• ItemOptionRate.xml - probability tables that feed ItemOption
• ExcellentOptionRate.xml - which excellent flags roll
• SetItemOption.xml - ancient set bonuses (same values as this page)
• SocketItemOption.xml - socket seed / bonus / package (separate enum)
• JewelOfHarmonyOption.xml - JoH options (separate enum)
• 380ItemOption.xml - 380 item options (separate enum, indices 1-8)

OptionIndex Values#

All values documented here use the standard 80-161 range, plus the implicit-only 162-165 range. Slot 0 on wing / pet items may also use sentinel values 49 (Dinorant), 62 (Dark Horse), and 76 (Fenrir); these produce no direct stat effect through the option applier.

Slot 0 (skill) rows normally use OptionIndex="0" as a placeholder - the shipped General Weapon, General Book and General Shield rows all do. On slot 0 the value is ignored for items that carry a skill, because the server substitutes the item's own skill id. Leave it at 0 when writing new skill-eligibility rows.

Damage and Defense (80-96)#

Speed and Hunt Recovery (97-99)#

Wing and AG (100-105)#

Pet Sentinels and Defensive Procs (106-112)#

OptionIndex values 106, 107, 108, and 112 are sentinels populated on pets / Fenrir / Dinorant; the option applier handles them as no-ops because the corresponding pet systems consume the slot directly. Values 109-111 are real defensive proc stats applied to the character.

Curse Damage (113-115)#

Combat Rate and Experience (116-118)#

HP / MP Pools (119-122)#

Universal Damage (123-125)#

Defense Scaling (126-127)#

Advanced Combat (128-135)#

Stat Bonuses (136-140)#

These (along with ADD_WING_LEADERSHIP at 105) are applied in a second pass after primary stats are recalculated, so they can lift attributes such as STR / AGI / VIT / ENE / CMD before downstream stats that scale off them are computed.

Conditional and Stat-Scaled (141-147)#

Elemental Resistance (148-154)#

Despite their damage-sounding names, these options grant elemental resistance to the corresponding element. They do not increase outgoing elemental damage.

PvP and Shield / SD (155-161)#

These grant the same stats normally reserved for 380-level set items (see 380ItemOption.xml), but they can be placed on any option slot for any item. The (PvP) stats only affect player-versus-player combat and have no effect against monsters.

Implicit-only (162-165)#

These four are usable only from ItemImplicit.xml. They are multiplicative rises applied while damage is being calculated, not additions to a stored stat, so they have no meaning as rolled item options.

Level-Scaled Options#

The per-level options compute the bonus as:

bonus = (CharLevel + MasterLevel) / OptionValue

Example: OptionIndex = 93 (physical damage per level) with OptionValue = 20

• Level 400 character, ML 0: 400 / 20 = +20 physical damage
• Level 400 character, ML 200: 600 / 20 = +30 physical damage

Stat-Scaled Options#

Options in the _BY_STRENGTH, _BY_DEXTERITY, _BY_VITALITY, or _BY_ENERGY families compute:

bonus = StatValue / OptionValue     (OptionValue > 0)
bonus = 0                           (OptionValue == 0, guarded in code)

Example: OptionIndex = 143 (physical damage per strength) with OptionValue = 10 and 500 Strength gives +50 physical damage.

Multiplier vs Additive Options#

Example - MUL_HP (91) with OptionValue = 10:

• Character has 5000 max HP
• Added bonus = 5000 * 10 / 100 = +500 bonus HP