> 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/excellentoptionrate.md).

# ExcellentOptionRate

<mark style="color:green;">Adjusts the chance of each individual Excellent option being selected for different item ranges, instead of all six Excellent options having the same probability.</mark>

| Column                      | Accepted values                   | Description                                                                                                                                                                |
| --------------------------- | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Index                       | `1`, `2`, `4`, `8`, `16`, or `32` | Specifies which of the six Excellent options this entry configures (each option corresponds to a bit: 1st = `1`, 2nd = `2`, 3rd = `4`, 4th = `8`, 5th = `16`, 6th = `32`). |
| ItemMinIndex / ItemMaxIndex | Number (item code range)          | Item code range to which this rule applies (e.g. `0`–`2559` covers regular weapons).                                                                                       |
| Name                        | Text enclosed in quotes           | Name of the option, provided only for readability while editing. **It is not used by the game**, even though it is an actual column (not a `//` comment).                  |
| Rate                        | Number from 0 to 100              | Weight of this specific Excellent option when selecting the item's Excellent bonuses, compared only against the other options defined for the same item range.             |
| Comment                     | Text after `//`                   | Free comment (typically the item category), ignored by the game.                                                                                                           |

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

* This file only affects items whose internal item code falls within one of the configured ranges (`ItemMinIndex`–`ItemMaxIndex`). If an item does not match any listed range, its Excellent options are selected with a **uniform** probability (all six options have the same chance), without using this file.
* A single item range may (and typically should) contain one entry for each applicable Excellent option (`1`, `2`, `4`, `8`, `16`, `32`). Not every item type needs all six options—for example, jewels and wings usually use only a subset of them.
