
UtilityConnect
被BetterStorage使用的UtilityMod
UtilityConnect
所有带管道或线缆的模组最终都会各自编写一套网络图。UtilityConnect 把这个工作一次性完成:一个与模组无关的 Hytale 库,将方块连接成网络并对其进行跟踪,在建造时实时生效,并在服务器重启后保留。物品、流体和能量旨在通过这些网络传输,其他模组则在其之上构建自己的运输系统,就像 Minecraft 世界中的 Forge Energy 或 Fabric Transfer API 一样。
API
| 类型 | 用途 |
|---|---|
| UtilityConnectAPI | • 库的入口点 • networks()、isReady()、runtimeVersion() |
| Networks | • 使用 addNode / removeNode 注册节点• 使用 hasNode、networkAt、sameNetwork、networkCount、nodeCount 进行查询 |
| NodeKind | • DEVICE 或 CONNECTOR• 只有连接器才能连接:两个并排放置的设备还不能构成网络 |
| NodeKindResolver | • 告诉库你的哪些方块扮演哪种角色 • 在方块处询问,而不是从存储值中获取 |
| NodePos / ChunkKey | • 节点的方块位置和区块位置 • 节点按区块保存 |
| TransportProvider<T> | • 资源移动的契约:insert、extract、capacity、tier• 尚未接入 |
| TransferMode | • SIMULATE 或 EXECUTE• 在真正执行前先尝试传输 |
状态
0.2.0-Alpha。网络部分可用,传输部分尚不可用。 方块在建造和破坏时加入网络,节点在完整的服务器重启后仍然保留。不过,没有任何东西会自动流经管道:TransportProvider 和 TransferMode 描述了契约,但尚未有实现支撑它们。
公共 API 不稳定。从 0.1.0-Alpha 到 0.2.0-Alpha 已经发生了破坏性变更:新增了 registerKindResolver,并且保存格式现在能识别连接器。
用法
将 UtilityConnect 添加为硬性 manifest 依赖。服务器会强制执行它,并为你安排生命周期顺序:UtilityConnect 的 setup() 会在你自己的 setup() 运行之前完成,因此从那时起 API 就已就绪。
manifest_dependencies = com.cyberpiratepenguin:utilityconnect=0.2.0-Alpha
// 只有你的模组知道它的哪个方块是管道、哪个是设备。
UtilityConnectAPI.networks().registerKindResolver((world, pos) -> {
String blockId = blockIdAt(world, pos);
if (!isMyBlock(blockId)) {
return null; // 不是你的方块:不要猜测
}
return isMyPipe(blockId) ? NodeKind.CONNECTOR : NodeKind.DEVICE;
});
之后,当你的某个方块被放置时调用 addNode,被破坏时调用 removeNode。BetterStorage 是第一个基于 UtilityConnect 构建的模组。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。