查看“︁guide for co”︁的源代码

== CoreProtect插件使用说明 ==

=== 简介 ===

[https://github.com/PlayPro/CoreProtect CoreProtect插件]，在本服中简称为coi。通过对玩家的全部行为进行记录，从而达到特定玩家回档、查询物品拿取记录与跟踪物品动向、物品被窃取后溯源的功能。以下是简易的插件使用说明。

在这里仅介绍普通玩家可用的功能，高权限组才可用的命令不予介绍。

=== coi命令 ===

通过输入<code>/coi</code>或<code>/co inspect</code>打开此功能。

输入后，点击任何容器，都不会直接打开容器的GUI，而是在对话框中出现此容器的操作记录，包括操作用户、操作时间、操作地点、操作物品种类与数量。

此功能打开后，无法对容器进行任何操作。如需关闭，再次打开对话框输入<code>/coi</code>或<code>/co inspect</code>关闭此功能。

=== co lookup命令 ===

<code>/co lookup</code>命令为本文的重点。你可以在主服内任意地点，通过<code>/co lookup</code>命令来实现对特定玩家的特定操作的查询。下面是使用方法。

===== co lookup命令的构成 =====

<code>/co lookup</code>命令由以下部分构成：

{| class="wikitable"
|-
| action || 行为
|-
| exclude || 不想查询的物品名称
|-
| include || 想要查询的物品名称
|-
| radius || 以玩家为中心的半径范围
|-
| time || 查询时间范围
|-
| user || 查询某位玩家
|-
| chat || 聊天记录
|-
| click || 点击信息
|-
| command || 使用命令的记录
|-
| kill || 死亡记录
|}

在这里只介绍前6项，其余不介绍。

====== action的相关操作 ======

输入<code>/co lookup action:</code>后,有几个选项，分别为：block、container、inventory、item、session，这几个选项含义如下
{| class="wikitable"
|-
| block || 对方块的操作
|-
| container || 对容器的操作
|-
| inventory || 物品栏的操作
|-
| item || 对掉落物的操作
|-
| session || 登入、登出信息
|}

每个操作都有+和-两种状态，分别代表对应的添加和删除。

对block而言，是玩家进行的放置方块和挖掉方块的操作

container，是玩家取出和放入容器的操作

inventory，是玩家对物品栏中内容的操作（很少用到）

item，是玩家丢弃、拾取物品的操作

session，是玩家登入、登出的操作

其中用的最多的功能是container相关（因为总有毛族人从箱子里毛东西）

=====exclude与include=====

这两项后面都跟随着物品名称，但要注意必须是官方的英文名称，中文是不可以的。

如果不知道英文名称，请百度/Bing/Google/ChatGPT/DeepSeek/Claude/Gemini

exclude为不想查询到的物品的信息，include是你想查询的物品的信息。如果想去除/添加多个物品，可以使用多个exclude与include来实现。

=====radius查询半径=====

radius有时需要指定，有时不需要。

radius可以查询特定的方块范围，如<code>radius:10</code>表示，查询以玩家为圆心，10个方块为半径的范围内的更改记录。

同时还有多种参数可选，例如<code>radius:#world_the_end</code>表示只查询末地范围。

=====time查询时间=====

时间（查询时间范围）是必须指定的参数。你可以根据需要自行设定。

=====user玩家=====

在前文提及的所有操作，你想查询谁做出的某项操作，通过user命令来指定。

===实战环节===
=====被毛怎样查=====

现在假设我的家中，有一盒贵重物品被毛族人取走，但我不知道是谁干的。我需要知道是谁，同时知道他是否还拿取了别的贵重物品。因此，首先需要使用<code>/coi</code>命令来查询是哪个玩家拿走了我的物品。现在假设通过<code>/coi</code>命令，我已查询到这个玩家叫做<code>Bane_Q</code>（×）

现在需要查询他在登入服务器的一个月内，是否拿取了其他贵重物品，此时需要<code>/co lookup</code>命令。

在本服务器中，贵重物品通常为各类下界合金盔甲、下界合金锭、NONO币、末影龙之眼、附魔书。这几项物品大致为：netherite_ingot、quartz、player_head、enchanted_book。例如我现在需要查询附魔书的拿取记录：

<code>/co lookup action:-container include:enchanted_book time:1m user:Bane_Q</code>

输入无误后，插件会返回拿取记录。此时就可以确定。

=====忘记东西在哪怎么查=====

本人经常会忘记盔甲/装备等放在了哪里。此时可通过插件查询记录

例如忘记了弓在哪里：
<code>/co lookup user:Pony_W include:bow action:+container time:100d</code>

这时就会返回信息。

{{待更新}}