锁定了neoforked

锁定了neoforked

Locks模组的非官方移植版,适用于1.21.1 neoforge——可锁定Minecraft中的任何容器、撬锁(包括战利品箱上生成的锁)等!

Locks Reforged

Locks Neoforked

给你建造的任何东西装上一把真实的锁——然后看着别人试着撬开它。

Locks Neoforked 是对 Melonslise 原版 Locks 模组的现代化重制版。现在你不仅可以给箱子加锁:门、活板门、熔炉、发射器、漏斗、木桶,以及其他模组添加的一切都可以。

这是原版 Locks(作者 Melonslise)的非官方移植版,适用于 Minecraft 1.21.1 的 NeoForge。

一个装在箱子上的镀金锁


为什么值得一玩

  • 任何模组的方块都能上锁。 一把空间锁可以保护一整个大箱子、一扇门,或一整排工业机械。它不在乎方块是哪个模组添加的。
  • 真正的迷你游戏,而不是倒计时。 每把锁都有一个锁芯组合。每一次拨错锁芯都会消耗你的开锁器耐久,消耗多少取决于你正在攻击的锁。你可以盯着耐久条,数清自己犯了几次错。
  • 它会主动找上你。 上锁的箱子会自然生成在主世界、下界和末地——你遇到的锁的等级与箱子本身的富有程度挂钩,所以村庄木箱和远古城市宝库的体验永远不会相同。
  • 钥匙、钥匙环和万能钥匙。 在放置锁之前先配一把副钥,随身携带一整环钥匙,或者把万能钥匙留给自己。
  • 真正的防御,而不只是贴图。 上锁的方块能抵抗爆炸、活塞、漏斗和红石,上锁的门对村民以及任何试图开门的模组 NPC 都会保持关闭。
  • 自由塑造。 十二种附魔分别作用于锁和开锁器,你可以强化自己的箱子,也可以削弱小偷。一切都由数据驱动:添加你自己的等级,或重新调整现有等级,无需改动代码。

获取各等级

七种锁等级——木、铜、铁、镀金、镀钻石、下界合金,另外还有一种 钢 等级,供提供钢的整合包使用——每种都有各自的锁芯数量、附魔能力、爆炸抗性和开锁器磨损。开锁器与之对应。没有任何东西锁在进度之后:下界合金装备耐火,并像原版一样由钻石等价物锻造升级而来。

村庄箱子上的铁锁

下界合金锁是末地专属的发现。 它们是你成功跑一趟末地城的奖励,不会出现在其他地方。在其他地方,一个富有到足以获得下界合金的箱子会降级为钻石,而不是什么都不掉——因此游戏中最强的锁始终是你必须亲自去夺取的东西。

钢来自你的整合包,而不是我们。 Locks 本身完全不提供钢材料:没有锭、没有粒、没有矿石、没有矿石生成。来自 Create、Immersive Engineering、Mekanism、Thermal 的钢——任何把钢标记到 c:ingots/steel 的模组——都能用于所有 Locks 配方。它是仅合成等级,不前置任何东西,如果你的整合包没有钢,相关配方会直接不存在,而不是损坏。


全部七种锁等级,精确数值

| 锁 | 锁芯数 | 附魔能力 | 抗性 | 开锁器磨损 | |------|------|----------------|------------|-----------| | 木 | 5 | 15 | 4 | 1 | | 铜 | 6 | 16 | 8 | 2 | | 镀金 | 6 | 22 | 6 | 2 | | 铁 | 7 | 14 | 12 | 3 | | 钢 | 9 | 12 | 20 | 6 | | 镀钻石 | 11 | 10 | 100 | 12 | | 下界合金 | 14 | 8 | 200 | 24 |
  • 锁芯数 — 迷你游戏中的锁芯数量;锁芯越多越难撬。
  • 附魔能力 — 锁接受强力附魔的容易程度。
  • 抗性 — 爆炸抗性。镀钻石和下界合金几乎坚不可摧。
  • 开锁器磨损 — 此锁在每次拨错锁芯时从开锁器扣除的耐久。这正是让等级成为真正经济防御的原因:拿着木开锁器去撬下界合金锁,一次失误就会结束。

钢锁在设定上就是个外来者——它是唯一需要其他模组材料的等级,因此它不前置任何东西(镀金和镀钻石锁建立在铁机构之上),也永远不会生成在自然生成的箱子上。请把它当作整合包里的风味等级,而不是阶梯中的一级。

全部七种开锁器等级,精确数值

