Skip to content
Craft Wiki

Getting started

The quickest way is ArtCraft Launcher: install it, then press Install on MaterialCraft’s card. To download MaterialCraft on its own, see Install and update.

MaterialCraft opens with the Home window. From here you can:

  • Choose New graph to start a material.
  • Choose Open package… to open an .sbs file. From a terminal, materialcraft my-material.sbs opens it directly.
  • Open the Atomic sample under Samples, to see a small graph that uses functions and an FX-Map.
  • Pick a file under Recent.

To skip it next time, clear Show at startup. Help › Home screen… brings it back.

Choose File › New › Graph… (Ctrl+N, or ⌘N on a Mac). In the New graph window:

  1. Type a Graph name.
  2. Pick a Template. Material outputs is a good start: it adds outputs for base color, normal, roughness, metallic, height and ambient occlusion, each fed by a flat color. Empty gives a blank graph, and Atomic sample is the small example from the Home window.
  3. Pick a Size, from 256 to 4096 pixels.
  4. Choose Create.

The graph appears in the Explorer, inside the open package.

  • Point at the graph and press Space (or Tab) to search for a node by name. You can also drag one in from the Library.
  • Drag from a node’s output port to another node’s input port to connect them.
  • Click a node to change its settings in Properties.

Every node shows a thumbnail of its result. An edit only recomputes the nodes after it, so changes show up quickly.

  • Double-click a node to show it in the 2D View.
  • The 3D View shows the material from your graph’s outputs on a built-in shape. Its Scene menu changes the shape, or loads your own OBJ, glTF or GLB model with Load mesh….

Press Ctrl+S (⌘S on a Mac). MaterialCraft saves the package as an .sbs file. It also autosaves a copy in Documents/MaterialCraft/autosave.

  1. Choose File › Export outputs… (Ctrl+Shift+E).
  2. Choose a Folder.
  3. Pick a Format, a Bit depth and a Resolution.
  4. Change File names if you like. $(graph), $(identifier) and $(usage) are replaced by the graph name, the output’s name and its usage.
  5. Choose Export.
  • Workflows: wires, functions, FX-Maps, the Levels editor and more.
  • Troubleshooting: if the window doesn’t open or something looks wrong.