# ConduitFly
**ConduitFly** 是一个专为 BentoBox -based 天空方块服务器设计的 Minecraft 插件。它允许玩家在其岛屿上放置可定制的 **Conduit 方块**，以在可配置的半径内提供 **临时飞行**。飞行时长、区域和防摔伤害都可以根据玩家的 **等级** 进行自定义。
---
## ✨ 功能
- 🔗 **BentoBox 集成**: 飞行由每个岛屿管理
- 🌀 **可放置的 Conduit 方块**，可在范围内提供飞行
- 💸 **等级系统**: 玩家可以使用 Vault 经济系统升级等级
- 🎯 **视觉粒子区域指示器**
- 🔧 通过 **YAML** 完全可配置
- 💾 支持 **SQLite** 和 **MySQL**
- 🔄 使用 `/conduitfly reload` 热重载更改
- 🖱️ 分页 **GUI 菜单** 用于等级交互
---
## 🔧 依赖
| 依赖项 | 目的 |
|--------------|-------------------------------------------|
| BentoBox | 岛屿数据访问（由于存储逻辑，目前是必需的；未来版本可能成为软依赖） |
| Vault | 经济集成 |
| 经济插件 | (EssentialsX, CMI, etc.) |
> 如果缺少必需的依赖项，插件将无法加载。
---
## 💻 安装
1. 将 `ConduitFly.jar` 放入您的 `plugins/` 目录中。
2. 启动服务器。将创建以下文件：
- `config.yml`
3. 调整设置以满足您的需求。
4. 使用 `/conduitfly reload` 应用更改，无需重新启动。
---
## 🏆 等级系统
玩家可以使用 `/conduitfly rankup` 打开 GUI 以查看和升级他们的等级。 每个等级定义：
- ✈️ **飞行时长** (以秒为单位)
- 🌀 **Conduit 半径**
- 🛡️ 可选的 **防摔伤害**
- 💰 **升级费用**
---
## 🛠️ 命令
| 命令 | 描述 |
|-----------------------|---------------------------------------------------|
| `/conduitfly reload` | 重新加载配置 |
| `/conduitfly rankup` | 打开 GUI 以查看/升级等级 |
| `/conduitfly area` | 视觉显示 Conduit 的活动范围 |
---
## 🧩 支持 & 贡献
发现一个错误、有功能请求，或者只是想贡献？
📬 [在 GitHub 上打开问题或拉取请求](https://github.com/ogsammaenr/ConduitFly/issues)
我们欢迎所有的反馈和贡献！
## 📁 配置概览
- `conduit.material`: 哪个方块提供飞行（默认：`CONDUIT`）
- `ranks`: 定义每个等级的属性
- `particles`: Conduit 区域内显示的视觉效果
- `storage`: 选择 `sqlite` 或 `mysql`
- `rank-gui`: 自定义 GUI 布局和图标
查看 `config.yml` 以获取完整的文档。
---
## ⚙️ 存储选项
| 类型 | 描述 |
|---------|----------------------------------------------|
| SQLite | 默认。轻量级且易于使用 |
| MySQL | 用于外部或大型服务器网络 |
---
## 📜 许可
本项目使用 **MIT 许可证**。
只要包含原始许可证和版权声明，您就可以自由使用、修改和分发插件。
---
给您的玩家飞行自由 — 由导管提供！ 🛫✨