CogTrade
CogTrade 是一款专为 Minecraft 1.20.1 设计的 Fabric 经济与交易模组,适用于生存服务器和注重自动化的世界。
大多数经济模组仅提供命令和菜单。而 CogTrade 提供了一套 物理化、与世界深度融合的交易系统 —— 库存来自真实的箱子,价格由真实玩家设定,经济体系源于实际的游戏玩法。
⚠️ Alpha 测试版 — 核心系统可玩,但仍可能存在错误和破坏性更新。安装或更新前请备份你的世界。
工作原理
玩家放置一个 Trade Depot(贸易仓库) 并将其连接到一个或多个箱子上。仓库会读取真实的物品栏——没有虚假的库存,也没有抽象的数字。然后他们放置一个 Trade Post(贸易站点),顾客通过右键点击来浏览和购买可用物品。一切皆具实体、可见且融入世界中。
Server Market(服务器市场) 作为中央管理员控制的市场与上述系统并行存在——有助于通过基础物品为经济注入活力,并为玩家提供定价参考点。
玩家还可以彼此进行 实时直接交易 —— 通过同步的即时交易界面提供物品和金币——或者使用内置于游戏内书籍 GUI 中的 BookTrade 系统。
功能特性
? CogTrade 书籍 GUI
- 按 L 键或右键点击 Market Block(市场方块) 以打开统一的 CogTrade 书籍
- 所有主要接口集于一处:Market · Depot · Trade Post · Trade
- 采用书籍主题设计,在所有屏幕尺寸和分辨率下保持一致的缩放比例
? Server Market(服务器市场)
- 通过简洁、功能齐全的市场界面买卖物品
- 搜索栏、分类过滤器以及排序功能(名称 / 价格 / 库存)
- 收藏夹系统和最近查看的物品
- 交易历史记录
- 管理员控制的目录——通过命令添加、移除和定价物品
?️ 玩家商店系统
- Trade Depot(贸易仓库) — 连接多个箱子,将真实库存作为存货读取
- Trade Post(贸易站点) — 面向顾客的商店方块,右键点击即可浏览
- 物理库存系统:如果箱子里没有物品,就无法出售
- 贸易方块上方悬浮显示 3D 名称标签
- 列表上的分类标签:
Misc · Block · Food · Tool · Material
- 只有所有者才能破坏自己的方块
? 玩家直接交易
- 向任何在线玩家发送实时交易请求
/trade offer <player>
- 同步的实时 GUI —— 双方玩家瞬间看到相同的报价状态
- 每方最多提供 9 个物品槽位 和 金币数量
- 双重确认系统 —— 只有当 两位玩家都按下 READY(准备就绪) 时交易才会完成
- 更改任何报价会自动重置准备状态(防止最后一刻的替换)
- 左键点击移动整堆物品,右键点击移动单个物品,中键点击移动自定义数量
- 物品始终安全返回——离线玩家将在下次登录时收到他们的物品
- 所有完成的交易均记录到数据库中
?? BookTrade
- 直接从书籍 GUI 内部与其他玩家交换物品
- 实时报价 / 接受 / 拒绝,并带有服务端验证
- 无需命令——所有操作都在一个界面中完成
? 经济系统
- 每位玩家独立的余额,支持配置初始资金
- 每日收入和支出追踪器
- 屏幕上动画显示的余额 HUD
/balance 和 /pay 命令
- 内置参考价格的 100+ 种物品(矿物、下界/末地材料、食物、工具、护甲),帮助玩家设定公平汇率
命令
玩家命令
| 命令 |
描述 |
/market |
打开服务器市场 |
/market locate |
高亮显示最近的市场方块 |
/market history |
查看你的交易历史 |
/balance |
检查当前余额 |
/pay <player> <amount> |
向其他玩家发送金币 |
/trade offer <player> |
发送直接交易请求 |
/trade accept |
接受传入的交易请求 |
/trade reject |
拒绝传入的交易请求 |
/trade cancel |
取消你当前的交易会话 |
操作员命令 (等级 2)
| 命令 |
描述 |
/ctadmin balance add|remove|set|check |
管理玩家余额 |
/ctadmin market add|remove|edit|price|stock |
管理服务器市场目录 |
/ctadmin config |
查看和编辑模组配置 |
/placemarket |
放置服务器市场方块 |
单人游戏 & 多人游戏
在单人游戏中
将服务器市场用作个人经济层——与世界物品目录进行交易,追踪支出,并管理你自己的商店系统。
在多人游戏中
CogTrade 成为一个完整的玩家经济框架:
- 玩家从真实存储中提供自己的库存
- 卖家在不同类别上竞争价格
- Trade Post 鼓励玩家互相访问彼此的基地
- 玩家可以直接交易,无需拥有商店
- 非常适合 SMP 服务器和高自动化整合包
设计理念
经济应源自真实的存储、真实的库存和真实的玩家活动。
| ❌ CogTrade 避免的做法 |
✅ CogTrade 采用的做法 |
| 虚假的无限商店库存 |
库存来自真实的箱子 |
| 与世界脱节的抽象市场 |
世界中存在的物理仓库和站点方块 |
| 仅依赖命令的交易系统 |
双方玩家使用的同步实时 GUI |
| 出售你不拥有的物品 |
无库存 = 无法出售 |
计划中的功能
当前的 Alpha 版本专注于 核心交易基础。计划添加的功能包括:
| 功能 |
类别 |
| 玩家买入订单 |
经济 |
| 实体金币物品 |
经济 |
| ATM 方块 |
经济 |
| 税收和租金系统 |
经济 |
| 区块认领集成 |
世界 |
| 拍卖 |
交易 |
| 任务和职业 |
进度 |
| 公会系统 |
社交 |
| 更深入的 Create 模组集成 |
技术 |
| CogDungeon 扩展内容 |
内容 |
技术细节
- SQLite 数据库,每个世界独立存储——无需外部设置
- SQLite 驱动程序打包在 JAR 文件内部
- Fabric 1.20.1 — 需要 Fabric API
Alpha 通知
该项目正处于 活跃 Alpha 开发阶段。
- 核心功能可玩且正常运行
- UI 和平衡性数值可能在不同版本之间有所变化
- 数据库结构变更可能在重大更新时要求重置
- 非常欢迎提供反馈与错误报告
如果出现任何问题,请及时报告——这正是本模组变得更好的方式。
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
| Command |
Description |
/market |
Open the server market |
/market locate |
Highlight the nearest Market Block |
/market history |
View your transaction history |
/balance |
Check your current balance |
/pay <player> <amount> |
Send coins to another player |
/trade offer <player> |
Send a direct trade request |
/trade accept |
Accept an incoming trade request |
/trade reject |
Reject an incoming trade request |
/trade cancel |
Cancel your active trade session |
Operator Commands (level 2)
| Command |
Description |
/ctadmin balance add|remove|set|check |
Manage player balances |
/ctadmin market add|remove|edit|price|stock |
Manage the server market catalog |
/ctadmin config |
View and edit mod configuration |
/placemarket |
Place a Server Market block |
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.
| ❌ What CogTrade avoids |
✅ What CogTrade does instead |
| Fake infinite shop stock |
Stock comes from real chests |
| Abstract markets disconnected from the world |
Physical depot and post blocks in the world |
| Command-only trade systems |
Live synchronized GUI for both players |
| Selling items you don't own |
No stock = no sale |
Planned Features
The current Alpha focuses on the core trading foundation. Planned additions:
| Feature |
Category |
| Player buy orders |
Economy |
| Physical coin item |
Economy |
| ATM block |
Economy |
| Taxes and rent system |
Economy |
| Chunk claim integration |
World |
| Auctions |
Trading |
| Quests and professions |
Progression |
| Guild system |
Social |
| Deeper Create mod integration |
Technical |
| CogDungeon expansion content |
Content |
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