Superior Shop: Ultimate KubeJS Shop System for Minecraft

Superior Shop

Running a modpack without a proper shop system feels like building a castle with your bare hands. You can do it, but why would you when better tools exist? Superior Shop steps in as a KubeJS-first shop system designed specifically for modpacks that need more than a basic buy/sell menu. Whether you are crafting a small survival server or a massive progression-heavy adventure, this add-on gives you the control you need without drowning you in complexity.

Why Choose Superior Shop for Minecraft?

The average shop mod offers a simple interface: buy here, sell there, done. Superior Shop for Minecraft goes several steps further. It is built around KubeJS, which means you can register buy and sell entries entirely through scripts. No clunky config files, no restarting the server every time you tweak a price. You write a script, reload, and the shop updates instantly. This approach makes it perfect for modpack makers who want to create clean shop categories, register custom entries, and lock items behind progression checks. Imagine hiding an elytra until a player has killed the Ender Dragon. With Superior Shop, that is a simple condition in your KubeJS script. The shop only shows the item when the player's persistent data contains the right flag.

Core Features That Set It Apart

Superior Shop is not just about buying and selling. It is a full economy toolkit wrapped in a lightweight package. Here is what you get:

• Register buy and sell entries entirely through KubeJS
• Create custom categories with icons, ordering, and visibility controls
• Set per-entry prices, quantities, NBT data, hover themes, and sort order
• Add purchase limits and scaling prices that increase with each transaction
• Gate entries behind player progression checks
• Run timed flash sales on categories or tagged shop entries
• Hook into shop activity with dedicated KubeJS events
• Perfect for tutorials, loot boxes, resource exchanges, modifiers, and limited-time events

The scaling price mechanic deserves special attention. You can set an item to cost 25 emeralds initially, then multiply the price by 1.5 after every purchase, round it upward, and cap it at 200. This creates natural supply and demand without requiring a single line of extra code. Players who buy early get a bargain; late buyers pay a premium.

Flash Sales and Timed Events

Seasonal events and limited-time offers are where Superior Shop truly shines. You can tag any entry with a custom label, then trigger a sale that affects all tagged items at once. For example, start a "Mining Fever" sale that cuts iron pickaxe prices by 50 percent for two minutes. The sale broadcasts a message to all players, applies the discount, and ends automatically. This opens up endless possibilities for server-wide events, holiday specials, or weekend bonuses.

KubeJS Events for Deep Integration

Reacting to shop activity is just as important as setting it up. Superior Shop fires events whenever a player buys or sells an item. You can use these hooks to give bonuses, run commands, or trigger custom logic. For instance, when a player sells items worth more than 100 currency, you can automatically grant them an extra 10 as a loyalty bonus. The events are clean, well-documented, and easy to work with.

How to Install Superior Shop

Installing this add-on is straightforward. Superior Shop supports multiple Minecraft versions, and it runs on the Fabric loader with KubeJS as a dependency. Make sure you have the correct versions of both before you start. The process is simple: download Superior Shop from a trusted source, place the jar file into your mods folder, and launch the game. If you are using a modpack, add it to the pack's mods directory and test it on a dev instance first. For those who want the smoothest experience, the foxygame.net launcher offers one-click installation for Superior Shop, letting you skip the manual file management entirely and jump straight into building your dream shop.

How to Install and Set Up Your First Shop

Once the mod is running, you need to create a KubeJS script. The syntax is intuitive, especially if you have any experience with JavaScript or other scripting languages. Start by defining a category:

ServerEvents.superiorShopCategories(event => {
  event.category('starter', cat => {
    cat.title('Starter Supplies')
    cat.icon('minecraft:emerald')
    cat.order(0)
    cat.hidden(false)
  })
})

Then add entries to that category. A basic buy entry for bread looks like this:

ServerEvents.superiorShopItems(event => {
  const starter = event.category('starter')
  starter.item('minecraft:bread', 'buy', 5)
    .hoverTheme('light_green')
    .order(0)
})

You can chain methods to add limits, scaling, NBT data, and visibility conditions. The data-driven approach also allows you to define all categories and items in a single object, then loop through them during registration. This keeps your shop layout organized and easy to edit, even as it grows to dozens of categories and hundreds of items.

Advanced Configuration Tips

For larger shops, consider using the data-driven pattern. Define a constant object that holds all your categories and items, then register them in a loop. This reduces repetitive code and makes it trivial to add new entries. You can also use custom IDs for entries, which lets you target them in flash sales or other events without relying on item names. The foxygame.net launcher also keeps Superior Shop updated automatically, so you always have the latest features and bug fixes without hunting for new versions manually.

Final Thoughts on Superior Shop

Superior Shop fills a gap that many modpack makers feel but cannot quite articulate. It is simple enough for a small server with a handful of items, yet powerful enough for full economy systems, seasonal events, and progression-heavy gameplay. The KubeJS integration means you are never locked out of customization, and the event system ensures you can react to anything that happens in your shop. If you are tired of clunky shop plugins that fight against your modpack design, give Superior Shop a try. The learning curve is gentle, the documentation is clear, and the results speak for themselves. Download Superior Shop today and see how much smoother your economy runs.