Q Shop
Running a Minecraft server means keeping players busy, and nothing keeps them busier than a well-stocked shop. Q Shop is a configurable shop mod that lets you build buy, sell, barter and command-based shops directly inside the game, with custom currencies, purchase limits and deep KubeJS automation. Whether you run a small survival world or a large modded network, Q Shop gives you the tools to turn a simple chest of goods into a full economy.
What Q Shop Adds to Your Server
At its core, Q Shop is a shop framework. You create shops, give each one sub-shops with their own icons and descriptions, and fill them with entries that players can interact with through a single trade interface. Every entry can be a buy offer, a sell offer, an item-for-item barter, or a command entry that runs a configured server command after a successful purchase.
Barter entries can optionally charge an extra currency fee on top of the traded items, which is handy for premium exchanges. Command entries open the door to things like teleportation, kit grants or crate rewards, all triggered through the same shop screen your players already know.
Supported Versions and Loaders
Q Shop supports Minecraft Forge 1.20.1, NeoForge 1.21.1 and NeoForge 26.1.2. All supported builds provide the same core shop features, so server owners upgrading between versions do not have to relearn the mod. The loader and version branches differ only in optional integrations such as stage providers.
If you want the fastest possible setup, the foxygame.net launcher can drop Q Shop straight into a compatible modpack with one click, handling loader matching and version checks so you never have to sort through jars manually.
Optional Integrations
Q Shop has no mandatory gameplay integration dependencies. KubeJS and FTB Quests are optional and only needed for their respective features. GameStages and AStages are available on the loader and version branches that support them; NeoForge 26.1.2 uses KubeJS PlayerStages because AStages does not currently provide a build for that version. Stage requirements use KubeJS stages when KubeJS is installed.
Trade Screen and Quantity Controls
The trade screen is built for bulk buying. A slider and input box handle quantity selection with live limit, inventory and balance checks, so players always see exactly what they can afford. When the available quantity is large, quick buttons for x1, x10, x100 and x1000 change the slider step and range for fast bulk purchases. Entry grids and sub-shop tabs scroll smoothly, and GUI scaling keeps item tooltips and button tooltips independent of the local Q Shop scale.
An optional F8 layout debugger lets you adjust the shop, trade settings and item browser screens. Layout offsets are stored in config/qshop_layout.json, while resource packs can override them through assets/qshop/style.json. For a matching visual style, the Q Shop Create style Resourcepack offers a Create-inspired look with files for the supported versions.
Custom Currencies, Limits and Requirements
Q Shop lets you create any number of non-item currencies such as coins, points or tokens. Balances are stored per player and synchronized to the client, and you can manage them with commands or KubeJS. Purchase limits can be applied globally or per player, counted in trade units rather than item quantities, with reset periods of NEVER, DAILY, WEEKLY and MONTHLY.
- Multiple shops identified by a stable ID or UUID
- Sub-shops with icons, descriptions and independent entries
- Creative-mode editing for adding, copying, reordering and removing entries
- Custom display names, descriptions, display items and item NBT
- Gate sub-shops or single entries behind FTB Quests tasks or stages
- Death-based currency loss with configurable retention percentages
Commands and Configuration
Server admins get a full command suite: /qshop open, /qshop list, /qshop balance, /qshop reload, /qshop overwrite, plus currency and shop editing subcommands. Shop editing requires permission level 2 and Creative mode, and the final sub-shop cannot be removed. Configuration lives under serverconfig/qshop/ for world data and config/qshop/ for the server-wide template, and Q Shop creates missing template files from its bundled defaults.
KubeJS Automation
Install KubeJS on the server to enable the global Q Shop binding. The public 1.1.0 API is Builder-first, so you create shops, tabs and entries with readable method chains, then call add() to commit them. Calling add() with an existing entry UUID replaces that entry in place, while an existing tab UUID updates tab metadata and preserves its entries. Reference rules accept shop IDs or UUIDs, zero-based indexes or UUIDs for tabs, and indexes or UUIDs for entries. Use UUIDs for long-lived scripts because indexes shift when content is reordered.
Trade events let you intercept or log activity. beforeTrade fires before a purchase and can cancel it, while afterTrade exposes traded units, total items, paid price and partial completion. currencyChanged reports every effective currency change, including trades, FTB money rewards, commands and configured death retention. Forge addon mods can use the official com.qshop.api.QShopAddonApi facade for server-side container integrations.
How to Install Q Shop
To install Q Shop, place the matching jar for your loader and Minecraft version into the mods folder, then launch the game once to generate the default configuration. From there, use /qshop shop create and /qshop edit to build your first shop, or write a KubeJS script for automated setup. If you want to download Q Shop alongside a curated set of server-side add-ons, the foxygame.net launcher keeps every mod in its catalog updated automatically, including Q Shop, so version mismatches after a game update are handled for you.
Q Shop turns a plain item economy into something players actually enjoy browsing. With flexible currencies, sensible limits, optional quest gating and a clean trade interface, it scales from a single starter shop to a full network marketplace without forcing extra dependencies on your pack.