> For the complete documentation index, see [llms.txt](https://changelog.matrixemulator.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://changelog.matrixemulator.com/welcome/server/muserver/data/item/setitemoption.md).

# SetItemOption

<mark style="color:green;">Defines the bonuses for each Ancient Set (for example: Warrior, Anonymous, Hyperion), including partial set bonuses (based on the number of equipped pieces) and the full set bonus when the complete set is equipped.</mark>

<table data-search="false"><thead><tr><th>Column</th><th>Accepted values</th><th>Description</th></tr></thead><tbody><tr><td>Index</td><td>Number, one per set</td><td>Identifies the Ancient Set.</td></tr><tr><td>Name</td><td>Text enclosed in quotes</td><td>Set name.</td></tr><tr><td>Option1 / Value1, Option2 / Value2</td><td>Number (fixed option ID), or <code>*</code></td><td>Bonuses unlocked when equipping <strong>2 pieces</strong> of the set. Up to 2 bonuses can be active at this stage.</td></tr><tr><td>Option3 / Value3, Option4 / Value4</td><td>Number, or <code>*</code></td><td><strong>Additional</strong> bonuses unlocked when equipping 3 pieces (added on top of the 2-piece bonus).</td></tr><tr><td>Option5 / Value5, Option6 / Value6</td><td>Number, or <code>*</code></td><td>Additional bonuses unlocked when equipping 4 pieces.</td></tr><tr><td>Option7 / Value7, Option8 / Value8</td><td>Number, or <code>*</code></td><td>Additional bonuses unlocked when equipping 5 pieces.</td></tr><tr><td>Option9 / Value9, Option10 / Value10</td><td>Number, or <code>*</code></td><td>Additional bonuses unlocked when equipping 6 pieces.</td></tr><tr><td>Option11 / Value11, Option12 / Value12</td><td>Number, or <code>*</code></td><td>Additional bonuses unlocked when equipping 7 pieces.</td></tr><tr><td>FullOption1 / FullValue1 … FullOption5 / FullValue5</td><td>Number, or <code>*</code></td><td><strong>Exclusive</strong> bonuses activated only when the player equips the maximum number of pieces for that specific set (defined in <code>SetItemType.txt</code>; it is not always the same number for every set).</td></tr></tbody></table>

### <mark style="color:yellow;">Notes</mark>

* Piece-based bonuses are **cumulative**: a player wearing 4 pieces receives the 2-piece bonus **plus** the 3-piece bonus **plus** the 4-piece bonus at the same time. These are not replacement tiers.
* The **Full** bonus only activates when the number of equipped pieces exactly matches the maximum piece count defined for that specific set. It is not always "7 pieces" or any other fixed number.
* The code for each `Option`/`FullOption` comes from a fixed list of approximately 36 possible effects (attributes, physical/magic damage, defense, HP, mana, critical damage, elemental damage, and others). New effects cannot be created by editing this file.