# mc-asset — Minecraft Pixel Asset Engine

mc-asset — Minecraft Pixel Asset Engine is a Claude Code MCP server that generates textures and validates packs for Minecraft Java Edition. It renders sprites from text character grids.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: smile-minecraft
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/smile-minecraft/mc-asset
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/mc-asset-minecraft-pixel-asset-engine

## What it does

The server turns texture creation into text manipulation: it renders sprites from `.grid` character grids, quantizes reference artwork, and compiles animation sheets alongside `.mcmeta` files. Fixed seeds and integer math guarantee identical PNG output across runs.

It also validates entire resource packs, checks texture seams, and performs lossless compression. Overwriting existing files on disk requires the `--force` flag.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mc-asset -- npx -y mc-asset
```

### Codex

**Platform CLI**
```bash
codex mcp add mc-asset-minecraft-pixel-asset-engine -- npx -y mc-asset
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mc-asset-minecraft-pixel-asset-engine": {
            "command": "npx",
            "args": [
                "-y",
                "mc-asset"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mc-asset-minecraft-pixel-asset-engine": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mc-asset"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mc-asset-minecraft-pixel-asset-engine npx -y mc-asset
```

## When to use it
- render 16x16 sprites from text character grids
- generate nine material variants from a single base item
- compile animated sprite sheets and `.mcmeta` files
- validate resource packs and check texture seams before release

## Example prompts
- Generate a 16x16 iron sword texture from a character grid using mc-asset
- Create nine material variants for this pickaxe sprite
- Run validate-pack to check the resource pack for texture errors

## Similar
- [minecraft-imagegen](https://affpapa.org/en/nevibecode/skills/minecraft-imagegen.md) — skill · 213 installs
- [asset-pipeline](https://affpapa.org/en/nevibecode/skills/asset-pipeline.md) — skill · 2000 installs
- [minecraft-resource-pack](https://affpapa.org/en/nevibecode/skills/minecraft-resource-pack.md) — skill · 385 installs
- [game-asset-generation](https://affpapa.org/en/nevibecode/skills/game-asset-generation.md) — skill · 610 installs
- [layer-pixel-art](https://affpapa.org/en/nevibecode/skills/layer-pixel-art.md) — skill · 5100 installs
- [pixel-art-sprites](https://affpapa.org/en/nevibecode/skills/pixel-art-sprites.md) — skill · 3300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
