HyVoltz

HyVoltz is a lightweight energy network library for Hytale mods. It provides a standardized way to move power between blocks without forcing a specific gameplay mechanic or tiered system on your users.

It is not a tech mod, a machine pack, or a gameplay overhaul. It is strictly a library for developers.

The Mental Model

Think of HyVoltz as a Graph Manager. You tell it which blocks are nodes, and it handles the graph traversal, network merging, splitting, and energy balancing every tick. You focus on your machine logic; HyVoltz handles the "wires". The entire network is handled as one whole unit.

Core Features

Ad-hoc Networks: Networks form and dissolve automatically based on adjacency.
Tick-Optimized: Energy distribution is solved once per network per tick, not per block.
Side-Sensitive: You control exactly which sides of your block can input or output power.
Implementation Agnostic: No "voltage" or "packets". Simple long values representing HyVoltz or HV.

What HyVoltz Does NOT Do

No Cables: You simply implement your own cable blocks (they are just CONNECTOR nodes).
No Persistence: Networks are runtime-only. You must save your machine's buffer to NBT/Component storage yourself.
No Visuals: You control all rendering.

Usage Example

// In your BlockComponent
HyVoltzNodeComponent powerNode = new HyVoltzNodeComponent(new MyGeneratorNode());

// Attach when block is placed/loaded
powerNode.attach(world.getUuid(), blockPos);

// In your tick loop, logic runs automatically
// HyVoltz moves power from Producers -> Consumers

Hy-Voltz