Skip to content

Shop System

Mod: part of KyuubiSoft Core (KyuubiSoftCore-2.9.9.jar) | Version: Core 2.9.9 | Config: mods/kyuubisoft_core/shops/

The Shop System runs the server-owned NPC shops of KyuubiSoft Core. Players buy and sell at merchant NPCs or with a command, and pay with quest tokens, achievement points, the server economy or any item. Shops are JSON files, and admins can also build and edit them in game with the shop editor.

Latest versions from the changelog:

  • v2.10.0 · Nov 10, 2026 · Kronen (not released yet)
  • v2.9.9 · Nov 9, 2026 · Design & Feature Update
  • New shop window in the KS Premium look: “Buy” and “Sell” tabs, category pills, 3×3 offer cards and a detail panel with today’s limit, how many you already own, a quantity stepper and the total. The sell tab lists per-piece prices, daily sell limits and “Sell all”.
  • In-game shop editor (2.9.0) in the /ksadmin hub, tile NPC Shops: search, templates, copies, a price tool, a player preview and NPC links. See Shop Editor.
  • New shop options: a header icon, openVia (any, npc or command), a working allowBuyMultiple, entries that can be switched off (enabled: false) and an editor display name per entry.
  • Own command: /ksnpcshop open|sell|list. Before, Core used /ksshop, which clashed with the Player Shops mod.
  • Safer purchases: an item is only charged when it fits into the inventory, a command that cannot run is refused before paying, and a command that fails while running is refunded.
  • Multiple Currencies — Quest tokens, achievement points, the server economy (economy) or any item (item:<ItemId>)
  • JSON Configuration — Define offers, prices and categories in config files
  • NPC Integration — Open shops at a merchant NPC, through a dialog answer or by command
  • Buy & Sell — Players buy offers and sell items back for currency
  • Purchase Limits — Optional purchase and sell limits per item per day
  • Daily Rotation — Every player gets their own daily pick, drawn by weight
  • Command Purchases — Run a command instead of handing out an item
  • Custom Shops — Add your own shops next to the shipped ones
  • In-Game Shop Editor — Create, copy, edit and delete shops without editing JSON
  1. The Core mod includes the shop system — no extra installation needed.
  2. Shop files are in mods/kyuubisoft_core/shops/.
  3. Use /ksnpcshop open <shopId> to open a shop in game.
  4. Use /ksnpcshop list to see all shops.
  5. Edit shops in the shop editor (/ksadmin → NPC Shops), or edit the JSON files and run /ksadmin reload.
CommandDescription
/ksnpcshop open <shopId>Open a specific shop
/ksnpcshop sell <shopId>Open a shop on its “Sell” tab
/ksnpcshop listList all shops

On servers without the Player Shops mod, the old /ksshop open|sell|list still works the same way.

import DocCardList from ‘@theme/DocCardList’;