CraftLock

模组

· 作者 Chompii

一种小游戏类型的模组,每制作一次配方后就会锁定该配方

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

需要前置:Fabric API

最新 1.04.37 · 1.21.11 · Fabric

一键开服(送7天)

CraftLock

一个配方。一次机会。

一款 Fabric 模组,将每个合成变为仅有一次使用的机会。一旦你合成了它,在整局世界的生命周期内就再也无法再次合成该物品。


概述

CraftLock 是一款为内容创作者和自定挑战爱好者打造的硬核挑战模组。其设定简单而残酷:

游戏中的每种配方只能被合成为一次。之后,它将永远消失。

当你第一次合成橡木木板、木棍、熔炉、钻石镐或末影之眼时,该配方就会被锁定。下次你将相同的材料放入工作台时,结果槽位将为空。模组会播放拒绝音效,并在动作栏显示提示 "Already crafted Oak Planks once"(已合成过橡木木板),你的工具箱里就会少一件工具。

它覆盖了工作台、2x2 背包网格、熔炉、高炉、烟熏炉、营火、锻造台、切石机和酿造台。默认情况下有两个配方被豁免——烈焰粉和末影之眼——因为如果没有它们,你就无法通关游戏。


功能

锁定机制

  • 全面覆盖 — 工作台、背包 2x2、熔炉家族、锻造、切石机、酿造台
  • 配方级粒度 — 来自原木的 oak_planks 与来自去皮原木的 oak_planks 分别独立锁定
  • 重启后持久化 — 锁定列表保存在世界存档中,可跨会话保留
  • 豁免列表 — 你可以选择让某些配方无限次使用(默认:blaze_powder、ender_eye)

直播优化体验

  • 黄色聊天广播 — 每次首次合成时显示:Chompii has crafted: Iron Ingot(Chompii 合成了:铁锭)
  • 铃声提示 — 当新配方被锁定时,所有玩家都会听到铃声
  • 动作栏警告 + 村民“不行”音效 — 尝试被阻止的合成时触发
  • 工具提示徽章 — 被锁定的物品显示红色斜体 Locked 行及归属信息:by Chompii · day 7
  • 配方书叠加层 — 配方书中被锁定的配方会以红色色调高亮显示
  • 动态标题 — 执行 /craftlock start 时播放(浅蓝色斜体 CraftLock 带副标题,伴随柔和紫水晶叮声)

工具支持

  • 完整的命令套件供管理员/主播使用(见下文)
  • JSON 配置文件位于 config/craftlock.json,用于调整音效、豁免列表和品牌文本
  • 通过 assets/craftlock/lang/en_us.json 支持翻译
  • 使用 craftlock 命名空间的 SLF4J 日志记录器

安装

要求

组件 版本
Minecraft 1.21.11
Fabric Loader >= 0.19.2
Fabric API 0.141.4+1.21.11
Java 21

步骤

  1. 为 Minecraft 1.21.11 安装 Fabric Loader。
  2. 将 Fabric API 放入你的 mods/ 文件夹。
  3. 将最新的 craftlock-1.0.jar(来自 Releases 页面)与其放在同一目录下。
  4. 启动游戏。当你加载世界时模组会自动运行——但锁定功能不会立即生效,直到你执行 /craftlock start。

命令

所有命令都需要 gamemaster 权限等级(在原版游戏中对应等级 2——单人主机自动获得此权限)。

命令 描述
/craftlock start 开始强制执行锁定。向所有玩家展示 CraftLock 标题。
/craftlock stop 暂停执行但不清除锁定列表。使用 start 恢复。
/craftlock status 打印运行状态、已锁定配方数量和已豁免配方数量。
/craftlock list 按 ID 列出所有已锁定配方。
/craftlock reset 清除整个锁定列表。不影响 started 标志。
/craftlock lock <recipe> 手动锁定某个配方(适用于设置挑战场景)。
/craftlock unlock <recipe> 手动解锁单个配方。

示例

> /craftlock start
[CraftLock started.]
[Title: CraftLock]
[Subtitle: Created by Chompii]

> /craftlock list
Locked recipes (3):
  - minecraft:oak_planks
  - minecraft:stick
  - minecraft:crafting_table

> /craftlock unlock minecraft:stick
Unlocked minecraft:stick

配置

首次启动时,模组会生成 config/craftlock.json 文件,包含以下默认值。编辑该文件并重启世界以应用更改。

