Документация
Docs/ru/reference/model-format/index.md
Справочник формата моделей
Сгенерированный справочник. Не редактируйте напрямую. Обновите
BuildTools/ModelFormatInterface.json, затем запуститеpython BuildTools/docs_model_format.py --write.
| Индекс | Синтаксис | Токены | Композиция | Ресурсы | Анимация | Валидация | Каноническая JSON-модель | Руководство |
Справочник описывает переиспользуемый язык .fo3d, принадлежащий движку, и собираемые им ресурсы моделей. Конкретные игровые модели и семантика слоёв принадлежат проекту.
Состояние контракта
| Поле | Значение |
|---|---|
| Стабильность | experimental |
| Политика поддержки | Контракт генерируется для закреплённой ревизии движка. Каталоги моделей, семантика слоёв, enum анимаций, визуальные правила и конкретные ресурсы принадлежат проектам. |
| Исходный манифест | BuildTools/ModelFormatInterface.json |
| Дайджест контракта | d4dac97de23a3960a8fe62548f084177090b9e133570a286a15409334b093319 |
| Расширение исходника | .fo3d |
| Входные меши | .fbx, .obj |
| Runtime-сторона | client |
| Справочник | Записей | Назначение |
|---|---|---|
| Токены | 32 группы / 59 написаний | Все принимаемые текущим parser токены. |
| Ресурсы | 6 | Входы мешей, описаний, текстур, эффектов и частиц. |
| Валидация | 15 | Правила авторинга, запекания, runtime и legacy. |
Граница
Включено:
- лексический синтаксис .fo3d, include-шаблоны, состояние parser и разрешение путей;
- слои моделей, root modifiers, attachments мешей/моделей/частиц, transforms, materials, effects и cuts;
- входы FBX и OBJ, требования к baked hierarchy, compile-time лимиты и runtime-композиция;
- точки интеграции анимации со специализированным справочником model animation.
Не включено:
- каталоги моделей проекта, семантика номеров слоёв, enum assignments, правила экипировки и игровые тайминги;
- руководства по DCC-инструментам Blender, Maya, 3ds Max и другим;
- детали реализации renderer backend и справочник shader language;
- offsets кадров 2D-спрайтов и sprite root motion.