> ## Documentation Index
> Fetch the complete documentation index at: https://docs.razebot.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Role Shop

> Let members spend in-game currency to buy server roles directly.

# Role Shop

> Let members spend in-game currency to buy server roles directly.

## Overview

The role shop lets server admins list Discord roles for purchase with economy currency. Members browse the shop, buy roles they want, and have them assigned instantly. Listings can have limited stock.

*Alias: `;rshop`*

<Info>
  Admin commands require **Manage Server**.
</Info>

***

## Browse roles

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    ;roleshop list
    ```

    *Alias: `;roleshop`*

    Lists all roles available for purchase. Shows role, price, remaining stock (if limited), and description.
  </Tab>

  <Tab title="Example">
    ```bash theme={null} theme={null}
    ;roleshop
    ```

    *Alias: `;roleshop`*

    Lists all roles available for purchase. Shows role, price, remaining stock (if limited), and description.
  </Tab>
</Tabs>

***

## Buy a role

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    ;roleshop buy @role
    ```

    Purchase a role from the shop. Price deducted from wallet immediately. Fails if you already own the role, stock is sold out, or the bot's role is too low to assign it.
  </Tab>

  <Tab title="Example">
    ```bash theme={null} theme={null}
    ;roleshop buy @VIP
    ```

    Purchase a role from the shop. Price deducted from wallet immediately. Fails if you already own the role, stock is sold out, or the bot's role is too low to assign it.
  </Tab>
</Tabs>

***

## Admin: Manage listings

<AccordionGroup>
  <Accordion title="Add a role">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;roleshop add @role (price)
        ```

        Add a role to the shop at the given price. The bot's role must be above the target role in the hierarchy.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;roleshop add @VIP 50000
        ```

        Add a role to the shop at the given price. The bot's role must be above the target role in the hierarchy.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Remove a role">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;roleshop remove @role
        ```

        Remove a role from the shop. Members who already own it keep it.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;roleshop remove @VIP
        ```

        Remove a role from the shop. Members who already own it keep it.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Edit a listing">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;roleshop edit @role (price)
        ```

        Update the price or description of an existing listing.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;roleshop edit @VIP 75000
        ```

        Update the price or description of an existing listing.
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="Set stock">
    <Tabs>
      <Tab title="Syntax">
        ```bash theme={null} theme={null}
        ;roleshop stock @role (amount)
        ```

        Set how many copies of the role can be sold. Use `0` for unlimited.
      </Tab>

      <Tab title="Example">
        ```bash theme={null} theme={null}
        ;roleshop stock @VIP 10
        ```

        Set how many copies of the role can be sold. Use `0` for unlimited.
      </Tab>
    </Tabs>
  </Accordion>
</AccordionGroup>