块回滚

块回滚

你可以回滚对块的更改或实体的删除,并查看历史记录。

BlockRollback

BlockRollback 是一款适用于 Bukkit 系 1.21.x 服务器(如 Paper、Spigot、Purpur)的轻量级审计与回滚插件。 它会将玩家行为、部分自然变化以及命令编辑记录到 SQLite 中,以便之后通过 inspect、lookup 和 rollback 进行检查、查询和回滚。

你可以用 /br 作为 /blockrollback 的别名。

主要功能

  • 记录方块的放置与破坏、桶操作、爆炸、火焰、流体流动以及自然方块更新
  • 记录容器物品交易和方块点击交互
  • 记录方块放置与破坏、生物死亡、物品消失,以及由 /fill 和 /kill 引起的更改
  • Inspect 模式可让你就地查看所点击坐标的历史记录
  • 按玩家名、特殊标签、时间范围和半径搜索日志
  • 支持回滚方块变化,也可以恢复被击杀的生物和消失的物品
  • 本地使用 SQLite,无需外部数据库服务器
  • 支持多语言消息

支持环境

  • Bukkit 系 1.21.x
  • 基于 Paper API 1.21.4
  • Java 21
  • Paper、Spigot、Purpur 及兼容的加载器

命令

命令 描述
/br inspect [on|off] 切换 Inspect 模式。开启时,点击方块会显示该方块位置的历史记录。
/br lookup <player|*|#Mobs|#DespawnItem> <time> [radius] [page] 搜索符合给定条件的日志。time 使用 30m、1h、1d、1w、1y 等格式。
/br rollback <player|*|#Mobs|#DespawnItem> <time> [radius] 应用符合给定条件的可回滚记录。
/br tp <world> <x> <y> <z> 传送到查询结果中的坐标。
/br cancel 取消当前正在运行的回滚。
/br status 显示数据库大小、日志数量、写入队列状态和回滚进度。
/br reload 重新加载 config.yml、config.json 和语言文件。
/br help 显示帮助。

示例

  • /br inspect on
  • /br lookup Steve 1h 20
  • /br lookup #TNT 1d
  • /br rollback Steve 30m 20
  • /br rollback #Mobs 15m 30
  • /br rollback #DespawnItem 10m 20

过滤器的工作原理

  • 像 Steve 这样的玩家名会定位与该玩家相关的方块更改
  • * 会定位范围内所有可回滚记录
  • #Mobs 会定位生物死亡记录
  • #DespawnItem 会定位物品消失记录
  • #TNT、#Creeper、#Fire、#Fluid 和 #Natural 等特殊标签也可用于查询和回滚

记录内容

可回滚

  • 方块放置与破坏
  • 桶的放置与拾取
  • 爆炸造成的破坏
  • 火焰造成的燃烧
  • 流体流动
  • 自然方块变化
  • 由 /fill 引起的方块更改
  • 由 /kill 引起的生物死亡和生物移除
  • 物品消失

仅审计

  • 将物品放入容器和从容器取出物品
  • 对方块左键和右键交互

权限

权限 描述 默认
blockrollback.inspect 切换 Inspect 模式 OP
blockrollback.lookup 运行 lookup 并使用 /br tp OP
blockrollback.rollback 运行回滚和取消 OP
blockrollback.admin 运行 status 和 reload OP

配置

config.yml

主要设置:

键 描述
database-file SQLite 文件名
log.block-place-break 记录方块放置与破坏
log.buckets 记录桶操作
log.container-transactions 记录容器交易
log.item-despawn 记录物品消失
log.mob-kill 记录生物死亡
log.interactions 记录方块点击
log.explosions 记录爆炸
log.fire 记录火焰造成的燃烧
log.fluid-flow 记录流体流动
log.natural-block-updates 记录自然方块更新
inspect.use-adjacent-when-holding-block 手持方块并右键时,检查相邻目标位置
rollback.default-radius 玩家省略半径时使用的默认半径
rollback.max-radius 最大回滚半径
rollback.max-records-per-run 一次回滚运行中处理的最大记录数
rollback.apply-per-tick 每 tick 应用的记录数
command-tracking.fill 启用 /fill 追踪
command-tracking.fill-max-blocks /fill 追踪的最大方块数
command-tracking.kill 启用 /kill 追踪
command-tracking.kill-max-entities /kill 追踪的最大实体数
command-tracking.console-world 控制台执行命令时使用的世界名
command-tracking.notify-skip 当目标过大而跳过追踪时发出通知

config.json

config.json 用于配置语言。

{
  "configVersion": 1,
  "language": "en_us "
}

支持的语言:

  • ja_jp
  • en_us
  • de_de
  • fr_fr
  • ru_ru
  • zh_cn

首次启动时的默认值为 en_us。 你也可以编辑 plugins/BlockRollback/lang/ 中生成的 .lang 文件来创建自己的翻译。

行为说明

  • 一次只能运行一个回滚
  • 对于 lookup 和 rollback,当由玩家运行时,半径过滤使用执行者的当前位置
  • 基于半径的 lookup 无法从控制台使用
  • 启用 Inspect 模式时,正常方块交互会被取消,以便将点击用于审计显示
  • 如果目标世界不存在或目标实体已存在,则跳过该记录

存储数据

  • 日志以 SQLite 形式存储在 plugins/BlockRollback/<database-file>
  • 表名为 action_logs
  • 会为时间、玩家名加时间以及位置创建索引