🏪 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

🛒 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

📊 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

🎉 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!

🎮 Commands

🔧 Admin Commands

⚙️ 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

1. Install Minecraft Forge 1.20.1 (47.x)
2. Install the GeckoLib 4.4+ dependency (required on both client and server)
3. Drop the futureshops-1.0.jar into your mods/ folder
4. Launch the game — shop catalog and config files auto-generate
5. Configure your shops in config/futureshops/shops/
6. 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

Smart denomination breakdown (/withdraw 132 yes):

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

Depositing Coins

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

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:

What happens to invalid coins:

Coin Behavior Rules

📋 Technical Details

🤝 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. 🟪⬛