squad-proto/assets/sources/README.md
z.kirill 8d35f4c2ec Конвейер ассетов: манифесты, риги, каталоги, инструменты
Всё, из чего собираются спрайты, и ничего собранного. Источник истины —
assets/manifests и assets/*/catalog.yaml; PNG, .sfa и contact sheet остаются
за бортом, потому что воспроизводятся командой (docs/12-assets.md).

  assets/manifests   что и как рендерить: окружение, твари, агенты, предметы
  assets/agents      паперdoll-риг восьми направлений, каталог снаряжения
  assets/monsters    пять морфологий, каждая своим ригом (docs/14-monsters.md)
  assets/sources     исходные развёртки и импорты
  assets/art_masters мастер-развёртки, по которым сверяется стиль
  tools/             сборка ассетов, покрытие, генераторы, blender-скрипты
  generated/         заголовки с константами SF_ASSET_*: без них игра не
                     соберётся, поэтому они в репозитории, хотя и производные

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-13 21:06:09 +03:00

1002 B

assets/sources

Исходники ассетов, на которые ссылаются манифесты из assets/manifests/.

  • imports/ — готовые PNG для бэкенда import (поле source);
  • rigs/.blend-риги для бэкенда blender (поле rig).

Процедурные ассеты исходников не имеют: генератор и параметры целиком описаны в манифесте. Пути в манифесте разрешаются относительно самого манифеста, поэтому импорт выглядит так:

health_potion:
  backend: import
  source: ../sources/imports/health_potion.png
  size: 32x32
  tags: [item, consumable]

Собранные .sfa и palettes.sfp сюда не кладутся — они живут в build/sprites/ и не версионируются. Подробности: docs/12-assets.md.