ase-deliver

Sin .aseprite no hay entrega. AseDeliver es la capa de compilación que falta entre «la IA ha dibujado una imagen» y «el juego puede usarla».

El modelo de imagen puede cambiar. El contrato de entrega no.

Demostración

El ejemplo del slime es un resultado de 32×32 dibujado por la propia herramienta (contorno, cuatro niveles de luz y sombra, idle / walk / jump), ya verificado abriéndolo con el Aseprite 1.3.18.2 oficial.

Ver la página completa (imágenes grandes + animaciones): ylty1516.github.io/ase-deliver

Related MCP server: Aseprite-MCP

Qué produce

Cómo lo usa cualquier IA

1. init un proyecto plantilla

2. brief — dibuja según los nombres de archivo que lista (cualquier modelo, o ASCII)

3. Coloca los archivos en raw/

4. build

5. El deliverable de validate debe ser true

6. open en Aseprite

El contrato completo está en AGENTS.md. Grok / Claude / Cursor / Codex pueden leer directamente este archivo.

git clone https://github.com/ylty1516/ase-deliver.git
cd ase-deliver
py -3 -m venv .venv
.venv\Scripts\python.exe -m pip install -r requirements.txt

ase-deliver.bat demo --out examples\slime --open
ase-deliver.bat init hero --template character-platformer --desc "side-view fox knight"
ase-deliver.bat brief hero
ase-deliver.bat build hero

Linux / macOS:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
PYTHONPATH=. python -m ase_deliver demo --out examples/slime

Plantillas

MCP

Cualquier cliente MCP:

{
  "mcpServers": {
    "ase-deliver": {
      "command": "python",
      "args": ["-m", "ase_deliver", "mcp"],
      "env": { "PYTHONPATH": "/path/to/ase-deliver" }
    }
  }
}

Herramientas: init_project · generation_brief · paint_cel · build · validate_sprite · open_in_aseprite

Reglas estrictas (para el modelo)

• Sujeto aislado, fondo #FF00FF o transparente, sin suelo, sombras, marcas de agua ni texto

• Postura de pie con los pies tocando el borde inferior del lienzo

• Mismo personaje entre fotogramas: proporción, colores y pivot fijos

• Las animaciones en bucle deben poder hacer loop

• No inventes nombres de archivo; usa los del brief

Sin modelo de imagen:

{ "map": { ".": null, "#": "#63c74d" }, "rows": ["....", ".##.", ".##.", "...."] }

ase-deliver paint <project> --tag idle --frame 0 --file pixels.json

Licencia

MIT