CogTrade

CogTrade

一个适用于Fabric服务器和单人世界的实体交易与经济模组。

经济

CogTrade

CogTrade 是一个适用于 Minecraft 1.20.1 的 Fabric 经济与交易模组,专为生存服务器和以自动化为中心的世界打造。

大多数经济模组只给你一个命令和一个菜单。CogTrade 提供的是一套物理的、与世界深度整合的交易系统——库存来自真实的箱子,价格由真实的玩家设定,经济从实际的游戏玩法中成长起来。

⚠️ Alpha 版本——核心系统已可游玩,但仍可能出现 bug 和破坏性变更。安装或更新前请备份你的世界。


工作原理

玩家放置一个 Trade Depot(交易仓库) 并将其连接到一个或多个箱子。交易仓库读取真实库存——没有虚假库存,没有抽象数字。然后他们放置一个 Trade Post(交易站),顾客右键点击即可浏览并购买可用物品。一切都是物理的、可见的、属于世界的一部分。

Server Market(服务器市场) 与之并行,是一个由管理员控制的中央市场——可用于以基础物品为经济播种,并为玩家提供定价参考。

玩家还可以实时直接互相交易——通过同步的实时交易界面提供物品和金币——或使用内置于游戏内书籍 GUI 的 BookTrade 系统。


特性

📖 CogTrade 书籍 GUI

  • 按 L 或右键点击 Market Block(市场方块) 打开统一的 CogTrade 书籍
  • 所有主要界面集中在一处:Market · Depot · Trade Post · Trade
  • 书籍主题设计,在所有屏幕尺寸和分辨率下保持一致缩放

🏪 服务器市场

  • 通过简洁、功能完整的市场界面买卖物品
  • 搜索栏、分类筛选和排序(名称 / 价格 / 库存)
  • 收藏系统和最近浏览物品
  • 交易历史
  • 管理员控制的目录——通过命令添加、移除物品并设置价格

🏗️ 玩家商店系统

  • 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 Block
/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 放置一个 Server Market 方块

单人游戏与多人游戏

在单人游戏中

将服务器市场用作个人经济层——与世界物品目录交易、追踪你的支出,并管理你自己的商店系统。

在多人游戏中

CogTrade 会成为一个完整的玩家经济框架:

  • 玩家从真实存储中供给自己的库存
  • 卖家在不同分类中展开价格竞争
  • Trade Post 鼓励玩家互相参观基地
  • 玩家可以无需商店直接交易
  • 非常适合 SMP 服务器和重度自动化的整合包

设计理念

经济应当来自真实的存储、真实的库存和真实的玩家活动。

❌ CogTrade 避免的做法 ✅ CogTrade 取而代之的做法
虚假的无限商店库存 库存来自真实的箱子
与世界脱节的抽象市场 世界中的物理仓库和交易站方块
仅命令的交易系统 为双方玩家提供实时同步 GUI
出售你并不拥有的物品 没有库存 = 无法出售

计划中的特性

当前的 Alpha 版本聚焦于核心交易基础。计划新增的内容:

特性 分类
玩家求购订单 经济
物理金币物品 经济
ATM 方块 经济
税收与租金系统 经济
区块认领整合 世界
拍卖 交易
任务与职业 成长
公会系统 社交
更深入的 Create 模组整合 技术
CogDungeon 扩展内容 内容

技术信息

  • SQLite 数据库,按世界存储——无需外部设置
  • SQLite 驱动已打包在 JAR 内
  • Fabric 1.20.1——需要 Fabric API

Alpha 说明

本项目正处于活跃的 Alpha 开发阶段。

  • 核心特性可游玩且功能正常
  • UI 和平衡数值可能在不同版本间变化
  • 重大更新可能更改数据库架构,进而需要重置
  • 非常欢迎反馈和 bug 报告

如果有什么出错了,请报告——这正是这个模组变得更好的方式。