战利品日志

战利品日志

跟踪方块破坏、物品拾取、生物击杀和会话统计。将掉落物归因于导致其产生的方块。可在游戏内浏览会话历史记录,或导出数据为 JSON 格式——支持 Fabric、Quilt 和 NeoForge。

游戏机制

v1.3.0 更新内容

  • 多目标支持:可同时追踪最多 3 个独立目标,在 HUD 上分别显示进度
  • 每个目标在右上角覆盖层显示独立的进度计数和完成勾号
  • 掉落率显示:在会话历史中查看方块聚合数据的最佳物品/掉落率
  • 会话历史现在在显示获得物品的同时还显示方块类型数量

Loot Journal

追踪你破坏每个方块所获得的物品。 Loot Journal 会静默监控你的物品栏,并将物品拾取归因于导致其掉落的方块——然后在会话结束时以整洁的 JSON 格式导出结果。

专为方块随机速通而设计,但也对任何想要了解采矿实际获得物品的人有用。


1.2.0 更新内容

  • 箱子与容器追踪——在容器(箱子、木桶等)打开时拾取的物品现在被单独追踪,并在会话摘要中显示为"容器"一行,因此箱子中的战利品绝不会与方块掉落混淆
  • 目标追踪——通过新的战利品目标界面设置物品目标(例如"钻石 x64");右上角的 HUD 覆盖层会显示实时进度,达到目标时会发送一条聊天消息

1.1.1 更新内容

针对 v1.1.0 新增的三个功能的 Bug 修复:

  • 修复了当生物实体 ID 在冒号后名称为空时(例如格式错误的注册表条目)在会话历史生物击杀摘要中引发的崩溃
  • 修复了在没有保存的会话可点击时,详情面板中误导性地显示"点击会话查看详情"提示的问题
  • 修复了会话历史列表中因格式错误的 startTime 字符串可能引发的崩溃——现在会优雅地回退到原始字符串

1.1.0 更新内容

  • 会话计时器——每次断开连接报告均显示已用时间
  • 生物击杀追踪——每次会话击杀的生物总数,按类型细分 (仅限单人游戏和局域网)
  • 会话历史屏幕——无需离开世界即可在游戏中浏览过去的会话

功能特性

掉落归因

每次破坏方块都会打开一个短暂的归因窗口。在该窗口内从物品栏获得的物品会链接到刚刚破坏的方块。快速挖掘时,多个待处理的破坏事件会被并发追踪。

会话追踪

当你加入世界或服务器时,会话自动开始,断开连接时结束。断开连接时你会收到聊天摘要:

  • 获得和丢失的所有物品
  • 获得的经验值
  • 会话计时器——每次报告均显示已用时间
  • 生物击杀——每次会话击杀的生物总数,按类型细分
  • 容器战利品——从箱子/容器中拾取的物品单独显示
  • 破坏的方块类型数量

箱子与容器追踪 (1.2.0 新增)

在任何容器界面(箱子、木桶、熔炉等)打开时拾取的物品会被归入单独的"容器"桶中,因此绝不会与方块掉落混淆。当收集到容器战利品时,会话摘要会打印专门的"容器"行。

目标追踪 (1.2.0 新增)

从新的战利品目标界面设置战利品目标(在 控制 > Loot Journal 中绑定按键):

  • 输入任意物品名称(例如 diamond、iron_ingot)并设置目标数量
  • HUD 右上角的小覆盖层显示实时会话进度
  • 达到目标时会发送一条聊天消息
  • 目标跨会话持久化;可随时从目标界面清除

会话历史屏幕 (1.1.0 新增)

无需离开游戏即可浏览过去的会话。通过按键绑定(默认未绑定)打开历史屏幕,可查看:

  • 日期、世界名称和会话时长
  • 获得的物品、生物击杀、经验和破坏的方块
  • 点击任何会话行展开详情

生物击杀追踪 (1.1.0 新增)

每次生物死亡都会被记录到会话中。摘要会显示按生物类型细分的统计数据——适用于追踪战斗密集的会话或生物掉落率。

JSON 导出

会话数据保存到 loot-journal/sessions/session-YYYY-MM-DD-HH-mm-ss.json。一个运行中的 statistics.json 文件会累积所有会话中每种方块类型的掉落计数和计算的掉落频率。

方块随机模式

专为方块随机挑战运行的专用模式:

  • 限制每次只能有一个待处理的破坏事件,以免掉落混淆
  • 每次破坏实时显示一行聊天信息——[随机] 草方块 → 泥土 x1,种子 x2
  • 采用更宽的归因窗口以处理服务器战利品表延迟

游戏内配置界面

所有设置均可在游戏中调整,无需重启。通过可配置的按键绑定打开。


按键绑定

操作 默认按键
显示会话中报告 J
打开设置 (未绑定)
打开会话历史 (未绑定)
打开战利品目标 (未绑定)

输出文件

位于 .minecraft/loot-journal/ 目录下:

文件 内容
sessions/session-*.json 每次会话的物品获得/丢失、生物击杀、方块聚合数据、经验值、时长
statistics.json 每种方块类型的累计掉落次数和掉落频率

配置选项

设置项 默认值 描述
enabled true 总开关
attributionWindowTicks 60 破坏后收集掉落的刻数(约 3 秒)
blockRandomizerMode false 启用方块随机模式
brFeedbackInChat true 方块随机模式下每次破坏的聊天行
writeSessionJson true 保存每次会话的 JSON 文件
writeStatisticsJson true 更新累计统计文件
writeBreakEvents false 在会话 JSON 中包含每次破坏事件数据
showSummaryOnDisconnect true 断开连接时在聊天中打印摘要

运行需求

Fabric(1.21.1 和 1.21.11)

  • Fabric Loader 0.19.2+
  • Fabric API

NeoForge(1.21.1、1.21.11 和 26.1)

  • NeoForge 21.1.172+