FParkan

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

Описание

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

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

Установка

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

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

• локально: каталог docs/
• сайт: https://fparkan.popov.link

Библиотеки

• crates/fparkan-nres — strict/lossless модель архивов NRes.
• crates/fparkan-rsli — чтение, lookup и lossless roundtrip архивов RsLi.
• crates/fparkan-msh — validated static MSH geometry.
• crates/fparkan-runtime — transactional mission loading и headless runtime foundation.
• apps/fparkan-cli, apps/fparkan-viewer, apps/fparkan-headless, apps/fparkan-game — composition roots.

Тестирование

Базовое тестирование проходит на синтетических тестах из репозитория:

cargo xtask ci

Для дополнительного тестирования на реальных игровых ресурсах:

• используйте оригинальную копию игры (диск или GOG-версия);
• разместите игровые каталоги в testdata/;
• игровые ресурсы в репозиторий не включаются, так как защищены авторским правом.

Локальный licensed gate использует некоммитимый manifest:

cat > /private/tmp/fparkan-corpora.toml <<'EOF'
schema = 1

[[corpus]]
id = "part1-local"
kind = "part1"
root = "/absolute/path/to/IS"
expected_profile = "parkan-is-part1"

[[corpus]]
id = "part2-local"
kind = "part2"
root = "/absolute/path/to/IS2"
expected_profile = "parkan-is-part2"
EOF

FPARKAN_CORPORA_MANIFEST=/private/tmp/fparkan-corpora.toml \
  cargo xtask acceptance report --suite licensed --stage 5

Contributing & Support

Проект активно поддерживается и открыт для contribution. Issues и pull requests можно создавать в обоих репозиториях:

• Primary development: valentineus/fparkan
• GitHub mirror: valentineus/fparkan

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

Лицензия

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