# LogBlock – 高级方块记录与管理工具
LogBlock 是一个轻量级且强大的 Minecraft 插件，它追踪服务器上每个玩家的所有操作。专为想要完全控制方块事件的管理员设计的本插件，实时记录方块放置、方块破坏和玩家互动，同时提供易于使用的管理工具来监控和调查活动。
## 特性
* **全面的方块追踪：** 自动记录方块放置和破坏，包含玩家、位置、类型和时间戳。
* **管理工具：** 特殊的“记录棒”允许管理员在游戏内直接检查方块记录。
* **持久存储：** 使用 HikariCP 配合 SQLite，提供快速可靠的数据管理。
* **事件记录 API：** 易于扩展，可用于自定义记录或与其他插件集成。
* **基于权限的访问：** 只有拥有 `logblock.admin` 权限的玩家才能使用管理命令。
* **最小的性能影响：** 优化的数据库连接和异步记录确保流畅的游戏体验。
## 指令
* `/logblock getstick` – 给予管理员一个特殊的记录棒来检查方块记录。
## 完美适合
* 希望防止破坏或追踪玩家活动的服务器。
* 需要可靠的实时记录解决方案的管理员。
* 任何想要高级、轻量级记录工具的 Minecraft 服务器。
## 与 Timber 的集成
LogBlock 可以与 [Timber](https://www.curseforge.com/minecraft/bukkit-plugins/treetimber) 插件一起使用，以增强树木记录和监控。当安装了 Timber 时，LogBlock 会记录树木砍伐造成的方块破坏的详细记录，从而让服务器管理员：
- 追踪哪些玩家在砍伐树木。
- 监控大规模的采伐事件。
- 调查与树木砍伐相关的意外或故意破坏行为。
- 将树木砍伐行为集成到自定义分析或管理工具中。
此集成确保所有 Timber 操作都被安全地实时记录，并且可以通过 LogBlock 的 API 访问，从而为服务器上的林业活动提供完整的审计跟踪。
## 将 LogBlock 作为 API 使用
LogBlock 不仅仅是一个插件——它还提供了一个 **完全可访问的 API** 给开发者。你可以将它集成到你自己的插件或工具中，以实时访问方块记录、玩家操作和历史数据。
### 示例用法
`LogBlockApi api = LogBlock.getLogBlockApi();`
`// 获取所有记录条目 List logs = api.getLogEntry();`
`// 添加自定义记录 LogEntry customLog = new LogEntry(playerUUID, x, y, z, world, LogEntry.BlockAction.PLACE, Material.STONE, System.currentTimeMillis()); api.addLogEntry(customLog);`
`// 获取特定方块上的最后一次操作 LogEntry last = api.getLastLogAtLocation("world", 100, 64, -200);`