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

# CustomOnlineLottery

<mark style="color:green;">Configures the automatic lottery among all online players, which drops an item for the winner at a point on the map. Supports up to 24 independent lotteries (</mark><mark style="color:green;">`Index`</mark><mark style="color:green;">). The drawn items come from another file (</mark><mark style="color:green;">`Lottery.txt`</mark><mark style="color:green;">, from the Event Item Bag system) — here you only configure the schedule, the map, and the extra currency rewards.</mark>

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

| **Column**                                        | **Accepted values**     | **What it is**                                                                             |
| ------------------------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------ |
| Index                                             | Number from `0` to `23` | The lottery 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 lottery happens. `*` = any value works.                                 |

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

| **Column** | **Accepted values**     | **What it is**                                                      |
| ---------- | ----------------------- | ------------------------------------------------------------------- |
| Index      | Number from `0` to `23` | The lottery to which this line belongs (only one line per lottery). |
| Name       | Text in quotation marks | Name of the lottery, used in chat announcements.                    |
| DropMap    | Number                  | Map where the winner's item will drop.                              |
| AlarmTime  | Number (minutes)        | How long before the lottery that players are notified.              |

### <mark style="color:yellow;">Block 2 — extra currency rewards</mark>

| **Column** | **Accepted values**     | **What it is**                          |
| ---------- | ----------------------- | --------------------------------------- |
| Index      | Number from `0` to `23` | The lottery to which this line belongs. |
| WC         | Number                  | Extra WCoinC given to the winner.       |
| WP         | Number                  | Extra WCoinP given to the winner.       |
| GP         | Number                  | Extra Goblin Point given to the winner. |

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

* If the lottery is started manually through the GameServer menu (instead of waiting for the time in block 0), the rewards used are always those of `Index 0`.
* Unlike `CustomEventDrop.txt` and `CustomQuiz.txt`, this file does not have an event duration column — the draw is instantaneous as soon as the scheduled time arrives, there is no configurable time window here.
* The item actually drawn (which item, level, options) is defined in `Lottery.txt` of the Event Item Bag system, not in this file.