mroxso/artcraft-skills

materialcraft

Build and edit node-based procedural PBR materials, graphs, and texture exports or automate the MaterialCraft application using its control protocol, MCP bridge, or headless CLI.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/mroxso/artcraft-skills --skill materialcraft

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

MaterialCraft

Operate MaterialCraft through its structured automation interface. Preserve the user's requested material workflow and target graph.

Protocol reference

Read the relevant sections of references/control-protocol.md before constructing calls. This is the downloaded upstream protocol, captured on 2026-11-11.

Source: MaterialCraft control protocol.

Useful sections: the Methods table (which methods are headless-only vs app-only), Key commands, Node library, Linked packages, 3D material assignment, Function graphs, and Portable materials (TextureCraft). Relative links inside the downloaded document refer to upstream documentation; resolve them against https://github.com/storytold/materialcraft/blob/main/docs/ when needed. The document lists key commands, not the full library of 227 nodes: discover node definitions and parameters at runtime with library.list / command.list instead of inventing IDs.

Locate the executables

materialcraft and materialcraft-cli may not be on PATH even when MaterialCraft is installed. Discover them before assuming anything is missing, and never invent a path — search for it:

  1. PATH: command -v materialcraft materialcraft-cli (POSIX) or where materialcraft materialcraft-cli (Windows).
  2. macOS: look for MaterialCraft.app in /Applications and ~/Applications, or run mdfind -name MaterialCraft.app; the binary inside Contents/MacOS/ is the desktop app.
  3. Linux: AppImage, Flatpak, deb/rpm, or tarball installs; the CLI may be a separate download.
  4. Built from source: cargo run --release -p materialcraft and cargo run --release -p materialcraft-cli -- ….

Select the session

  • For a user's open package or visible application, use a MaterialCraft MCP bridge (materialcraft-cli mcp --bridge <port>) or the app's control channel (materialcraft --control <port>). A headless session has its own in-process workspace and cannot edit the user's live window.
  • For unattended file processing, use headless MCP (materialcraft-cli mcp --read-root DIR --write-root DIR) or the JSON-lines server (materialcraft-cli serve), on stdio or 127.0.0.1:<port> behind a token.
  • Discover available MaterialCraft tools and installed executables first. If the required connection or executable is missing, report the concrete prerequisite; creating this skill does not install MaterialCraft or register an MCP server.

The control channel requires an auth request first on every connection: token from MATERIALCRAFT_CONTROL_TOKEN or the file <temp>/materialcraft-control-<port>.token. Then one JSON object per line, {"id", "method", "params"}; match replies by id and check ok. Set MATERIALCRAFT_NO_PREFS=1 for scripted runs so the user's layout is left alone. Keep TCP on loopback and credentials in a private token file; do not print, commit, or expose tokens in command arguments.

Inspect, edit, and verify

Inspect before editing: session.inspect returns the package, graphs, the open graph's nodes (def, params, bindings, base, ports, cook error/size/mean/ms), wires, frames, exposed inputs, views, and history. In the app, ui.inspect adds the graph view rectangle, per-node screen rectangles, and per-port screen positions. Discover command and node IDs with command.list {filter?} and library.list {filter?, category?}.

Build graphs with file.new {template?, name?, size?} (templates: empty, pbr, bricks, stone_tiles, wood, rusty_metal, fabric, ground), graph.node.add {def, at?, params?, connectFrom?, label?}, graph.connect / graph.disconnect, and graph.node.param {id?, param, value}. Parameter values are typed: numbers, [x, y], "#rrggbb", enum index, curve [[x, y], …], gradient [[pos, color], …], or {"t": "function", "v": {...}} for a function graph driving a parameter (dynamic parameter; remove with {param, remove: true}). Set per-node cook settings with graph.node.base {sizeMode?, size?, format?, seed?, tiling?}.

Commands run programmatically and never open dialogs. Use ui.menu.invoke only when interactive menu behavior is intended. For UI gestures, ui.input {events} applies synthetic events one frame at a time using window points taken from ui.inspect (nodes, ports): move, down, up, click, doubleClick, drag, scroll, key (egui key names), text.

Verify visually and structurally: re-run session.inspect and check each node's cook error and mean output; render with view.screenshot {view: "3d"|"2d"} (app) or render {…} (headless, PNG base64 — hq: true gives the beauty render with displacement, ray-traced AO and a shadowed key light). Use view.2d / view.3d commands to point the views at a specific node, channel, or scene; view.3d.loadMesh {path} shows an OBJ/glTF/GLB mesh (scene custom).

File access and output

Headless file access is workspace-scoped by launch-time roots (--read-root / --write-root); use task-scoped roots and forward-slash relative paths within them. Do not bypass rejected paths by switching to ambient filesystem commands.

  • Packages: package.open {path} / package.save {path?} (headless); the app saves through its own menus. .mcmat files open too (their source package, on its graph).
  • Bitmaps: bitmap.import {path, name?} embeds an image as a resource.
  • Texture maps: outputs.export {dir, format?, pattern?, depth?, size?, graph?} cooks at full size and writes every output — PNG, JPEG, TGA, TIFF, BMP, WEBP, EXR or HDR at 8, 16 or 32 bits.
  • Portable materials: file.exportMaterial {path, graph?, size?, values?, inputs?} writes a .mcmat for TextureCraft; file.sendToTextureCraft {graph?} exports into TextureCraft's library folder. In the workspace sandbox, exporting a .mcmat is CLI-only: materialcraft-cli run package.mcraft file.exportMaterial '{"path": "out.mcmat", "size": 2048}'.
  • Report successful saves and exports with the exact output path and format. Do not overwrite the user's source package unless asked; save a copy under a new name.

Batches and uncertain outcomes

Use command.batch {steps} (headless) for known sequences; it stops at the first error. Batches are not transactions: earlier steps persist on failure, so inspect per-step results.

After a disconnect or any other unclear failure, run session.inspect before retrying a mutation — the command may already have completed. Stop and report unresolved state if inspection cannot determine whether replay is safe.

같은 저장소의 Skills

더 많은 Skills

모든 Skills