虚空存储

警告 这是我发布的第一个 Hytale 模组，所以请预期会存在一些 Bug、粗糙的边缘情况，以及随时间推移的平衡性调整。如果某些内容出错或感觉不对劲，感谢你在不断改进期间的耐心等待。

在尝试使用前，请务必备份你的世界。

警告：Hytale 更新可能会导致旧世界损坏。

 

Archmon 为 Hytale 制作的 VoidStorage

最初是 Hytale Java 插件的模板，由 Archmon 基于 YouTube 上 Kaupenjoe 在其 Hytale 模组制作教程中发布的内容修改而来。

声明： 本模组旨在将 Minecraft 中的 EnderStorage 模组带入 Hytale。我使用了 Kaupenjoe 和 Ali 的视频作为模组的起点，并且在创作过程中使用了 Google.com 搜索中的 AI。同时，我也大量使用了 intellij jetbrains/codex 中的 AI 来帮助我进行模组的开发。

当前功能

• 口袋维度保险箱：一个基于数据库的私有存储方块，以放置位置为键。这意味着你可以将它们并排放置，每个保险箱都有自己独立的库存，而且只有你可以访问（自动化也无法访问）。并且只有你才能移除它（或者至少你或管理员可以）。当保险箱被破坏时，所有内容都会掉落，不会丢失任何东西。
• 虚空箱子：一个共享的网络箱子，使用颜色代码通道，有 4096 种可能性。（使用虚空扳手更改通道代码）。通过向箱子添加精金锭（同样使用虚空扳手），你可以访问私人网络箱子，获得更多功能。每个玩家除了共享网络外，还可以拥有自己的网络。
• 虚空扳手：一个扳手，手持时可以在潜行状态下打开虚空箱子的 GUI。（默认情况下，是 Control-F）。

供其他模组访问虚空箱子的 API

要访问虚空箱子，其他模组必须使用 VoidStorage API。该 API 提供了与虚空箱子交互的方法，例如存入和取出物品。这允许其他模组利用虚空箱子进行存储。请参考 VoidStorageAPI 类中的方法来使用该 API。请注意，口袋维度保险箱和虚空扳手不属于 API 的一部分。只有虚空箱子被包含在内，而且即便如此，这也只是为了允许其他模组查看并交互虚空箱子的库存。由于世界侧箱子存在的问题，这样做是必要的。（参见已知问题）

版本更新日志

• 1.0.0：针对 Hytale 版本 2026.03.26-89796e57b（更新前 5）的初始发布
• 1.1.0：更新至 Hytale 版本 0.5.0

已知问题

• 虚空箱子本意是将按钮放在顶部，但由于方块状态的工作方式，这意味着我需要 8092 个模型文件来展示虚空箱子的所有不同动画文件。目前，我为虚空箱子设置了 2 个方块状态。
• 点击拖拽存入箱子时，物品会弹回玩家的背包中。（这是 Hytale 的 Bug。）
• 潜行时挥动虚空扳手不起作用，因为我无法触发所需的事件。
• 其他模组必须通过我的 API 实现对虚空箱子的访问，以便它们能够使用虚空箱子。如果没有这个，其他模组将无法访问虚空箱子。这是因为在尝试从世界侧导入箱子时，我发现这种方式存在问题。例如，我可以将世界侧用作导入缓冲区，但如果箱子已满，物品将留在无法访问的世界侧箱子中，直到虚空箱子清空或该虚空箱子的实例被销毁。我还尝试在世界侧箱子和数据库侧箱子之间建立一座桥，但这也存在物品复制等问题。我本来希望像 Minecraft 模组那样，通过将所有内容整合为一个库存来实现所有功能，但当时并没有可用的钩子。
• 飞行时无法打开虚空箱子的 GUI。解决方法：不要飞行。