> For the complete documentation index, see [llms.txt](https://axiomemu.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://axiomemu.gitbook.io/docs/data/item/380itemoption.md).

# 380ItemOption

This configuration file defines the available option types for 380-level enhanced items and their default bonus values.

## File Location

```
Data/Item/380ItemOption.xml
```

## Dependencies

| Depended On By                                    | Purpose                                           |
| ------------------------------------------------- | ------------------------------------------------- |
| [380ItemType.xml](/docs/data/item/380itemtype.md) | References option indices and uses default values |

## How It Works

1. [380ItemType.xml](/docs/data/item/380itemtype.md) references option indices from this file
2. When OptionValue is `*` (wildcard) in 380ItemType.xml, the server falls back to the default Value from this file
3. Bonuses are recalculated from the full equipped set each time stats change, so they effectively apply while the 380 item is worn and fall off when it is removed
4. Most bonuses are PvP-specific (attack success, damage, defense success, and defense bonuses that only apply during player-versus-player combat)

## Structure

```xml
<Item380OptionList>
    <Option Index="1" Name="Add Attack Success Rate PvP" Value="10"/>
</Item380OptionList>
```

## Attributes

| Attribute | Type   | Description                                                                                        |
| --------- | ------ | -------------------------------------------------------------------------------------------------- |
| `Index`   | int    | Option index (0-9 accepted by loader, 1-8 have defined effects, see [Option Types](#option-types)) |
| `Name`    | string | Display name for the option (descriptive only, not used by the server)                             |
| `Value`   | int    | Default bonus value (integer)                                                                      |

## Option Types

| Index | Name                         | Effect                                                           | Typical Use |
| ----- | ---------------------------- | ---------------------------------------------------------------- | ----------- |
| 1     | Add Attack Success Rate PvP  | Adds value to the PvP attack success rate stat                   | Weapons     |
| 2     | Add Damage PvP               | Adds value to the PvP damage bonus stat                          | Weapons     |
| 3     | Add Defense Success Rate PvP | Adds value to the PvP defense success rate stat                  | All armor   |
| 4     | Add Defense PvP              | Adds value to the PvP defense bonus stat                         | Pants       |
| 5     | Add Max HP                   | Adds value to maximum life                                       | Gloves      |
| 6     | Add Max SD                   | Adds value to maximum shield                                     | Boots       |
| 7     | Set SD Recovery Type         | Overwrites the SD recovery type field (assignment, not addition) | Armor       |
| 8     | Add SD Recovery Rate         | Adds value to the SD recovery rate stat                          | Helms       |

### Effect Details

| Index | Applies To                    | Notes                                                  |
| ----- | ----------------------------- | ------------------------------------------------------ |
| 1     | PvP attack success rate stat  | PvP-only stat                                          |
| 2     | PvP damage stat               | PvP-only stat                                          |
| 3     | PvP defense success rate stat | PvP-only stat                                          |
| 4     | PvP defense stat              | PvP-only stat                                          |
| 5     | Max Life                      | Applies in all combat                                  |
| 6     | Max Shield                    | Applies in all combat                                  |
| 7     | SD recovery type field        | Assignment, not additive. Last equipped 380 armor wins |
| 8     | SD recovery rate              | Applies in all combat                                  |

## Examples

{% tabs %}
{% tab title="Correct Format" %}

```xml
<Item380OptionList>
    <Option Index="1" Name="Add Attack Success Rate PvP" Value="10"/>
    <Option Index="2" Name="Add Damage PvP" Value="15"/>
    <Option Index="3" Name="Add Defense Success Rate PvP" Value="10"/>
    <Option Index="4" Name="Add Defense PvP" Value="20"/>
    <Option Index="5" Name="Add Max HP" Value="100"/>
    <Option Index="6" Name="Add Max SD" Value="50"/>
    <Option Index="7" Name="Set SD Recovery Type" Value="1"/>
    <Option Index="8" Name="Add SD Recovery Rate" Value="5"/>
</Item380OptionList>
```

All Value attributes must be **integers**.
{% endtab %}

{% tab title="Balanced PvP Values" %}

```xml
<Item380OptionList>
    <!-- PvP combat bonuses -->
    <Option Index="1" Name="Add Attack Success Rate PvP" Value="5"/>
    <Option Index="2" Name="Add Damage PvP" Value="10"/>
    <Option Index="3" Name="Add Defense Success Rate PvP" Value="5"/>
    <Option Index="4" Name="Add Defense PvP" Value="10"/>

    <!-- Survivability bonuses -->
    <Option Index="5" Name="Add Max HP" Value="50"/>
    <Option Index="6" Name="Add Max SD" Value="25"/>
    <Option Index="7" Name="Set SD Recovery Type" Value="1"/>
    <Option Index="8" Name="Add SD Recovery Rate" Value="3"/>
</Item380OptionList>
```

{% endtab %}
{% endtabs %}

## Important Behavior

{% hint style="info" %}
**Default Values**: These values are used when [380ItemType.xml](/docs/data/item/380itemtype.md) specifies `*` for OptionValue. Specific numeric values in 380ItemType.xml override the default Value from this file.
{% endhint %}

{% hint style="info" %}
**Index 0 Reserved**: Index `0` is the "no option" sentinel used by 380ItemType.xml. Valid options start at index 1. Defining an entry at Index 0 here has no effect because the consumer skips it.
{% endhint %}

{% hint style="info" %}
**Loader cap**: The loader accepts Index values 0-9 (10 slots). Only indices 1-8 have defined effects. Entries at index 9 load without error but are never consumed.
{% endhint %}

{% hint style="info" %}
**Matching Index Required**: The loader stores each Option at array slot `Index`, and the lookup rejects slots whose stored Index does not match the requested one. If two Option entries share the same Index, the later one overwrites the earlier one.
{% endhint %}

{% hint style="info" %}
**Equipment state**: Bonuses are recomputed from the full equipped set whenever stats are rebuilt, so swapping a 380 item automatically refreshes the totals.
{% endhint %}

{% hint style="warning" %}
**SD Recovery Type (Index 7)**: This option assigns the SD recovery type field rather than adding to it. If multiple equipped 380 items use index 7, the last one processed wins.
{% endhint %}

## Common Issues

{% hint style="warning" %}
**Missing Option Index**: If [380ItemType.xml](/docs/data/item/380itemtype.md) references an OptionIndex not defined here, no bonus is applied.
{% endhint %}

{% hint style="warning" %}
**Value of 0**: A Value of 0 means the option provides no bonus even when equipped.
{% endhint %}

{% hint style="danger" %}
**Value Must Be Integer**: Non-numeric Value strings parse as `0` and the option provides no bonus. Use plain integers.
{% endhint %}

## See Also

* [380ItemType.xml](/docs/data/item/380itemtype.md) - Item to option assignments that reference these indices
* [Item.xml](/docs/data/item/item.md) - Base item definitions by Category and Type
* [ItemOption.xml](/docs/data/item/itemoption.md) - Standard level-based option stat bonuses
* [ItemOptionRate.xml](/docs/data/item/itemoptionrate.md) - Rate tables for non-380 options