🏪 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.

❤️ Support & Community

🐛 Found a bug? Report it on the Issues tab
💡 Have an idea? Drop it in the comments
⭐ Enjoying the mod? Leave a rating — it helps a ton!

Built with ❤️ for the Minecraft community. No external textures were harmed in the making of this mod. 🟪⬛

🏪 FutureShops — The Ultimate Minecraft Economy & Shop Mod

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

✨ Feature Highlights

🛒 Server Shop (/shop)

🏠 Player-Owned Shop Blocks

💰 Full Economy System

🪙 Physical Currency (CoinItem)

⚒️ Bartering System

📊 Dashboard & Leaderboards

🎉 Promo & Discount System

🖼️ Full UI Showcase

🎮 Commands

🔧 Admin Commands

⚙️ Configuration

🔒 Security & Anti-Dupe

📦 Installation

🪙 Money System — Full Documentation

How Coins Work

Getting Coins

Depositing Coins

Coin Tooltip

Anti-Dupe Security

Coin Behavior Rules

📋 Technical Details

🤝 Mod Compatibility

🧠 Refined Storage integration (shipped)

🔌 Other storage & transport

🗺️ Roadmap

❓ FAQ

❤️ Support & Community

🛒 Server Shop (`/shop`)

Future Shops