CogTrade

CogTrade is a Fabric economy and trading mod for Minecraft 1.20.1, built for survival servers and automation-focused worlds.

Most economy mods give you a command and a menu. CogTrade gives you a physical, world-integrated trading system — one where stock comes from real chests, prices are set by real players, and the economy grows from actual gameplay.

⚠️ Alpha Release — Core systems are playable, but bugs and breaking changes may still occur. Back up your world before installing or updating.

How It Works

Players place a Trade Depot and connect it to one or more chests. The depot reads real inventory — no fake stock, no abstract numbers. Then they place a Trade Post, which customers right-click to browse and buy available items. Everything is physical, visible, and part of the world.

The Server Market sits alongside this as a central admin-controlled marketplace — useful for seeding the economy with base-level items and giving players a reference point for pricing.

Players can also trade directly with each other in real time — offering items and coins through a synchronized live trade interface — or use the BookTrade system built into the in-game book GUI.

Features

📖 CogTrade Book GUI

• Press L or right-click a Market Block to open the unified CogTrade book
• All major interfaces in one place: Market · Depot · Trade Post · Trade
• Book-themed design with consistent scaling across all screen sizes and resolutions

🏪 Server Market

• Buy and sell items through a clean, full-featured market interface
• Search bar, category filters, and sorting (name / price / stock)
• Favorites system and recently viewed items
• Transaction history
• Admin-controlled catalog — add, remove, and price items via commands

🏗️ Player Shop System

• Trade Depot — connects to multiple chests, reads real inventory as stock
• Trade Post — customer-facing shop block, right-click to browse
• Physical stock system: if it's not in the chest, it can't be sold
• Floating 3D name labels above trade blocks
• Category tags on listings: Misc · Block · Food · Tool · Material
• Only the owner can break their own blocks

🤝 Direct Player Trading

• Send a live trade request to any online player with /trade offer <player>
• Synchronized real-time GUI — both players see the same offer state instantly
• Each side offers up to 9 item slots and a coin amount
• Dual-confirmation system — trade only completes when both players press READY
• Changing any offer automatically resets ready states (prevents last-second swaps)
• Left-click to move a full stack, right-click for a single item, middle-click for a custom quantity
• Items are always returned safely — offline players receive theirs on next login
• All completed trades are logged to the database

🤜🤛 BookTrade

• Trade items with another player directly from within the Book GUI
• Real-time offer / accept / reject with server-side validation
• No commands needed — everything in one interface

💰 Economy

• Per-player balance with configurable starting funds
• Daily earnings and spending tracker
• Animated balance HUD on screen
• /balance and /pay commands
• 100+ items with built-in reference prices (minerals, Nether/End materials, food, tools, armor) to help players set fair rates

Commands

Player Commands

Operator Commands (level 2)

Singleplayer & Multiplayer

In Singleplayer

Use the server market as a personal economy layer — trade with the world's item catalog, track your spending, and manage your own shop system.

In Multiplayer

CogTrade becomes a full player economy framework:

• Players supply their own stock from real storage
• Sellers compete on price across different categories
• The Trade Post encourages players to visit each other's bases
• Players can trade directly without needing a shop
• Ideal for SMP servers and automation-heavy modpacks

Design Philosophy

Economy should come from real storage, real stock, and real player activity.

Planned Features

The current Alpha focuses on the core trading foundation. Planned additions:

Technical

• SQLite database, stored per world — no external setup required
• SQLite driver bundled inside the JAR
• Fabric 1.20.1 — requires Fabric API

Alpha Notice

This project is in active Alpha development.

• Core features are playable and functional
• UI and balance values may change between versions
• Database schema changes may require a reset on major updates
• Feedback and bug reports are extremely welcome

If something breaks, please report it — that's how this mod gets better.