PlayerActionLogger (PAL)

模组

· 作者 gigachadfr

一个记录客户端操作的模组(可与 Complementary Python 脚本配合使用,在游戏中提供 AI 解说)

0 本站下载 0 关注 更新于 2 个月前

最新 2.2.0 · 1.21.1 · NeoForge

一键开服(送7天)

PlayerActionLogger (PAL)

PAL 将 你的 玩家行为记录到一个结构化文件中,专为供 LLM(大型语言模型)读取而设计,以便它能实时解说你的游戏过程。它还附带一个可选的 Python 机器人,可以大声朗读解说内容。

它 仅适用于客户端:在单人游戏中或任何服务器上均可使用;服务器端不需要它,且它只记录你自己的玩家行为。

如果你用它制作了视频,请注明该项目。


日志长什么样

每个事件都是一行 JSON 数据,并带有等级标记,以便读者能区分紧急状况与背景噪音:

The event log

等级 含义
INFO 背景信息。挖矿、行走、风景、命令等
NOTABLE 值得提及的事件。击杀、进度达成、聊天、受到伤害等
CRITICAL 正在发生的情况。死亡、低生命值、岩浆、身后有苦力怕等

这个等级的设定是整个项目的核心:正是它让解说者能够在苦力怕出现时插话,而在挖掘第 200 个石块时保持安静。

追踪的内容

  • 生命体征 — 生命值、饥饿值、护甲、经验值、状态效果,以及它们何时变得危险
  • 战斗 — 你击杀了什么、什么杀死了你、受到的伤害及其来源
  • 挖矿 — 矿物发现、会话摘要、实际挖掘过的方块
  • 建造与容器 — 放置方块、箱子、工作台、合成
  • 危险 — 敌对生物逼近、岩浆、高空坠落、溺水
  • 世界 — 生物群系、维度、一天中的时间、天气、高度
  • 进度 — 进度达成、等级提升、原版统计数据
  • 聊天 — 你说的话、别人说的话、你执行的命令

实时状态,而非仅历史记录

除了日志之外,该模组每秒重写一次 player_state.json —— 日志记录的是 发生了什么,而这个文件反映的是 当前真实的状态:

The live state file

生命值、位置、装备耐久度、完整物品栏以及原版统计数据。这意味着玩家无需重新回放整个日志,就能回答诸如“我因岩浆死亡了多少次”或“我现在手里拿着什么”之类的问题。

伴生机器人(可选)

该模组本身已具备实用性——任何能够读取 JSONL 格式的工具都可以使用它。但仓库中还提供了一个 Python 机器人,它会读取日志,将其发送给 Gemini,并通过本地 Web 仪表盘朗读回复:

仪表盘

实时生命值、使用真实物品图标绘制的物品栏(包含模组物品——纹理直接从你已有的 JAR 文件中读取)、事件流、API 配额,以及解说员的启动/停止控制。它仅在 127.0.0.1 上运行。

版本

Minecraft 加载器 依赖项
26.1.2 Fabric Fabric API
1.21.11 Fabric Fabric API
1.21.1 Fabric Fabric API
1.21.1 NeoForge 21.1 无其他依赖

NeoForge 版本无需额外依赖——它使用 NeoForge 自身的事件系统,因此可直接放入整合包中,不会引入其他任何内容。

所有构建版本均为同一模组、同一版本号:功能集一致,无论选择哪个 jar 文件。

使用方法

  1. 为你的 Minecraft 版本安装 Fabric(如果是 NeoForge 构建版,则安装 NeoForge)。
  2. 在 Fabric 上安装 Fabric API。
  3. 将对应的 jar 文件放入 mods/ 目录——文件名会标明它适用于哪个游戏和加载器。
  4. 开始游玩。加入世界后即可开始记录日志。

文件存放位置: <你的 Minecraft 文件夹>/logs/player_actions/ — session.log 用于记录事件,player_state.json 用于实时快照。

为什么

它原本是为 LLM 评论而设计的——让你在玩游戏时让某些东西对你的游戏行为做出反应——但日志是纯 JSONL 格式,没有任何与 AI 相关的特殊内容,因此它同样适用于游戏过程追踪、统计数据,或任何其他需要知道你做了什么的操作。

源码、Python 机器人及问题反馈:

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源