CoreProtect命令入门教程
CoreProtect 命令入门教程
面向服务器管理员。教你用
/co系列命令查事件、抓破坏、回滚现场。 默认你有 OP 或coreprotect.*权限。
核心概念(先看这 30 秒)
CoreProtect 帮你做四件事,每件事一个命令:
| 想干什么 | 命令 | 简写 |
|---|---|---|
| 拿"探测棒"现场点方块查 | /co inspect |
/co i |
| 用过滤条件查日志 | /co lookup <参数> |
/co l |
| 把符合条件的改动撤回去 | /co rollback <参数> |
/co rb |
| 把撤回去的再恢复 | /co restore <参数> |
/co rs |
所有命令共用一套参数(u: t: r: a: b: e: i: x:),学会一次就行。
铁律:回滚之前必须先 lookup 确认范围。 直接 rollback 翻车不可恢复(只能再 restore 一次,但中间产生的新破坏也会一起带回来)。
一、Inspector(探测模式)— /co i
最常用的入门工具。开启后,你点方块就能看记录,不用打任何参数。
/co i # 切换探测模式,再输一次就关
开启后:
| 操作 | 效果 |
|---|---|
| 左键点方块 | 看这块之前被谁放的(它现在的位置原来是什么) |
| 右键点方块 | 看相邻方块的活动(也就是这块旁边发生了什么) |
| 右键点容器 | 查该容器的物品存取流水(谁拿了什么、谁放了什么) |
| 左键点空气 | 把"目标方块"前移一格(用于看悬空位置原本是什么) |
聊天框会输出一条条记录,长这样:
----- CoreProtect -----
2.34/h ago - Steve removed #diamond_ore.
2.34/h ago - §7Steve placed #cobblestone.
带 §7 灰色的条目表示这条记录已经被回滚过了。
调查破坏现场,90% 的工作都是开着 inspect 模式到处点。
二、Lookup(查询)— /co l <参数>
用参数过滤数据库,适合事后调查、远程查询、统计。
/co l u:Steve t:1h # Steve 过去一小时干了啥
/co l u:Steve a:-block t:2h # Steve 过去两小时破坏了哪些方块
/co l r:20 a:+container t:1d # 我周围 20 格内,过去一天谁往容器里放了东西
翻页
/co l 2 # 上一次查询的第 2 页
/co l 3
看不完整时,鼠标悬停聊天里的条目,会显示完整坐标 + 维度
三、参数系统(这部分是核心,背下来)
所有 /co l /co rb /co rs 都用同一套参数。参数之间用空格分隔,顺序无所谓。
3.1 u:<玩家> — 用户
u:Steve # 玩家 Steve
u:Steve,Alex # 多个玩家用逗号
u:#creeper # 苦力怕(实体造成的破坏前面加 #)
u:#tnt # TNT
u:#fire # 火
u:#water # 水流
3.2 t:<时间> — 时间范围(从过去多久到现在)
t:30s # 过去 30 秒
t:5m # 过去 5 分钟
t:2h # 过去 2 小时
t:1d # 过去 1 天
t:1w # 过去 1 周
t:1d2h30m # 可以组合
不写 t: 默认是过去 3 周(回滚命令必须显式写 t:)。
3.3 r:<半径> — 范围
r:10 # 自己周围 10 格(立方体)
r:50 # 周围 50 格
r:#world # 整个 world 维度
r:#worldedit # 你 WorldEdit 选区内
r:#global # 全服所有维度(慎用)
不写 r: 默认是全服。做回滚一定要写 r:,否则可能把整个服务器干翻。
3.4 a:<动作> — 动作类型
最常用的几个:
| 参数 | 含义 |
|---|---|
a:+block |
放置方块 |
a:-block |
破坏方块 |
a:block |
放置 + 破坏 |
a:+container |
往容器里放东西 |
a:-container |
从容器里拿东西 |
a:container |
容器存取(全部) |
a:+item |
物品进入背包(捡起、合成等) |
a:-item |
物品离开背包(丢弃、消耗等) |
a:click |
玩家交互(开门、按按钮、踩压力板) |
a:kill |
实体死亡 |
a:chat |
聊天消息 |
a:command |
执行命令 |
a:session |
登录登出 |
a:username |
改名 |
a:sign |
告示牌文字 |
3.5 b:<方块> / e:<实体> — 类型过滤
b:diamond_ore # 只看钻石矿石
b:diamond_ore,gold_ore # 多个用逗号
e:villager # 村民
e:cow,sheep # 牛和羊
3.6 i: / x: — 包含 / 排除
i:diamond_ore # 只包含这种(等同于 b:)
x:cobblestone,dirt # 排除圆石和泥土(查盗采时很有用)
典型用法:查破坏时排除掉自然方块,只看值钱东西:
/co l u:Steve a:-block t:1d x:stone,dirt,grass_block,cobblestone
3.7 特殊关键字
#worldedit— 限定在你的 WE 选区内#global— 全服(回滚命令需显式声明)#preview— 仅预览不执行(回滚必备,见下)
四、Rollback(回滚)— /co rb
把符合条件的改动撤回去。命令格式和 lookup 一模一样,只是把 l 换成 rb。
4.1 先预览,再执行
永远先用 #preview(或直接 lookup)预览:
/co rb u:Steve t:2h r:30 #preview # 预览:服务器会播出动画但不真正改动
/co rb u:Steve t:2h r:30 # 确认无误,真正执行
#preview 模式下,被回滚的方块会以"幽灵"形式显示给你看,不会真的改世界。你重新输一遍不带 #preview 的命令就提交。
4.2 必填项
回滚命令必须包含时间 t:,否则会拒绝执行。强烈建议同时包含 r: 或 u:,否则范围太大。
4.3 典型回滚
# 把 Steve 过去一小时干的所有破坏全部回滚,半径 50 格
/co rb u:Steve t:1h r:50
# 把苦力怕过去一天炸的所有坑全部修复(全服)
/co rb u:#creeper t:1d r:#global
# 只回滚某玩家偷的容器物品
/co rb u:Steve t:6h a:-container
# 在你的 WE 选区内回滚指定时间段
/co rb t:30m r:#worldedit
五、Restore(恢复)— /co rs
把刚才回滚掉的再恢复回去。用来撤销 rollback 的失误。
参数和 rb 完全一样:
# 哎我刚才把范围搞错了,撤销
/co rs u:Steve t:1h r:50
⚠️ 注意:rs 不是"时光机",它只能恢复已经被 CoreProtect 记录过的状态。如果你 rollback 之后又有人做了新改动,rs 会把那些新改动也一起带回到 rollback 前的样子。
六、实战场景(照抄就能用)
场景 1:苦力怕在主城炸了个坑
站到坑边上,半径覆盖坑就行:
/co rb u:#creeper t:1h r:15 #preview
/co rb u:#creeper t:1h r:15
场景 2:Steve 拆了别人的房子
先查范围:
/co i # 开探测,左键点几块残骸确认是 Steve 干的
/co l u:Steve a:-block t:3h r:50 # 查具体范围
/co rb u:Steve a:-block t:3h r:50 # 回滚
场景 3:Steve 偷了别人箱子里的钻石
# 查箱子流水(站在箱子旁边)
/co l a:container t:1d r:3
# 看到 Steve 拿了之后,把容器物品还原
/co rb u:Steve a:-container t:1d
容器回滚只回滚物品,不影响方块本身。
场景 4:Steve 过去 6 小时所有破坏行为全部撤销
/co rb u:Steve a:-block t:6h r:#global
场景 5:回滚搞错了,撤销
把刚才那条命令的 rb 换成 rs:
/co rs u:Steve a:-block t:6h r:#global
场景 6:谁打死了我的村民
站在村民死亡点附近:
/co l a:kill e:villager t:2h r:20
场景 7:谁在主城开了铁门
/co l a:click t:1h r:5 # 站在门旁边,半径 5
场景 8:某玩家最近聊了什么 / 执行了什么命令
/co l u:Steve a:chat t:1d
/co l u:Steve a:command t:1d
场景 9:某区域内谁动过这个箱子
/co i # 开探测
# 右键这个箱子,直接看流水
场景 10:物品溯源 — 谁第一个挖到了这把附魔剑
CoreProtect 不能查物品 NBT 链路,但可以查容器流水:
/co l a:container i:diamond_sword t:30d r:#global
七、辅助命令
/co help # 命令帮助
/co status # 插件状态(版本、数据库大小、队列长度)
/co reload # 重载配置(不重启)
/co near # 速查:周围 5 格、过去几分钟的全部活动
/co near u:Steve # near 也支持参数
/co undo # 撤销你上一次的 rb/rs(等同 rs/rb)
/co purge t:30d # 清理 30 天前的旧日志,释放数据库空间
/co near 是巡服神器,看到可疑现场直接打这一条就够了。
/co purge 建议每月跑一次。数据库膨胀之后查询会变慢,SQLite 尤其明显。
八、常见坑
t:不写默认 3 周,回滚命令会拒绝执行。 回滚必须显式写时间。r:不写默认全服,lookup 没事,rollback 灾难。 养成总是带r:的习惯。/reload会损坏 CoreProtect 数据库连接,改完配置用/co reload或重启服务器,别用 Bukkit 的/reload。- 聊天里悬停坐标可以点击传送(如果服务器支持),但前提是消息要悬停看完整内容。
- 容器流水占数据库 60%+ 的空间,如果你不需要可以在 config 关掉
chest-transactions(但关了就查不了偷箱子)。 - 回滚不会回滚玩家经验、生命值、效果,只针对方块/容器/实体。玩家死亡后掉落物可以通过
a:-item查,但本体回不来。 - WorldEdit 操作默认走 CoreProtect 记录(
disable-worldedit: false),也就是说//set之后也能被/co rb撤销。 #preview看到的是"如果回滚会变成什么样",不是当前状态。退出预览模式重新输不带#preview的命令才真正执行。
九、最短上手路径
如果你只想最快地用起来,记这五条:
/co i # 探测模式,点点点
/co near # 周围有啥动静
/co l u:玩家 t:1h # 这玩家最近一小时干了啥
/co rb u:玩家 t:1h r:50 #preview # 预览回滚
/co rb u:玩家 t:1h r:50 # 真回滚
剩下的参数,需要的时候回来查表就行。