开锁器 强度 附魔能力 耐久 对抗同级锁时的错误锁芯次数
木 0.20 5 32 32
发夹(铜) 0.28 7 48 24
金 0.25 22 40 20
铁 0.35 10 96 32
钢 0.70 12 192 32
钻石 0.85 10 384 32
下界合金 0.95 15 768 32
  • 强度 — 开锁器可以尝试哪些锁(复杂度门槛)。它不影响磨损。
  • 附魔能力 — 开锁器在附魔台上接受附魔的容易程度。金开锁器就是“请附魔我”等级,和原版金装备一样。
  • 耐久 — 开锁器损坏前的耐久点数。默认数值让开锁器在对抗同级锁时大约能承受 32 次失误。
  • 开锁器是正规工具,因此 经验修补、耐久附魔和铁砧 都有效,每个等级都可修复。

开锁器可堆叠至 64。 Minecraft 通常会让有耐久的物品无法堆叠;Locks 恢复了完整堆叠数,且每次只会磨损一把开锁器。第一次真正扣除耐久的错误锁芯会拆分堆叠:手中的开锁器承受伤害,剩余的未使用部分返回背包。磨损的开锁器修复前不会合并回新的堆叠,铁砧也拒绝把附魔书应用于数量大于一的堆叠,所以一本书无法一次性附魔 64 把开锁器。

下界合金锁和开锁器耐火,能在岩浆中存活。两者都使用下界合金升级模板从钻石等价物锻造而来。

开锁细节

装有锁的箱子不会简单地拒绝打开。用开锁器右键点击它,你便会进入锁芯匹配迷你游戏:拨动锁芯,直到找到组合。

错误的锁芯会消耗耐久,由锁决定。 你的开锁器能否存活没有随机判定。你正在攻击的锁决定了每次失误的消耗,只有当耐久耗尽时开锁器才会损坏。偏差恰好一个锁芯的猜测,消耗约为完全猜错的三分之一,但绝不低于 1——因此没有任何附魔与配置值的组合能让开锁变成免费的。你可以观察耐久条,准确知道在最坏情况发生前还能犯几次错。

提示信息会告诉你真相。 每把锁都有自己的 id 和组合,其生成方式确保无法从公开数据推导出来,HUD 和提示信息可以配置为显示尽可能多或尽可能少的信息。

可选: 启用 允许空手开锁 后,玩家可以空手玩同一个迷你游戏,无需开锁器。空手尝试从不消耗或损坏任何东西,也不会被复杂度阻挡,但一次错误锁芯会重置你已经解出的所有锁芯。默认关闭;无论是否启用,实体开锁器的行为都完全不变。

钥匙、钥匙环与万能钥匙

钥匙胚 是未切割的——在你把它与锁配对之前,它打不开任何东西,而且你要在放置锁之前进行配对:

  1. 合成一个 钥匙胚。
  2. 在放置锁之前,将钥匙胚和锁一起放入任意合成网格——你的 2×2 背包合成格可以,工作台也可以。
  3. 配方会返还锁,并产出与之匹配的 钥匙。
  4. 放置锁。这把钥匙现在可以解锁和重新上锁。
  5. 将配好的钥匙与另一个钥匙胚合成,即可切割一把备用钥匙。

该配方为无序合成,一个钥匙胚产出一把钥匙。

钥匙胚无法复制已经放置的锁。 这是有意为之:如果拿着钥匙胚对着已放置的锁就能切出匹配的钥匙,任何访客都能制造一把,你的锁就什么都保护不了。拿着钥匙胚右键点击已放置的锁,只会提醒你正确流程。如果你在配对前就放置了锁,请空手潜行取回未上锁的锁,完成配对后再重新放置。

  • 钥匙环 可同时容纳多把钥匙,并能打开其中任意钥匙对应的锁。安装 Curios 后,它可直接从饰品栏生效,无需占用你的手。
  • 万能钥匙 可打开任何锁,无论其 id 为何。
  • 感知 附魔会将锁绑定到放置它的人:该方块对放置者正常开启,而对其他人保持锁定。空手潜行右键点击即可直接操作锁本身。

全部十二种附魔

**锁附魔**——作用于锁:
附魔 最大等级 效果
电击 V 电击开锁失败的玩家(无视护甲)
坚固 III 让每次错误锁芯额外消耗开锁器耐久(默认每级 +50%)
复杂度 III 完全阻止低等级开锁器尝试该锁
静默 I 在拒绝访问时抑制咔嗒声。与电击不兼容
自动开锁 III 有 10%/20%/30% 的几率瞬间开锁,绕过迷你游戏。与复杂度不兼容
加固 III 爆炸抗性提高 50%/100%/150%
感知 I 锁不会作用于放置它的人。空手潜行右键点击即可直接操作锁本身

