Description

🏪 FutureShops — The Ultimate Minecraft Economy & Shop Mod

🎮 Minecraft Forge 1.20.1 · Server-Side Economy · Player Shops · Bartering · Physical Currency

Transform your Minecraft server into a thriving marketplace. FutureShops brings a fully-featured, Amazon-style economy system to Minecraft — complete with server shops, player-owned storefronts, physical currency, bartering, promo sales, leaderboards, and a sleek modern UI — all without a single external texture.

✨ Feature Highlights

alt text

🛒 Server Shop (/shop)

Browse an infinite-stock admin shop with a gorgeous dark-themed GUI. Categories, search, filters — it's like shopping online, but in Minecraft.

📂 Category sidebar with scrollable tabs and item icons
🔍 Real-time search — find any item instantly
🏷️ Animated promo badges — pulsating red -X% discount chips on sale items
🛍️ Shopping cart — queue up purchases, adjust quantities, checkout all at once
📜 Transaction history — filterable log with search, sort, time-window, and push updates
💰 Balance display — always know how much you've got

🏠 Player-Owned Shop Blocks

Place a Shop Block, configure your listings, link your chests, and open for business.

👤 Owner assignment on placement — your block, your shop
📦 Single or multi-item mode — sell one item or up to 12 per block
🏷️ Custom shop names — brand your storefront
💵 Three trade modes: Money, Barter, or Both simultaneously
🔗 Storage linking — link chests, barrels, or an entire Refined Storage network for automatic stock management
📊 Owner dashboard — revenue tracking, settlement claims, stock alerts
🎁 Owner promo editor — set percentage discounts, Buy-X-Get-Y deals, flash sales, and scheduled windows
👁️ Owner preview — Shift+right-click to test your shop as a visitor
🛒 Buyer experience — same polished UI as the server shop, familiar and intuitive

💰 Full Economy System

A server-authoritative economy that keeps your server fair.

/balance — check your funds with a beautiful dashboard
/pay <player> <amount> — send money to friends
/baltop — leaderboard with player heads, top balances, most transactions, top sellers, and most popular products
/withdraw <amount> [yes|no] — convert balance to physical coins
- Smart denominations: $1, $5, $10, $20, $50, $100, $1,000 bills
- Example: /withdraw 132 yes → 1×$100 + 1×$20 + 1×$10 + 2×$1
/deposit — convert coins back to balance

🪙 Physical Currency (CoinItem)

Hold your wealth in your hands — or trade it in person.

🖱️ Right-click to deposit — simply right-click any coin in your hand to instantly deposit its full value into your balance. No commands needed!
🔐 Anti-dupe protection — every coin is minted with a unique ID, cryptographic checksum, and server-side spent-mint tracking
📝 NBT-based denominations — coins show their value on hover
♻️ Deposit validation — previously spent mint IDs are permanently rejected and destroyed
🗑️ Invalid coin auto-destroy — tampered or duplicated coins are automatically destroyed on use

⚒️ Bartering System

Not everything has to be about money.

🔄 Item-for-item trades — trade diamonds for emeralds, or whatever you configure
🎨 Dedicated barter screen — clean half-and-half layout: "You Receive" ⟵⟶ "You Give"
📋 Multiple recipes per item — tabs for different trade options
🤝 Works in player shops too — owners can set barter items and quantities
🧮 Smart Max button — auto-calculates the most you can trade based on your inventory

alt text

📊 Dashboard & Leaderboards

Know where you stand in the economy.

🧑 Player profile — your head, balance, revenue, shop count, supply alerts
🏆 Baltop leaderboard — top 10 balances with player heads
📈 Transaction spotlight — most transactions, top seller, most popular product
🏪 Storefront management — see all your placed shops, stock levels, and low-supply warnings

alt text

🎉 Promo & Discount System

Run sales like a real business.

💥 Percentage discounts — animated pulsating red badges with -X% text
🎁 Buy-X-Get-Y — promotional bundles
⏰ Scheduled windows — set start/end times for flash sales
🔥 Flash sale toggle — limited-time urgency
🏷️ Works everywhere — server shop, player shops, all trade modes

🖼️ Full UI Showcase

All UI is rendered entirely with Minecraft's built-in drawing primitives — no external textures required!

