贸易箱

贸易箱

一个Minecraft Fabric模组,添加了具有9x5物品栏布局的自动交易箱子。设置自动售货机风格的商店,顾客放入购买物品并自动获得出售物品作为回报。

经济

TradeChest 模组

一个 Minecraft Fabric 模组,添加了具有 9x5 物品栏布局的自动交易箱。设置自动售货机式的商店,顾客放入购买物品后自动获得出售物品作为回报。

Minecraft Fabric Java

特性

  • 自动交易系统:放入购买物品,出售物品会自动送达取货区
  • 9x5 物品栏布局:为购买物品、取货区、配置、所有者收集和出售物品存储提供专用区域
  • 所有权系统:通过基于用户名的所有权保护你的交易设置
  • 不能作为普通箱子使用:交易箱只能在正确配置后使用
  • 物品移动:交易后购买物品会自动移动到所有者收集区

要求

  • Minecraft 1.20.1
  • Fabric Loader 0.15.7+
  • Fabric API
  • Java 17 或更高版本

安装

玩家安装

  1. 安装 Fabric Loader

  2. 下载依赖

    • 下载适用于 1.20.1 的 Fabric API
    • 将 Fabric API 的 JAR 文件放入你的 .minecraft/mods 文件夹
  3. 安装 TradeChest 模组

    • 下载最新的 TradeChest 模组 JAR 文件
    • 将其放入你的 .minecraft/mods 文件夹
  4. 启动游戏

    • 使用 Fabric 配置文件启动 Minecraft
    • 交易箱物品将在"功能方块"创造模式标签页中可用

开发者安装

  1. 克隆仓库

    git clone https://github.com/rodortega/mc-tradechest.git
    cd mc-tradechest
    
  2. 从源码构建

    ./gradlew build
    
  3. 在开发环境中运行

    ./gradlew runClient
    

使用方法

合成

使用以下配方合成交易箱:

交易箱配方

[木板] [木板] [木板]
[木板] [纸  ] [木板]
[木板] [木板] [木板]

基本设置

  1. 放置交易箱 - 在配置所有者之前无法使用

  2. 设置所有权(槽位 18):

    • 使用铁砧将一张纸重命名为你的确切用户名
    • 将其放入槽位 18(第三行的第一个槽位)
    • 你现在是所有者,可以管理该箱子

设置所有者

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

设置购买要求

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

设置出售物品

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

补充库存

  1. 准备交易:
    • 顾客将铁锭放入顶行(槽位 0-8)
    • 钻石自动出现在取货区(槽位 9-17)
    • 铁锭移动到你的收集区(槽位 27-35)

物品栏布局(9x5)

第 1 行:[购买物品输入区 - 顾客在此放入购买物品]           (槽位 0-8)
第 2 行:[取货区 - 交易物品自动出现在此]                   (槽位 9-17)
第 3 行:[所有者] [购买] [出售] [----锁定的配置区域----]     (槽位 18-26)
第 4 行:[所有者收集区 - 交易后购买物品存放于此]           (槽位 27-35)
第 5 行:[出售物品存储区 - 所有者在此储备出售物品]         (槽位 36-44)

交易工作原理

  1. 顾客操作:在第 1 行放入 10 个铁锭
  2. 自动处理:系统检测到完整交易
  3. 物品移动:
    • 5 个钻石从第 5 行移动到第 2 行(取货区)
    • 10 个铁锭从第 1 行移动到第 4 行(所有者收集区)
  4. 顾客取货:顾客从第 2 行取走钻石
  5. 多余物品处理:如果顾客放入了 15 个铁锭,多余的 5 个会留在第 1 行等待取回

示例:自动钻石商店

  1. 设置阶段:

    • 重命名纸张:YourUsername、10 minecraft:iron_ingot、5 minecraft:diamond
    • 分别将纸张放入槽位 18、19、20
    • 在底行(槽位 36-44)储备 64 个钻石
  2. 顾客交易:

    • 顾客在顶行放入 20 个铁锭
    • 系统自动处理 2 次交易(20 ÷ 10 = 2)
    • 10 个钻石出现在取货区(5 × 2 = 10)
    • 20 个铁锭移动到所有者收集区
    • 顾客从取货区取走 10 个钻石
  3. 所有者收益:

    • 随时从第 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 许可证下提供。欢迎从中学习并将其纳入你自己的项目中。

请我喝杯咖啡!