|
|
---
|
|
|
description: PixelLab MCP — генерация спрайтов для AutoHero, сохранение в репо и ключи манифеста
|
|
|
globs:
|
|
|
- frontend/assets/**
|
|
|
- frontend/public/assets/game/**
|
|
|
- frontend/src/game/assets/**
|
|
|
- docs/art-bible.md
|
|
|
- docs/pixellab-mcp-schema.md
|
|
|
---
|
|
|
|
|
|
# PixelLab AI MCP — пайплайн спрайтов
|
|
|
|
|
|
## Когда использовать
|
|
|
|
|
|
При добавлении или замене **растровой** графики сцены (тайлы, пропы, персонажи, здания как спрайты), если задача — сгенерировать PNG через подключённый **PixelLab** MCP в Cursor.
|
|
|
|
|
|
Креативная дисциплина и префикс промптов: [docs/art-bible.md](docs/art-bible.md) §1 и §8. Сверка имён инструментов и параметров: [docs/pixellab-mcp-schema.md](docs/pixellab-mcp-schema.md) и живые [PixelLab MCP docs](https://api.pixellab.ai/mcp/docs).
|
|
|
|
|
|
## Обязательное правило после генерации
|
|
|
|
|
|
1. **Сразу после успешного `get_*` (статус completed)** сохранить изображение в репозиторий под стабильным именем, согласованным с манифестом:
|
|
|
- каталог: **`frontend/assets/`** с подпапками по типу: `tiles/` (тайлы `terrain.*.vN.png`), `prop/`, `building/`, `enemies/`, `characters/`;
|
|
|
- имя файла: совпадает с контент-ключом или префиксом ключа (`terrain.grass.v0.png`, `prop.tree.v1.png`, `enemy.wolf_forest.png`, …).
|
|
|
2. **`frontend/public/assets/game/manifest.json`** — поле `file` для каждой текстуры **относительно `frontend/assets/`** (например `tiles/terrain.grass.v0.png`). Обновить манифест в том же шаге. Не оставлять ассет только по временной ссылке MCP.
|
|
|
3. Для **асинхронных** задач: вызвать `create_*`, затем периодически `get_*` по `tile_id` / `object_id` / `character_id`, пока не `completed`.
|
|
|
|
|
|
## Маппинг задач на инструменты (кратко)
|
|
|
|
|
|
- Изометрический тайл / куб / пол: `create_isometric_tile` → `get_isometric_tile` (в ответе может быть base64 PNG).
|
|
|
- Проп или высокий объект с прозрачным фоном: `create_map_object` → `get_map_object`.
|
|
|
- Герой / NPC / враг (пиксель-пайплайн): `create_character` → при необходимости `animate_character` → `get_character` (ZIP/URL — выгрузить кадры в репо).
|
|
|
- Сетки Wang / платформер: `create_topdown_tileset` / `create_sidescroller_tileset` — только если осознанно нужны для контента.
|
|
|
|
|
|
Имена в UI Cursor могут быть с префиксом сервера (`mcp_*_create_character` и т.д.) — вызывать те же семантические инструменты.
|
|
|
|
|
|
## Безопасность
|
|
|
|
|
|
Не вставлять **API token** PixelLab в файлы репозитория. Токен только в локальной конфигурации MCP пользователя.
|