
方块审计
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)
- 时间格式:Ns/Nm/Nh/Nd(例如
回滚/恢复/撤销
/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、参数
- SQLite:默认位于
数据与隐私
- 仅记录审计/回滚所需的基本事件、坐标、物品/方块/实体 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
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。