Releases · MineExplorer/IC_Libraries

23 Apr 00:17

MineExplorer

energy-net-v13

c48d8a1

EnergyNet lib v13 Latest

Latest

Fixed bug that skipped conductor tiles for energy packets with split transfer mode

Assets 4

18 Apr 13:14

MineExplorer

energy-net-v12

6428c92

EnergyNet lib v12

Overview

The library got a major architectural overhaul, introducing a proper wire connections graph structure, smarter energy distribution, a generator output buffer and in-game debug mode, while maintaining backwards compatibility.

Breaking Changes

canExtractEnergy in the EnergyTile interface is deprecated and replaced with canEmitEnergy.
Added getFreeEnergyAmount() and isGenerator() methods to the EnergyTile interface.
EnergyTileRegistry.machineIDs and isMachine() have been removed.
EnergyGridBuilder.onWireDestroyed and rebuildForWire have been removed; wire destruction is now handled internally by the grid via removeCoords.

Bug Fixes

Fixed packet transfer in mixed-type grid connections. EnergyGrid.receiveEnergy() now automatically converts incoming packets of a different energy type.
Deferred node removal to prevent modification of the node list during its iteration.
Removed excessive recursion branching during energy packet transfer, each node connection is iterated only one time.

New Features

Block Graph Architecture

The flat wires coordinate list BlockCoordsData has been replaced with a proper adjacency graph. Each wire block is now represented by a BlockNode that tracks directed links to neighboring wire blocks and tile entity nodes. This enables accurate grid integrity checks and correct splitting without full grid rebuild.

Generator Output Buffer

Tile entities that return true from isGenerator() get an energy buffer that stores one packet of energy for each connected grid. It allows to accumulate energy from multiple generators in the grid and send it via one packet, significantly reducing algorithm time complexity.

TransferMode Enum

Energy packets now carry a TransferMode:

Split (default) — queries getFreeCapacity() on all receivers, filters to active ones, and distributes energy evenly sorted by available capacity.
Full — dumps all energy into the first available receiver in order.

TrasnferMode can be set in addPacket() or defaultTransferMode property in EnergyNode.

Idle Grid Cleanup

Wire grids with no active entries or receivers auto-destroy after 200 idle ticks (~10 seconds), freeing memory from disconnected wire segments.

In-Game Debug Mode

A new debug system can be toggled with the chat command /enet debug on|off. When enabled:

Wire grid creation and removal is logged to chat.
A HUD tip shows average TPS, mean energy tick duration, and peak tick duration over a rolling 20-tick window.

New API

EnergyTypeRegistry.createWireGrid(blockID, blockSource) — factory method for creating a grid instance from a registered wire ID.
EnergyNet.debugEnabled — readable flag.
BlockNode and EnergyTileNode are now exported from the library.