Valentin Popov 0e19660eb5 Refactor documentation structure and add new specifications
- Updated MSH documentation to reflect changes in material, wear, and texture specifications.
- Introduced new `render.md` file detailing the render pipeline process.
- Removed outdated sections from `runtime-pipeline.md` and redirected to `render.md`.
- Added detailed specifications for `Texm` texture format and `WEAR` wear table.
- Updated navigation in `mkdocs.yml` to align with new documentation structure.
2026-02-19 04:46:23 +04:00
2026-01-30 04:27:02 +04:00
2024-02-06 02:26:50 +04:00

FParkan

Open source проект с реализацией компонентов игрового движка игры «Паркан: Железная Стратегия» и набором вспомогательных инструментов для исследования.

Описание

Проект находится в активной разработке и включает:

  • библиотеки для работы с форматами игровых архивов;
  • инструменты для валидации/подготовки тестовых данных;
  • спецификации форматов и сопутствующую документацию.

Установка

Проект находится в начальной стадии, подробная инструкция по установке пока отсутствует.

Документация

Инструменты

Вспомогательные инструменты находятся в каталоге 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 можно создавать в обоих репозиториях:

Основная разработка ведётся в self-hosted репозитории.

Лицензия

Проект распространяется под лицензией GNU GPL v2.

Description
Utilities and tools for the game "Parkan: Iron Strategy".
https://fparkan.popov.link
Readme 26 MiB
Languages
Rust 69.5%
Python 30.5%