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

# CustomQuiz

<mark style="color:green;">Configures the automatic quiz event (question and answer in chat, with one question drawn per round). Supports up to 24 independent quizzes (</mark><mark style="color:green;">`Index`</mark><mark style="color:green;">), each with its own schedule and its own question.</mark>

### <mark style="color:yellow;">Block 0 — times when the quiz triggers</mark>

| **Column**                                        | **Accepted values**     | **What it is**                                                                          |
| ------------------------------------------------- | ----------------------- | --------------------------------------------------------------------------------------- |
| Index                                             | Number from `0` to `23` | The quiz to which this time belongs. There can be multiple lines with the same `Index`. |
| Year / Month / Day / DoW / Hour / Minute / Second | Number, or `*`          | Date/time when the quiz starts. `*` = any value works.                                  |

### <mark style="color:yellow;">Block 1 — general quiz data</mark>

| **Column** | **Accepted values**     | **What it is**                                                              |
| ---------- | ----------------------- | --------------------------------------------------------------------------- |
| Index      | Number from `0` to `23` | The quiz to which this line belongs (only one line per quiz).               |
| Name       | Text in quotation marks | Name of the quiz, used in chat announcements.                               |
| AlarmTime  | Number (minutes)        | How long before the quiz starts that players are notified.                  |
| EventTime  | Number (minutes)        | How much time players have to answer before the quiz ends without a winner. |

### <mark style="color:yellow;">Block 2 — questions</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>ID</td><td>Number, one per question</td><td>Identifies the question.</td></tr><tr><td>WC</td><td>Number</td><td>WCoinC prize for the one who gets it right.</td></tr><tr><td>WP</td><td>Number</td><td>WCoinP prize for the one who gets it right.</td></tr><tr><td>GP</td><td>Number</td><td>Goblin Point prize for the one who gets it right.</td></tr><tr><td>Question</td><td>Text in quotation marks</td><td>The question displayed in the chat.</td></tr><tr><td>Answer</td><td>Text in quotation marks</td><td>The correct answer.</td></tr></tbody></table>

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

* Each round, the game draws a question from block 2 — the questions are not tied to a specific quiz `Index`, they all enter the same general draw.
* Avoid accents and special characters in the `Answer`, as the comparison with what the player types in the chat is usually sensitive to these types of characters.
* Just like in `CustomEventDrop.txt`, `AlarmTime`/`EventTime` are in minutes.