Oggvik’s Inventory Freeze

Oggvik's Inventory Freeze

一个用 Java 编写的简单 Minecraft Forge 模组，可为所有玩家全局“冻结”可配置的物品栏槽位。它主要用于服务器（例如带有角色扮演活动的 RP 服务器，为了增强沉浸感，你可能会想限制物品栏槽位数量），也可以作为整合包的一部分（例如超硬核生存整合包）。

该模组提供一条命令，可全局启用特定物品栏槽位的“冻结”功能，使用命令：

/inventory-lock [true/false]

DESIGN

• 🪷 用 Java 编写的代码非常简洁明了
• 🔒 服务端看门狗，可防止物品复制漏洞和物品删除
• 🚀 可以轻松移植到更新版本的 Minecraft/Forge
• 😎 自定义物品拾取逻辑，防止物品被拾取到“冻结”/“锁定”的物品栏槽位中
• 🎨 GUI 效果（前端）代码与程序其余部分的内部逻辑（后端）相互隔离
• 🩷 体积很小（目前仅有 ~330 KB)
• 👋 已测试确认在生存模式和多人游戏中（包括多人服务器）均可正常运行

FUNCTIONALITY

• 当/inventory-lock true处于启用状态时，冻结玩家物品栏中的部分区域。
• ❌ 当/inventory-lock处于true状态时，玩家无法在自己的“冻结”/锁定物品栏槽位中放入、取出或删除物品。
• 👗 只会冻结已配置的物品栏槽位。也就是说，不会影响箱子、其他模组（例如背包）、盔甲、披风以及其他与外观相关的自定义物品栏槽位。
• 🔢 服务器管理员可以轻松配置要冻结的物品栏槽位。
• 🪽 玩家切换到创造模式时，物品栏会自动解冻；如果他们在/inventory-lock处于true状态时退出创造模式，物品栏则会再次冻结。
• 🖼️ 被冻结的槽位会显示灰色半透明方块覆盖层（指示效果今后可能会调整）。
• [开发中] 🧑‍🤝‍🧑 可选择将特定玩家排除在/inventory-lock之外。例如，在服务器上主持 RP 活动或扮演演员的玩家，可以在活动期间不受/inventory-lock影响。

COMPATIBLE VERSIONS

Minecraft：1.16.5
模组启动器：Forge（已在36.2.42上测试）

BUILDING THE PROJECT

首次构建项目时，需要进入项目根目录并运行：
./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 Runs：
./gradlew genIntellijRuns

EXAMPLE SCREENSHOTS

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

Example 1根据下方的自定义服务器配置显示已锁定的物品栏槽位：

示例 2 – 使用整合包

以下示例展示了物品栏冻结功能在整合包中的实际效果：

鸣谢：“Dawn of Humanity”受 AoT 启发的整合包

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

与example 2相同，但展示了应用资源包后覆盖层指示效果仍然正常。
请注意，锁定的物品栏槽位颜色比未锁定的快捷栏槽位更暗；而在这个资源包中，它们原本应该是同一种颜色。

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