mc-asset

English | 繁體中文 | 简体中文

mc-asset is a texture and model tool for Minecraft Java Edition resource packs, built for both creators and AI agents over the command line (CLI) or MCP.

Language models can't place pixels by eye, so mc-asset turns texture work into text and commands: draw a sprite as a character grid, pixelize reference art, generate tiling textures, pack animation sheets, preview cuboid models, and validate a whole resource pack, from a shell or over MCP. The same input and seed always produce identical files.

Six 16×16 items, each written as a text grid and drawn by mc-asset render (shown ×6), following the vanilla style rules in the minecraft-pixel-art skill. The grids are in docs/assets/showcase/items/.

Contents

• What It Does
• Highlights
• Showcase
• Installation
• For AI agents
• Quickstart
• Practical Recipes
• MCP Server
• Command Reference
• Batch Operations (--operations)
• Architecture & Reliability Guarantees
• Development
• License

What It Does

• Draw textures from text character grids (render)
• Downsample reference art into pixel art (pixelize) and reduce colors (quantize)
• Fan one sprite out into material variants (variant)
• Generate and seam-check tiling textures (generate, tile)
• Pack animation sprite sheets and write .mcmeta files (animate, mcmeta)
• Scale GUI sprites with nine-slice borders (gui-scale)
• Compare two PNGs pixel by pixel (compare)
• Validate a single texture or a whole resource pack (validate, validate-pack)
• Losslessly compress PNGs (optimize)
• Create, validate, and preview Java block models (model)
• Author complete resource packs from declarative recipes, audit styles, catalog vanilla assets, and export reproducible zips (pack, style)
• Expose all capabilities to AI agents over an MCP server (mcp)

Highlights

• Text in, texture out. Sprites are character grids (.grid) or editable multi-layer sources (.mcpx) that build to PNG. See docs/mcpx-format.md.
• Identical output. No unseeded randomness and integer-only color blending, so PNG and .mcpx output is identical run to run and between Bun and Node.
• One engine, two front ends. The CLI and the stdio MCP server call the same core, so an agent gets the exact same result as a shell script.
• Uniform JSON output. --json always returns { success, result, error } with a stable error code, a

... View full README on GitHub