LuckyItem

Defines lucky items with time-based decay and enhancement options

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

File Location

GameServer/Data/Item/LuckyItem.xml

Dependencies

Depends On	Purpose
Item.xml	Item definitions by Index
ItemOptionRate.xml	Option0-6 reference option rate indices

How It Works

1. Lucky items have time-based durability decay (same as Wings/Pendants, not damage-based)

2. Durability decreases every few seconds while equipped

3. Each item has configurable enhancement options (Option0-6)

4. Items are grouped for class-based availability

5. Jewel of Extension can restore durability to full (255) when between 1-254

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

Attribute	Type	Description
Index	int	Item index (Category * 512 + Type)
Group	int	Lucky item group (0 or 1)
Decay	int	Decay threshold - Time until 1 durability point is lost (in ticks of 10 each second). Higher = slower decay. Example: 2400 = 240 seconds (4 minutes) per durability point
Option0	int	Level option index (ItemOptionRate)
Option1	int	Skill option index
Option2	int	Luck option index
Option3	int	Excellent option index
Option4	int	Additional level option index
Option5	int	Set option index
Option6	int	Socket option index
Comment	string	Item name (optional, for reference)

Index Calculation

Index = Category * 512 + Type

Category	Base Index	Item Type
7	3584	Helms
8	4096	Armor
9	4608	Pants
10	5120	Gloves
11	5632	Boots

Examples

Helm Set

<!-- 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 = Early-tier, Group 1 = Higher-tier

Full Armor Set

Custom Options

Important Behavior

Time-Based Decay: Unlike normal items, lucky items lose durability over time while equipped, not from combat damage. The system checks every second and adds 10 to an internal counter. When the counter exceeds the Decay value, durability decreases by 1 and the counter resets.

Decay Calculation: With Decay=2400, it takes 2400/10 = 240 seconds (4 minutes) per durability point. Total lifetime = Durability * (Decay/10) seconds. Example: 255 durability at Decay=2400 = 1020 minutes (17 hours) of use.

Durability States:

• 0 = Broken (unusable, cannot be repaired with Jewel of Extension)

• 1-254 = Usable (can be repaired to 255 with Jewel of Extension)

• 255 = Full (cannot use Jewel of Extension, already at max)

Option Indices: Option0-6 reference indices in ItemOptionRate.xml. These determine the enhancement values applied to the item.

Group Filtering: GetLuckyItemIndex filters by category and group, and also checks class requirements from Item.xml.

Version Requirement: Lucky items require GAMESERVER_UPDATE >= 502 to function. They're disabled in earlier versions.

JoH Exclusion: Lucky items (Type 62-72 in categories 7-11) cannot receive Jewel of Harmony options.

Common Issues

Item Not Recognized: Verify the Index calculation is correct (Category * 512 + Type) and matches Item.xml.

Options Not Applied: Check that Option0-6 values reference valid indices in ItemOptionRate.xml.

Durability Tracking: Lucky item durability is tracked separately via DataServer using m_DurabilitySmall field, which stores the internal decay counter. This is saved/loaded independently from the main durability value to persist the exact decay state across server restarts.

Equipped Items Only: Durability decay only occurs for items in equipped slots (2-6: Helm, Armor, Pants, Gloves, Boots). Items in inventory do not decay.