Commands
Core’s NPC shops use the /ksnpcshop command (since Core 2.9.0).
Player Commands
Section titled “Player Commands”/ksnpcshop open <shopId>
Section titled “/ksnpcshop open <shopId>”Opens a shop by its ID.
| Parameter | Description |
|---|---|
shopId | The unique identifier of the shop (the JSON file name without .json). |
Example:
/ksnpcshop open blacksmith/ksnpcshop open daily_dealsThe command refuses with a message when the shop does not exist, when the shop is set to open only at its NPC (openVia: "npc"), or when the shop needs a permission the player does not have.
/ksnpcshop sell <shopId>
Section titled “/ksnpcshop sell <shopId>”Opens a shop directly on its Sell tab, where players sell items from their inventory.
Example:
/ksnpcshop sell general_storeSelling only works if the shop has "sellEnabled": true. Otherwise the command answers “Selling is not enabled at this shop.”
/ksnpcshop list
Section titled “/ksnpcshop list”Lists all registered shops.
Output:
=== Available Shops (3) === - blacksmith (Blacksmith, 8 items) - daily_deals (Daily Deals, 12 items) - example_shop (Example Shop, 6 items)Each line shows the shop ID, its title and the number of entries.
NPC-Bound Shops
Section titled “NPC-Bound Shops”Shops can also be opened at an NPC (Citizen). Interacting with the NPC opens the shop window directly — no command needed. The NPC stops moving while the shop is open and walks on when the player closes it.
| Citizen field | Description |
|---|---|
shopId | Opens the shop on its “Buy” tab when the player interacts with the NPC. |
sellShopId | Opens the shop directly on its “Sell” tab. |
You can link NPCs in the Shop Editor (Settings → Link NPC) or in the NPC management window. A dialog answer can open a shop too, with the dialog action Open shop (open_shop) or a dialog command ksnpcshop open <shopId>.
A shop with openVia: "command" does not open at its NPC; the player gets a message instead. A shop with openVia: "npc" only opens at its NPC.
Command Reference
Section titled “Command Reference”| Command | Description | Access |
|---|---|---|
/ksnpcshop open <shopId> | Open a specific shop | All players (see Permissions) |
/ksnpcshop sell <shopId> | Open a shop on its “Sell” tab | All players |
/ksnpcshop list | List all shops | All players |
There is no admin command for NPC shops. Admins edit shops in the shop editor, which opens from the /ksadmin hub (tile NPC Shops), or in the JSON files followed by /ksadmin reload.