fparkan/docs/index.md

FParkan

FParkan -- самостоятельная техническая книга о восстановлении игрового движка Iron3D из Parkan: Iron Strategy. Она ведёт от запуска оригинальной программы и карты DLL к форматам ресурсов, загрузке миссии, геометрии, материалам, рендеру, поведению, звуку, сети и плану чистой совместимой реализации.

Сайт оформлен как онлайн-книга: тома читаются последовательно, а справочник используется как быстрый доступ к форматам, проверочным правилам и границам доказанного знания.

Источник истины и синхронизация

Каталог docs/ — единственный рабочий источник истины для FParkan. 18 июля 2026 года его постранично сопоставили с книгой FParkan в Notion: восемь томов и приложения уже покрывают её 42 основные статьи, а актуальные локальные материалы содержат и последующие результаты разработки. Notion больше не является местом внесения изменений: новые факты, исправления и решения фиксируются только здесь, в томе, справочнике или evidence-документе, которому они принадлежат.

При расхождении приоритет имеют более новое локальное доказательство и текущий scope проекта: самостоятельный runtime ориентирован исключительно на Windows и Vulkan. Исторические упоминания других ОС в старых внешних заметках не расширяют поддерживаемую платформу.

Действующий dependency-ordered план stage 0--5 находится в Vulkan revision для Windows. Это редакторская локальная версия: она включает недостающие контрактные требования из Notion, но не переносит снятые с проекта Linux/macOS и hosted-CI цели.

Как читать

Если вы впервые разбираете игровой движок, начните с тома I и II. Там вводится лексика, доказательная политика, модульная архитектура и жизненный цикл кадра.

Если нужна реализация совместимого движка, читайте тома III--VII линейно: ресурсы, миссии, мир, рендер, интерактивные подсистемы и порядок работ.

Если вы проверяете выводы, переходите к тому VIII и приложениям. Там собраны уровни уверенности, corpus gates, открытые вопросы и критерии закрытия.

Восемь томов

1. Путеводитель и методика -- назначение книги, маршруты чтения, язык предметной области и правила проверки.
2. Запуск, архитектура и игровой цикл -- iron_3d.exe, пятнадцать DLL, сервисы, World3D, очередь объектов и границы кадра.
3. Ресурсная система и форматы -- NRes, RsLi, кэши, имена, objects.rlb, unit DAT и сквозное разрешение ресурсов.
4. Мир, миссии и runtime -- TMA, ландшафт, ареалы, маршруты, создание мира и свойства размещённых объектов.
5. Геометрия, материалы и рендер -- MSH, анимация, WEAR, MAT0, Texm, FXID, свет, атмосфера и полный render frame.
6. Поведение, управление, звук и сеть -- AI, Behavior, Wizard, Control, ввод, камера, звук и DirectPlay-слой.
7. Руководство по полной реализации -- целевая архитектура, этапы работ, тестовый контур, точность, скорость и критерий совместимости.
8. Справочник и доказательная база -- ABI, конфигурация, статистика корпусов, границы знания и глоссарий.

Политика доказательств

Специфические утверждения об Iron3D принимаются только после локальной проверки на исполняемых файлах, DLL, демоверсии, полных каталогах Частей 1 и 2 или на взаимных инвариантах реальных ресурсов. Внешние описания и текущий код FParkan могут подсказывать вопросы, но не заменяют проверку.

Неизвестные поля не получают правдоподобных имён. Пока смысл не закрыт, документация фиксирует raw layout, границы, безопасное чтение и lossless сохранение.