# ShadowTrace 服务器插件
ShadowTrace 服务器插件是 ShadowTrace 模组的强大后端伴侣，专为在 Paper 平台运行的 Minecraft 服务器设计。它提供 ShadowTrace 游戏中可视化功能所必需的服务器端功能。该插件与 CoreProtect 集成，以分析和跟踪特定玩家在定义的时间段内进行的方块挖掘活动。
通过异步处理 CoreProtect 数据，ShadowTrace 可以直观地显示矿物已被开采的地方——帮助管理员和版主实时或事后检测潜在的 X 射线使用。该插件通过插件消息通道直接与 ShadowTrace 模组通信，以提供这些数据。
**ShadowTrace 模组需要在服务器上才能正常运行此插件。**
**ShadowTrace 插件需要 CoreProtect 才能正常运行。**
[在此处下载 ShadowTrace 客户端模组。](https://modrinth.com/mod/shadowtrace)
## 功能
* 查看玩家的 historical 挖掘活动。
* 查看挖掘方块的精确坐标。
* 通过玩家和时间范围（例如 `1m`、`1h`、`1d`）进行过滤。
* 支持每个搜索最多 300 个方块，已针对可见性进行了优化。
* 适用于在线和离线玩家。
* 使用自定义数据包系统进行高效的数据传输。
## 命令
玩家需要 `shadowtrace.command.shadowtrace` 权限才能使用任何命令。
## `/shadowtrace getores [player] [time]`
此命令允许您检索并可视化特定玩家在给定时间范围内内的矿物开采活动。它从 CoreProtect 中提取数据，并将其发送到 ShadowTrace 模组进行游戏内显示。
### 参数
* `[player]` - 您要检查其挖掘活动的的目标玩家。
* `[time]` - 要搜索的时间范围，使用诸如：
`1m` = 1 分钟
`1h` = 1 小时
`1d` = 1 天
**示例用法：**
`/shadowtrace getores Steve 2h`
这将显示史蒂夫在过去 2 小时内开采的矿物位置。
## `/shadowtrace blocks [player] [time] [blocks]`
此命令允许您可视化目标玩家在定义的时间窗口内执行的具体方块破坏事件。您可以通过在 `[blocks]` 参数中列出它们来指定您感兴趣的精确方块类型。
### 参数
* `[player]` - 您要检查其方块破坏活动的玩家。
* `[time]` - 要搜索的时间范围，使用诸如：
`1m` = 1 分钟
`1h` = 1 小时
`1d` = 1 天
* `[blocks]` - 方块类型（如枚举名称，例如 DIAMOND_ORE,GOLD_ORE）的逗号分隔列表。
**示例用法：**
`/shadowtrace blocks Steve 1d DIAMOND_ORE,GOLD_ORE,SPAWNER`
这显示了史蒂夫在过去一天中破坏的任何指定方块 (钻石矿石、金矿石和 Spawner)。