Screen Description ShopMainScreen Dark modern grid with category sidebar, animated promo badges, profile footer ItemDetailScreen Large item preview, pricing info, quantity controls, buy/sell/barter actions CartScreen Row-based checkout with inline quantity controls and gold-accented totals BarterScreen Half-and-half "You Receive ⟵⟶ You Give" with recipe tabs TransactionHistory Filterable log with ALL/BUY/SELL/BARTER tabs, time windows, search Player Shop Owner config panel + visitor storefront — same polish as server shop Promo Editor Modal overlay for setting discount type, value, BxGy, schedules Balance Dashboard Player head, balance, revenue, shop stats, low-stock warnings Leaderboard Top 10 with heads, transaction/seller/product spotlights Settlement History Paged revenue log with SALE/CLAIM/ROLLBACK filters

🎮 Commands

Command Description /shop Open the server shop storefront /shop <shopId> Open a specific named shop /balance or /bal View your balance & dashboard /balance ui Open the full balance dashboard GUI /baltop View the economy leaderboard /baltop ui Open the leaderboard GUI /pay <player> <amount> Send money to another player /withdraw <amount> [yes|no] Convert balance to physical money items /deposit Convert held Money back to balance /link Confirm storage link (look at chest first)

🔧 Admin Commands

Command Description /shopadmin reload Hot-reload shop catalog from config /shopadmin coinaudit Inspect active vs consumed mints per player /shopadmin promo set <shop> <item> <type> <value> Set a promo on a catalog item /shopadmin promo clear <shop> <item> Remove a promo from a catalog item

⚙️ Configuration

Shop catalogs are defined in JSON files at:

