> 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/shop/000-shopname.md).

# 000 - ShopName

## <mark style="color:yellow;">Shop — General Format</mark>

<mark style="color:green;">Defines the items sold by an NPC. This is the format used by all files in this folder — each file represents an NPC's shop, linked by the number at the beginning of the filename to the corresponding</mark> <mark style="color:green;"></mark><mark style="color:green;">`Index`</mark> <mark style="color:green;"></mark><mark style="color:green;">in</mark> [<mark style="color:green;">ShopManager.txt</mark>](https://www.google.com/search?q=../ShopManager.txt.md) <mark style="color:green;">(e.g.,</mark> <mark style="color:green;"></mark><mark style="color:green;">`000 - Hanzo the Blacksmith.txt`</mark> <mark style="color:green;"></mark><mark style="color:green;">is the shop for</mark> <mark style="color:green;"></mark><mark style="color:green;">`Index 0`</mark><mark style="color:green;">).</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>Description</strong></td></tr><tr><td>Sect</td><td>Number (item group)</td><td>Combined with <code>Type</code>, it forms the ID of the item being sold.</td></tr><tr><td>Type</td><td>Number (item index within the group)</td><td>See <code>Sect</code>.</td></tr><tr><td>Level</td><td>Number</td><td>Level (+value) of the item for sale.</td></tr><tr><td>Dur</td><td>Number, or <code>0</code></td><td>Item durability. <code>0</code> = automatically uses the default maximum durability of that item.</td></tr><tr><td>Skill</td><td>Number</td><td>Item Skill option.</td></tr><tr><td>Luck</td><td>Number</td><td>Item Luck option.</td></tr><tr><td>Option</td><td>Number</td><td>Additional option (the percentage damage/defense bonus) of the item.</td></tr><tr><td>ExcOp</td><td>Number, in bits (0 to 63)</td><td>Excellent options of the item. <code>0</code> = none.</td></tr><tr><td>SetOp</td><td>Number</td><td>Ancient/set option of the item. <code>0</code> = none.</td></tr><tr><td>JoH</td><td>Number</td><td>Jewel of Harmony bonus of the item (same format as <code>JewelOfHarmonyOption.txt</code>: one half indicates which bonus, the other half indicates its level). <code>0</code> = none.</td></tr><tr><td>OEx</td><td>Number</td><td>Special "380" option of the item (see <code>380ItemOption.txt</code>). <code>0</code> = none.</td></tr><tr><td>Socket1 – Socket5</td><td>Number, or <code>255</code></td><td>Option for each of the item's sockets, in order. <code>255</code> = empty socket. Only has an effect if the item actually supports that socket (see <code>SocketItemType.txt</code>).</td></tr><tr><td>Bonus</td><td>Number, or <code>255</code></td><td>Special socket combination bonus of the item (see block 1/2 of <code>SocketItemOption.txt</code>). <code>255</code> = none.</td></tr><tr><td>Comment</td><td>Text after <code>//</code></td><td>Name of the item, for editor identification purposes only — it is not read by the game.</td></tr></tbody></table>

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

* All items in a shop come with fixed options defined line by line — nothing here is randomized like it is with items that drop from monsters.
* If the item does not support sockets (is not in `SocketItemType.txt`), the values in `Socket1`–`Socket5` are ignored.
* The order of the lines in the file is the order in which the items fill the shop slots, from top to bottom and left to right — if a larger item does not fit in the current position, it skips to the next available one.