chore: simplify project to engine docs and tests
Remove planning and acceptance scaffolding while retaining the native Vulkan mission preview, format readers, runtime algorithms, and ordinary Rust tests. Keep the book aligned with the runnable project and validate checked-in shaders without generated tool metadata.
This commit is contained in:
+21
-66
@@ -1,72 +1,27 @@
|
||||
# FParkan
|
||||
|
||||
FParkan -- самостоятельная техническая книга о восстановлении игрового движка
|
||||
Iron3D из *Parkan: Iron Strategy*. Она ведёт от запуска оригинальной программы
|
||||
и карты DLL к форматам ресурсов, загрузке миссии, геометрии, материалам,
|
||||
рендеру, поведению, звуку, сети и плану чистой совместимой реализации.
|
||||
Эта книга рассказывает, как устроен движок *Паркан: Железная стратегия* и как
|
||||
FParkan воспроизводит его работу на Rust и Vulkan. Начнём с простого вопроса:
|
||||
что должно произойти между выбором миссии и появлением первого кадра?
|
||||
Ответ связывает архивы, модели, поверхность карты, камеру, свет и поведение
|
||||
объектов в одну программу.
|
||||
|
||||
Сайт оформлен как онлайн-книга: тома читаются последовательно, а справочник
|
||||
используется как быстрый доступ к форматам, проверочным правилам и границам
|
||||
доказанного знания.
|
||||
Главы читаются последовательно. Для знакомства с игровой разработкой
|
||||
подойдут первые две; подробные структуры файлов можно искать в справочнике.
|
||||
|
||||
## Источник истины и синхронизация
|
||||
1. [Путеводитель](tomes/01-guide.md): основные понятия и чтение бинарных структур.
|
||||
2. [Архитектура и игровой цикл](tomes/02-architecture.md): запуск, мир и кадр.
|
||||
3. [Ресурсы](tomes/03-resources.md): архивы, имена и связи файлов.
|
||||
4. [Миссии и ландшафт](tomes/04-world.md): размещение объектов и поверхность.
|
||||
5. [Геометрия и рендер](tomes/05-render.md): путь от вершины до пикселя.
|
||||
6. [Поведение, управление и звук](tomes/06-behavior.md): интерактивный мир.
|
||||
7. [Работа над движком](tomes/07-implementation.md): код, тесты и проверка результата.
|
||||
8. [Устройство оригинальной программы](tomes/08-evidence.md): DLL, адреса и конфигурация.
|
||||
|
||||
Каталог `docs/` — единственный рабочий источник истины для FParkan. 18 июля
|
||||
2026 года его содержательно сопоставили с книгой FParkan в Notion; результат,
|
||||
маршрутизация статей и сознательно исключённые цели зафиксированы в
|
||||
[сверке](baseline/notion-reconciliation.md). Актуальные локальные материалы
|
||||
содержат и последующие результаты разработки. Notion больше не
|
||||
является местом внесения изменений: новые факты, исправления и решения
|
||||
фиксируются только здесь, в томе, справочнике или evidence-документе, которому
|
||||
они принадлежат.
|
||||
В [глоссарии](appendices/glossary.md) собраны термины, а в
|
||||
[открытых вопросах](appendices/knowledge-boundaries.md) — ещё не восстановленное
|
||||
поведение. Описание алгоритма оригинала и возможности текущего приложения
|
||||
различаются явно. Предположение остаётся предположением, пока его не
|
||||
подтверждают игровые файлы или код оригинала.
|
||||
|
||||
При расхождении приоритет имеют более новое локальное доказательство и текущий
|
||||
scope проекта: самостоятельный runtime ориентирован исключительно на Windows и
|
||||
Vulkan. Исторические упоминания других ОС в старых внешних заметках не
|
||||
расширяют поддерживаемую платформу.
|
||||
|
||||
Действующий dependency-ordered план `stage 0--5` находится в
|
||||
[Vulkan revision для Windows](baseline/vulkan-revision-plan.md). Это
|
||||
редакторская локальная версия: она включает недостающие контрактные требования
|
||||
из 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
|
||||
сохранение.
|
||||
Команды запуска и проверки приведены в [README](../README.md).
|
||||
|
||||
Reference in New Issue
Block a user