Среда одиночных сценариев Disciples II: Rise of the Elves и обучение агента PPO на JAX/GPU. Ручная игра и обучение используют одну реализацию движения, боя, развития, экономики и магии. Браузер отображает состояние и отправляет команды.
Развитие идёт от прохождения отдельных сценариев к незнакомым картам, затем к игре против другого агента. У Disciples II есть скрытая информация и длинные кампании; схема AlphaZero для полностью наблюдаемых настольных игр требует адаптации. План проекта.
Реализация сочетает данные установленной Rise of the Elves, подтверждённые правила оригинала и согласованные адаптации Python-референса. Источники и ограничения каждой механики указаны в справочниках; сведения о покрытии нужно сверять с текущим кодом и тестами.
Из корня проекта в WSL/Linux с NVIDIA GPU:
bash scripts/install_runtime.sh
bash scripts/run_gpu.sh serve_number_grid.py --map trade_train --port 8769На Windows: open-numbergrid.cmd -Map trade_train. Игра открывается по адресу http://127.0.0.1:8769/viewer.html.
Руководство по запуску, обучению, чекпойнтам и проверкам. Обучения, замеры и тесты выполняются по явному запросу; правила работы — AGENTS.md.
| Справочник | Содержание |
|---|---|
| Бои | Атаки, очередь, эффекты, иммунитеты, направленная атака и ограничения |
| Юниты | Каталог, опыт, герои, навыки, стартовые отряды и перестановки |
| Предметы | Экипировка, боевые предметы, зелья и сундуки |
| Магия | Исследование, применение, свитки и посохи |
| Экономика | Строительство, храм, торговцы, тренеры, найм и руины |
| Мир | Дни, отдых, движение, рельеф, земля, источники и города |
| Карты и кампании | Реестр, сценарии, Проклятое дитя, текущая карта и целевые награды |
| Обучение | Runtime, команды, метрики, отчёты, методика скорости и проверки |
| Лаборатория стража | Поиск тактик, приближения и неподтверждённые правила |
Подробные правила отдельных карт: Default и драконы/столица, Small, Бегство Бетрезена, Соляная темница, Дикие горы, City Defence, Trade Train, Mirror Match.
Актуальные команды и правила находятся в этих справочниках. Результаты конкретных запусков хранятся в results/; прошлые версии документации доступны в истории Git.
JAX-реализация использует Stoix и Stoa. Обзор библиотеки — README_STOIX.md; описание Stoa — stoa-src/README.md. Документация алгоритмов находится рядом с реализациями в stoix/systems/.
Лицензии сохранены отдельно: MIT проекта, Apache-2.0 Stoix, лицензия Stoa. MIT-лицензия проекта не заменяет лицензии включённых библиотек. Участие в разработке.