380ItemType Configuration

This configuration file defines which items can receive 380-level enhancement options and maps them to specific option types from 380ItemOption.xml.

File Location#

Data/Item/380ItemType.xml

Dependencies#

Depends On	Purpose
Item.xml	Item definitions by Category/Type
380ItemOption.xml	Option type definitions and default values

How It Works#

Player obtains a 380-enhanced item (carries the 380 flag on its extended option byte, bit 0x80)
Server looks up the item in 380ItemType by the combined item index (Category * 512 + Type)
Retrieves OptionIndex1/2 (option types) and OptionValue1/2 (raw values)
* in OptionValue is stored internally as -1 and triggers fallback to the default Value in 380ItemOption.xml; any other string is parsed as an integer (non-numeric strings become 0)
Applies each option that has a non-zero index and a matching entry in 380ItemOption.xml

Structure#

<Item380TypeList>
    <Item Category="0" Type="22" OptionIndex1="2" OptionValue1="*" OptionIndex2="1" OptionValue2="*"/>
</Item380TypeList>

Attributes#

Attribute	Type	Description
`Category`	int	Item category (0-11 are standard equipment slots; higher categories are valid if the item index resolves)
`Type`	int	Item type index within category
`OptionIndex1`	int	First option type (0 = none, otherwise an index defined in 380ItemOption.xml)
`OptionValue1`	string	First option value (`*` = use default from 380ItemOption, otherwise an integer)
`OptionIndex2`	int	Second option type (0 = none, otherwise an index defined in 380ItemOption.xml)
`OptionValue2`	string	Second option value (`*` = use default, otherwise an integer)

Item Index Calculation#

ItemIndex = Category * 512 + Type

Category Reference#

Category	Item Type
0	Swords
1	Axes
2	Maces/Scepters
3	Spears
4	Bows/Crossbows
5	Staffs
6	Shields
7	Helms
8	Armor
9	Pants
10	Gloves
11	Boots

Option Types#

See 380ItemOption.xml for the authoritative list and default values.

Index	Name	Effect
1	Add Attack Success Rate PvP	Adds value to PvP attack success rate
2	Add Damage PvP	Adds value to PvP damage
3	Add Defense Success Rate PvP	Adds value to PvP defense success rate
4	Add Defense PvP	Adds value to PvP defense
5	Add Max HP	Adds value to maximum life
6	Add Max SD	Adds value to maximum shield
7	Set SD Recovery Type	Assigns the SD recovery type field (not additive)
8	Add SD Recovery Rate	Adds value to SD recovery rate

Standard Option Assignments#

Default assignments shipped in the stock 380ItemType.xml:

Equipment Slot	OptionIndex1	OptionIndex2
Weapons (Cat 0, 2, 4, 5)	2 (Damage PvP)	1 (Attack Rate PvP)
Helms (Cat 7)	8 (SD Recovery Rate)	3 (Defense Rate PvP)
Armor (Cat 8)	7 (SD Recovery Type)	3 (Defense Rate PvP)
Pants (Cat 9)	4 (Defense PvP)	3 (Defense Rate PvP)
Gloves (Cat 10)	5 (Max HP)	3 (Defense Rate PvP)
Boots (Cat 11)	6 (Max SD)	3 (Defense Rate PvP)

Examples#

<!-- Rune Blade (Section 0, Type 22) - PvP damage bonuses -->
<Item Category="0" Type="22" OptionIndex1="2" OptionValue1="*" OptionIndex2="1" OptionValue2="*"/>

OptionIndex1=2: Add Damage PvP (default value from 380ItemOption)
OptionIndex2=1: Add Attack Success Rate PvP (default value)

<!-- Dark Phoenix Helm (Section 7, Type 29) - SD recovery bonuses -->
<Item Category="7" Type="29" OptionIndex1="8" OptionValue1="*" OptionIndex2="3" OptionValue2="*"/>

OptionIndex1=8: Add SD Recovery Rate
OptionIndex2=3: Add Defense Success Rate PvP

<!-- Custom weapon with specific values instead of defaults -->
<Item Category="0" Type="22" OptionIndex1="2" OptionValue1="15" OptionIndex2="1" OptionValue2="10"/>

OptionValue1=15: +15 Damage PvP (overrides default)
OptionValue2=10: +10 Attack Rate PvP (overrides default)