Документация
Docs/ru/reference/map-format/index.md
Справочник формата карт
Сгенерированный справочник. Не редактируйте напрямую. Обновите
BuildTools/MapFormatInterface.jsonили владеющие метаданные движка, затем запуститеpython BuildTools/docs_map_format.py --write.
| Индекс | Синтаксис | Свойства | Запекание | Валидация | Каноническая JSON-модель | Руководство по авторингу |
Этот справочник описывает переиспользуемый контракт движка для авторских файлов .fomap, их результатов запекания для отдельных сторон и начальной runtime-материализации.
Состояние контракта
| Поле | Значение |
|---|---|
| Стабильность | experimental |
| Политика поддержки | Контракт генерируется для закреплённой ревизии движка. Каталоги карт проекта, пользовательские метаданные, игровая семантика и правила композиции остаются во владении проекта. |
| Исходный манифест | BuildTools/MapFormatInterface.json |
| Дайджест контракта | 07431a7209c6beff0e6b2d828070b596d7a4f7ac0d6a2859c79bfb23effe732a |
| Справочник | Записей | Назначение |
|---|---|---|
| Синтаксис | 8 | Секции и управляющие директивы. |
| Свойства | 108 | Свойства Map, Critter и Item, которыми владеет движок. |
| Запекание | 4 | Владение и материализация на сервере и клиенте. |
| Валидация | 19 | Требования и ограничения, подтверждённые исходным кодом. |
Граница ответственности
Включено:
- один или несколько якорей ProtoMap со вложенными адресованными по карте секциями Critter и Item
- идентичность карты, ID размещений, ссылки на прототипы, владение и переопределения свойств
- нормализация Mapper, запекание для отдельных сторон и runtime-материализация
- каталоги свойств Map, Critter и Item, которыми владеет движок
Исключено:
- авторские свойства проекта, ID прототипов, каталоги карт и таксономия каталогов
- правила заданий, встреч, баланса, визуальных наборов и дизайна уровней
- runtime-записи сохранения и динамические сущности, созданные после материализации карты
- поиск пути, боевая геометрия, дизайн освещения и зависящие от рендерера рекомендации по композиции
Встраивающие проекты обязаны отдельно документировать добавленные метаданные, прототипы, каталог карт и соглашения по дизайну уровней.