日志

日志

服务端活动日志记录与调查工具，支持对已记录的方块变更、岩浆扩散和爆炸破坏进行审核后的回滚。

日志预览查看大图

Logbook

查明是谁更改了方块，追踪已记录的物品转移，并在应用回滚之前进行审查。

Logbook 是一款面向 Minecraft 服务器管理人员的服务端日志与调查模组。它会记录受支持的活动，并附带时间戳、位置和可用的玩家身份信息。你可以通过聊天进行搜索、检查单条记录，并在选定区域内恢复已记录的方块状态。玩家无需安装客户端模组。

调查活动

  • 按区域、时间、玩家、操作或对象进行搜索。
  • 检查方块破坏与放置、岩浆与水的变动、火焰伤害、爆炸、告示牌编辑、受支持的容器交互、物品掉落与拾取、菜单访问以及村民交易。
  • 读取捕获的方块变更前后状态，并区分已完成的操作与观察结果。
  • 保存查询、通过案件保留来保全证据，并导出记录供管理人员审查。
  • 无需外部服务即可在本地保存证据。可选的 Loglibrarian 支持可添加集中式证据存储。

站在受影响的区域附近，在 Minecraft 聊天中使用以下命令：

/lb search range:32 after:30m player:Alex action:block-break
/lb page 2
/lb detail 1

结果显示谁做了什么、何时发生以及方块坐标，每页聊天显示五条记录。详情会优先展示事件摘要；技术性元数据单独提供。可点击控件提供分页、细化搜索和证据详情功能。使用 /lb refine 来缩小当前搜索范围。此工作流程在服务端运行，无需安装 Companion。

预览回滚

使用 /lb rollback range:8 after:2h player:Alex 来准备预览，或使用 Logbook 魔杖选择两个角点。审查受影响的方块、跳过的位置以及覆盖差异，然后应用完全审查过的方案。

回滚会恢复已记录的方块状态。它不会重建物品栏、方块实体内容、实体或存储网络。按玩家筛选的回滚可能会覆盖同一位置上的后续更改，因此在应用之前请先审查预览。

新记录的岩浆蔓延和爆炸伤害可以包含在回溯中。Logbook 会记录实际的方块变更，包括受影响的相邻方块，并在其记录的蔓延之前恢复流体源。请在选区中同时包含源头和受影响的区域。玩家归属遵循观察到的原因；未知原因保持未知，并被仅限玩家的筛选排除在外。

截图使用了一个真实的测试事件，涉及 13 个 TNT 炸药、79 个被破坏的方块和一个岩浆桶。仅命令和 Companion 的回溯均对照 29,791 个已保存的方块状态进行了检查。比较结果仅剩预览中明确跳过的方块实体，没有残留的岩浆。

捕获使用现有的方块回调和一个有界的后台写入队列。环境捕获具有每刻限制，如果达到该限制会报告捕获缺口。回溯以增量方式工作，默认限制为每刻两个位置。它无法恢复从未被记录过的更改，无法重建掉落的物品，也无法保证覆盖绕过受支持钩子的自定义模组操作。

模组集成

Logbook 为以下受支持的操作包含专门的观察器：

模组 记录的活动
Create 通过其受支持的破坏辅助工具进行的方块变更
Applied Energistics 2 已完成的网络存入和取出
Refined Storage 1 和 2 受支持的物品和流体存入与取出
Carry On 方块拾取、方块放置和实体拾取
FTB Chunks 认领、取消认领、强制加载和卸载事件
FTB Teams 团队归属、所有权及其他受支持的团队通知
Open Parties and Claims 认领和强制加载状态通知
Waystones, the Balm-based mod 激活及受支持的传送完成事件
Cobblemon 捕获、释放和交易完成事件
Sable / Simulated / Aeronautics 飞船生命周期和姿态观察，以及受支持的组装和拆卸通知

命名的方块破坏与放置记录还涵盖了 Sable、Aeronautics、Simulated、Offroad、Sophisticated Storage、Sophisticated Backpacks、Storage Drawers、Tom's Storage，以及以下 Create 附属模组：Big Cannons、Copycats+、Steam 'n' Rails、Crafts & Additions、Connected、Deco、Enchantment Industry、Slice & Dice、Stuff & Additions、New Age、Vintage Improvements、The Factory Must Grow、Numismatics 和 Bells & Whistles。

这些方块记录依赖于操作经过受支持的玩家钩子。它们并不意味覆盖了每一台机器、自定义物品栏或模组功能。可用的集成取决于所安装的模组版本。运行 /lb coverage 来检查你的服务器。当某个集成未提供操作者时，Logbook 会将操作者留为未知。

可选的 Companion

在管理员的客户端上安装 Logbook Companion，以获得世界内检查器、证据地图、幽灵方块全息图和可视化回滚审查。仅服务端的截图图库演示了在缺少 Companion 时的聊天命令。Companion 有其自己单独的图库。

安装

为你的确切 Minecraft 版本和加载器选择对应的服务端 JAR：

  • Minecraft 1.20.1： Fabric 或 Forge，Java 17 或更高版本。
  • Minecraft 1.21.1： Fabric 或 NeoForge，Java 21 或更高版本。

将其放入服务器的 mods 文件夹，重启，然后运行 /lb status 和 /lb coverage。管理人员命令需要权限等级 4。Logbook 不需要 Fabric API、Architectury API 或外部数据库服务。

致谢

Logbook 最初由 KaptainWutax 为 Craft Down Under 开发，后来经过更新和调整以公开发布。感谢 KaptainWutax 构建了原始模组。

Craft Down Under