# 🚁 EasyCFly - 高级基于领地的飞行插件
[](https://github.com/turjo/EasyCFly)
[](https://www.spigotmc.org/)
[](LICENSE)
[](https://www.oracle.com/java/)
> **最先进、功能最丰富的 Minecraft 服务器基于领地的飞行插件**
## ✨ 功能
### 🎯 核心功能
- **智能领地检测** - 自动检测来自多个插件的领地
- **信任系统** - 允许特定玩家在你的领地内飞行
- **飞行时间限制** - 可配置的飞行时长，带有警告提示
- **冷却系统** - 使用可自定义的冷却时间，防止飞行垃圾信息
- **经济整合** - 通过 Vault 支持为飞行收费
- **多世界支持** - 每个世界都有飞行设置和限制
### 🎨 视觉效果
- **粒子轨迹** - 飞行时漂亮的粒子效果
- **动作栏消息** - 实时飞行信息
- **Boss 栏计时器** - 视觉化的飞行时间倒计时
- **声音效果** - 沉浸式的音频反馈
- **自定义 GUI** - 直观的飞行管理界面
### 🔧 高级功能
- **飞行区域** - 定义飞行特定区域
- **反作弊整合** - 与主要的防作弊插件兼容
- **统计跟踪** - 跟踪飞行时间与距离
- **PlaceholderAPI 支持** - 丰富的占位符整合
- **Discord 整合** - 将飞行事件记录到 Discord
- **数据库支持** - SQLite 和 MySQL 支持
- **性能优化** - 异步操作和缓存
### 🛡️ 领地插件支持
- **WorldGuard** - 全区域支持
- **GriefPrevention** - 完全的领地整合
- **Lands** - 高级的土地管理
- **Towny** - 城镇和国家支持
- **Residence** - 住宅区域支持
- **自动检测** - 自动查找并整合
## 📋 要求
- **Minecraft 版本**: 1.20.4+
- **Java 版本**: 17+
- **服务器软件**: Spigot, Paper 或其变种
- **依赖**: 至少一个支持的领地插件
- **可选**: Vault（用于经济），PlaceholderAPI（用于占位符）
## 🚀 安装
1. **下载** 最新版本从 [Releases](https://github.com/turjo/EasyCFly/releases)
2. **放置** JAR 文件到你服务器的 `plugins` 文件夹
3. **安装** 支持的领地插件 (WorldGuard, GriefPrevention, 等)
4. **启动** 你的服务器
5. **配置** 插件在 `plugins/EasyCFly/config.yml`
6. **重新加载** 使用 `/cflyreload`
## 🎮 命令
| 命令 | 描述 | 权限 |
|---------|-------------|------------|
| `/cfly` | 切换飞行开关 | `easycfly.fly` |
| `/cfly on` | 启用飞行 | `easycfly.fly` |
| `/cfly off` | 关闭飞行 | `easycfly.fly` |
| `/cfly status` | 查看飞行信息 | `easycfly.fly` |
| `/cfly time` | 检查剩余飞行时间 | `easycfly.fly` |
| `/cflytrust <玩家>` | 信任某个玩家飞行 | `easycfly.fly` |
| `/cflyuntrust <玩家>` | 取消信任某个玩家 | `easycfly.fly` |
| `/cflyinfo` | 详细的飞行信息 | `easycfly.fly` |
| `/cflyreload` | 重新加载配置 | `easycfly.admin.reload` |
## 🔑 权限
### 基本权限
- `easycfly.fly` - 基本飞行权限
- `easycfly.fly.unlimited` - 无限飞行时间
### 管理员权限
- `easycfly.admin.*` - 所有管理员权限
- `easycfly.admin.reload` - 重新加载配置
- `easycfly.admin.toggle` - 为他人切换飞行
### 绕过权限
- `easycfly.bypass.cooldown` - 绕过飞行冷却
- `easycfly.bypass.cost` - 绕过飞行费用
- `easycfly.bypass.time` - 绕过时间限制
## 📊 PlaceholderAPI 占位符
| 占位符 | 描述 |
|-------------|-------------|
| `%easycfly_flying%` | 飞行状态 (true/false) |
| `%easycfly_can_fly%` | 是否可以在当前位置飞行 |
| `%easycfly_time_remaining%` | 剩余飞行时间 |
| `%easycfly_cooldown%` | 剩余冷却时间 |
| `%easycfly_trusted_count%` | 信任玩家的数量 |
| `%easycfly_flight_cost%` | 启用飞行的费用 |