node graph

A reusable node graph editor library and evaluation engine.

NodeGraph

Maven Central

A reusable node graph editor library and evaluation engine for Minecraft Forge 1.20.1.

Node editor: nodes with a header, typed input/output ports, and input widgets (text / slider / button-group / dropdown)
Type system: per-type colors, registry, automatic conversion rules (rendered with a warning)
Evaluation engine: lazy Blender-style evaluation with cycle detection and per-run caching
Canvas: pan / zoom / scroll, grid, embeddable NodeGraphWidget
Node groups: wireframe boxes, drag-to-regroup, resize handle, per-group scale
Editing: box-select, right-click context menu, copy / cut / paste, full undo/redo, keyboard shortcuts (Ctrl+C/X/V, Del, Ctrl+Z / Ctrl+Shift+Z)
Add node: searchable overlay; dragging a port to empty space opens a type-filtered menu with auto-connect
Live results: output ports display their evaluated value each frame; widget edits recompute downstream instantly

Gradle (Forge 1.20.1 mod consumers use fg.deobf):

repositories {
    mavenCentral()
}

dependencies {
    implementation fg.deobf('io.github.tt432:nodegraph:1.0.0')
}

Obtain the Node Graph Editor item from the Tools creative tab.
Right-click to open the editor.
Drag from an output port to an input port to connect them — same type only, or auto-convert (shown with an orange warning).
Right-click the canvas → Add Node... to insert from the catalog; drag a port onto empty space for a type-filtered menu that auto-connects the new node.
Click a text input widget to edit its value; downstream results recompute live.
Middle-drag to pan, Ctrl+scroll to zoom, left-drag empty space to box-select.