{
  "titleText": "CraftLock",
  "subtitleText": "Created by Chompii",
  "exemptRecipes": [
    "minecraft:blaze_powder",
    "minecraft:ender_eye"
  ],
  "craftPingVolume": 0.6,
  "craftPingPitch": 1.5,
  "startSoundVolume": 1.0,
  "startSoundPitch": 1.0,
  "blockedSoundVolume": 1.0,
  "blockedSoundPitch": 1.0
}
字段 类型 说明
titleText string 执行 /craftlock start 时显示的文本。
subtitleText string 与标题配对的副标题。
exemptRecipes string[] 可以无限次合成的配方 ID。
craftPingVolume / craftPingPitch float 每次首次合成时播放的铃声音量/音调。
startSoundVolume / startSoundPitch float 执行 /craftlock start 时播放的紫水晶叮声音量/音调。
blockedSoundVolume / blockedSoundPitch float 合成被阻止时播放的村民“不行”音效音量/音调。

工作原理

CraftLock 基于每个世界的 SavedData 实例构建,存储以下内容:

  • 一组已锁定的配方 ID
  • 元数据映射:{recipe_id -> {crafter, world_day}}
  • 一个 started 标志

Mixin 附加到相应的原版菜单和方块实体上:

类 Hook 目的
CraftingMenu slotChangedCraftingGrid (TAIL) 如果匹配的配方被锁定,则清空结果槽位并发送 ClientboundContainerSetSlotPacket。同时缓存配方,以便在原版鼠标右键快速取走物品后,ResultSlot.onTake 仍能访问它。
ResultSlot onTake (HEAD) 记录锁定状态 + 进行广播。
AbstractFurnaceBlockEntity canBurn (HEAD) + setRecipeUsed (HEAD) 如果已锁定则阻止熔炼;完成后进行记录。
CampfireBlockEntity getCookableRecipe (RETURN) + placeFood (RETURN) 如果已锁定则阻止放置食物;放置时进行记录。
SmithingMenu createResult (TAIL) + onTake (HEAD) 如果已锁定则清空结果;取走时进行记录。
StonecutterMenu setupResultSlot (TAIL) + onTake (HEAD) 采用相同的模式。
PotionBrewing mix (RETURN) 如果输出将是被锁定的药水变种,则返回未混合的输入物;成功酿造时施加锁定。
RecipeButton renderWidget (TAIL) — 仅客户端 在配方书内为已锁定的配方绘制红色覆盖层。

当锁定列表发生变化时,通过自定义数据包 craftlock:lock_list 将状态同步给所有已连接客户端,因此工具提示和配方书覆盖层会实时更新。


挑战跑图者须知

典型的跑图流程:

  1. 创建新世界。 锁定列表按存档持久化,因此请勿复用旧存档。
  2. 运行 /craftlock start 以开始执行限制。在此之前,模组仅处于观察模式。
  3. 规划你的路线。 末影之眼和烈焰粉不受限制,因此你可以到达末地。除此之外——每一个合成配方——在首次制作时即被锁定。
  4. 如果你需要重录某一段落,请在拍摄间隔使用 /craftlock reset。
  5. 使用 /craftlock list 来审计你已消耗的物品。

给剪辑师的提示: 黄色的聊天广播(Chompii has crafted: ...)旨在即使在压缩的 YouTube 视频片段中也易于阅读,并且非常适合配合“里程碑时刻”剪辑时的铃声提示。


从源码构建

git clone <repository-url>
cd CraftLock
./gradlew build

编译后的 jar 文件位于 build/libs/ 中。

对于开发,你可以使用:

./gradlew runClient   # 启动加载了模组的开发客户端
./gradlew runServer   # 启动专用的开发服务器
./gradlew genSources  # 反编译 Minecraft 以便 IDE 导航

致谢

由 Chompii 制作。

基于 Fabric 模组开发工具链构建。由 SpongePowered Mixin 和 MixinExtras 提供支持。


许可证

根据 CraftLock License 发布 —— 完整文本请参阅 LICENSE。

简而言之:

  • 你可以使用、修改、分发、分叉、重新打包和嵌入该模组。
  • 你必须在使用该模组时显式署名 Chompii(视频描述、整合包致谢、衍生模组自述文件等)。
  • 你不得声称自己是 CraftLock 的原始作者。
  • 软件按“原样”提供,不提供任何担保。

如果你正在发布视频,适当的署名格式如下:

"Featuring CraftLock by Chompii — github.com/Chompii/CraftLock"

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源