开锁器附魔——作用于开锁器,并提供反制手段:

附魔 最大等级 效果
巧手 III 降低错误锁芯的耐久消耗,每级 15%(反制坚固)。与最后一抓不兼容
共鸣 II 提升对抗复杂锁时的有效开锁器强度(反制复杂度)
接地 III 手持开锁器时(任意手)减少电击锁造成的伤害(反制电击)
静手 I 降低拨错锁芯的声音
最后一抓 I 约 20% 几率使错误锁芯完全不消耗耐久。与巧手不兼容

这十二种附魔中的每一种都可以在服务器配置中单独禁用,开锁器一侧的效果也可以调整。

锁到底保护什么

上锁的门无法被村民或任何其他开门 AI 打开——包括驱动原版或子类门的模组 NPC。关闭上锁的门仍然允许;只有打开会被拒绝,而重新锁上一扇开着的门会将其关闭,因此门永远不会在锁报告为已锁定时保持敞开。

上锁的方块同时受到保护,免受:

  • 红石激活
  • 漏斗抽取
  • 活塞移动
  • 爆炸
  • 破坏(可配置)

上锁箱子的生成方式

  • 上锁的箱子会自然生成在 主世界、下界和末地 的结构中,也会生成在生物群系加入相关原版标签的模组维度中。
  • 默认情况下,大约十分之三的箱子会保持空置。 找到上锁的箱子应该是一件事件,而不是理所当然。将 箱子上锁几率 提高到 1.0 可封印每个箱子,或降低它让更多箱子保持无锁。
  • 等级跟随箱子的战利品价值。 该价值通过读取战利品表自身的 JSON 确定性地计算——池、掷数、权重、嵌套引用和标签条目——因此同一个箱子总是得到相同的分数。物品价值随堆叠数量的平方根缩放,所以 64 个圆石不会超过一把钻石剑,而稀有度和战利品表附魔函数会将物品推高一个档次。可在配置中逐物品覆盖。
  • 达到某个等级只是使其可能,而非确定。 一个达到钻石资格的箱子仍会为钻石进行掷骰,失败则降一级,因此富有的箱子结果多样而非整齐划一。各等级的概率均可配置。
  • 箱子最终空置有两个独立原因:其战利品价值低于最低阈值,或它在上面那 30% 的掷骰中失败。两者可分别调整。
  • 锁、钥匙和机构会被注入箱子战利品表(可按模式配置,默认 minecraft:chests/)。
  • 可配置职业的村民(默认为工具匠)出售开锁器和机构——并且可以选择性地出售游戏早期的木、铜、铁锁。流浪商人提供金开锁器以及稀有的附魔钻石和下界合金锁。每个交易类别都可独立开关。钢永远不会被交易。

仅限末地的下界合金等级 由两个数据包标签控制:locks:biome_gated_locks 指定受限的锁,默认包含 locks:netherite_lock;locks:biome_gated_lock_biomes 指定它们可出现的生物群系,默认包含 #minecraft:is_end。清空或扩展其中任意一个即可将某个等级移到其他维度;执行 /reload 即可。

配置

所有设置均由配置驱动。请注意,locks-server.toml 是 按世界 生成的,其位置与其他两个文件不同。

config/locks-common.toml —— 世界生成与物品数值

  • 箱子上锁几率 —— 符合条件的自然生成箱子获得锁的几率(0.0–1.0,默认 0.7,因此大约十分之三保持空置)
  • 生成附魔几率 —— 自然生成的锁被附魔的频率(默认 40%)
  • Generated Locks / Generated Lock Chances —— 世界生成中出现哪些等级及其相对权重(在关闭战利品缩放时使用;也是 Loot Value Tiers 的等级顺序)
  • 战利品缩放锁 —— 根据箱子战利品价值决定锁等级(默认开启),包括 Default Item Value、稀有度倍率、Enchantment Value Bonus、Item Value Overrides、各等级的 Loot Value Tiers 阈值(默认 [2.0, 5.0, 9.0, 13.0, 20.0, 21.0])以及 Lock Tier Chances(默认 [1.0, 0.85, 0.7, 0.55, 0.35, 0.5]),即各等级的保留几率,使达到资格的等级成为掷骰而非保证
  • Randomize Loaded Locks —— 是否随机化从结构文件加载的组合(默认 false)
  • Lock Stats / Lockpick Stats —— 各等级的数值覆盖(见上文)

