Skip to content

alexanderheuts/quest-shop

Repository files navigation

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 (via datapack) where players can spend earned coins.
  • Coins can be gained by killing enemies (loot), via Quest rewards (FTB Quests), or given with commands.
  • Support progression gating — Shop Categories can be (un)locked via Quest rewards (FTB Quests), or 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.
    • Quest Rewards:
      • Coin Reward - rewards X amount of coins
      • Category Reward - (un)locks a category of items

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


Mod Configuration

The config file allows you to enable or disable coin as loot drops, as well as the drop chance.


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.

About

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.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages