Merchantry

Merchantry

A server-side shop, economy and player market — no client install needed.

Merchantry adds a complete, easy-to-configure economy to your server: a GUI shop, an optional currency with fair ways to earn it, a player market, repairs, homes, permanent utility commands and more. Everything runs on the server, so players can join with a plain vanilla client — only the server needs the mod.

Available for NeoForge 1.21.1, Fabric 1.21.1 and Fabric 1.20.1.

✨ Features

🛒 Shop (/shop)

• Chest-style GUI with Buy, Sell and Market tabs
• Confirmation screen for every purchase, with a quantity selector for items and charges
• Offer types:
  • Items — sell any item stack (with enchantments, names, etc.)
  • Permanent commands — /craft, /anvil, /enderchest (/ec), /stonecutter, /smithing, /grindstone, /loom, /cartography
  • Extra homes — each next home costs more (configurable multiplier)
  • Repairs — /repair (item in hand) and /repairall (whole inventory), priced automatically by damage and material tier
  • keepInventory charges — one charge protects your inventory and XP on one death (the gamerule is never touched)
  • One-time commands — any server command, e.g. a random teleport
• Two payment modes: pay with $ when the currency is enabled, or with items (e.g. diamonds) when it’s disabled — each offer can have both prices

💰 Currency (optional)

• Disabled by default — turn it on with enableCurrency = true
• /balance, /pay <player> <amount>, /cheque <amount> (signed paper cheques players can trade and redeem)
• Personal sidebar showing your balance, time to the next payout and payouts left today (/sidebar to toggle)
• Balance mirrored to a scoreboard objective for datapacks
• Hard to automate earnings:
  • one-time rewards for advancements (task / goal / challenge)
  • discovering new biomes and dimensions
  • active playtime with AFK detection and a daily limit

🏪 Sell to the server (/sell)

• Sell resources like iron, gold, diamonds or emeralds for $
• Left-click sells 1, right-click 64, shift-click everything
• Fully configurable list and prices

🤝 Player market (/market)

• /market sell <price> [amount] lists the item in your hand
• Categories: weapons, armor, tools, food, blocks, magic & potions, other
• Configurable sales fee and listing limit per player
• Sellers get paid even while offline; admins can remove listings

📦 Selling chest (optional, enableSeller = true)

• A plain vanilla chest that sells its contents automatically — made for farms, no custom block and no client mod needed
• Bought in the shop (100 000 $ or 256 diamonds by default); always placed as a single chest, never a double one
• When the chest is full it sells everything at once at the /sell prices (minus a configurable tax), every minute by default
• Each sale consumes energy — power it with any energy mod (Forge Energy on NeoForge, Team Reborn Energy on Fabric), or set sellerEnergyPerSell = 0 to skip power
• Daily limit counted in sales; extra daily sells can be bought in the shop once all chests are placed
• Earnings arrive as a cheque after a delay (1 day by default): /seller shows what is ready and what is maturing, /seller collect [amount] pays out any amount
• Total earned is a scoreboard objective for leaderboards; admins get /seller give and /seller admin ... tools

🏠 Homes

• /sethome, /home, /delhome, /homes
• One home by default, more can be bought in the shop (up to a configurable limit)

🪙 Create: Numismatics compatibility (NeoForge 1.21.1 and Fabric 1.20.1)

• /exchange — convert $ ↔ Numismatics bank balance and deposit coins from your inventory
• Configurable exchange rate and fee
• Not available on Fabric 1.21.1 — Create: Numismatics has no Fabric release for that version

🧩 Mod compatibility

• Default shop and sell offers added automatically the first time the server starts with the mod (removed offers never come back):
  • Create — andesite, andesite alloy, zinc, copper, brass
  • Create Crafts & Additions — electrum · Create: New Age — magnetite · Create: Crafts & (More) Additions — silver
  • Applied Energistics 2 — certus quartz, charged certus, fluix, silicon, sky stone, blank patterns and the Mysterious Cube (inscriber presses) for a higher price
• FTB Ultimine — ultimine can be a permanent unlock bought in the shop (ultimineRequiresUnlock)
• keepInventory charges work with:
  • Trinkets (Fabric) and Curios (NeoForge) — accessory slots are kept too
  • Graves — no grave when a charge saved your items (blockGraves): Universal Graves and You’re in Grave Danger (Fabric); Gravestone, Corpse and You’re in Grave Danger (NeoForge)
  • FTB Chunks — no death waypoint; Xaero’s Minimap and JourneyMap too when the player has Merchantry on the client (hideDeathWaypoints)
• Leaderboards — balance, payouts left today and seconds to the next payout are scoreboard objectives, ready for leaderboard and hologram mods or datapacks

Create and AE2 only exist on NeoForge 1.21.1 and Fabric 1.20.1, so their offers and /exchange are not available on Fabric 1.21.1.

🛠️ Admin tools

• Graphical offer editor — just type /shopconfig
  • set products, icons and prices by clicking with an item on your cursor
  • +/- buttons for prices, reordering, deleting, creating new offers
• JEI / EMI drag & drop into the editor (needs the mod on the admin’s client — optional)
• Plenty of /shopconfig subcommands for scripting and quick edits
• /eco give|take|set, /keepinv give|set

🌍 Languages

• English and Polish, selected automatically per player based on their game language

⚙️ Configuration

Admin commands require permission level 2 (operator).

📦 Requirements

• Minecraft 1.21.1 — NeoForge 21.1, or Fabric Loader 0.16+ with Fabric API
• Minecraft 1.20.1 — Fabric Loader 0.15+ with Fabric API
• Server-side. The client mod is optional (only needed for JEI/EMI drag & drop in the editor)

Optional compatibility: JEI, EMI, FTB Ultimine, FTB Chunks, Xaero’s Minimap, JourneyMap, You’re in Grave Danger (all versions); Create and addons, Create: Numismatics, Applied Energistics 2 (NeoForge 1.21.1, Fabric 1.20.1); Curios, Gravestone, Corpse (NeoForge); Trinkets, Universal Graves (Fabric); an energy mod to power the selling chest — any Forge Energy mod (NeoForge) or Team Reborn Energy mod (Fabric)

📜 License

MIT — feel free to use Merchantry in your modpacks.

Source code: github.com/KociakTV/merchantry — bug reports and suggestions welcome in Issues.