ArtCraft

MaterialCraft icon: an engraved rhino on a teal tile

MaterialCraft

Procedural materials; an open-source, node-based material designer, built in pure Rust.

Build procedural materials from primitives and functions in a node graph, watch them update live in 2D and on a 3D model, and export the maps for any engine. It runs natively on macOS, Windows, Linux and FreeBSD, and in the browser via WebAssembly. Built by the ArtCraft team.

Status: in active development Written in pure Rust Runs on macOS, Windows, Linux, FreeBSD and the web MCP server for agents License: MIT OR Apache-2.0
Scanned by SonarCloud Reviewed by CodeRabbit

Join the ArtCraft community on Discord

MaterialCraft on getartcraft.com · ArtCraft · All Crafting Apps


The MaterialCraft workspace: the explorer and node library on the left; a brick wall material as a node graph with live thumbnails in the middle, over a 3D view of a rounded cube in red brick and a 2D view of the base color; the brick generator's parameters on the right
The workspace: explorer, library, node graph, 3D view, 2D view and properties

> [!NOTE] > **ArtCraft is a community of artists from all walks of life.** Painters, sculptors, game > artists, material and texture artists, photographers, filmmakers, illustrators, designers, > hobbyists, and people who picked up a stylus last week. If you make things, you belong here. > **[Come say hi on Discord](https://discord.gg/artcraft).**

A look around · Made in MaterialCraft · Why MaterialCraft · Quick start · Status · Downloads · The Crafting Apps · License

## A look around These screenshots show the earlier procedural library. The current build uses the primitive catalog described in [the primitive workflow](docs/atomic-workflow.md).
A wood planks graph: anisotropic noise warped by Perlin noise and multiplied over a plank pattern, shown on the rounded cube and in the 2D view

Wood planks: anisotropic grain, warped and laid over planks

A lava rock graph: Voronoi plates with cracks and glowing seams, as dark rock with orange emissive cracks on the rounded cube

Lava rock: cracked plates over glowing emissive seams

The New graph dialog: template spheres for empty, PBR, brick wall, stone tiles, wood planks, painted metal plates, rusty metal, lava rock, polished marble, wicker weave, woven fabric and mossy ground, with the graph name and size

New graph: start from a PBR template or a sample material

A mossy ground graph: stones height-blended with dirt and moss grown in the crevices, on the rounded cube and in the 2D view

Mossy ground: stones and dirt height-blended, with moss in the gaps

## Made in MaterialCraft These historical renders used the former Rust library and are no longer bundled as templates. They were built from its own procedural nodes (no photos, scans or textures from anywhere else) and rendered by `materialcraft-cli render --scene sphere --full --hq` (the height output displaces the mesh, with ray-traced ambient occlusion and a shadowed key light).

Eight material spheres: red brick, lava rock with glowing cracks, blue painted metal plates with rivets, wood planks, wicker weave, mossy ground, cracked stone tiles and polished white marble

Brick wall · Lava rock · Painted metal plates · Wood planks
Wicker weave · Mossy ground · Stone tiles · Polished marble

## Why MaterialCraft - **Familiar.** The layout, panels, menus and gestures material artists already know: a package explorer, a library of nodes with previews, the node graph with live thumbnails, a 3D view, a 2D view and a properties panel with base and specific parameters (Levels is edited over a histogram of its input, see [docs/levels-editor.md](docs/levels-editor.md)). Space opens the node search. - **Fast.** Every node cooks on every CPU core, and a content-addressed cache means an edit re-cooks only what lies downstream. Cooking runs on a worker thread, so the UI never waits. - **Tileable by design.** Noises and patterns live on whole-number lattices, so everything tiles seamlessly at any resolution, from 16 px to 8K. - **Robust.** No panics in shipped code, every command tested with hostile input, every node cooked with odd inputs in tests, undo from snapshots, and native SBS project files. Save `.sbs` with an adjacent `resources/` folder, or a self-contained `.mcraft` ZIP with `package.sbs` and `resources/`. - **Open.** Export base color, normal, roughness, metallic, height and ambient occlusion as PNG, JPEG, TGA, BMP, WEBP, EXR or HDR at 8, 16 or 32 bits, with your own file name pattern. - **Works with TextureCraft.** **File ▸ Send to TextureCraft** puts a material on TextureCraft's shelf as a portable `.mcmat`; painted onto a mesh there, its graph inputs stay live sliders and colors, re-cooked by MaterialCraft at the texture set's resolution with the mesh's baked maps feeding the graph's input nodes. - **Agent-native.** Every menu item and edit is a command you can drive from the CLI, a JSON control channel (including synthetic mouse and keyboard input) or an **MCP server**, so Claude and other agents can build materials the way a person does. - **Everywhere.** One codebase for the desktop apps and the same UI in the browser. ## Quick start ```sh git clone https://github.com/storytold/materialcraft cd materialcraft cargo run --release -p materialcraft # desktop app cargo run --release -p materialcraft -- package.sbs # open an SBS package cargo run --release -p materialcraft -- --control 7878 # + JSON control channel cargo run --release -p materialcraft-cli -- mcp # MCP server (stdio) cargo run --release -p materialcraft-cli -- new wood wood.sbs cargo run --release -p materialcraft-cli -- render wood.sbs wood.png --scene sphere --full --hq cargo run --release -p materialcraft-cli -- export wood.sbs textures --format png --depth 16 cargo run --release -p materialcraft-cli -- export my.sbs out --set wear=0.7 # with a graph input "wear" set first cargo run --release -p materialcraft-cli -- run my.sbs file.exportMaterial '{"path": "my.mcmat", "size": 2048}' # for TextureCraft cd apps/materialcraft-web && trunk serve # web build cargo xtask ci # fmt, clippy, tests, layering, wasm ``` You need Rust 1.95 or newer. The app opens with an empty graph in a new package; **File ▸ New ▸ Graph...** starts from a PBR template or one of the sample materials. ### Use it from Claude Code and other agents Register the MCP server with Claude Code, giving it the folders it may read and write: ```sh claude mcp add materialcraft -- /path/to/materialcraft-cli mcp --read-root /work/materials --write-root /work/materials ``` To drive the running app instead, start it with `--control 7878` and bridge to it: ```sh claude mcp add materialcraft-app -- /path/to/materialcraft-cli mcp --bridge 7878 ``` The details are in [`docs/control-protocol.md`](docs/control-protocol.md). ## Status MaterialCraft is under active development. [**ROADMAP.md**](ROADMAP.md) has the parity estimate by area, the remaining work and what's next. **Current focus (2026-11-16):** node behavior, regression coverage and SBS save/load. The old Rust procedural library has been removed. The replacement includes 29 main-graph entries, 85 function operations and four pattern node kinds. Start with **File → New → Atomic sample**. See [the primitive workflow](docs/atomic-workflow.md) for usage, validation scope and limitations. The [catalog status](docs/node-catalog-parity.md) records implemented behavior and remaining work. Full numerical compatibility and arbitrary SBS interoperability remain unestablished. **Workspace:** `crates/{core, geom, nodes, eval, formats, engine, render, automation, ui-egui}` and `apps/{materialcraft, materialcraft-cli, materialcraft-web}`. The egui frontend is its own crate, so the UI can be swapped without touching the engine; [`docs/architecture.md`](docs/architecture.md) explains how it fits together. Agent and contributor rules (clean room, the asset policy, no panics in shipped code, quality gates) are in [`AGENTS.md`](AGENTS.md). Every bundled asset is listed with its licence in [`ATTRIBUTION.md`](ATTRIBUTION.md). ## Downloads **New to MaterialCraft?** Download it from the [MaterialCraft page on getartcraft.com](https://getartcraft.com/apps/materialcraft). That's the easiest way to install it. **Want a specific build or format?** On GitHub, the [latest release](https://github.com/storytold/materialcraft/releases/latest) has every build listed below, and [all releases](https://github.com/storytold/materialcraft/releases) has earlier versions and their notes. `` in the file names is the version number, and `SHA256SUMS.txt` lists a checksum for every file. ### Windows | Build | Installer | Portable | |---|---|---| | x64 (64-bit Intel/AMD) | `materialcraft--windows-x64.msi` | `materialcraft--windows-x64-portable.zip` | | arm64 (Snapdragon and other ARM PCs) | `materialcraft--windows-arm64.msi` | `materialcraft--windows-arm64-portable.zip` | | x86 (32-bit) | `materialcraft--windows-x86.msi` | `materialcraft--windows-x86-portable.zip` | ### macOS | Build | File | Notes | |---|---|---| | App, universal (Apple silicon + Intel) | `materialcraft--macos-universal.dmg` | Signed and notarized | | Command-line tool, universal | `materialcraft-cli--macos-universal.zip` | Signed and notarized | ### Linux | Format | x86_64 | aarch64 (ARM64) | Notes | |---|---|---|---| | AppImage | `materialcraft--linux-x86_64.AppImage` | `materialcraft--linux-aarch64.AppImage` | Runs anywhere; updates itself with [AppImageUpdate](https://github.com/AppImageCommunity/AppImageUpdate) (`.zsync` files) | | Flatpak | `materialcraft--linux-x86_64.flatpak` | `materialcraft--linux-aarch64.flatpak` | Sandboxed; `flatpak install --user ` | | Debian/Ubuntu | `materialcraft--linux-x86_64.deb` | `materialcraft--linux-aarch64.deb` | | | Fedora/RHEL/openSUSE | `materialcraft--linux-x86_64.rpm` | `materialcraft--linux-aarch64.rpm` | | | Tarball | `materialcraft--linux-x86_64.tar.gz` | `materialcraft--linux-aarch64.tar.gz` | Unpack anywhere | ### FreeBSD | Build | File | |---|---| | x86_64 | `materialcraft--freebsd-x86_64.tar.gz` | ### Web (WebAssembly) | Build | File | Notes | |---|---|---| | Static site | `materialcraft-web-.zip` | Runs in a modern browser; host it on any static server | ## The Crafting Apps MaterialCraft is one of the **Crafting Apps**: free, open-source creative tools from the [ArtCraft](https://getartcraft.com/) team, each written from scratch in Rust and each able to stand on its own. | | App | What it's for | Code | Learn more | |:-:|---|---|---|---| | | **PhotoCraft** | Image editing: layers, masks, type and real PSD files | [GitHub](https://github.com/storytold/photocraft) | [Website](https://getartcraft.com/apps/photocraft) | | | **VectorCraft** | Vector illustration | [GitHub](https://github.com/storytold/vectorcraft) | [Website](https://getartcraft.com/apps/vectorcraft) | | | **TextureCraft** | 3D texture painting | [GitHub](https://github.com/storytold/texturecraft) | [Website](https://getartcraft.com/apps/texturecraft) | | | **MaterialCraft** | **Procedural materials with node graphs · you are here** | [GitHub](https://github.com/storytold/materialcraft) | [Website](https://getartcraft.com/apps/materialcraft) | | | **FilmCraft** | Video editing, color and sound | [GitHub](https://github.com/storytold/filmcraft) | [Website](https://getartcraft.com/apps/filmcraft) | | | **LightCraft** | Photo library and raw development | [GitHub](https://github.com/storytold/lightcraft) | [Website](https://getartcraft.com/apps/lightcraft) | | | **PdfCraft** | Reading, organizing and protecting PDFs | [GitHub](https://github.com/storytold/pdfcraft) | [Website](https://getartcraft.com/apps/pdfcraft) | | | **EffectCraft** | Motion graphics and visual effects | [GitHub](https://github.com/storytold/effectcraft) | [Website](https://getartcraft.com/apps/effectcraft) | | | **DesignCraft** | Page layout and publishing | [GitHub](https://github.com/storytold/designcraft) | [Website](https://getartcraft.com/apps/designcraft) | | | **GridCraft** | Spreadsheets and data | [GitHub](https://github.com/storytold/gridcraft) | [Website](https://getartcraft.com/apps/gridcraft) | And [**ArtCraft**](https://getartcraft.com/) itself, our AI image and video studio for artists who want real control.

Join the ArtCraft community on Discord

Come make things with us

Our Discord is where artists of every kind hang out: people who paint, sculpt, model, build materials, shoot, draw, cut film, set type, and people still figuring out what they like to make. Share what you're working on, ask for help, tell us what's broken, or tell us what you wish these tools could do. Whatever your medium and however long you've been at it, you're welcome here.

discord.gg/artcraft · getartcraft.com · The Crafting Apps · MaterialCraft

## Star history [![Star History Chart](https://api.star-history.com/svg?repos=storytold/materialcraft&type=Date&legend=top-left)](https://www.star-history.com/?repos=storytold%2Fmaterialcraft&type=date&legend=top-left) ## License and credits MaterialCraft is dual-licensed under [MIT](LICENSE-MIT) or [Apache-2.0](LICENSE-APACHE), at your option. Copyright (c) 2026 ArtCraft Team and the MaterialCraft contributors. Required notices are in [NOTICE](NOTICE). Bundled icons, images and other assets keep their own open licenses; each one is listed with its author, source and license in [ATTRIBUTION.md](ATTRIBUTION.md). Every material, noise, pattern, environment, library preview and mesh shown is generated procedurally by MaterialCraft itself; no third-party textures, scans or models appear in the screenshots. MaterialCraft is an independent, clean-room implementation of a node-based procedural material workflow and is not affiliated with any other software vendor. The app icon (an engraved rhino on MaterialCraft teal `#178a9c`) is original artwork made for this project by its owner; its files and notes are in [`assets/app-icon/`](assets/app-icon/). The ArtCraft name, wordmark and logos in [`docs/brand/`](docs/brand/) are trademarks of the ArtCraft Team and are not covered by this license. They may be used only unmodified, and only as part of this repository and MaterialCraft, under [`docs/brand/LICENSE-brand.txt`](docs/brand/LICENSE-brand.txt). Forks and modified versions must remove them.

Join the ArtCraft community on Discord

ArtCraft
Made by the ArtCraft team and community.