Valentin Popov
70ed6480c2
- Updated the structure and content of the materials and Texm documentation to provide a comprehensive overview of the material subsystem in the engine. - Enhanced sections on identifiers, architecture, material layout, and runtime storage. - Improved explanations of material attributes, animation modes, and parsing behavior. - Added detailed specifications for toolchain interactions, including lossless write rules and validation recommendations. - Included pseudocode examples for parsing MAT0 and Texm formats to aid in understanding.
FParkan
Open source проект с реализацией компонентов игрового движка игры «Паркан: Железная Стратегия» и набором вспомогательных инструментов для исследования.
Описание
Проект находится в активной разработке и включает:
- библиотеки для работы с форматами игровых архивов;
- инструменты для валидации/подготовки тестовых данных;
- спецификации форматов и сопутствующую документацию.
Установка
Проект находится в начальной стадии, подробная инструкция по установке пока отсутствует.
Документация
- локально: каталог
docs/ - сайт: https://fparkan.popov.link
Инструменты
Вспомогательные инструменты находятся в каталоге tools/.
- tools/archive_roundtrip_validator.py — инструмент верификации документации по архивам
NRes/RsLiна реальных файлах (включаяunpack -> repack -> byte-compare). - tools/init_testdata.py — подготовка тестовых данных по сигнатурам с раскладкой по каталогам.
Библиотеки
- crates/nres — библиотека для работы с файлами архивов NRes (чтение, поиск, редактирование, сохранение).
- crates/rsli — библиотека для работы с файлами архивов RsLi (чтение, поиск, загрузка/распаковка поддерживаемых методов).
Тестирование
Базовое тестирование проходит на синтетических тестах из репозитория.
Для дополнительного тестирования на реальных игровых ресурсах:
- используйте tools/init_testdata.py для подготовки локального набора;
- используйте оригинальную копию игры (диск или GOG-версия);
- игровые ресурсы в репозиторий не включаются, так как защищены авторским правом.
Contributing & Support
Проект активно поддерживается и открыт для contribution. Issues и pull requests можно создавать в обоих репозиториях:
- Primary development: valentineus/fparkan
- GitHub mirror: valentineus/fparkan
Основная разработка ведётся в self-hosted репозитории.
Лицензия
Проект распространяется под лицензией GNU GPL v2.