How nodes work
In Forge you never edit a model directly. Instead you describe how to build it, as a chain of small steps called nodes: make a box, raise panels on it, round its edges, paint it. Forge runs the chain and shows you the result, and when you change any step, everything after it updates on its own.
If you write code, a node will feel familiar: it is a function. Geometry comes in, its parameters are the arguments, and new geometry comes out. A graph is those functions chained together. Like a pure function, a node never changes its input; it hands a new result on to the next node.
What a node is
Section titled “What a node is”A node does one job. On the canvas it is a small box with three parts:
- Inputs: the pins where geometry comes in from other nodes. A node that makes geometry from nothing, such as Box, has none. Some inputs are optional, and the node works without them.
- Output: the pin where the node’s result comes out. Every node has exactly one, and you can wire it into as many other nodes as you like.
- Parameters: the node’s settings, such as how big a bevel is or how many edge loops to cut. Select a node to see them in the parameter panel, and hover a parameter’s name to read what it does.
The colored bar along the top of a node shows its family, in the same color as its section of the add-node menu. Every node’s page in this reference lists its inputs, output and parameters; Bevel is a good example.
What flows between nodes
Section titled “What flows between nodes”Wires carry geometry from one node’s output to another node’s input. Every pin has a type, and its color tells you which:
- Mesh: a 3D surface, made of points joined into faces. Most nodes take a mesh and give one back. A model you load with the Import node is a mesh too, and a mesh is what you export to your game engine.
- Curve: a line or path through space, with no surface. Draw one with the Curve node, then sweep a shape along it, fill it into a flat face, or place copies along it.
A few nodes, such as Transform and Mirror, work on more than one type: they give back the same type you wire in. Their pins are blue, like a mesh.
Three rules decide what can connect:
- A wire only joins pins of matching types, so a curve cannot go into a node that needs a mesh. The editor will not let you drop it there.
- Each input takes one wire. Wiring into an input that already has one replaces the old wire.
- One output can feed many inputs, so a single shape can branch into several versions.
From nodes to a workflow
Section titled “From nodes to a workflow”A workflow is a chain of nodes, read along the wires from first to last. Each node picks up the result of the one before it, does its job, and passes its own result on. Forge calls running a node cooking. Here is a simple crate:
- Box
Start with a box.
- Extrude Faces
Raise a panel on every side.
- Bevel
Soften the sharp edges.
- Smart UV
Unwrap it, ready for paint.
- Paint Fill
Paint it.
The add-node menu groups nodes by what they do, so you can find one by the job you have in mind: Create a starting shape, Model it, Deform its surface, then Texture it. The other families (Curve, Arrange, Topology and Utility) fit in anywhere.
See any step
Section titled “See any step”The viewport shows one node’s result at a time: the node whose display flag is on, the blue strip down its right edge. Click another node’s display flag to see the chain at that step, for example to check the shape before the bevel. To keep a second result in view, click its pin flag, just left of the display flag; each click cycles it through a solid mesh, a wireframe, both, and off.
Change your mind at any time
Section titled “Change your mind at any time”Every step stays editable. Go back to the Box and make it taller, and the panels, the bevel, the UVs and the paint all follow, with nothing to redo by hand. Only the nodes that lead to what you are viewing cook, and steps you did not change are reused, so edits stay quick.
Branch and combine
Section titled “Branch and combine”A graph does not have to be a straight line. Wire one output into two nodes to try two versions side by side. Nodes with more than one input bring chains back together: Merge puts several meshes into one, Boolean cuts one shape out of another (or joins them), and Extrude Along Curve runs a profile curve along a path curve.
Work on part of a mesh
Section titled “Work on part of a mesh”Many nodes can act on just part of a mesh. Name the part with a Selection node, for example “every face pointing up” or “these three edges”. The name then travels with the mesh through the wires, with no extra wire to draw. Any later node with an Apply to setting, such as Bevel, Extrude Faces, Noise or Delete, can pick that name and work only there.
Warnings
Section titled “Warnings”A node that cooked but wants your attention (say, it looks for a selection name that no longer exists) shows an amber ! badge. Hover the badge to read why.
Export
Section titled “Export”When the model is done, wire it into an Export node. It saves the mesh as a .glb file for Unity, Unreal, Godot or any engine that reads glTF, overwriting the same file each time you export.
Building a graph
Section titled “Building a graph”- Add a node: right-click an empty spot on the canvas and type its name.
- Wire two nodes: drag from one node’s output pin to another node’s input pin.
- Put a node into an existing wire: right-click the wire.
- Cut a wire: hold Alt and click it.
- See every shortcut: Help ▸ Commands.
Node families
Section titled “Node families”Every node has its own page, grouped into the same nine families as the add-node menu:
- Create (geometry from nothing): Blockout, Box, Ball, Grid, Curve, Reference Figure.
- Curve (take a curve in): Extrude Along Curve, Fill Curve, Trim Curve, Curve Points.
- Model (hand-modeling edits): Extrude Faces, Bevel, Loop Cut, Delete, Separate Pieces, Boolean.
- Deform (move points, keep the structure): Noise, Inflate, Ray.
- Arrange (move, copy and combine whole objects): Transform, Mirror, Merge, Place at Points.
- Topology (change the polygons, not the shape): Subdivide, Remesh, Clean, Fill Holes, Normals, Polyreduce.
- Texture (UVs, paint and bake): Smart UV, Auto Unwrap, Pack UVs, Paint Fill, Paint Masked, Clean Color Edges, Remove Color, Procedural Height Map, Bake.
- Character (rig, animate and texture characters): Character Seams, Auto Rig, Add Animation, Hair Guides, Hair Physics.
- Utility (plumbing): Selection, Portal, Import, Export, Engine Output, Unreal Engine Output.