From 0d7ae6a017b8b2bf26c5c14c39cb62b599e8262d Mon Sep 17 00:00:00 2001 From: Valentin Popov Date: Thu, 19 Feb 2026 11:07:04 +0400 Subject: Документирование и обновление спецификаций MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Обновлены спецификации `runtime-pipeline`, `sound`, `terrain-map-loading`, `texture`, `ui` и `wear`. - Добавлены разделы о статусе покрытия и оставшихся задачах для достижения 100% завершенности. - Внесены уточнения по архитектурным ролям, минимальным контрактам и требованиям к toolchain для каждой подсистемы. - Уточнены форматы данных и правила взаимодействия между компонентами системы. --- docs/specs/arealmap.md | 30 ++++++++++++++++++++++++++++-- 1 file changed, 28 insertions(+), 2 deletions(-) (limited to 'docs/specs/arealmap.md') diff --git a/docs/specs/arealmap.md b/docs/specs/arealmap.md index cac2743..3b234c9 100644 --- a/docs/specs/arealmap.md +++ b/docs/specs/arealmap.md @@ -1,5 +1,31 @@ # ArealMap -Документ описывает формат и структуру карты мира: зоны/сектора, координаты, размещение объектов и связь с terrain и миссиями. +`ArealMap` — подсистема топологии мира и логических зон. -> Статус: в работе. Спецификация будет дополняться по мере реверс-инжиниринга `ArealMap.dll`. +Подробный бинарный формат `Land.map` и связь с terrain описаны в: + +- [Terrain + ArealMap](terrain-map-loading.md) + +## 1. Роль в движке + +1. Хранит ареалы, связи между ареалами и клеточный индекс. +2. Используется для навигации, логики объектов и AI-решений. +3. Связывает геометрию карты с миссионной и поведенческой логикой. + +## 2. Минимальный runtime-контракт + +1. Валидный граф ареалов и edge-link связей. +2. Валидная cell-grid индексация (`cellsX/cellsY` + hit lists). +3. Согласованные идентификаторы ареалов для AI/Behavior/Missions. + +## 3. Статус покрытия и что осталось до 100% + +Закрыто: + +- бинарный контракт `Land.map` и pair-загрузка с `Land.msh`. + +Осталось: + +1. Полная доменная семантика `class_id`/`logic_flag` по всем игровым сценариям. +2. Формальная спецификация API-запросов к ArealMap (поиск зон, фильтры, события). +3. Набор parity-тестов поведения навигационных запросов на одинаковых входах. -- cgit v1.2.3