Shop Commands
All shop commands use the /ksshop prefix.
Player Commands
/ksshop open <shopId>
Opens a registered shop by its ID.
| Parameter | Description |
|---|---|
shopId | The unique identifier of the shop (matches the JSON filename without .json). |
Example:
/ksshop open blacksmith
/ksshop open daily_deals
/ksshop open example_shop
If the shop does not exist, an error message is displayed. If the shop's currency provider is not available, the shop will not open.
/ksshop list
Lists all registered shops on the server.
Output:
Available shops (3):
- blacksmith (Blacksmith, 8 items)
- daily_deals (Daily Deals, 12 items)
- example_shop (Example Shop, 6 items)
Each entry shows the shop ID, its display title, and the number of items it contains.
NPC-Bound Shops
Shops can also be opened through NPC (Citizen) interactions. When a shop is linked to a Citizen, interacting with the NPC opens the shop UI directly -- no command needed. The NPC stops moving while the shop is open and resumes when the player closes it.
NPC-bound shops are configured through the Citizens system, not through shop commands. The shop itself is still defined as a regular JSON file.
Command Reference
| Command | Description | Access |
|---|---|---|
/ksshop open <shopId> | Open a specific shop | All players |
/ksshop list | List all available shops | All players |
Shops opened via command use the same purchase logic as NPC-bound shops. Currency checks, purchase limits, and inventory validation all apply regardless of how the shop is opened.