方块审计

方块审计

CraftAudit是一个用于Minecraft Forge的服务器端审计模组/插件,记录玩家和环境对世界所做的更改(方块放置/破坏、容器输入输出、点燃、物品展示框/画作操作、桶的使用、击杀等)。

游戏机制

CraftAudit – 方块/实体审计日志与回滚工具(Forge)

概述

CraftAudit 是一个适用于 Minecraft Forge 的服务端审计模组/插件,用于记录玩家和环境对世界所做的更改(方块放置/破坏、容器存取、点火、物品展示框/画作操作、桶使用、击杀等)。它提供就地检查、区域查询、回滚/恢复和撤销功能,支持 SQLite 或 MySQL 存储。

功能

  • 方块更改日志记录

    • 玩家破坏/放置(可选记录 BlockState/NBT 快照)
    • 环境破坏(natural_break):爆炸、流体、重力
  • 交互日志记录

    • 容器放入/取出(基于菜单会话,精确定位方块位置)
    • 告示牌编辑(记录文本)
    • 点火(营火/蜡烛/TNT/火焰)
    • 红石交互:按钮/拉杆/门
    • 物品展示框/画作:放入/取出/旋转/放置/破坏
    • 桶:装填/倒空/捕鱼/挤奶
    • 击杀:记录击杀者、受害者、原因、投射物、武器、距离等
  • 查询

    • 审计模式下,左键/右键点击方块可查看该位置的日志(分页)
    • 区域+时间查询(near 命令)
  • 回滚/恢复/撤销

    • 在半径与时间窗口内回滚某玩家的放置/破坏(rollback)
    • 恢复所有破坏(玩家与环境)或按类型过滤(restore)
    • 恢复击杀:在日志位置重新生成非玩家实体(restore ... kill)
    • 撤销上一次回滚/恢复(undo):还原方块或移除生成的实体
  • 存储

    • SQLite(默认)或 MySQL 后端
    • 可配置文件位置和 MySQL 参数
  • 其他

    • 物品/方块的本地化名称
    • 审计模式免于记录(审计者的操作被忽略)

命令

所有 craftaudit 命令均有 /ca 别名。需要 OP 等级 2。

基础

  • /craftaudit status
    显示数据库/模式状态
  • /craftaudit inspect 或 /ca i
    切换审计模式(左键:方块日志,右键:交互日志)
  • /craftaudit log [page]
    显示最近右键点击方块的交互日志(分页)
  • /craftaudit blocklog [page]
    显示最近左键点击方块的方块日志(分页)

区域查询

  • /craftaudit near <radius> <time> [page]
    搜索玩家附近的日志(按半径与时间)
    • 时间格式:Ns/Nm/Nh/Nd(例如 30m、12h、5d)

回滚/恢复/撤销

  • /craftaudit rollback <player> <time> [radius=10]
    在区域与时间范围内回滚某玩家的放置/破坏
  • /craftaudit restore <time> [radius=10] [type]
    恢复破坏或击杀,可选按类型过滤:
    • 无类型:所有破坏(玩家与环境)
    • break:仅玩家破坏
    • natural/natural_break:仅环境破坏
    • explosion/fluid/gravity:按原因分类的环境破坏
    • kill 或 kill:<entity_id>:恢复击杀(重新生成非玩家实体)
  • /craftaudit undo
    撤销上一次回滚/恢复(还原方块,移除生成的实体)
  • /craftaudit purge <time>
    清除早于指定时间的日志(不可逆)

时间格式

  • 示例:30s、15m、12h、7d

安装

  • 将模组 jar 放入 Forge 服务端的 mods 文件夹
  • 需要 Java 17(Forge 1.19+)
  • 首次运行后生成配置文件

配置

  • 数据库:
    • SQLite:默认位于 gameDir/craftaudit/craftaudit.db
    • MySQL:可配置主机、端口、数据库、用户、密码、SSL、参数

数据与隐私

  • 仅记录审计/回滚所需的基本事件、坐标、物品/方块/实体 ID
  • 破坏方块实体时存储其 NBT(压缩、大小受限、可选启用)
  • 定期使用 purge 清理旧日志

构建

  • 需要 JDK 17 和 Forge MDK
  • 典型步骤:导入 Gradle、同步依赖、构建 jar

贡献

  • 欢迎提交 Issue、PR 和功能请求

许可证

依据 Creative Commons Attribution 4.0 International(CC BY 4.0)许可
参见 LICENSE。

Copyright (c) 2025 CraftAudit contributors