Hy-Voltz

Hy-Voltz

一个用于处理游戏中所有电力的API

图书馆

HyVoltz

HyVoltz 是一个为 Hytale 模组设计的轻量级能量网络库。它提供了一种标准化的方式在方块之间传输能量，而无需向你的用户强制施加特定的游戏机制或分级系统。

它不是一个科技模组、机器包或游戏玩法改造。它纯粹是一个面向开发者的库。

理念模型

将 HyVoltz 想象成一个图形管理器。你告诉它哪些方块是节点，它会在每个游戏刻处理图形遍历、网络合并、拆分以及能量平衡。你专注于机器逻辑；HyVoltz 处理"导线"。整个网络作为一个整体单元被处理。

核心特性

  • 即席网络：网络根据相邻关系自动形成和解散。
  • 刻优化：每个刻每个网络仅解决一次能量分配，而非每个方块。
  • 侧面敏感：你可以精确控制方块的哪些侧面可以输入或输出能量。
  • 实现无关：没有"电压"或"数据包"。仅使用代表 HyVoltz 或 HV 的简单长整型数值。

HyVoltz 不做什么

  • 无电缆：你只需实现自己的电缆方块（它们只是 CONNECTOR 节点）。
  • 无持久化：网络仅在运行时存在。你需要自行将机器的缓冲区保存到 NBT/组件存储中。
  • 无视觉效果：所有渲染由你控制。

使用示例

// 在你的 BlockComponent 中
HyVoltzNodeComponent powerNode = new HyVoltzNodeComponent(new MyGeneratorNode());

// 当方块放置/加载时附加
powerNode.attach(world.getUuid(), blockPos);

// 在你的刻循环中，逻辑会自动运行
// HyVoltz 将能量从生产者移动到消费者