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

# CustomEventDrop

<mark style="color:green;">Configures up to 10 automatic item drop events at a fixed point on the map (time-based event, with prior notice). The file has 3 blocks, with each line starting with the event</mark> <mark style="color:green;"></mark><mark style="color:green;">`Index`</mark> <mark style="color:green;"></mark><mark style="color:green;">(</mark><mark style="color:green;">`0`</mark> <mark style="color:green;"></mark><mark style="color:green;">to</mark> <mark style="color:green;"></mark><mark style="color:green;">`9`</mark><mark style="color:green;">) — the same</mark> <mark style="color:green;"></mark><mark style="color:green;">`Index`</mark> <mark style="color:green;"></mark><mark style="color:green;">binds the lines of the 3 blocks together.</mark>

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

| **Column**                                        | **Accepted values**    | **What it is**                                                                                                                            |
| ------------------------------------------------- | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Index                                             | Number from `0` to `9` | The event to which this time belongs. There can be multiple lines with the same `Index` (the event triggers at each of the listed times). |
| Year / Month / Day / DoW / Hour / Minute / Second | Number, or `*`         | Year/Month/Day/Day of the week/Hour/Minute/Second when the event starts. `*` = any value works (no restriction).                          |

### <mark style="color:yellow;">Block 1 — general event data</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 from <code>0</code> to <code>9</code></td><td>The event to which this line belongs (only one line per event).</td></tr><tr><td>Name</td><td>Text in quotation marks</td><td>Name of the event, used in chat announcements.</td></tr><tr><td>DropMap</td><td>Number</td><td>Map where the items will drop.</td></tr><tr><td>DropX / DropY</td><td>Number</td><td>Center of the drop area.</td></tr><tr><td>DropRange</td><td>Number</td><td>Radius (in squares) around <code>DropX</code>/<code>DropY</code> where items can land.</td></tr><tr><td>AlarmTime</td><td>Number (minutes)</td><td>How long before the event starts that players are notified.</td></tr><tr><td>EventTime</td><td>Number (minutes)</td><td>Total duration of the event (item dropping).</td></tr></tbody></table>

### <mark style="color:yellow;">Block 2 — items that drop during the event</mark>

| **Column** | **Accepted values**             | **What it is**                                                                   |
| ---------- | ------------------------------- | -------------------------------------------------------------------------------- |
| Index      | Number from `0` to `9`          | The event to which this item belongs.                                            |
| ItemIndex  | Number (pre-combined item code) | Item that will drop.                                                             |
| ItemLevel  | Number                          | Level (+how much) of the item.                                                   |
| DropCount  | Number                          | How many copies of this item drop when its turn comes.                           |
| DropDelay  | Number (seconds)                | How long after the start of the event (not the server) this item begins to drop. |

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

* `AlarmTime` and `EventTime` are in minutes, but `DropDelay` (block 2) is in seconds, counted from the start of the event's drop phase — not from midnight or the scheduled time in block 0.
* An event goes through 3 phases: waiting → announcement (`AlarmTime` before the start) → item drop (lasts for `EventTime`, pouring out the items from block 2 according to each one's `DropDelay`). Once `EventTime` ends, the event returns to waiting for the next time in block 0.
* If two events (different indexes) have the same scheduled time, both trigger normally — there is no conflict, as each `Index` runs independently.