feat: port 1.21.8 feature set to 1.21.11 (speed command, /fly player rename, persistence)

README.md

@@ -5,8 +5,9 @@
 ## 功能特性
 
 - 🕊️ **自由飞行** — 通过命令开启/关闭创造模式飞行能力
+- ⚡ **飞行速度调节** — 通过命令在 0.01–0.15 范围内自定义飞行速度
 - 🛡️ **摔落保护** — 飞行状态下免疫摔落伤害
-- 💾 **状态持久化** — 重新加入服务器时自动恢复飞行状态
+- 💾 **状态持久化** — 飞行状态与速度保存到配置文件，退出重进或服务器重启后自动恢复
 - 👥 **多玩家支持** — 管理员可为其他玩家切换飞行状态
 
 ## 环境要求
@@ -36,12 +37,24 @@
 - 如果当前未飞行，执行后**开启飞行**
 - 如果当前正在飞行，执行后**关闭飞行**
 
-### `/fly <player>`
+### `/fly speed <0.01-0.15>`
+
+设置自己的飞行速度，范围为 0.01 到 0.15（默认 0.05）。所有玩家均可执行。
+
+```
+/fly speed 0.10
+```
+
+- 数值越大飞行越快，0.15 为允许的最大速度
+- 设置后立即生效，无需重新开启飞行
+- 速度会与飞行状态一起保存，退出重进后仍然保留
+
+### `/fly player <player>`
 
 切换指定玩家的飞行状态。需要 OP 权限（权限等级 2）。
 
 ```
-/fly Steve
+/fly player Steve
 ```
 
 - 如果目标玩家未飞行，执行后**为其开启飞行**
@@ -59,17 +72,25 @@
    - **双击空格** — 切换飞行/普通状态
 3. 再次输入 `/fly` 关闭飞行，回到普通模式
 
+### 飞行速度
+
+使用 `/fly speed <数值>` 调整飞行速度（0.01–0.15）：
+
+- `/fly speed 0.03` — 较慢的飞行速度
+- `/fly speed 0.05` — 默认速度
+- `/fly speed 0.15` — 最快速度
+
 ### 管理员操作
 
 作为服务器管理员，你可以为其他玩家管理飞行权限：
 
 ```
-/fly <玩家名>
+/fly player <玩家名>
 ```
 
 例如：
-- `/fly Steve` — 为 Steve 开启飞行
-- `/fly Alex` — 关闭 Alex 的飞行
+- `/fly player Steve` — 为 Steve 开启飞行
+- `/fly player Alex` — 关闭 Alex 的飞行
 
 ### 摔落保护
 
@@ -77,13 +98,13 @@
 
 ### 重连恢复
 
-如果玩家在飞行状态下断开连接，重新加入服务器时飞行状态会自动恢复。
+玩家的飞行状态（是否飞行）与飞行速度会持久化保存。退出游戏后重新加入，甚至服务器重启，都会自动恢复上次的飞行状态与速度。
 
 ## FAQ
 
 ### Q: 飞行状态会一直保留吗？
 
-A: 飞行状态在服务器运行期间持续有效。如果你关闭了飞行、或者服务器重启，飞行状态会被重置。但如果你是断开重连，飞行状态会自动恢复。
+A: 会。飞行状态（是否飞行）与飞行速度会保存到服务端的 `config/openfly_flight_data.json` 文件。玩家退出重进、服务器重启后都会自动恢复上次的状态。
 
 ### Q: 飞行时还会受到摔落伤害吗？
 
@@ -91,7 +112,7 @@ A: 不会。飞行状态下免疫所有摔落伤害，关闭飞行后恢复正
 
 ### Q: 普通玩家可以使用 `/fly` 吗？
 
-A: 可以。`/fly` 命令对所有玩家开放，无需 OP 权限。但 `/fly <player>` 需要 OP 权限。
+A: 可以。`/fly` 与 `/fly speed` 命令对所有玩家开放，无需 OP 权限。但 `/fly player <player>` 需要 OP 权限。
 
 ### Q: 这个模组需要安装在客户端还是服务端？