# OpenCiv3: база знаний для нашей игры

OpenCiv3 — независимый открытый ремейк Civilization III, ранее называвшийся C7. Для нашей браузерной стратегии он полезен как изучаемая реализация механик, импорта файлов и архитектуры. Это не исходники Firaxis и не эталон, доказывающий точное поведение оригинала.

Исследование проведено **26 октября 2026 года**. Ветка `Development` зафиксирована на коммите [`c1370e2f63a6042a3c4206f0043543d7da0d5cc5`](https://github.com/C7-Game/OpenCiv3/commit/c1370e2f63a6042a3c4206f0043543d7da0d5cc5) от **25.10.2026, 19:52:21 UTC**. Материалы написаны по README, wiki, релизам, задачам и выбранным участкам исходников. Получены и проверены по Git blob SHA **302 текстовых файла**; это объём доступного для анализа корпуса, а не заявление о полном чтении всех файлов. Игра и её тесты в этом исследовании не запускались.

## С чего начать

- [Состояние, история и границы готовности](status-and-releases.md) — отличия релиза от ветки разработки.
- [Матрица реализованных возможностей](feature-matrix.md) — где есть логика, где только данные или интерфейс.
- [Что применить в нашей игре](application-to-our-game.md) — приоритеты, зависимости и критерии готовности.
- [Нерешённые вопросы и противоречия источников](limitations-and-open-questions.md).

## Устройство движка

| Тема | Содержание |
| --- | --- |
| [Архитектура](architecture.md) | Godot, C#, модель состояния, сообщения и границы модулей |
| [Ход и победа](turns-and-victory.md) | Порядок расчётов, очки, завоевание, доминирование и лимит ходов |
| [Карта и генерация](world-map-and-generation.md) | Координаты, соседи, seed, биомы, реки, стартовые позиции |
| [Модель данных и состав правил](rules-and-data-model.md) | Прототипы, экземпляры, идентификаторы и измеренный состав |
| [Моды и Lua](modding-and-lua.md) | База, дополнения, поведение, графика и звук |
| [Сохранения](saves-and-serialization.md) | JSON, восстановление ссылок, режим игры и воспроизводимость |
| [Импорт Civ3](civ3-import-and-formats.md) | BIQ, SAV, сжатие, преобразование правил и ограничения |

## Игровые системы

| Тема | Содержание |
| --- | --- |
| [Клетки и работы рабочих](terrain-yields-and-workers.md) | Доходы, ресурсы, слои улучшений, стоимость и прогресс работ |
| [Города и производство](cities-and-production.md) | Жители, еда, рост, население как стоимость, здания и чудеса |
| [Экономика, наука и правительства](economy-science-and-government.md) | Коммерция, бюджеты, содержание, исследования и анархия |
| [Культура и настроение](culture-and-happiness.md) | Границы, довольство, ресурсы роскоши и беспорядки |
| [Юниты и маршруты](units-and-pathfinding.md) | Возможности, перемещение, A*, дороги, транспорт |
| [Бой и обстрел](combat-and-bombardment.md) | Раунды, модификаторы, отступление, цели и неизвестные параметры |
| [Дипломатия и торговля](diplomacy-and-trade.md) | Отношения, соглашения, обмен технологиями и дорожная сеть |
| [Искусственный интеллект](artificial-intelligence.md) | Стратегические приоритеты, роли, производство и ограничения |

## Представление и разработка

- [Графика, звук и отрисовка](graphics-audio-and-rendering.md).
- [Интерфейс и внутриигровая справка](interface-and-codex.md).
- [Сборка, тестирование и проверка совместимости](development-and-testing.md).
- [Лицензии и условия заимствования](licenses-and-reuse.md).
- [Источники, метод и журнал проверки](source-log.md).
- [Машинные результаты исследования](data/README.md).

## Как читать доказательства

**Код:** найден исполняемый путь в закреплённой версии; это статическое свидетельство, без проверки поведения в запущенной игре. **Данные:** запись или флаг присутствует в таблице; выполнение механики этим не подтверждается. **Документация:** заявление авторов или описание релиза. **План:** идея, issue или незавершённый PR. **Вывод для нас:** наша рекомендация, не обещание OpenCiv3.

При разногласиях между старой wiki и исходниками для описания текущего устройства используем исходники. Ошибки, TODO и приближённые расчёты сохраняем в конспектах. Статус issue сам по себе не означает отсутствия или наличия функции.

## Связь с другими исследованиями

[Оригинальная поставка и Path of Atlants 2](../original-game/README.md) описывает фактические файлы и расширенный состав нашего профиля. [Предыдущее чтение графических форматов OpenCiv3](../civ3-conquests/knowledge-base/github-tools/README.md) содержит более узкие статьи о PCX, FLC и атласах. Этот раздел дополняет их устройством игры и прикладными выводами.

Первоисточник проекта: [C7-Game/OpenCiv3](https://github.com/C7-Game/OpenCiv3). Обзор позиционирования: [README.md](https://github.com/C7-Game/OpenCiv3/blob/c1370e2f63a6042a3c4206f0043543d7da0d5cc5/README.md).

