From c69cad6a26f40385db07f1cd62739176a8099ba9 Mon Sep 17 00:00:00 2001 From: Valentin Popov Date: Mon, 9 Feb 2026 23:36:32 +0000 Subject: feat: добавить начальный README с описанием проекта и инструкциями MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) diff --git a/README.md b/README.md index e69de29..f9b0e35 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,55 @@ +# FParkan + +Open source проект с реализацией компонентов игрового движка игры **«Паркан: Железная Стратегия»** и набором [вспомогательных инструментов](tools) для исследования. + +## Описание + +Проект находится в активной разработке и включает: + +- библиотеки для работы с форматами игровых архивов; +- инструменты для валидации/подготовки тестовых данных; +- спецификации форматов и сопутствующую документацию. + +## Установка + +Проект находится в начальной стадии, подробная инструкция по установке пока отсутствует. + +## Документация + +- локально: каталог [`docs/`](docs) +- сайт: + +## Инструменты + +Вспомогательные инструменты находятся в каталоге [`tools/`](tools). + +- [tools/archive_roundtrip_validator.py](tools/archive_roundtrip_validator.py) — инструмент верификации документации по архивам `NRes`/`RsLi` на реальных файлах (включая `unpack -> repack -> byte-compare`). +- [tools/init_testdata.py](tools/init_testdata.py) — подготовка тестовых данных по сигнатурам с раскладкой по каталогам. + +## Библиотеки + +- [crates/nres](crates/nres) — библиотека для работы с файлами архивов NRes (чтение, поиск, редактирование, сохранение). +- [crates/rsli](crates/rsli) — библиотека для работы с файлами архивов RsLi (чтение, поиск, загрузка/распаковка поддерживаемых методов). + +## Тестирование + +Базовое тестирование проходит на синтетических тестах из репозитория. + +Для дополнительного тестирования на реальных игровых ресурсах: + +- используйте [tools/init_testdata.py](tools/init_testdata.py) для подготовки локального набора; +- используйте оригинальную копию игры (диск или [GOG-версия](https://www.gog.com/en/game/parkan_iron_strategy)); +- игровые ресурсы в репозиторий не включаются, так как защищены авторским правом. + +## Contributing & Support + +Проект активно поддерживается и открыт для contribution. Issues и pull requests можно создавать в обоих репозиториях: + +- **Primary development**: [valentineus/fparkan](https://code.popov.link/valentineus/fparkan/issues) +- **GitHub mirror**: [valentineus/fparkan](https://github.com/valentineus/fparkan/issues) + +Основная разработка ведётся в self-hosted репозитории. + +## Лицензия + +Проект распространяется под лицензией **[GNU GPL v2](LICENSE.txt)**. -- cgit v1.2.3