TradeChest

模组

· 作者 rodortega

一款 Minecraft Fabric 模组,添加了带有 9x5 物品栏布局的自动交易箱。设置类似自动售货机的商店,顾客可以放入购买物品,并自动获得相应的出售物品作为回报。

0 本站下载 0 关注 更新于 9 个月前

最新 1.0.3 · 1.20.6 · Fabric

一键开服(送7天)

TradeChest 模组

一款适用于 Minecraft Fabric 的模组,添加了带有 9x5 物品栏布局的自动交易箱子。你可以搭建类似自动售货机的商店,顾客放入购买物品后,会自动获得相应的出售物品作为回报。

功能特性

  • 自动交易系统:放入购买物品后,出售物品将自动送达领取区域
  • 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
    • Trade Chest 物品将在“功能性方块”创造模式标签页中可用

开发者构建

  1. 克隆仓库

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

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

    ./gradlew runClient
    

使用方法

合成配方

使用以下配方合成 Trade Chest:

Trade Chest Recipe

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

基础设置

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

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

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

Setting Owner

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

Setting Buy Requirements

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

Setting Sell Items

  1. 补充出售物品库存:
    • 将钻石放入底行(第 36-44 槽位)
    • 只能放置配置好的出售物品类型

Restocking Supplies

  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 许可证提供。欢迎学习并在你自己的项目中整合使用。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源