LuckyItem Configuration

This configuration file defines Lucky Items - special armor pieces with time-based durability decay and configurable enhancement options.

File Location#

Data/Item/LuckyItem.xml

Dependencies#

Depends OnPurpose
Item.xmlItem definitions by Index
ItemOptionRate.xmlOption0-6 reference option rate indices

How It Works#

  1. Lucky items have time-based durability decay, not damage-based
  2. Durability decreases over time while equipped (one point every Decay seconds)
  3. Each item has configurable enhancement options (Option0-6)
  4. Items are grouped into pools that the Lucky Ticket chaos mix picks from
  5. Jewel of Extension restores durability to full (255) when current durability is between 1 and 254
  6. Jewel of Elevation raises the item's Jewel of Harmony option level
  7. Jewel of Harmony cannot be applied to Lucky items (use Jewel of Elevation instead)
  8. The fractional decay counter (DurabilitySmall) is persisted to the DataServer at save time and on logout, so progress survives restarts and map changes

Structure#

<LuckyItemList>
    <Item Index="3646" Group="0" Decay="2400"
          Option0="10" Option1="10" Option2="10" Option3="10"
          Option4="10" Option5="10" Option6="10" Comment="Scale Helm"/>
</LuckyItemList>

Attributes#

AttributeTypeDescription
IndexintItem index (Category * 512 + Type)
GroupintLucky item group (0 or 1)
DecayintDecay threshold. The internal counter rises by an effective rate of 1 unit per second of equipped wear; when the counter exceeds this value, durability drops by 1 and the counter resets to 0. Decay therefore equals the number of seconds per durability point. Example: 2400 = 2400 seconds (40 minutes) per durability point
Option0intItemOptionRate index used to roll the item's +Level
Option1intItemOptionRate index used to roll the skill option (0/1)
Option2intItemOptionRate index used to roll the luck option (0/1)
Option3intItemOptionRate index used to roll the additional option (+4/+8/+12/+16 tier)
Option4intItemOptionRate index used to roll excellent options
Option5intItemOptionRate index used to roll the ancient/set option
Option6intItemOptionRate index used to roll the socket seed option
CommentstringItem name (optional, for reference)

Index Calculation#

Index = Category * 512 + Type
CategoryBase IndexItem Type
73584Helms
84096Armor
94608Pants
105120Gloves
115632Boots

Examples#

<!-- Lucky Helms (Category 7, base index 3584) -->
<Item Index="3646" Group="0" Decay="2400"
      Option0="10" Option1="10" Option2="10" Option3="10"
      Option4="10" Option5="10" Option6="10" Comment="Scale Helm"/>
<Item Index="3650" Group="1" Decay="2400"
      Option0="10" Option1="10" Option2="10" Option3="10"
      Option4="10" Option5="10" Option6="10" Comment="Dark Soul Helm"/>
  • Index 3646 = Category 7 * 512 + Type 62
  • Group 0 and Group 1 are two independent pools. The Lucky Ticket chaos mix picks one item at random from the pool that matches the ticket's group and category, filtered by the player's class.

Important Behavior#

Common Issues#

Last updated April 21, 2026