FAQ & Troubleshooting
Common questions and solutions for Core’s NPC shops.
Frequently Asked Questions
Section titled “Frequently Asked Questions”How do I create a new shop?
Section titled “How do I create a new shop?”There are two ways:
- Shop editor — Run
/ksadmin, open the tile NPC Shops and click + New shop. Start from a preset, a shipped shop or a copy. See Shop Editor. - JSON file — Create a new
.jsonfile inmods/kyuubisoft_core/shops/and run/ksadmin reload.
How do players open a shop?
Section titled “How do players open a shop?”- Via command:
/ksnpcshop open <shopId>(or/ksnpcshop sell <shopId>for the “Sell” tab) - Via NPC: Link the NPC in the shop editor, or set
"shopId": "your_shop"on a citizen. Players press F on the NPC to open the shop. - Via dialog: Use the dialog action Open shop, or a dialog command
ksnpcshop open your_shop. Dialog answers that open a shop are tagged “Opens shop” for the player.
openVia decides which of these ways work for a shop (any, npc or command).
Why does /ksshop open something else?
Section titled “Why does /ksshop open something else?”/ksshop belongs to the Player Shops mod when it is installed. Core’s NPC shops use /ksnpcshop. Update old dialogs, signs and commands that still call ksshop open for NPC shops.
Can I use physical items as currency?
Section titled “Can I use physical items as currency?”Yes. Set the shop’s currencyId to item:<ItemId>:
"currencyId": "item:Ingredient_Bar_Gold"The shop counts and removes the items from the player’s inventory. See Currencies. For the server’s money use "currencyId": "economy" (needs an economy plugin, for example through VaultUnlocked).
How does daily rotation work?
Section titled “How does daily rotation work?”Set "dailyShopSize" to a number greater than zero. Each player gets their own pick of that many entries every day, drawn by weight and renewed at midnight (server time).
"settings": { "dailyShopSize": 6, "itemsPerPage": 9}Can players buy several at once?
Section titled “Can players buy several at once?”Yes, with "allowBuyMultiple": true in the shop settings (or “Buy several at once” in the editor). Players then get a quantity stepper; the maximum is the daily limit, what they can afford and what fits into their inventory. Command entries are always bought one at a time.
Can players sell items?
Section titled “Can players sell items?”Yes, if selling is enabled on the shop:
{ "sellEnabled": true, "sellPricePercent": 50, "sellCurrencyId": null}Players can sell via:
/ksnpcshop sell <shopId>- the “Sell” tab of the shop window
- NPC interaction if
"sellShopId"is set on the citizen
The “Sell” tab shows the price per piece, today’s sell limit and a “Sell all” button.
How is the sell price calculated?
Section titled “How is the sell price calculated?”The price per piece follows this order:
- Per-entry
sellPrice— if set on a catalog entry. - Explicit
sellItemslist — if the item is listed there. - Percentage of the buy price —
sellPricePercentof the entry’s price, divided by its quantity (default: 50%).
Items that are neither in the catalog nor in sellItems cannot be sold.
Can I hide an entry without deleting it?
Section titled “Can I hide an entry without deleting it?”Yes. Switch it off in the editor, or set "enabled": false on the entry. It is no longer sold, rotated or bought back, and you can switch it on again later.
Can I restrict who buys specific items?
Section titled “Can I restrict who buys specific items?”Yes. Set a permission field on the entry (the entry shows as locked for everyone else), or on the whole shop (players without it cannot open the shop):
{ "itemId": "Weapon_Sword_Adamantite", "cost": 100, "permission": "shop.vip"}Can a shop execute commands instead of giving items?
Section titled “Can a shop execute commands instead of giving items?”Yes. Set a command field on the entry:
{ "itemId": "xp_boost_100", "displayName": "100 XP Boost", "cost": 10, "command": "ksadmin addxp {player} 100", "commandRunAsServer": true}{player} and {PlayerName} become the buyer’s name, {uuid} their UUID. commandRunAsServer: true runs the command as the console, false as the buyer. In the shop editor, console entries need ks.core.admin.dialog.console — see Permissions.
Troubleshooting
Section titled “Troubleshooting”Shop does not open
Section titled “Shop does not open”Symptoms: /ksnpcshop open <shopId> shows “There is no shop with the id …”, “This shop can only be opened at its NPC” or “You don’t have permission to access this shop.”
Solutions:
- Check the shop ID — Run
/ksnpcshop list. The ID must match exactly. - Check
openVia—npcshops only open at their NPC,commandshops only by command. - Check the shop’s
permission— Players without it cannot open the shop. - Check the command permission — If an admin denied
ks.core.shop.user.use(orks.shop.user.usewhile the Core node is unset), the shop commands answer “You may not use the shop commands.” - Check the JSON syntax — Invalid JSON prevents loading. Check the server console for errors.
- Reload after changes — Run
/ksadmin reloadafter editing shop files.
”Currency not available” / nothing can be bought
Section titled “”Currency not available” / nothing can be bought”Cause: The currency for the shop’s currencyId is not registered.
| Currency ID | Required |
|---|---|
quest_tokens | Quest System |
achievement_points | Achievement System |
season_tokens | Season Pass |
economy | An economy plugin (e.g. through VaultUnlocked) |
item:<ItemId> | Core (always available) |
Solution: Install the required mod or plugin, or change the shop’s currencyId. The shop editor marks unknown currencies as an error.
Purchase is refused
Section titled “Purchase is refused”The shop window and the status line tell the player why:
- Not enough currency — “Not enough … — … missing”.
- Inventory full — The purchase is refused before paying: “Your inventory is full — nothing was charged.”
- Purchase limit reached — “Sold out today”; limits reset daily.
- Missing permission — The entry shows as locked.
- Command entry not available — The command does not exist or the buyer may not use it; nothing is charged. If it fails while running, the price is refunded.
Sell mode not working
Section titled “Sell mode not working”- Check
sellEnabled— Must betruein the shop config. - Check sell whitelist — If
sellWhitelistis set, only items in the list can be sold. - Check sell blacklist — Items in
sellBlacklistcan never be sold. - Command entries — are never sellable.
- Item not in catalog — Items that are not in the shop’s catalog or
sellItemslist cannot be sold. - Damaged or modified items — are listed as “not sellable” when the shop cannot take them.
Daily shop shows different items than expected
Section titled “Daily shop shows different items than expected”This is by design: every player gets their own daily pick. If you want all players to see the same entries, set dailyShopSize to 0 for a fixed catalog.
A deleted shipped shop came back / does not come back
Section titled “A deleted shipped shop came back / does not come back”Since Core 2.9.0, shipped shops you delete or rename in the editor are listed in shops/.removed_defaults and are not extracted again. To restore one, remove its line from that file and restart or reload.
Custom shop file not loaded
Section titled “Custom shop file not loaded”- Check the file name — Custom override files must be named
custom_<shopId>.jsoninside thecustom/folder. - Check JSON validity — Invalid JSON prevents loading. Check the server console for errors.
- Reload — Run
/ksadmin reloadafter adding custom files.
NPC shop does not open on interaction
Section titled “NPC shop does not open on interaction”- Check the link — In the shop editor (Settings → NPCs) or the citizen’s
"shopId". - Check
openVia— Acommandshop does not open at its NPC. - Check
fKeyInteractionEnabled— Must betruefor the interaction prompt to appear. - NPC with a dialog — If the NPC has a dialog, the shop opens through a dialog answer, not directly. The editor points this out.
- Quest profile — If the Quest mod has an NPC profile for this citizen, the quest dialog comes first. Add a dialog answer that opens the shop.
Shop opened from a dialog ignores clicks
Section titled “Shop opened from a dialog ignores clicks”Symptoms: A shop opened by the dialog action Open shop (or a command on the last answer) is visible, but no button works until the player presses Esc.
Cause: Before Core 2.9.6, the dialog closed first and the shop opened right after. On a server with ping, the late answer to that close removed the new shop on the server.
Solution: Update Core. The dialog window now stays until the shop is open (at most 5 seconds) and only closes if nothing replaced it.