Node Graph Toolkit
Node Graph Toolkit is LDLib2's framework for building in-game graph editors.
It provides the graph data model, node and port definitions, wires, variables, subgraphs, a blackboard, editor panels, undoable commands, and resource-backed graph editing.
Main Pieces
Graph is the user-facing definition. It decides which node classes and types are supported.
GraphModel stores the actual graph state: nodes, ports, wires, variables, subgraphs, placemats, sticky notes, and change tracking.
GraphEditorView is the recommended editor UI entry. It wraps GraphView, adds save handling, dirty state, breadcrumbs, and subgraph dive support.
GraphView is the lower-level graph canvas and panel host. Use it directly only for embedded or test UIs that do not need the full editor workflow.
GraphResource integrates graph assets into the LDLib2 Editor resource system.
Chapter Map
Getting Started builds a small graph and opens it through GraphEditorView.
Graph Definition covers Graph, GraphNodeRegistry, supported nodes, supported types, and validation hooks.
Nodes and Ports covers Node, node options, input/output ports, orientation, and previews.
Variables and Blackboard covers graph variables, blackboard usage, variable inspectors, and subgraph input/output ports.
Type Handles covers TypeHandle, built-in types, custom type registration, constants, default values, icons, colors, and configurators.
GraphView covers the low-level graph UI used by GraphEditorView.
Editor Resources covers GraphResource, GraphEditorView, save callbacks, and resource-panel editing.
Subgraphs covers local and external subgraphs.
Context and Block Nodes covers context nodes that own ordered block lists.
Commands and Customization covers command interception, capabilities, diagnostics, and UI customization points.
Glossary defines the common model and UI terms.