Commands

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 sell <shopId>`

Opens a registered shop in sell mode. Players can sell items from their inventory for currency.

Parameter	Description
`shopId`	The unique identifier of the shop.

Example:

/ksshop sell general_store
/ksshop sell blacksmith

Sell mode is only available if the shop has "sellEnabled": true in its configuration. If selling is disabled, an error message is displayed.

`/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.

Citizens support two shop-related fields:

Field	Description
`shopId`	Opens the shop in buy mode when the player interacts with the NPC.
`sellShopId`	Opens the shop directly in sell mode when the player interacts with the NPC.

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 sell <shopId>`	Open a shop in sell mode	All players
`/ksshop list`	List all available shops	All players