跳到正文

Cam3’s Sawmill

作者:Cam3_E

适用于 Minecraft 1.21.11(Fabric)的木材切石机。每次加载数据包时,都会根据合成配方自动生成切石配方,因此其他模组添加的木材类型也能直接使用,无需编写兼容代码。

收藏

截图

介绍

介绍由机器翻译自 CurseForge 原页面,仅供参考。

Cam3’s Sawmill

一款适用于 Minecraft 1.21.11(Fabric)的木材切石机。每次加载数据包时,都会根据合成配方自动生成配方,因此其他模组添加的木材类型也能直接使用,无需编写兼容代码。

构建

需要 JDK 21 或更高版本。

./gradlew build

模组 JAR 文件位于 build/libs/cam3s-sawmill-1.0.0.jar。
运行时需要:Fabric Loader 和 Fabric API。可选:Mod Menu 和 Cloth Config(配置界面)。客户端和服务器都要安装。

方块

外形、放置方式和界面都与切石机相同。模型以原版切石机模型为父模型,并使用模组自带的纹理;界面则使用游戏中切石机自带的 GUI 纹理,因此模组不会复制任何原版文件。

合成:配方形状与切石机相同,只需将石头换成去皮原木:在三块任意木种的去皮原木(可以混搭)上方放一个铁锭。可用原木由物品标签 cam3s_sawmill:stripped_logs 指定:包括所有原版去皮原木、去皮菌柄和竹块,以及常见标签 c:stripped_logs 中的模组物品。与玩家获得石头后解锁切石机一样,获得去皮原木后即可解锁此配方。用斧头采掘更快。

配方生成方式

#minecraft:planks 中的每种物品都视为一种木材,价值为 1 块木板。其他物品的成本根据所有材料都由木板制成的合成配方计算(木板、台阶、木棍、箱子等),并重复计算,直到结果不再变化;若有多种配方,则取成本最低的一种:

  • 只接受一种木材的材料(如橡木木板),成本按该木种计算;
  • 接受多种木材的材料(如 #minecraft:planks、木棍),成本按“任意木板”计算;
  • 包含两种不同木材,或含有任何非木板制成的材料(铁、线、原木等)的配方,都会忽略。

随后根据配方模式,将成本转换为配方。

RESTRICTED、VANILLA_LIKE(默认)和 EXTENDED。与切石机类似:仅适用于方块,每次投入 1 块木板;产出数量按 1 块木板合成时的产量向下取整,但至少为 1(台阶产出 2 个,其他物品产出 1 个)。不同模式的区别在于:物品可由单块木板合成的最高成本、是否包含可由任意木板制成的物品,以及少数不受成本上限限制的例外:

模式 最高合成成本 包含可由任意木板制成的物品 不受成本上限限制的物品
RESTRICTED 1 块木板 否,仅限单一木种的变体 楼梯
VANILLA_LIKE 2 块木板 是(梯子) 楼梯、活板门、栅栏门
EXTENDED 4 块木板 是(梯子、工作台、堆肥桶) 楼梯、活板门、栅栏门

REBALANCED。任意物品都可按合成成本和 maxDiscount 定价,且成本不会高于合成所需材料:

  • strictDiscount关闭(默认):配方保持简单,投入一块木板产出一个或多个物品,或投入多块木板产出一个物品,不会出现多对多配方。折扣只是目标值;无法精确达到时,取整会偏向玩家(堆肥桶成本为 3.5 块木板,折扣 10% 时按 3 块计算;碗则是 1 块木板产出 2 个)。如果结果导致燃烧时间超过投入的木板,则会降低折扣,而不是移除配方(台阶仍为 1 → 2,船仍为 4 → 1)。
  • strictDiscount开启:选择能得到整数个物品且符合折扣要求的最少木板数量,即使配方看起来不太寻常(折扣 10% 时,6 个梯子需要 7 块木板)。

所有模式均适用:1 块木板可合成 2 根木棍(使用 REBALANCED 折扣时更多)。

燃料规则,适用于所有模式。如果某种配方的产物在熔炉中的燃烧时间长于投入材料,就会移除该配方:切割后的木材不能比原木本身提供更多燃料。燃烧时间取自服务器本身,也包括其他模组通过 Fabric API 添加的燃料。判断时使用可燃烧的木板;不会燃烧的木板(绯红木、诡异木)不参与检查,并会获得与其他木材相同的配方。原版中此规则不会移除任何配方;它是针对模组物品的保护措施。

原木配方(可关闭),两种模式下都适用,且不会损失材料:

  • 原木 → 木板,数量与合成配方相同(4 个,竹块为 2 个);
  • 原木 → 去皮原木,采用斧头剥皮配方;
  • 原木 ↔ 木头,双向均为 1:1(去皮版本也适用)。

排除物品:通过数据包将它们添加到物品标签 cam3s_sawmill:blacklist 中。
手动添加配方:数据包可以添加 cam3s_sawmill:woodcutting 配方:

{
  "type": "cam3s_sawmill:woodcutting",
  "ingredient": "minecraft:oak_planks",
  "input_count": 2,
  "result": { "id": "minecraft:oak_door", "count": 1 }
}

配置

config/cam3s_sawmill.json,也可以在安装 Cloth Config 后通过 Mod Menu 在游戏内设置。
更改会在 /reload 时生效,或在世界重启后生效。专用服务器会使用服务器端的配置文件。

选项 默认值 效果
recipeMode VANILLA_LIKE RESTRICTED、VANILLA_LIKE、EXTENDED 或 REBALANCED,详见上文。
maxDiscount 0.35 REBALANCED仅此模式可用(其他模式下,配置界面中此项会变灰):配方应比合成便宜多少(0.0 到 0.9)。
strictDiscount false REBALANCED仅此模式可用(其他模式下,此项会变灰):严格遵循 maxDiscount,即使配方结果不太寻常。
logRecipes true 生成原木 → 木板、剥皮和原木 ↔ 木头配方。

鸣谢

  • 纹理和图标:Camille。icons/ 中包含供模组页面使用的两种尺寸图标。
  • 音效:剪辑自 Pixabay 上的音效,遵循 Pixabay 内容许可协议。

技术说明

  • 配方生成需要物品标签,而标签只会在数据包加载结束时填充(ReloadableServerResources.updateStaticRegistryTags)。ReloadableServerResourcesMixin 会在此时触发生成;RecipeManagerMixin 会添加配方,并再次完成配方管理器的初始化。
  • 燃烧时间取自 FuelValues.vanillaBurnTimes,它也会触发 Fabric API 的燃料事件。
  • 服务器界面直接读取配方管理器;客户端则读取 Fabric API 同步的配方。
  • 服务器和客户端采用相同的配方排序方式(结果物品 ID、输入数量、配方 ID),因此两端点击配方时会选中同一个配方。

常见问题

Cam3’s Sawmill 支持哪些 Minecraft 版本?

Cam3’s Sawmill 支持 Minecraft Java 版 1.21.11,可用的加载器:Fabric。下载时注意选择和你游戏版本一致的文件。

Cam3’s Sawmill 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。

评论

登录后评论和评分

Cam3_E 的其他作品

查看全部 →