> For the complete documentation index, see [llms.txt](https://realisticnode.gitbook.io/rnsetups/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://realisticnode.gitbook.io/rnsetups/ultimate-survival/features/player-shops.md).

# Player shops

Chest shops that players run themselves, with QuickShop-Hikari.

Players can open their own shops with **QuickShop-Hikari**: a chest with a sign that sells or buys an item for a fixed price, even when the owner is offline.

## Using a shop

1. **Left-click the sign** (or the chest) of a shop. The chat shows the shop information: owner, item, stock and price.
2. **Type the amount** in the chat. Type `all` to buy everything you can.

A shop can be **selling** (you buy from it) or **buying** (you sell to it). Shops work everywhere, including the spawn.

## Creating your shop

1. Place a chest, trapped chest or barrel where you are allowed to build (your claim or the wild).
2. **Hold the item** you want to trade and **left-click the chest**.
3. **Type the price** for one item in the chat. A sign is added to the chest.
4. Put the stock in the chest. Use `/qs buy` while looking at the shop to make it buy instead of sell.

Shops cannot be created at the spawn.

| Rank     | Shops |
| -------- | ----- |
| Member   | 5     |
| VIP      | 10    |
| Elite    | 15    |
| Legend   | 25    |
| Ultimate | 40    |

## Commands

| Command               | What it does                             |
| --------------------- | ---------------------------------------- |
| `/qs help`            | Every shop command                       |
| `/qs price <price>`   | Change the price of the shop you look at |
| `/qs buy`, `/qs sell` | Make the shop buy or sell                |
| `/qs find <item>`     | Find the nearest shop with an item       |
| `/qs browse`          | Browse every shop on the server          |
| `/qs remove`          | Remove your shop                         |

`/qs`, `/quickshop`, `/chestshop` and `/cshop` all work. `/shop` stays the server shop.

## The example admin shop

The spawn market has an **admin shop** with unlimited stock (cooked beef for ⛁12) and a hologram above it that explains how shops work. Make your own admin shops with `/qs create <price>` while holding the item and looking at a chest, then `/qs unlimited`. Unlimited shops belong to the `AdminShop` account. To create one at the spawn, allow it for a moment with `/rg flag -w void spawn quickshophikari-create allow` and set it back to `deny` afterwards.

## Configuration

| What                              | Where                                                                                 |
| --------------------------------- | ------------------------------------------------------------------------------------- |
| Limits, tax, unlimited shop owner | `plugins/QuickShop-Hikari/config.yml`                                                 |
| Messages                          | `plugins/QuickShop-Hikari/overrides/en_us/messages.yml`                               |
| Where shops can be created        | WorldGuard flag `quickshophikari-create` and `plugins/qscompat-worldguard/config.yml` |
| Player permissions                | LuckPerms: `quickshop.player` (default group), `quickshop.limit.<rank>`               |

Reload with `/qs reload`. Buyers pay a 5% tax by default (`shop-tax` in `config.yml`).