# 区域事件 | [](https://app.codacy.com/gh/aivruu/region-events/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
[](https://jitpack.io/#aivruu/region-events)
`RegionEvents` 是一个现代插件，用于管理玩家在其世界中进入或离开 `WorldGuard` 区域的时间。 此插件提供 API 来处理位于区域内的玩家，提供搜索世界或位置区域的功能，以及监听玩家进入或离开区域的事件。
此插件专为在 1.21.1 及更高版本上运行 `Paper (或分支)` 而设计。
## 功能
* 监听玩家进入或离开区域的事件。
* 提供有用的函数来搜索指定世界或位置上的潜在区域，或获取位于区域内的玩家。
* 异步：插件使用异步任务来检查玩家在区域内/外的移动，以在区域操作事件触发之前。
* 易于使用。
## 文档
插件本身的源代码已经过记录，以便充分了解插件的作用，并且如果其他开发者想贡献，知道在哪里以及如何进行。 无论如何，都有指南来了解如何实现和使用插件的 API 类、实用程序和事件。
* [插件 API 导入](https://github.com/aivruu/region-events/blob/main/docs/install-guide.md)； 用于插件 API 安装。
* [API 实例访问](https://github.com/aivruu/region-events/blob/main/docs/api-access-guide.md)； 了解如何获取插件 API 实例。
* [RegionHelper 用法](https://github.com/aivruu/region-events/blob/main/docs/region-helper-usage-guide.md)； 区域管理可用函数概览。
* [可用事件](https://github.com/aivruu/region-events/blob/main/docs/events-guide.md)； 插件提供的可用事件。
## 构建
插件的依赖管理结构使用 Gradle-Kotlin，并且需要 Java 21+ 用于编译。
```
git clone git@github.com:aivruu/region-events
cd region-events
./gradlew shadowJar
```