# Unstuck 插件
## 描述
Unstuck 插件专为 Minecraft Spigot 服务器设计，旨在帮助卡在基岩层（高度 127）中的玩家。 此插件提供了一个简单的命令，将玩家传送到更安全的位置，确保他们可以继续他们的冒险，而不会被困住。
## 功能
- **Unstuck 命令**: 玩家可以使用的命令，将他们传送到基岩层之外的安全位置。
- **安全传送**: 插件会计算出基岩层上方或预定义的安全区域内的安全位置。
- **可配置的设置**: 服务器管理员可以配置安全传送位置或玩家应该传送到的高度。
- **基于权限的访问**: 只有具有适当权限的玩家才能使用 unstuck 命令，以确保公平使用。
## 命令
- `/stuck` - 将玩家传送到更安全的位置
- `/escape` - 玩家逃到更安全的位置
## 权限
无需任何。
## 安装
1. 下载插件 jar 文件。
2. 将 jar 文件放在你的 Spigot/Paper 服务器的 `plugins` 文件夹中。
3. 重新启动服务器以加载插件。
4. 如果需要，在生成的 `config.yml` 文件中配置插件设置。
## 配置
`config.yml` 文件允许服务器管理员设置安全传送位置或玩家应该传送到的高度。 示例配置：
```yaml
# UnstuckPlugin 配置
# /stuck 命令使用之间的秒数
cooldown-seconds: 30
# 搜索安全位置的当前位置半径
search-radius: 5
# 查找安全位置的最大尝试次数
max-attempts: 50
# 安全位置的 Y 坐标范围
# 如果需要，这些值会根据世界最小/最大 Y 坐标进行调整
min-y: 32
max-y: 120
# 请勿触碰此选项！！
# 启用调试日志记录 (仅用于故障排除，因为它旨在收集日志文件)
debug: false
```