默认等级是根据原版 1.21.1 实测的箱子战利品分布放置的,而非凭猜测。如果整合包抬高了物品价值,就会把每个箱子推上梯子,因此如果你也调整了 Default Item Value、稀有度倍率或 Item Value Overrides,请重新调整间距。高于 p90 的阈值实际上不可达——而下界合金的值必须保持在约 22 或以下,因为末地城箱子(价值 22.2)是游戏中唯一的末地箱子表,且下界合金受末地限制。

saves/<world>/serverconfig/locks-server.toml —— 服务器端游戏规则(首次加载时按世界生成)

  • Lockable Blocks / Lockable Tags —— 可上锁内容的 regex 模式和方块标签(默认:箱子、木桶、漏斗、门、活板门、栅栏门、潜影盒)
  • Max Lockable Volume —— 单把锁可覆盖的最大方块数(默认 6)
  • Allow Removing Locks / Protect Lockables / Easy Lock —— 潜行取下未上锁的锁、生存模式防破坏、一键放置
  • Display —— 隐藏锁 id、HUD 附魔、HUD 提示信息
  • Enchantments —— 单独启用或禁用十二种附魔中的每一种,并有一个 Lock Pick 子节调整巧手、共鸣、坚固、差之毫厘、接地、最后一抓和静手
  • Enchantments.Shocking —— 伤害公式、冷却、是否需要附魔,以及四个独立触发条件(开锁器损坏、错误锁芯、未授权交互、尝试破坏方块)。创造模式玩家免疫
  • Netherite Lockpick Unbreakable —— 下界合金开锁器永不损坏(默认 false)
  • Allow Itemless Lock Picking —— 空手玩迷你游戏(默认 false)
  • Loot Table Injection Patterns —— 哪些战利品表接收开锁器和钥匙注入(默认 minecraft:chests/)
  • Trades —— 村民和流浪商人销售的总开关与各类别开关,以及 Villager Profession(默认 minecraft:toolsmith)。村民锁销售是可选项;没有任何类别涵盖钢
  • Compatibility.CarryOn —— 集成是否激活、上锁方块是否可被携带、携带是否需要授权、是否拒绝部分多方块拾取,以及传输日志

config/locks-client.toml —— 客户端设置

  • Deaf Mode —— 开锁的无障碍视觉反馈(默认 true)

过期的配置文件: 当模组更新并添加新等级时,现有的 TOML 文件会保留其旧的默认值——例如在某个等级存在之前写入的 Generated Locks 列表将不包含它。请自行添加条目,或删除 locks-common.toml 让其重新生成。这也是为什么必须始终成立的行为在代码中强制执行:当 c:ingots/steel 为空时,钢锁被 locks:steel_provider_locks 物品标签硬性锁定,因此过期配置无法将其重新放入你的世界。

添加自定义锁与开锁器

Locks Reforged 拥有完全数据驱动的物品系统。你可以根据需求使用三种不同方法,添加全新的锁和开锁器等级——或调整现有等级。

方法 1:配置文件夹(新自定义物品)

将 JSON 文件放入配置文件夹,即可注册全新的锁或开锁器物品。模组会在启动时自动发现它们。

要添加自定义锁,创建 config/locks/lock_types/<name>.json:

{
  "length": 7,
  "enchantment_value": 14,
  "resistance": 12,
  "pick_wear": 3,
  "fire_resistant": false
}
  • length —— 锁芯数量(1–20)
  • enchantment_value —— 附魔能力(1–50)
  • resistance —— 爆炸抗性(0–1000)
  • pick_wear —— 此锁上错误锁芯消耗的开锁器耐久(1–1000,可选,默认 1)
  • fire_resistant —— 物品是否能在火焰和岩浆中存活(可选,默认 false)

要添加自定义开锁器,创建 config/locks/lockpick_types/<name>.json:

{
  "strength": 0.5,
  "enchantment_value": 10,
  "durability": 96,
  "fire_resistant": false
}
  • strength —— 开锁器可以尝试哪些锁,复杂度门槛(0.01–10.0)。不影响磨损
  • enchantment_value —— 附魔台上的附魔能力(0–50,可选,默认 0 = 不可台附魔)
  • durability —— 开锁器损坏前的耐久点数(0–10000,可选,默认 64)。0 使其无法损坏——为想要旧版“开锁器永不损坏”感觉的整合包提供的逃生通道
  • fire_resistant —— 物品是否能在火焰和岩浆中存活(可选,默认 false)

文件名会成为物品在 locks: 命名空间下的注册名(例如 netherite_lock.json 注册为 locks:netherite_lock)。配置文件夹物品会覆盖同名 JAR 内置物品,因此你也可以用它替换内置数值。

