Skip to content

About

Standalone trajectory dashboard and battle replay for Stronghold Protocol RL research

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

ArkGuardRL Viewer

卫戍协议强化学习实验的独立可视化工具。浏览轨迹与诊断报告,检查各轮站位、朝向、装备、商店与盟约,并播放原生战斗帧。

安装与启动

Python 3.10 及以上。基础文件浏览使用 Python 标准库与浏览器。

git clone https://github.com/ArkStrongholdRL/ArkGuardRL-Viewer.git
cd ArkGuardRL-Viewer
python3 -m venv .venv
.venv/bin/python -m pip install -e .
.venv/bin/arkguardrl-viewer --results-root /absolute/path/to/results

打开 http://127.0.0.1:8765。也可以运行 python -m arkguardrl_viewer,参数相同。 服务绑定本机地址。查看服务器上的记录时使用 SSH 隧道转发该端口。

基础部署区棋盘直接使用快照中的单位名称、坐标和朝向。完整原生渲染可挂载已有游戏安装与 Pixi 依赖。

arkguardrl-viewer --results-root /path/to/results \
  --engine-root /path/to/Stronghold-Protocol \
  --vendor-root /path/to/existing/public/vendor

--engine-root 应包含 data/、shared/、public/js/ 等目录。 原生渲染器与资源从该安装读取。--vendor-root 默认使用游戏的 public/vendor。

记录格式

  • .jsonl、.ndjson 及其 .gz 压缩文件支持完整状态轨迹。记录可直接保存,也可包装在 record 字段。state 或 after 字段提供状态,header 与 footer 提供元数据和结果。
  • .json、.json.gz 支持诊断报告与训练指标。ready 可以是各轮快照,也可以包含 before、after 及漏怪等诊断字段。页面展示已记录的 Ready 前局面,完整诊断字段保留在原始记录中。
  • 仅有动作的 actions.jsonl.gz 可通过下方导出命令在匹配版本的 Core 中重放,生成状态和战斗帧。缺少状态的文件在观察台显示其记录元数据。
  • 首页的“打开战斗帧播放器”接受 arkguardrl/native-battle-replay-v1 JSONL,支持播放、拖动进度、倍速、位置和血条。

JSON 报告解压后上限 32 MiB。JSONL 按需读取状态帧,扫描上限 512 MiB 解压数据或 50,000 个状态。单行上限 8 MiB。

从已有动作导出战斗帧

这一功能使用另行安装的 ArkGuardRL-Core、对应平台的原生扩展和游戏数据。 重放需要与原记录匹配的游戏版本、Core、初始核心、DIY 配置和引擎种子。

arkguardrl-replay \
  --data-root /path/to/Stronghold-Protocol/data \
  --native-library /path/to/_native.so \
  --core band_sarkazb --seed 543260021 \
  --actions /path/to/actions.jsonl.gz \
  --out /path/to/new-replay.jsonl \
  --html /path/to/new-replay.html

--seed 对无头动作日志必填,有头记录可从元数据读取。JSON 动作文件接受 engine_seed、actions 和可选 core、diy、setup_revision。 --core 默认 band_chen,应按原始记录指定。导出保留实际胜负,输出路径须为新文件。 --sample-ticks 默认 3,对应 30 Hz 引擎约每 100 ms 采样一次。 生成的 HTML 可直接打开,包含播放器和全部帧数据。

人工接管

保留原观察台的人工接管与示范记录入口。该入口使用已有 Research/Core 的基础 route policy 运行时,需要另外安装兼容的 arkguardrl-research、Core、Torch 与游戏运行环境。新 EntityTransformer 模型的实时接管接线仍需适配。 人工示范写入结果目录,保留动作来源与 on_policy=False 标记。此功能目前按原实现迁移,独立仓库首次发布尚未完成实时对局运行确认。

来源与许可

从 ArkGuardRL-Core 的训练观察台和原生回放工具拆出。采用 GPL-3.0-or-later,来源说明见 NOTICE.md。

About

Standalone trajectory dashboard and battle replay for Stronghold Protocol RL research

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages