
贸易箱
一个Minecraft Fabric模组,添加了具有9x5物品栏布局的自动交易箱子。设置自动售货机风格的商店,顾客放入购买物品并自动获得出售物品作为回报。
TradeChest 模组
一个 Minecraft Fabric 模组,添加了具有 9x5 物品栏布局的自动交易箱。设置自动售货机式的商店,顾客放入购买物品后自动获得出售物品作为回报。
特性
- 自动交易系统:放入购买物品,出售物品会自动送达取货区
- 9x5 物品栏布局:为购买物品、取货区、配置、所有者收集和出售物品存储提供专用区域
- 所有权系统:通过基于用户名的所有权保护你的交易设置
- 不能作为普通箱子使用:交易箱只能在正确配置后使用
- 物品移动:交易后购买物品会自动移动到所有者收集区
要求
- Minecraft 1.20.1
- Fabric Loader 0.15.7+
- Fabric API
- Java 17 或更高版本
安装
玩家安装
安装 Fabric Loader
- 下载并运行 Fabric 安装程序
- 选择 Minecraft 1.20.1 并安装 Fabric
下载依赖
- 下载适用于 1.20.1 的 Fabric API
- 将 Fabric API 的 JAR 文件放入你的
.minecraft/mods文件夹
安装 TradeChest 模组
- 下载最新的 TradeChest 模组 JAR 文件
- 将其放入你的
.minecraft/mods文件夹
启动游戏
- 使用 Fabric 配置文件启动 Minecraft
- 交易箱物品将在"功能方块"创造模式标签页中可用
开发者安装
克隆仓库
git clone https://github.com/rodortega/mc-tradechest.git cd mc-tradechest从源码构建
./gradlew build在开发环境中运行
./gradlew runClient
使用方法
合成
使用以下配方合成交易箱:

[木板] [木板] [木板]
[木板] [纸 ] [木板]
[木板] [木板] [木板]
基本设置
放置交易箱 - 在配置所有者之前无法使用
设置所有权(槽位 18):
- 使用铁砧将一张纸重命名为你的确切用户名
- 将其放入槽位 18(第三行的第一个槽位)
- 你现在是所有者,可以管理该箱子

- 配置购买要求(槽位 19):
- 将一张纸重命名为:
10 minecraft:iron_ingot - 放入槽位 19
- 这决定了顾客必须提供什么
- 将一张纸重命名为:

- 配置出售物品(槽位 20):
- 将一张纸重命名为:
5 minecraft:diamond - 放入槽位 20
- 这决定了顾客会获得什么
- 将一张纸重命名为:

- 储备出售物品:
- 将钻石放入底行(槽位 36-44)
- 只能放入配置的出售物品类型

- 准备交易:
- 顾客将铁锭放入顶行(槽位 0-8)
- 钻石自动出现在取货区(槽位 9-17)
- 铁锭移动到你的收集区(槽位 27-35)
物品栏布局(9x5)
第 1 行:[购买物品输入区 - 顾客在此放入购买物品] (槽位 0-8)
第 2 行:[取货区 - 交易物品自动出现在此] (槽位 9-17)
第 3 行:[所有者] [购买] [出售] [----锁定的配置区域----] (槽位 18-26)
第 4 行:[所有者收集区 - 交易后购买物品存放于此] (槽位 27-35)
第 5 行:[出售物品存储区 - 所有者在此储备出售物品] (槽位 36-44)
交易工作原理
- 顾客操作:在第 1 行放入 10 个铁锭
- 自动处理:系统检测到完整交易
- 物品移动:
- 5 个钻石从第 5 行移动到第 2 行(取货区)
- 10 个铁锭从第 1 行移动到第 4 行(所有者收集区)
- 顾客取货:顾客从第 2 行取走钻石
- 多余物品处理:如果顾客放入了 15 个铁锭,多余的 5 个会留在第 1 行等待取回
示例:自动钻石商店
设置阶段:
- 重命名纸张:
YourUsername、10 minecraft:iron_ingot、5 minecraft:diamond - 分别将纸张放入槽位 18、19、20
- 在底行(槽位 36-44)储备 64 个钻石
- 重命名纸张:
顾客交易:
- 顾客在顶行放入 20 个铁锭
- 系统自动处理 2 次交易(20 ÷ 10 = 2)
- 10 个钻石出现在取货区(5 × 2 = 10)
- 20 个铁锭移动到所有者收集区
- 顾客从取货区取走 10 个钻石
所有者收益:
- 随时从第 4 行收集 20 个铁锭
- 根据需要从第 5 行补充钻石
- 无需手动干预
权限
| 槽位范围 | 区域 | 顾客可执行 | 所有者可执行 |
|---|---|---|---|
| 0-8 | 购买物品输入区 | 放入购买物品、取回多余物品 | 完全访问 |
| 9-17 | 取货区 | 取走任何物品 | 完全访问 |
| 18-20 | 配置区 | 无 | 放入/取出纸张 |
| 21-26 | 锁定区域 | 无 | 无 |
| 27-35 | 所有者收集区 | 无 | 完全访问 |
| 36-44 | 出售物品存储区 | 无 | 储备出售物品 |
纸张格式
- 所有者纸张:仅你的确切用户名(例如
Steve) - 购买纸张:
[数量] [物品ID](例如10 minecraft:iron_ingot) - 出售纸张:
[数量] [物品ID](例如5 minecraft:diamond)
故障排除
- 完全无法使用箱子:你需要先在槽位 18 放入所有者纸张
- 无法取出所有者纸张:确保纸张名称与你的游戏内用户名完全匹配
- 无法放入购买/出售纸张:你必须是所有者(槽位 18 中有你的名字纸张)
- 交易不工作:确保槽位 19-20 中已配置购买和出售纸张
- 无法在底行放入物品:槽位 36-44 只允许放入配置的出售物品类型
- 物品不会自动移动:检查你是否已储备出售物品且取货区未满
构建
此模组使用 Fabric 工具链:
# 清理并构建
./gradlew clean build
# 运行客户端进行测试
./gradlew runClient
# 生成源码 jar
./gradlew sourcesJar
开发
项目结构
src/main/java/com/rodmod/tradechest/- 模组主代码src/main/resources/- 资源和数据文件build.gradle- 构建配置gradle.properties- 项目属性
关键类
RodMod- 模组主初始化器TradeChestBlock- 方块实现TradeChestBlockEntity- 包含物品栏逻辑的方块实体TradeChestMenu- GUI 的容器菜单TradeChestSlot- 带放置限制的自定义槽位
许可证
此模组在 CC0 许可证下提供。欢迎从中学习并将其纳入你自己的项目中。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。