config/futureshops/shops/*.json

Each file defines categories, items, prices, barter recipes, promo rules, and stock settings. Hot-reloadable with /shopadmin reload.

Server economy config lives in:

config/futureshops-common.toml

🔒 Security & Anti-Dupe

FutureShops takes server integrity seriously:

✅ Server-authoritative transactions — all buy/sell/barter validated server-side
✅ Cryptographic coin checksums — tampered coins are rejected
✅ Spent-mint registry — deposited coins are permanently tracked, preventing re-use
✅ Per-shop transaction locking — prevents race conditions on player shops
✅ Staged rollback — failed transactions cleanly revert items and balance
✅ Raycast storage linking — anti-exploit validation on linked containers
✅ Session management — shops auto-close on logout, death, or distance

📦 Installation

Install Minecraft Forge 1.20.1 (47.x)
Install the GeckoLib 4.4+ dependency (required on both client and server)
Drop the futureshops-1.0.jar into your mods/ folder
Launch the game — shop catalog and config files auto-generate
Configure your shops in config/futureshops/shops/
Use /shop in-game to open the storefront — you're in business! 🎉

🪙 Money System — Full Documentation

FutureShops features a physical currency system that lets players hold, trade, and manage wealth as real items in their inventory.

How Coins Work

Coins are special items with no crafting recipe — the only way to create them is through the /withdraw command. Each coin carries hidden NBT data that makes it unique and tamper-proof.

Getting Coins

Method How Withdraw from balance /withdraw <amount> or /withdraw <amount> yes Single large coin /withdraw <amount> no — one coin worth the full amount

Smart denomination breakdown (/withdraw 132 yes):

Bill Count $100 ×1 $20 ×1 $10 ×1 $1 ×2

Available denominations: $1, $5, $10, $20, $50, $100, $1,000

Depositing Coins

There are two ways to deposit coins back into your digital balance:

Method How Details 🖱️ Right-click Hold a coin and right-click Instantly deposits the entire stack in your hand. The fastest way! ⌨️ Command /deposit Deposits all valid coins in your inventory at once ⌨️ Partial command /deposit <amount> Deposits only the specified amount, consuming largest bills first

Coin Tooltip

When you hover over a coin in your inventory, you'll see:

🟡 Value: $X.XX — the denomination of this coin
⬜ Right-click to deposit — a reminder of the quick-deposit feature

Anti-Dupe Security

Every coin minted by FutureShops contains hidden security data:

NBT Field Purpose mint_id Unique UUID — no two coins share the same ID denomination The coin's value in minor units mint_timestamp When the coin was created mint_player UUID of the player who withdrew it mint_server Server identity hash checksum Cryptographic integrity check

What happens to invalid coins:

Scenario Result Tampered NBT (edited checksum/value) ❌ Coin destroyed on use Duplicated coin (same mint ID used twice) ❌ Second copy destroyed on deposit Already-deposited coin (mint ID consumed) ❌ Coin destroyed, player warned Missing coin data ❌ Coin destroyed silently

Coin Behavior Rules

Interaction Behavior Right-click (use) ✅ Instantly deposits into balance Drop on ground ✅ Allowed — 5-minute despawn Player death ✅ Drops like normal items (respects keepInventory) Store in chests/barrels ✅ Allowed — validated when extracted Crafting ❌ Cannot be used in recipes Anvil renaming ❌ Blocked by the server Hopper extraction ❌ Blocked by default (configurable)

📋 Technical Details

Property Value Mod Loader Minecraft Forge Minecraft Version 1.20.1 Forge Version 47.4.20+ Java Version 17 Mappings Official Mojang Server-side required ✅ Yes Client-side required ✅ Yes (for GUI) Dependencies 🦎 GeckoLib 4.4+ (client & server)

🤝 Mod Compatibility

🧠 Refined Storage integration (shipped)

FutureShops ships with native Refined Storage support — link a shop directly to an RS Controller, Grid, External Storage, or any RS network node, and the shop will query and pull stock straight from the entire RS network.

🔌 Soft dependency — integration auto-activates when RS is detected; if RS isn't installed, nothing changes.
🌐 Full-network aware — unlike hopper-style adapters, the RS bridge traverses INetworkNodeProxy → INetworkNode → INetwork so your shop sees every disk and every external-storage container on the network, not just one block.
🧪 NBT-strict — enchanted, named, and damage-data items are matched exactly (no more selling the "wrong" diamond pickaxe).
⚛️ Atomic extract/insert — if anything fails mid-transaction, changes roll back cleanly on the RS network.
♻️ Graceful fallback — if the RS API shifts, the adapter falls back to the standard Forge IItemHandler capability automatically.
🏷️ Supported mod IDs: refinedstorage, refinedstorage2, and refinedstorageaddons.

💡 Just look at a Controller / Grid / Crafter / External Storage block and run /link — that's it. The shop is now backed by your RS network.

🔌 Other storage & transport

✅ Vanilla inventories — chests, barrels, shulkers: link any IItemHandler container
✅ Vanilla hoppers — pipe items into linked shop storage
✅ Common item-pipe mods — anything exposing the Forge IItemHandler capability works out of the box
✅ CarryOn — shops can be picked up and moved (ownership preserved)
✅ Dedicated servers — fully supported; shops persist across restarts
🧩 Extensible — third-party mods can register their own ExternalStorageAdapter via the addon API to expose custom storage networks

🗺️ Roadmap

✅ ~~Refined Storage integration~~ — shipped
🔜 Applied Energistics 2 (AE2) adapter
🔜 Dynamic pricing system (supply/demand curves)
🔜 Stock refresh scheduler (timed restocks)
🔜 Public ExternalStorageAdapter developer API & event hooks for addon mods
🔜 Hopper/pipe compatibility matrix (Create, Mekanism, etc.)
🔜 Advanced analytics & export tools
🔜 Localization (ES, FR, DE, PT-BR, ZH-CN)

❓ FAQ

Q: Does this work on dedicated servers? 🟢 Yes. Built server-authoritative from day one.

Q: Will my shops survive a server restart? 🟢 Yes. Shops, balances, listings, and transaction history are all persisted to disk.

Q: Can players steal from my shop? 🔴 No. Only the owner (or server ops) can modify listings or pull from linked storage.

Q: Can I use this on an existing world? 🟢 Yes. Add the mod, restart, and your old world loads normally.

Q: Is it compatible with Fabric? 🔴 No — this is a Forge-only mod.

Q: Do I need GeckoLib? 🟢 Yes — GeckoLib 4.4+ is required for the 3D shop block model. CurseForge will prompt you to install it automatically.

Q: Can I link my shop to a Refined Storage network? 🟢 Yes! Look at any RS network block (Controller, Grid, External Storage, Crafter, etc.) and run /link. The shop will pull stock from your entire RS network — all disks, all external-storage containers — NBT-strict.

Q: What if I don't have Refined Storage installed? 🟢 Totally fine. RS is a soft dependency — everything else works without it. Standard chest/barrel linking still works out of the box.