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

# CustomMix

<mark style="color:green;">Configures custom Chaos Goblin combinations (Item Combination): what items to require, success chance, and what to give as a reward. The file has 3 blocks, linked together by the</mark> <mark style="color:green;"></mark><mark style="color:green;">`Index`</mark> <mark style="color:green;"></mark><mark style="color:green;">column (which identifies the mix).</mark>

### <mark style="color:yellow;">Block 0 — cost and success chance</mark>

| **Column**                  | **Accepted values** | **What it is**                                          |
| --------------------------- | ------------------- | ------------------------------------------------------- |
| Index                       | Number              | Identifies this custom mix (binds with blocks 1 and 2). |
| MixMoney                    | Number              | Zen charged to attempt the mix.                         |
| MixRate\_AL0 – MixRate\_AL3 | Number (%)          | Success chance, by Free/VIP1/VIP2/VIP3 account.         |

### <mark style="color:yellow;">Block 1 — required items</mark>

<table data-header-hidden data-search="false"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Column</strong></td><td><strong>Accepted values</strong></td><td><strong>What it is</strong></td></tr><tr><td>Index</td><td>Number of a mix from block 0</td><td>Which mix this required item belongs to.</td></tr><tr><td>Group</td><td>Number</td><td>Groups items that count as "the same requirement" within the same mix (multiple lines with the same <code>Group</code> = any of them works to fulfill that requirement).</td></tr><tr><td>Count</td><td>Number</td><td>How many units of this item are required.</td></tr><tr><td>ItemMinIndex / ItemMaxIndex</td><td>Number (pre-combined item code)</td><td>Range of accepted items (one line for a unique item = same value in both).</td></tr><tr><td>ItemLevel</td><td>Number, or <code>-1</code></td><td>Required level (+how much) of the item. <code>-1</code> = any level.</td></tr><tr><td>ItemOption1 / ItemOption2 / ItemOption3</td><td>Number, or <code>-1</code></td><td>Required options of the item. <code>-1</code> = any value.</td></tr><tr><td>ItemNewOption</td><td>Number, or <code>-1</code></td><td>Requires (or not) excellent. <code>-1</code> = any.</td></tr><tr><td>ItemSetOption</td><td>Number, or <code>-1</code></td><td>Requires (or not) ancient/set. <code>-1</code> = any.</td></tr></tbody></table>

### <mark style="color:yellow;">Block 2 — reward</mark>

| **Column** | **Accepted values**                                      | **What it is**                                                    |
| ---------- | -------------------------------------------------------- | ----------------------------------------------------------------- |
| Index      | Number of a mix from block 0                             | Which mix this reward belongs to.                                 |
| Group      | Number                                                   | Reward group (allows for more than one possible outcome per mix). |
| BagSpecial | Number of a special value from `EventItemBagManager.txt` | Defines the item/prize drawn upon a successful mix.               |

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

* The same mix `Index` can require multiple different item groups (block 1) — all groups listed for that `Index` must be satisfied, each with a unit from among the options of that specific group.
* The reward itself (which exact item comes out) is not defined directly in block 2 — `BagSpecial` points to an entry in the Event Item Bag system, which is what draws the final outcome.