分析 遥测

分析 遥测

只读NDJSON战斗/奔跑遥测 + 游戏内Analytics图表；需要BaseLib。无游戏玩法更改。

游戏玩法

分析 遥测预览查看大图

Analytics Telemetry

Slay the Spire 2 — 只读运行与战斗数据分析。不改变游戏玩法。

摘要

追加式的 NDJSON 会话日志，外加一个游戏内 Analytics 覆盖层：图表、计数器、下钻分析（总览、运行、章节、战斗、手牌、多人），以及可选的 BaseLib 设置（实时指标、会话文件尾部、导出）。为实况主、研究者和任何想在不动卡牌平衡的前提下看到数据的人而打造。

依赖要求

  • BaseLib — BaseLib-StS2 发布页。将 BaseLib 文件夹安装到 Slay the Spire 2/mods/ 中，并在 此 mod 之前 启用它（依赖关系见 AnalyticsTelemetry.json）。
  • 解压此下载，使你拥有 mods/AnalyticsTelemetry/AnalyticsTelemetry.dll 和 AnalyticsTelemetry.json（如果文件页说明需要，则还有 .pck）。

安装

  • 解压至 mods/AnalyticsTelemetry/（布局与其他 Megadot mod 相同）。
  • 先启用 BaseLib，然后在游戏内 mod 列表中启用 Analytics Telemetry。

游戏内使用

  • Analytics 按钮 — 位于右上角；打开指标面板（下拉视图、时间序列、柱状图、计数器、手牌条、可选全文 + 最近 NDJSON 预览）。
  • 设置 → Mods — 更深层的 实时指标 标签页（相同界面，自动刷新）、会话文件 标签页（已保存 *.ndjson 的尾部）、可选 导出（默认关闭，需自行配置）。

数据存放位置

  • 会话：位于游戏用户数据文件夹下，例如 …/SlayTheSpire2/AnalyticsTelemetry/sessions/run-*.ndjson（确切根目录遵循你操作系统下 Godot 的 user://）。
  • 运行存档从你的 Steam 个人资料目录中读取 current_run*.save，用于丰富地图/金币类事件；Steam 账号文件夹名在负载中会以 哈希 形式呈现，而非原样复制。
  • 远程导出仅在你在 mod 设置中开启并提供 URL 后才会运行。

兼容性

面向当前 Slay the Spire 2 + Megadot 模组栈。游戏或 BaseLib 更新可能需要刷新 mod — 请查看文件描述或源码仓库获取最新构建。

故障排查

  • Mod 灰显 / 无法加载 — 请先启用 BaseLib。
  • 启用了两个 mod 却显示 "Loaded 1 mods" — 通常是 BaseLib 程序集版本不匹配；请使用游戏从 mods/BaseLib/ 加载的同一个 BaseLib.dll，而不是不匹配的 NuGet 构建。检查 user://logs/godot*.log 中的加载错误。

源码与问题反馈

https://github.com/drwahl/AnalyticsTelemetry-StS2