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

# CustomQuest

<mark style="color:green;">Configures a chain of sequential and custom quests (without a fixed NPC — the player advances using a command): the character can only do quest</mark> <mark style="color:green;"></mark><mark style="color:green;">`N+1`</mark> <mark style="color:green;"></mark><mark style="color:green;">after completing quest</mark> <mark style="color:green;"></mark><mark style="color:green;">`N`</mark><mark style="color:green;">. The file has 7 blocks, all linked by the</mark> <mark style="color:green;"></mark><mark style="color:green;">`Quest`</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 position in the chain.</mark>

### <mark style="color:yellow;">Block 0 — character requirements</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>Quest</td><td>Number</td><td>Position in the chain (1 quest per line in this block).</td></tr><tr><td>Level / MLevel</td><td>Number, or <code>*</code></td><td>Minimum Level/Master Level. <code>*</code> = no requirement.</td></tr><tr><td>Reset / MReset</td><td>Number, or <code>*</code></td><td>Minimum Reset/Master Reset. <code>*</code> = no requirement.</td></tr><tr><td>Zen</td><td>Number</td><td>Required Zen (deducted upon completion).</td></tr><tr><td>WC / WP / GP</td><td>Number</td><td>Required WCoinC/WCoinP/Goblin Point (deducted upon completion).</td></tr><tr><td>AL</td><td>Number, or <code>*</code></td><td>Required Free/VIP1/VIP2/VIP3 account level. <code>*</code> = any.</td></tr><tr><td>RankUser</td><td>Number, or <code>*</code></td><td>Required ranking position. <code>*</code> = no requirement.</td></tr><tr><td>Kills</td><td>Number, or <code>*</code></td><td>Minimum amount of kills (PK) of the character. <code>*</code> = no requirement.</td></tr></tbody></table>

### <mark style="color:yellow;">Block 1 — required item (removed from inventory)</mark>

| **Column**     | **Accepted values**                        | **What it is**                                            |
| -------------- | ------------------------------------------ | --------------------------------------------------------- |
| Quest          | Number                                     | The quest in the chain to which this requirement belongs. |
| Section / Type | Number / Number                            | Together they form the required item.                     |
| Level          | Number, or `*`                             | Required level (+how much) of the item. `*` = any.        |
| Luck / Skill   | `0` (without), `1` (with) or `*` (ignores) | Requires (or not) the Luck/Skill option on the item.      |
| Amount         | Number                                     | Required amount.                                          |

### <mark style="color:yellow;">Block 2 — monster to kill</mark>

| **Column** | **Accepted values**                     | **What it is**                                                |
| ---------- | --------------------------------------- | ------------------------------------------------------------- |
| Quest      | Number                                  | Which quest it belongs to (only 1 type of monster per quest). |
| Monster    | Number of an `Index` from `Monster.txt` | Monster that needs to be killed.                              |
| Amount     | Number                                  | Required amount of kills.                                     |

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

| **Column**   | **Accepted values** | **What it is**                               |
| ------------ | ------------------- | -------------------------------------------- |
| Quest        | Number              | Which quest it belongs to.                   |
| WC / WP / GP | Number              | WCoinC/WCoinP/Goblin Point given as a prize. |
| Money        | Number              | Zen given as a prize.                        |

### <mark style="color:yellow;">Block 4 — item reward</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>Quest</td><td>Number</td><td>Which quest it belongs to.</td></tr><tr><td>Section / Type</td><td>Number / Number</td><td>Together they form the given item.</td></tr><tr><td>Level</td><td>Number</td><td>Level (+how much) of the item.</td></tr><tr><td>Durab</td><td>Number</td><td>Durability of the item.</td></tr><tr><td>Skill / Luck / Option</td><td>Number</td><td>Options of the item.</td></tr><tr><td>ExcOp</td><td>Number, in bits</td><td>Excellent options.</td></tr><tr><td>SetOp</td><td>Number</td><td>Ancient/set option.</td></tr><tr><td>JoH</td><td>Number</td><td>Jewel of Harmony option.</td></tr><tr><td>OEx</td><td>Number</td><td>Special "380" option.</td></tr><tr><td>Socket1 – Socket5</td><td>Number, or <code>255</code></td><td>Sockets of the item. <code>255</code> = empty.</td></tr><tr><td>Time</td><td>Number, or <code>0</code></td><td>Duration of the item (temporary item). <code>0</code> = permanent.</td></tr><tr><td>Class</td><td><code>*</code> or class number (<code>0</code> DW … <code>6</code> RF)</td><td>Restricts the item to a class. <code>*</code> = any class.</td></tr></tbody></table>

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

| **Column**      | **Accepted values** | **What it is**              |
| --------------- | ------------------- | --------------------------- |
| Quest           | Number              | Which quest it belongs to.  |
| Effect          | Number of an effect | Buff given upon completion. |
| Power1 / Power2 | Number              | Strength of the buff.       |
| Time            | Number              | Duration of the buff.       |

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

| **Column**   | **Accepted values** | **What it is**             |
| ------------ | ------------------- | -------------------------- |
| Quest        | Number              | Which quest it belongs to. |
| Experience   | Number              | Experience given.          |
| LevelUpPoint | Number              | Status points given.       |

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

* The player's progress in this chain is a single counter per character (not per quest) — upon completing quest `N`, the counter advances and unlocks quest `N+1`. It is not possible to skip quests or repeat an old quest using this system.
* All blocks are optional per quest: a quest without a reward line in any specific block simply does not grant that type of prize.
* This system is not tied to any fixed NPC — that is controlled by `CustomNpcQuest.txt` (which delivers a specific NPC + map position for each line of the chain).