Skip to content
Craft Wiki

Workflows

On a Mac, use ⌘ in place of Ctrl in the shortcuts below.

Panel What it’s for
Explorer The open package and its graphs. Click a graph to open it
Library Every node you can add. Search it, or drag a node onto the graph
Graph Where you build the material
Properties The settings of the selected node, or of the graph
2D View One node’s result as a flat image
3D View The whole material on a shape or a model
Console Messages, warnings and errors
History Your recent changes

Open or close panels from the Windows menu. Windows › Reset layout puts them back where they started.

A package is one .sbs file. It can hold several graphs, plus the images they use.

  • File › New › Graph… adds a graph to the open package.
  • File › New › Function Graph… adds a function graph: a graph of math operations, saved in the package.
  • File › New › Empty package starts again with an empty package.
  • File › Open… opens an .sbs package, or a .mcmat material.
  • Point at the graph and press Space or Tab to search for a node. Right-click the graph for Add node and more.
  • Drag from an output port to an input port to connect two nodes.
  • Double-click a node to show it in the 2D View.
  • Select nodes and choose Tools › Create graph from selection to turn them into a graph of their own.
  • Right-click the graph to add a comment, a frame, or a navigation pin. F2 and Shift+F2 jump between pins.
  • Tools › Snap to grid turns snapping on or off.
To Do this
Zoom Scroll the wheel
Pan Middle-drag, or Alt+drag
Frame everything, or the selection F
Duplicate Ctrl+D
Copy, cut, paste Ctrl+C, Ctrl+X, Ctrl+V
Select every node Ctrl+A
Delete Delete
Delete a node and join its wires back up Backspace
Turn the selected nodes off Shift+D
Undo, redo Ctrl+Z, Ctrl+Y
  • Click a wire to select it. Shift+click or Ctrl+click selects more.
  • Press Delete to remove the selected wires.
  • Select two or more wires into a node and press X to swap where they come from. On a Blend node, this swaps the foreground and background.
  • Drag a wire to pull a reroute dot out of it. Double-click a wire to drop a dot there.
  • Right-click a wire for Insert reroute dot and the other wire commands.
  • Output nodes are what the graph makes. Give each a usage, such as base color, normal or roughness. The 3D View and the export use them.
  • Input color, Input grayscale and Input value nodes are inputs of the graph. Use them to feed in an image or a value from outside.

An exposed parameter becomes a slider or color on the graph itself, so you can tune the material without opening its nodes.

  1. Right-click a node’s parameter in Properties and choose Expose as graph input.
  2. Clear the selection to show the graph’s own Properties. The parameter is listed under Input parameters. This is also where you find Random seed and the graph’s Attributes: category, description, author and tags.
  3. To keep a look, type a Preset name and choose Save preset. The Presets list applies it again later. Delete preset removes the one named in the field.

To delete an input, use the x beside it. To feed an exposed input into another node’s parameter, right-click that parameter and choose Bind to input.

The command-line tool sets exposed inputs with --set, as shown in Use it with an AI assistant.

Pixel processor computes every pixel of its image with a function. Value processor computes one value with a function.

Select the node, then choose Edit function graph… in Properties. In the function editor you add operations, set constants, wire them up and pick the result.

An FX-Map node builds an image by placing and repeating shapes.

  1. Select the FX-Map node and press Ctrl+E (Edit › Edit node graph), or right-click it and choose Edit graph.
  2. Inside, add Quadrant, Switch, Iterate and Dot nodes. Wire them from bottom ports to top ports.
  3. Right-click a node and choose Set as root to make it the start of the pattern.
  4. Press Alt+Left (Edit › Parent graph) to go back to the main graph.

Select a Levels node. Properties shows a histogram of the node’s input, with the levels curve over it. Drag the handles under the histogram to set the input range and midtones, and the handles under the gray bar to set the output range. The sliders below give exact values.

The Levels editor in the properties panel: a histogram of the input with the levels curve over it, three input handles below it and two output handles under a black-to-white bar, with the exact sliders underneath. Screenshot from MaterialCraft 0.1

Choose File › Import bitmap… to add an image to the package. MaterialCraft reads SVG, PNG, JPEG, TGA, TIFF, BMP, WebP, OpenEXR and Radiance HDR. Use it in the graph with a Bitmap or SVG node. File › Reload resources reads the files again after you change them.

In the 2D View, show one channel (R, G, B or A) or all of them, turn on a histogram, or tile the image three by three to check its edges. Save image… saves what you see as PNG, OpenEXR or TGA.

The 3D View has its own menus:

  • Scene: pick a shape, load your own OBJ, glTF or GLB model with Load mesh…, or Reset scene.
  • Camera, Environment, Display and Renderer: the view, the lighting, and options such as tiling, height depth, transparency and Flip normal map Y (DirectX).

Shift+drag in the 3D View turns the lighting. Tools › View outputs in 3D view puts the graph’s outputs on the 3D model.

While you edit, previews are computed at a smaller size to stay fast. Change it in Tools › Preview size.

  • File › Export outputs… (Ctrl+Shift+E) writes every output of the graph as an image. Pick the Folder, Format, Bit depth, Resolution (up to 8192 pixels) and the File names pattern.
  • File › Export material… writes a portable .mcmat file with the maps and the graph together.

Choose Edit › Preferences… to set the language (English or Arabic), brightness, accent color, interface scale, how often to autosave, the preview size while editing, node thumbnails, and how the 3D view pans.

Help › Shortcuts list… lists every shortcut.

MaterialCraft’s command-line tool, materialcraft-cli, has an MCP server, so Claude and other AI assistants can build graphs, set parameters and export maps. Give it the folders it may read and write:

Terminal window
claude mcp add materialcraft -- materialcraft-cli mcp --read-root . --write-root .

To see its changes live, start the app with materialcraft --control 7878, then connect with materialcraft-cli mcp --bridge 7878.

The tool also works on its own. Run materialcraft-cli --help to see what it can do, for example:

Terminal window
materialcraft-cli new pbr my-material.sbs --size 2048
materialcraft-cli export my-material.sbs textures --format png --depth 16
materialcraft-cli render my-material.sbs preview.png --scene sphere
Command What it does
new <template> <out.sbs> Makes a package. The templates are empty, pbr and atomics
info <package> Lists the graphs, nodes and outputs
nodes Lists the node library. Narrow it with --filter or --category
cook <package> Computes a graph and reports the time and errors for each node
run <package> <command-id> Runs one command. Add -o out.sbs to save the result
batch <script.json> Runs a list of commands from a file
serve Takes commands as JSON lines, on stdio or on a local port

cook, export and render accept --set to give an exposed graph input a value first. Use JSON for the value:

Terminal window
materialcraft-cli export my-material.sbs textures --set roughness=0.4 --set tint="#aa7744"

render also takes --scene (rounded_cube, cube, sphere, cylinder, plane, torus or material_ball), --tiling, --view 2d --node <id> to render one node, and --hq for a finer, lit render. Where a command wants a package, sample stands for the built-in Atomic sample.

The control port needs a token, so other programs on your computer can’t drive the app. materialcraft --control 7878 writes one to a file in your temp folder, and materialcraft-cli mcp --bridge 7878 reads it. To use your own, set MATERIALCRAFT_CONTROL_TOKEN (16 to 1024 characters) before you start the app, or pass the token with --token.