OpenFly
一个 Fabric 模组，为玩家提供便捷的飞行功能。
功能特性
- 🕊️ 自由飞行 — 通过命令开启/关闭创造模式飞行能力
- ⚡ 飞行速度调节 — 通过命令在 0.1–2.0 范围内自定义飞行速度
- 🛡️ 摔落保护 — 飞行状态下免疫摔落伤害
- 💾 状态持久化 — 重新加入服务器时自动恢复飞行状态
- 👥 多玩家支持 — 管理员可为其他玩家切换飞行状态
环境要求
- Minecraft 1.21.8
- Java 21+
- Fabric Loader ≥ 0.19.5
- Fabric API
安装
- 安装 Fabric Loader
- 下载 Fabric API 并放入
mods文件夹 - 将 OpenFly 的
.jar文件放入mods文件夹 - 启动游戏
命令用法
/fly
切换自己的飞行状态。所有玩家均可执行。
/fly
- 如果当前未飞行，执行后开启飞行
- 如果当前正在飞行，执行后关闭飞行
/fly speed <0.1-2.0>
设置自己的飞行速度，范围为 0.1 到 2.0（默认 0.05）。所有玩家均可执行。
/fly speed 1.5
- 数值越大飞行越快，2.0 为允许的最大速度
- 设置后立即生效，无需重新开启飞行
/fly player <player>
切换指定玩家的飞行状态。需要 OP 权限（权限等级 2）。
/fly player Steve
- 如果目标玩家未飞行，执行后为其开启飞行
- 如果目标玩家正在飞行，执行后为其关闭飞行
- 操作记录会广播到聊天栏
使用指南
基本飞行
- 在游戏中输入
/fly即可开启飞行 - 开启后可以使用与创造模式相同的飞行操作：
- 空格键 — 上升
- Shift 键 — 下降
- 双击空格 — 切换飞行/普通状态
- 再次输入
/fly关闭飞行，回到普通模式
飞行速度
使用 /fly speed <数值> 调整飞行速度（0.1–2.0）：
/fly speed 0.5— 较慢的飞行速度/fly speed 1.0— 中速/fly speed 2.0— 最快速度
管理员操作
作为服务器管理员，你可以为其他玩家管理飞行权限：
/fly player <玩家名>
例如：
/fly player Steve— 为 Steve 开启飞行/fly player Alex— 关闭 Alex 的飞行
摔落保护
飞行开启期间，你不会受到任何摔落伤害。关闭飞行后，摔落伤害恢复正常。
重连恢复
如果玩家在飞行状态下断开连接，重新加入服务器时飞行状态会自动恢复。
FAQ
Q: 飞行状态会一直保留吗？
A: 飞行状态在服务器运行期间持续有效。如果你关闭了飞行、或者服务器重启，飞行状态会被重置。但如果你是断开重连，飞行状态会自动恢复。
Q: 飞行时还会受到摔落伤害吗？
A: 不会。飞行状态下免疫所有摔落伤害，关闭飞行后恢复正常。
Q: 普通玩家可以使用 /fly 吗？
A: 可以。/fly 与 /fly speed 命令对所有玩家开放，无需 OP 权限。但 /fly player <player> 需要 OP 权限。
Q: 这个模组需要安装在客户端还是服务端？
A: 服务端。这是一个服务端模组，只需安装在服务器上即可。客户端无需安装。
Q: 与其他模组兼容吗？
A: OpenFly 基于 Fabric API 开发，与大多数 Fabric 模组兼容。如果遇到冲突，请在 Issues 中反馈。
构建
./gradlew build
构建产物位于 build/libs/ 目录。