重要: 以这种方式注册的自定义物品会自动出现在游戏中,但若没有以下内容,将不可见且不可合成:

  • 提供模型和纹理的 资源包(assets/locks/models/item/<name>.json、assets/locks/textures/item/<name>.png),以及可选的解锁界面纹理(assets/locks/textures/lockpicking/<name>.png,会回退到铁锁的纹理)
  • 提供合成配方的 数据包(data/locks/recipe/<name>.json),并将物品加入相应的标签(data/locks/tags/item/locks.json 或 lock_picks.json)

模组会在首次启动时在 config/locks/lock_types/_example.json.disabled 和 config/locks/lockpick_types/_example.json.disabled 创建示例文件以供参考。

方法 2:数据包数值覆盖(按世界调整现有物品)

数据包可以按世界覆盖任何现有锁或开锁器的数值。覆盖会在世界加载时以及每次运行 /reload 时应用,非常适合整合包作者或冒险地图。

要覆盖锁数值,将 JSON 文件放在 data/<namespace>/locks/lock_stat_overrides/<name>.json:

{
  "item": "locks:iron_lock",
  "length": 3,
  "resistance": 50
}

要覆盖开锁器数值,将 JSON 文件放在 data/<namespace>/locks/lockpick_stat_overrides/<name>.json:

{
  "item": "locks:iron_lock_pick",
  "strength": 1.5
}

只有你列出的字段会被更改——省略的字段保留当前值。多个数据包可以提供覆盖;它们按数据包加载顺序叠加。

锁的 pick_wear 可以在此覆盖,因为它在每次错误锁芯时都会重新读取。开锁器的 durability 不能——它在启动注册物品时就已 baked 进物品,远早于任何数据包加载,此处写 durability 键会被忽略并在日志中给出警告。

方法 3:TOML 配置(无需数据包即可覆盖数值)

每种内置锁和开锁器在 locks-common.toml 中都有 TOML 配置条目,让你无需数据包即可覆盖单个数值。将任意值设为 -1(开锁器强度设为 -1.0)即可使用 JSON 默认值。每把锁还有一个 Pick Wear 条目。开锁器耐久是唯一无法在此处或通过数据包设置的数值——请在 config/locks/lockpick_types/<name>.json 中设置。

# 示例:让铜锁拥有 8 个锁芯而不是 6 个
["Lock Stats"."Copper Lock"]
    Length = 8
    "Enchantment Value" = -1
    Resistance = -1
    "Pick Wear" = -1

# 示例:将铜开锁器强度翻倍
["Lockpick Stats"]
    "Copper Lockpick Strength" = 0.56

TOML 覆盖在数据包覆盖之前应用,因此数据包拥有最终优先权。

覆盖优先级

当多个系统为同一数值提供值时,优先级顺序为:

  1. 数据包数值覆盖(最高优先级,在 /reload 时应用)
  2. TOML 配置覆盖(在配置加载时应用)
  3. 配置文件夹 JSON(在启动时覆盖 JAR 默认值)
  4. JAR 内置 JSON(最低优先级,内置于模组中)

关于机构

锁机构(木、铜、铁、钢)是基础合成组件——它们不是数据驱动的,无法通过配置或数据包添加。每种锁配方都需要一个机构作为中心材料:木锁和铜锁使用各自的机构,铁锁和钢锁使用各自的,而镀金和镀钻石锁建立在铁机构之上(下界合金锁由钻石锁锻造而来)。

模组兼容性

  • Curios (可选) —— 钥匙环可从饰品栏生效,无需占用你的手。
  • Carry On (可选) —— 锁会随你拾取并携带的方块一起移动。可配置:上锁方块是否可被携带、携带是否需要授权,以及是否拒绝拾取多方块锁的一部分。
  • Respawning Structures (可选) —— 重生的箱子会重新上锁。
  • Lootr (可选) —— 大箱子的每一半都被视为独立可上锁对象,与 Lootr 拆分它们的方式一致。
  • C2ME 和其他异步区块模组 —— 区块可上锁数据会安全地在线程外解析,并在主线程交给世界,因此异步区块加载不会死锁或丢失锁。

要求

  • Minecraft 1.21.1
  • NeoForge 21.1.216 或更高
  • Java 21

可选:Curios(9.x API)和 Carry On(适用于 NeoForge 1.21.1 的 2.2.2+)。两者均非必需。

多人游戏说明: 客户端和服务器必须运行相同版本——开锁网络协议在握手时进行版本检查,版本不匹配的连接会被干净地拒绝,而不是之后出现异常行为。


致谢

这是一个保留所有原始玩法的非官方移植版。根据 CC BY-NC 3.0 许可,与原模组保持一致。