# FeatherTP (Feather Teleport)
FeatherTP 是一个 Minecraft 插件，允许玩家随机传送到 Minecraft 世界中的安全位置。该插件轻量且易于使用，非常适合希望在不影响服务器性能的情况下添加随机传送功能的服务器。
## 特性
- 随机传送到安全位置
- 可配置的传送范围和中心位置
- 传送之间的冷却设置
- 支持多个世界（world_nether, world_the_end, 等）
- 重新加载命令以重新加载配置
## 安装
1. 从 [Releases](https://github.com/Lightnabz/FeatherTP/releases) 下载 `.jar` 文件。
2. 将 `.jar` 文件放入你的 Minecraft 服务器的 `plugins` 文件夹中。
3. 重启你的 Minecraft 服务器。
## 使用方法
要使用 FeatherTP，请按照以下步骤操作：
1. **随机传送命令**
玩家可以使用 `/rtp` 命令随机传送到安全位置。此外，该插件还支持别名，如 `/tpr` 和 `/ltp`。
示例：
```
/rtp
/tpr
/ltp
```
2. **管理员命令**
- 重新加载插件配置：
```
/feathertp reload
```
此命令重新加载 `config.yml` 文件，无需重启服务器。
3. **权限**
- `feathertp.use`: 允许玩家使用 `/rtp`, `/tpr` 和 `/ltp` 命令。
- `feathertp.admin`: 授予访问 `/feathertp reload` 等管理员命令。
请确保在服务器的权限管理插件（例如 LuckPerms）中配置权限，以控制对这些命令的访问。
## 配置
该插件使用 `config.yml` 文件进行配置。以下是配置结构的示例：
```yaml
permissions:
require-use-permission: true # 如果为 true，则只有具有 `feathertp.use` 权限的玩家才能使用 /rtp
world:
teleport:
random:
minRange: 100 # 传送的最小范围
maxRange: 1000 # 传送的最大范围
centerX: 0 # 传送中心的 X 坐标
centerZ: 0 # 传送中心的 Z 坐标
maxTries: 10 # 找到安全位置的尝试次数
cooldownSeconds: 30 # 传送之间的秒数冷却时间
```
## 编译/构建
要从源代码构建 FeatherTP 插件，请按照以下步骤操作：
1. **克隆存储库**
将 FeatherTP 存储库克隆到您的本地计算机：
```bash
git clone https://github.com/Lightnabz/FeatherTP.git
cd FeatherTP
```
2. **确保先决条件**
确保已安装以下内容：
- [Java Development Kit (JDK)](https://www.oracle.com/java/technologies/javase-downloads.html) (版本 21 或更高版本)
- [Maven](https://maven.apache.org/)
3. **构建插件**
使用 Maven 编译插件并将它打包成 `.jar` 文件：
```bash
mvn clean package
```
4. **找到输出**
构建过程完成后，`.jar` 文件将位于 `target` 目录中。
您现在可以使用生成的 `.jar` 文件，如 [安装](#installation) 部分所述。