> For the complete documentation index, see [llms.txt](https://cozy-1.gitbook.io/dev-example2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cozy-1.gitbook.io/dev-example2/currency/creating-a-shop.md).

# Creating a shop

**Step 1: Initialize Your New Shop File**

1. Navigate to your server files: `plugins/manticcurrency/shops/`.
2. Create a new `.yml` file (e.g., `spawners.yml`).
3. Pro-Tip: Copy the contents of `example.yml` and paste them into your new file to use as a starting template.

**Step 2: Design the GUI Layout**

Open your new `spawners.yml` and modify the `menu-layout` list. This layout is a visual grid representing your inventory GUI.

* The Grid: Each row must be exactly 9 characters long, and you must have 1-6 rows depending on your preference.
* The Filler: The `#` character is typically your filler item (e.g., glass panes).
* The Products: Use unique alphanumeric characters (e.g., `a`, `b`, `1`, `2`) to mark the exact slots where your store items will appear.

**Step 3: Configure Store Products**

In the `store-items` section, define your products. Each product must have a `key` that matches the character you placed in your `menu-layout`.

* Pricing: Set your `price` (long) and define the `commands` that will be executed when the item is purchased.
* Placeholders: Inside your `lore`, you can use dynamic placeholders like `{cost}` and `{balance}` which will automatically update based on the player's wallet.

**Step 4: Link to Main Menu**

For players to actually access your new shop, you must link it to your `main-menu.yml`.

1. Open `plugins/manticcurrency/main-menu.yml`.
2. Add a new item to the `items` list (or edit an existing one).
3. Set the item's `action` to `[MENU] <filename>`, where `<filename>` is the name of your new shop file (excluding the `.yml`).
   * *Example:* `action: '[MENU] spawners'`
4. Ensure the character used for the `key` of this item is also present in your `main-menu.yml`'s `menu-layout`.

**Step 5: Refresh the System**

Once you have saved your files, run the command `/currency reload` in-game or via console. This refreshes all shop menus and registers your new custom shop category, making it live for all players.

\
:notebook: **Notes:**  ManticCurrency supports advanced parsing in all `display-name` and `lore` sections.

* **Internal Placeholders**: Use `{cost}`, `{balance}`, `{balance_short}`, `{total}`, and `{player}` directly in your lore to show real-time account data.
* **PlaceholderAPI**: If PlaceholderAPI is installed, you can include any valid server-wide placeholder (e.g., `%player_level%`) in your lore. The plugin will automatically detect and parse these every time the menu is opened.