Commands

texturescript COMMAND --help prints the same information. Relative paths inside .stages and scene files are relative to that file.

Common behaviour

• --json prints machine-readable JSON instead of text, on every command that has it.
• Refusals. A broken input is refused with REFUSED file:line: reason (or file:line:col) and exit status 1. Nothing is written.
• Global flags: --help/-h, --version/-v, --completions bash|zsh|fish|sh and --log-level.
• Vanilla blocks. view, shoot, mcp, fetch and jar take --jar PATH to choose a client jar instead of the newest one found; view, shoot and mcp also take --no-jar to draw only your own blocks.

palette

Derives each material's shades from a dark and a light anchor.

texturescript palette [flags] FAMILY.palette

Prints the palette section to paste into grids. Comment lines place each material's anchors against the vanilla envelope and warn when they fall outside. Refuses anchors closer than 15 OKLab lightness units. Format: Palette files.

grid

Renders a character grid.

texturescript grid [flags] SPEC.grid OUT.png

Writes OUT.png, a ×16 preview OUT_x16.png and the grid as ASCII in OUT.txt. Format: Grid files.

lint

Checks a texture against conventions measured on vanilla.

texturescript lint [flags] TEXTURE.png

Exits 1 when any rule fails. Rules: Lint rules.

stages

Generates a crop's growth stages and lints each one.

texturescript stages [flags] CROP.stages OUT_DIR

Writes OUT_DIR/stageN/ with each half's grid, PNG, preview and ASCII, and OUT_DIR/strip.png with every stage side by side. Exits 1 when a stage fails lint; the rendered outputs stay for inspection. Refuses to write next to stale outputs from a run with more stages or halves. Format: Stages files.

view

Opens a live 3D view of a scene that updates when you save.

texturescript view [flags] SCENE.toml

In the browser: drag to orbit, scroll to zoom, keys 1 to 9 pick a variant, v cycles variants, l toggles labels. The view follows edits to the scene and to every grid, palette and map it uses. Format: Scene files.

shoot

Screenshots a scene from one or more angles and variants, in one browser.

texturescript shoot [flags] SCENE.toml OUT.png

Writes one shot, or a labelled sheet with one row per variant and one column per camera. Needs a Chromium; see Environment.

sheet

Builds a labelled contact sheet of upscaled textures.

texturescript sheet [flags] OUT.png [FILES_OR_DIRS...]

diff

Compares a texture with the one it should match.

texturescript diff [flags] RENDERED.png TARGET.png

Prints the mismatch count, split into missing, extra and wrong-colour pixels, and a map of them.

togrid

Converts a PNG to an editable grid, letters ordered darkest first.

texturescript togrid [flags] IMAGE.png OUT.grid

skill

Prints where the authoring skill is, or exports it to a folder without game textures.

texturescript skill [flags] [OUT_DIR]

mcp

Serves render, lint and shoot and the skill to agents over MCP on stdio.

texturescript mcp [--jar PATH | --no-jar]

Tools and resources: MCP server.

fetch

Extracts the skill's vanilla reference examples from your own client jar.

texturescript fetch [flags]

Refuses to write anywhere git would track the files.

jar

Prints the Minecraft client jar TextureScript reads vanilla blocks from.

texturescript jar [--jar PATH]