双色潜影贝

双色潜影贝

对潜影盒的顶部和底部应用不同的颜色

装饰

双色潜影盒

Modrinth

一个适用于 Minecraft 1.21.1 – 26.3 的 Fabric 模组,可让你为潜影盒的**顶部(盖子)和底部(盒身)**分别应用不同的颜色!

特性

  • 双色潜影盒 —— 为盖子应用一种颜色,盒身应用另一种颜色
  • 可配置的操作方式(默认):
    • 手持染料 Shift + 右键 → 为**顶部(盖子)**上色
    • 手持染料 Ctrl + 右键 → 为**底部(盒身)**上色
  • 合成配方 —— 染料放在潜影盒上方为盖子上色,放在下方为盒身上色
  • 支持全部 16 种染料颜色(256 种组合!)
  • 颜色在破坏/放置循环中持久保留
  • 创造模式选取方块会复制确切的颜色
  • 炼药锅清洗 —— 使用装有水的炼药锅移除自定义颜色
  • 提示框显示 —— 悬停在物品上时可查看已应用的颜色
  • 完整的 3D 渲染 —— 颜色在已放置的方块和物品上均能正确显示

使用方法

  1. 放置一个潜影盒
  2. 手持任意染料并 Shift + 右键点击潜影盒,为盖子上色
  3. 手持任意染料并 Ctrl + 右键点击,为盒身上色
  4. 或者通过合成:将潜影盒放入合成网格,在其上方放置染料(盖子)和/或其下方放置染料(盒身)
  5. 若要移除颜色,对潜影盒物品使用装有水的炼药锅

配置

安装 Cloth Config 和 Mod Menu 以使用游戏内配置界面。

选项:

  • Show Color Tooltip —— 切换潜影盒物品的提示框显示
  • Dye Top (Lid) —— 自定义为顶部上色的按键组合(默认:Shift + 右键)
  • Dye Bottom (Base) —— 自定义为底部上色的按键组合(默认:Ctrl + 右键)

按键组合可以是两个按键/鼠标按钮的任意组合。

需求

  • Minecraft 1.21.1、1.21.4 – 1.21.8、26.2 或 26.3
  • Fabric Loader 0.16.0+(1.21.x)或 0.19.0+ 配合 Java 25(26.x)
  • Fabric API

可选:

安装

  1. 安装 Fabric Loader
  2. 下载 Fabric API
  3. 从 Modrinth 下载本模组
  4. 将两个模组都放入你的 mods 文件夹

从源码构建

本项目使用 Stonecutter 实现多版本支持。

# Windows
# 为当前活动版本构建(使用 ./gradlew chiseled 管理活动版本)
gradlew.bat build

# Linux/macOS
./gradlew build

输出的 JAR 位于 versions/<mc-version>/build/libs/。

Minecraft 1.21.x 从 master 分支构建,26.x 从 26.x 分支构建。

测试

端到端测试使用 Fabric GameTest,位于 src/gametest。

# 服务端游戏测试(无头运行,`build` 时也会执行)
./gradlew 26.3:runGameTest

# 客户端游戏测试:带模拟输入和截图检查的真实客户端
./gradlew 26.3:runClientGameTest

截图保存至 versions/<mc-version>/build/run/clientGameTest/screenshots/。

许可证

MIT 许可证 —— 详情请参阅 LICENSE。