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

# CustomStartItem

<mark style="color:green;">Configures the "starter kit" automatically given the first time a character enters the game: minimum points/status, gift items, and buffs. It only works with</mark> <mark style="color:green;"></mark><mark style="color:green;">`CustomStartItem`</mark> <mark style="color:green;"></mark><mark style="color:green;">enabled (by account type) in the general server configuration, and it is applied only once per character. The file has 3 blocks.</mark>

### <mark style="color:yellow;">Block 0 — guaranteed minimum status</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>Class</td><td>Class number (<code>0</code> DW … <code>6</code> RF), or <code>*</code></td><td>Which class this line applies to. <code>*</code> = all.</td></tr><tr><td>Reset</td><td>Number</td><td>Amount of bonus resets given.</td></tr><tr><td>LevelUpPoint</td><td>Number</td><td>Extra status points given.</td></tr><tr><td>Money</td><td>Number</td><td>Zen given.</td></tr><tr><td>Str / Agi / Vit / Ene</td><td>Number, or <code>*</code></td><td>Guaranteed minimum value of the attribute. <code>*</code> = does not change this attribute.</td></tr><tr><td>Com</td><td>Number, or <code>*</code></td><td>Guaranteed minimum value of Command (only applies to Dark Lord/Lord Emperor). <code>*</code> = does not change.</td></tr></tbody></table>

### <mark style="color:yellow;">Block 1 — gift 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>Class</td><td>Class number, or <code>*</code></td><td>Which class this item is given to. <code>*</code> = all.</td></tr><tr><td>Section / Item</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>Excellent</td><td>Number, in bits</td><td>Excellent options.</td></tr><tr><td>Ancient</td><td>Number</td><td>Ancient/set option.</td></tr><tr><td>Socket1 – Socket5</td><td>Number, or <code>255</code></td><td>Sockets of the item. <code>255</code> = empty (only valid if the item accepts sockets).</td></tr><tr><td>Duration</td><td>Number (days), or <code>-1</code></td><td>Validity time of the item. <code>-1</code> = permanent.</td></tr></tbody></table>

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

| **Column**      | **Accepted values**  | **What it is**                                |
| --------------- | -------------------- | --------------------------------------------- |
| Class           | Class number, or `*` | Which class this buff is given to. `*` = all. |
| Effect          | Number of an effect  | Buff given.                                   |
| Power1 / Power2 | Number               | Strength of the buff.                         |
| Time            | Number               | Duration of the buff.                         |

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

* The `Str`/`Agi`/`Vit`/`Ene`/`Com` values in block 0 are a guaranteed minimum, not an addition: they only overwrite the attribute if the value registered here is higher than the class default — they never reduce an attribute that is naturally higher from the start.
* The kit is delivered only once per character (it is marked internally); reducing or disabling the general switch later does not remove what has already been given.
* `Com` only has an effect on Dark Lord/Lord Emperor — for other classes, this column is ignored even if filled with a number.
