奥格维克的库存冻结

奥格维克的库存冻结

让你为所有玩家全局“冻结”可配置的物品栏槽位

管理

Oggvik's Inventory Freeze

一个用 Java 编写的简单 Minecraft Forge 模组,可让你为所有玩家全局“冻结”可配置的物品栏槽位。其主要用途是在服务器上使用(例如用于角色扮演事件的 RP 服务器,为了增强沉浸感而希望限制物品栏槽位数量),或作为整合包的一部分使用(例如极限硬核生存整合包)。

该模组提供一个单一命令,用于全局启用对特定物品栏槽位的“冻结”:

/inventory-lock [true/false]

设计

  • 🪷 使用 Java 编写的代码非常简洁干净
  • 🔒 服务端看门狗机制,防止刷物品漏洞和物品删除
  • 🚀 可以轻松移植到更新的 Minecraft/Forge 版本
  • 😎 自定义物品拾取逻辑,防止将物品拾取到“被冻结”/“被锁定”的物品栏槽位中
  • 🎨 GUI 效果(前端)代码与程序其余内部逻辑(后端)隔离
  • 🩷 体积小巧(目前仅为 ~330 KB)
  • 👋 已测试在生存模式和多人服务器(大量玩家)中均可正常工作

功能

  • 🧊 当 /inventory-lock true 时,“冻结”玩家物品栏的部分区域。
  • ❌ 当 /inventory-lock 为 true 时,玩家无法放入、取出或删除自己“被冻结”/被锁定物品栏槽位中的物品。
  • 👗 仅冻结所配置的物品栏槽位。也就是说,不影响箱子、其他模组(例如背包)、盔甲、披风及其他与装饰相关的自定义物品栏槽位。
  • 🔢 需要冻结的物品栏槽位可由服务器管理员轻松配置。
  • 🪽 当玩家切换到创造模式时自动解冻其物品栏,若在 /inventory-lock 为 true 期间退出创造模式,则再次冻结。
  • 🖼️ 被冻结的槽位将以灰色透明方块覆盖层标示(标示外观可能在后续版本中更改)。
  • [WIP] 🧑‍🤝‍🧑 可选地将特定玩家排除在 /inventory-lock 之外。例如,在服务器上主持 RP 事件的人或扮演角色的玩家可在该时段内被排除在 /inventory-lock 之外。

兼容版本

Minecraft:1.16.5 模组加载器:Forge(已在 36.2.42 上测试)

构建项目

首次构建项目时,你需要进入其根目录并运行: ./gradlew build --refresh-dependencies 之后再次编译时,只需运行 ./gradlew build 即可。 编译已测试可在 Java 17 OpenJDK 上正常工作,但更高的一些版本以及至少到 Java 8 的任何更低版本也应可用。 上述操作会在 ./build/libs 目录中生成 inventoryfreeeze-X.X.X.jar,你可以将其添加到 Minecraft 1.16.5 Forge 配置文件中进行游玩。

此外,如果你使用 IntelliJ IDEA(我推荐使用),也可以通过执行以下命令来编译 Forge Gradle 运行配置: ./gradlew genIntellijRuns

示例截图

示例 1 – 使用自定义模组配置

锁定槽位灰色覆盖层示例 示例 1 展示了根据下方自定义服务器配置锁定的物品栏槽位: 自定义物品栏槽位选择服务端配置示例

示例 2 – 使用整合包

以下是在整合包中运行物品栏冻结功能的示例: 整合包中锁定槽位灰色覆盖层示例

致谢:“Dawn of Humanity” 受 AoT 启发的整合包

示例 3 – 使用整合包 + 资源包

使用资源包时锁定槽位灰色覆盖层示例 与 示例 2 相同,但展示了应用资源包时覆盖层指示效果也能正常工作。 请注意,被锁定的物品栏槽位显示得比未锁定的快捷栏槽位更暗,而在此资源包中它们通常应具有相同的颜色。

致谢:“Dawn of Humanity: RP!” 资源包