# FreeProtect — 块记录与保护插件
**FreeProtect** 是一个轻量级、高效且功能丰富的 Minecraft 插件，旨在记录玩家的方块交互，并帮助服务器所有者跟踪破坏行为或可疑活动。 通过简单的命令和强大的搜索工具，FreeProtect 可以轻松保护您的世界，而无需不必要的冗余。
---
## ✨ 特点
* 记录方块破坏/放置事件，包含 **时间戳、位置、玩家姓名 & UUID**。
* **基于半径的搜索**，可在您周围搜索事件。
* **可点击的聊天组件**，可用于传送到已记录的操作。
* **分页结果**，并带有易于使用的导航按钮 (⏮ ◀ ▶ ⏭)。
* 完全异步搜索（无延迟）。
* 开箱即用，无需复杂设置。
---
## 📜 命令
| 命令 | 描述 |
| ------------------------------------------ | -------------------------------------------------------------------------------- |
| `/fp lookup event:<事件> radius:<方块>` | 在您周围搜索事件。 例如: `/fp lookup event:PlayerBlockBreak radius:20` |
| `/fp page <页码>` | 显示特定的搜索结果页。 |
| `/fp help` | 显示所有可用命令。 |
---
## 🔍 使用示例
### 1. 查找方块破坏
```mcfunction
/fp lookup event:PlayerBlockBreak radius:15
```
* 显示您位置 15 块范围内的所有破坏方块。
* 悬停在 **玩家姓名** 上以查看其 UUID。
* 悬停在 **位置行** 上并点击立即传送到那里。
### 2. 浏览页面
```mcfunction
/fp page 2
```
* 如果有多个页面可用，则显示结果的第二页。
### 3. 帮助菜单
```mcfunction
/fp help
```
* 显示可用命令的列表。
---
## 📖 搜索结果示例
```
3 分钟前 - Steve 破坏了石头。
(x120/y64/z-300/world)
```
* 悬停 `Steve` → 显示 UUID。
* 悬停 `(x120/y64/z-300/world)` → 工具提示：“点击传送”。
* 点击位置 → 立即传送到那里。
---
## 🚀 安装
1. 从 [Modrinth](https://modrinth.com/) 下载插件 JAR 文件。
2. 将其放入服务器的 `/plugins/` 文件夹中。
3. 重新启动服务器。
4. 完成！ 🎉
---
## 🛠️ 权限
| 权限 | 描述 |
| -------------------- | ------------------------------------- |
| `freeprotect.use` | 允许玩家使用搜索命令。 |
---
## 🧭 路线图
* 支持更多事件类型 (放置、交互)。
* 基于 GUI 的日志查看器。
* MySQL/SQLite 存储后端。
---
## ❤️ 贡献
欢迎参与、建议和 PR！ 帮助 FreeProtect 成为 Minecraft 社区中最佳的免费方块记录插件。
---
## 📌 总结
FreeProtect 是您在 Bukkit/Spigot/Paper 服务器上使用 **方块记录插件** 的首选选择。 易于使用，没有设置难题，并且具有在性能方面考虑周到的强大搜索功能。