> For the complete documentation index, see [llms.txt](https://refracdevelopment.gitbook.io/simplegems/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://refracdevelopment.gitbook.io/simplegems/how-to-create-shop-categories.md).

# How to create Shop Categories

All you need to do is copy the default category

```yaml
gems-menu:
  enabled: true
  default: true
  title: "&e&lGems Shop"
  size: 27
  fill:
    enabled: true
    material: BLACK_STAINED_GLASS_PANE
    durability: 0
    name: "&7"
  items:
    infoandbalanceItem:
      material: SUNFLOWER
      durability: 0
      skulls: false
      headDatabase: false
      skullOwner: ""
      customData: false
      customModelData: YOURIDHERE
      name: "&eWhat is the Gem Shop?"
      lore:
        - "&7The Gem Shop sells you items"
        - "&7you can not get in /shop."
        - ""
        - "&eYour Gem Balance: &b&l%star% &f%gems_formatted%"
      # Set to false so the menu knows this is not a buyable item
      buyable: false
      slot: 4
      amount: 1
    stick:
      material: STICK
      skulls: false
      headDatabase: false
      skullOwner: ""
      customData: false
      customModelData: YOURIDHERE
      data: 0
      glow: false
      itemsAdder: false
      name: "&dMagic Stick"
      lore:
        - "&7Be special and buy a stick for %cost% gem"
      message:
        enabled: true
        broadcast: true
        text:
          - "&e%player% bought %item% &efrom &f/gemshop&e."
      action:
        # If enabled will use this instead of commands
        enabled: false
        actions:
          - "[console] give %player% stick 1" # gives the player an item from console
          - "[message] %prefix% &e%player% bought %item% &efrom &f/gemshop&e." # sends a message to the player
          - "[close]" # Closes the inventory
      commands:
        - "give %player% stick 1"
      cost: 1
      slot: 10
      amount: 1
```

Then change default to false to make it not open with /gems shop

```yaml
default: false
```

Then add an item in the default category to open your new category

```yaml
open-menu-item:
  material: ARROW
  skulls: false
  headDatabase: false
  skullOwner: ""
  customData: false
  customModelData: YOURIDHERE
  durability: 0
  glow: false
  itemsAdder: false
  name: "&dOpen your menu name"
  lore:
    - "&7Open your menu name"
  action:
    enabled: true
    actions:
      - "{openmenu:menu-name}"
  # This is needed to make it not a buyable item
  # by default this is set to true for all items for compatibility
  # with older versions of the plugin when updating
  buyable: false
  slot: 15
  amount: 1
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://refracdevelopment.gitbook.io/simplegems/how-to-create-shop-categories.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.