Quest Shop

Quest Shop

QuestShop provides an in-game shop and (quest) reward progression system. It is designed for modpack makers to support controlled item access, team play, and quest progression.

by
483 Downloads
neoforgeeconomygame-mechanicsutility
Rent Server with this Mod

Screenshots

Quest Shop Screen
Quest Shop Coin

About this Mod

QuestShop

QuestShop is a lightweight Minecraft (NeoForge) mod that provides an in-game shop and reward progression system.
It is designed for modpack makers to support controlled item access, team play, and quest progression.

Inspired by FTB Money.

👩‍💻 Author: Holysweet
🧑‍💻 Developed by: AquariusSidhe (GitHub: alexanderheuts)
📜 License: MIT

Purpose

  • Provide a fully customizable shop where players can spend earned coins.
  • Coins can be earned with QuestRewards, or given with commands.
  • Support progression gating — Shop Categories can be (un)locked with commands.

Integrations

QuestShop works on its own, but offers optional integration with:

  • FTB Teams – for shared team progression.
  • FTB Quests – for quest-based rewards or unlocks.

No hard dependencies: packs can include QuestShop standalone or alongside these mods.


Commands

All in-game commands are attached under: /hqs

To open the shop use: /hqs shop


Shop Configuration

All shop content is defined via datapacks.

Shop category

data/yourpack/questshop/shop_categories/building.json
{ "display": "Building", "unlocked_by_default": true, "order": 30 }
  • The filename determines the category ID.
  • One file per category.
  • display - name shown in game.
  • unlocked_by_default - is the category, and its items, unlocked by default
  • order - integer for default ordering, compared to other categories, higher is lower on the list

Shop entry

data/yourpack/questshop/shop_entries/building_basic.json
[
  { 
    "item": "minecraft:cobblestone",
    "amount": 64, 
    "cost": 2,  
    "category": "building" 
  },
  { 
    "item": "minecraft:oak_planks",
    "amount": 64, 
    "cost": 2,  
    "category": "building" 
  }
]
  • Filenames are arbitrary. Used for your own grouping.
  • item - minecraft item ID to sell.
  • amount - the amount you get when purchased.
  • price - cost in the built-in currency.
  • category - category ID the item belongs to.

Folder structure (datapack):

(your_datapack)/
  pack.mcmeta
  data/
    yourpack/
      questshop/
        shop_categories/
          building.json
        shop_entries/
          building_basic.json

See repository for example datapack.

Available Versions

Quest Shop 1.3.0release
MC 1.21.1neoforge
September 20, 2025

How to Install Quest Shop on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set neoforge Loader

In the panel under "Egg", select the neoforge loader and matching Minecraft version (1.21.1).

3

Install Mod

Open the mod browser in the dashboard and search for "Quest Shop". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

neoforge

Minecraft Versions

1.21.1

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Quest Shop server crashes on startup – what to do?

Most common cause: wrong neoforge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.

Is Quest Shop compatible with neoforge?

Quest Shop officially supports neoforge for Minecraft 1.21.1. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Quest Shop – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Quest Shop consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install Quest Shop with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Required

Supported Versions

1.21.1