Spyglass

插件

· 作者 itdontmattamc

适用于 Paper 1.21+ 的企业级日志记录、检查与回滚

0 本站下载 0 关注 更新于 4 个月前

最新 1.0.2 · 26.2 · Paper

一键开服(送7天)

Spyglass

Spyglass 记录方块、容器、聊天、命令、战斗和移动事件,允许你使用 key:value 语言查询它们,并支持按玩家、区域、原因或批量回滚任何操作 - 同时服务器保持 20 TPS。

三种存储后端:嵌入式 SQLite(零设置,默认)、MongoDB 和 ClickHouse。SQLite 让它像 CoreProtect 一样易于部署;当你需要更大容量时,可以使用更大的后端。


性能

2,000,376 方块回滚 - Paper 1.21.8,6 GB 堆内存,Aikar 标志:

SG SQLite SG MongoDB SG ClickHouse CP SQLite CP MySQL
回滚 ~3 秒 ~7 秒 ~5 秒 ~11 秒 ~12 秒
撤销/恢复 ~3 秒 ~6 秒 ~4 秒 ~9 秒 ~210 秒
TPS (最低/平均) 20.0 / 20.0 20.0 / 20.0 20.0 / 20.0 14 / 19 13 / 20
最差的单个刻 ~37 毫秒 ~100 毫秒 ~50 毫秒 ~670 毫秒 ~270 毫秒
磁盘占用 ~156 MiB ~145 MiB ~11 MiB ~160 MiB ~180 MiB

回滚完全在主线线程外运行。没有后端低于 20 TPS。


功能

仅 Spyglass

  • 战斗日志 - 命中和投射物射击
  • 移动和传送日志
  • 命令日志中的密码脱敏
  • 通过显示名称、描述或附魔搜索物品
  • 通过可选的 Velocity 伴侣进行跨服务器搜索
  • 扩展 API - 自定义事件、查询参数、显示渲染器、回滚效果
  • 容器回收 - 回滚中被销毁的容器内的物品可通过 /sg inventory 恢复
  • 一键撤销,任意大小,回溯你的历史记录
  • 崩溃恢复 - 中断的回滚可以在重启后从保存的光标处恢复
  • 回滚不生成新的日志行
  • 自动数据修剪/可配置的 TTL
  • 回滚完全在主线线程外运行

与 CoreProtect 共享

  • 方块、实体和实体日志
  • 聊天、命令、会话和 IP 日志
  • 爆炸、火焰、液体和生长
  • WorldEdit 捕获 - 所有操作,不仅仅是 //set
  • 检查器魔杖和方块历史查找
  • 按玩家、时间或区域回滚和恢复

仅 CoreProtect

  • 应用前预览回滚

要求

  • Paper 1.21.8 或更新的 1.21.x(不支持 Spigot 或 Folia)
  • Java 21
  • 以下之一:SQLite(默认,零设置)、MongoDB 或 ClickHouse
  • 可选: WorldEdit 7.3+ 或 FastAsyncWorldEdit 2.15+ 用于编辑捕获和 -we 区域查询

命令

根命令:/spyglass 或 /sg。所有权限默认为 op。

命令 别名 权限
/sg search <query> s, lookup spyglass.search
/sg rollback <query> rb, roll spyglass.rollback
/sg restore <query> rs spyglass.rollback
/sg undo u spyglass.rollback
/sg rbqueue queue, rbq spyglass.rollback
/sg tool t, inspect spyglass.tool
/sg inventory inv, salvage spyglass.rollback
/sg events e spyglass.use
/sg page <n> p, pg spyglass.use
/sg help h, ? spyglass.use

两个权限控制一个功能而不是一个命令:

  • spyglass.search.ip - 显示加入 IP 并解锁 ip: 查询键
  • spyglass.worldedit - 允许 -we 标志使用 WorldEdit 选择作为搜索区域

查询语言

搜索、回滚和恢复共享一个 key:value 语法。组合任意数量的键;在值前加上 ! 以排除它。

/sg search p:Steve b:diamond_ore t:1d r:50
/sg rollback p:griefer a:break,!place t:6h r:100

键

键 说明
p: 玩家 - 逗号分隔表示 OR,p:!Steve 表示排除
a: 事件类型 - 参见 /sg events;a:!place 表示排除
b: 方块材料 - b:!chest 表示排除
i: 物品材料
iname: 物品显示名称(子字符串)
ilore: 物品描述行(子字符串)
ench: 附魔 - 例如 ench:sharpness=5
e: 实体类型
c: 原因 - 例如 c:tnt,!creeper
m: 聊天、告示牌或书籍文本(子字符串)
r: 半径(方块数)
t: 时间窗口 - t:1d, t:30m, t:1d12h(默认:4小时)
w: 世界名称
srv: 服务器名称(多服务器)
ip: 来源 IP - 需要 spyglass.search.ip

标志

标志 效果
-g 全局 - 跳过默认半径
-we 使用当前 WorldEdit 选择作为区域
-ord:asc / -ord:desc 排序顺序
-ng 不合并重复的相邻结果
-nc 抑制聊天摘要行
-ex 显示额外详细信息列
-nod:r,t 删除默认值(无半径或时间限制运行)

示例

# 谁在过去一天内破坏了这块方块?
/sg search b:* t:1d r:5

# 回滚玩家在过去两小时内所做的所有事情,全局范围。
/sg rollback p:Bob a:place,break t:2h -g

# TNT 破坏 - 玩家点燃的 TNT 归因于点火者。
/sg rollback p:griefer t:1h r:30

# 回滚除容器外的所有内容。
/sg rollback p:griefer t:6h r:100 b:!chest

# 谁捡起了名为 Excalibur 的剑?
/sg search a:pickup iname:Excalibur t:1w -g

# 追踪一把锋利 V 的物品通过掉落和拾取。
/sg search ench:sharpness=5 t:1d -g

# 特定 IP 今天运行的每个命令。
/sg search ip:1.2.3.4 a:command t:1d -g

# 恢复过去一小时内 WorldEdit 选择内的破坏。
//wand
/sg restore a:break t:1h -we

许可证

基于 PolyForm Internal Use License 1.0.0 的源码可用许可,并增加了 Minecraft 服务器的附加权限。您可以运行它并为自己的服务器分叉它,包括商业服务器。不允许重新分发、再许可和销售。

GitHub

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源