Skip to content

Commands

Core’s NPC shops use the /ksnpcshop command (since Core 2.9.0).

Opens a shop by its ID.

ParameterDescription
shopIdThe unique identifier of the shop (the JSON file name without .json).

Example:

/ksnpcshop open blacksmith
/ksnpcshop open daily_deals

The 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.


Opens a shop directly on its Sell tab, where players sell items from their inventory.

Example:

/ksnpcshop sell general_store

Selling only works if the shop has "sellEnabled": true. Otherwise the command answers “Selling is not enabled at this shop.”


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.

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 fieldDescription
shopIdOpens the shop on its “Buy” tab when the player interacts with the NPC.
sellShopIdOpens 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.

CommandDescriptionAccess
/ksnpcshop open <shopId>Open a specific shopAll players (see Permissions)
/ksnpcshop sell <shopId>Open a shop on its “Sell” tabAll players
/ksnpcshop listList all shopsAll 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.