UtilityConnect

UtilityConnect

被BetterStorage使用的UtilityMod

图书馆

UtilityConnect

Hytale Server 0.6.8 Java 25 Gradle Kotlin DSL MIT

所有带管道或线缆的模组最终都会各自编写一套网络图。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 构建的模组。