fix: persist flight state and fly speed per player (JSON config), restore on join/respawn

README.md

@@ -5,9 +5,9 @@
 ## 功能特性
 
 - 🕊️ **自由飞行** — 通过命令开启/关闭创造模式飞行能力
-- ⚡ **飞行速度调节** — 通过命令在 0.1–2.0 范围内自定义飞行速度
+- ⚡ **飞行速度调节** — 通过命令在 0.01–0.15 范围内自定义飞行速度
 - 🛡️ **摔落保护** — 飞行状态下免疫摔落伤害
-- 💾 **状态持久化** — 重新加入服务器时自动恢复飞行状态
+- 💾 **状态持久化** — 飞行状态与速度保存到配置文件，退出重进或服务器重启后自动恢复
 - 👥 **多玩家支持** — 管理员可为其他玩家切换飞行状态
 
 ## 环境要求
@@ -37,16 +37,17 @@
 - 如果当前未飞行，执行后**开启飞行**
 - 如果当前正在飞行，执行后**关闭飞行**
 
-### `/fly speed <0.1-2.0>`
+### `/fly speed <0.01-0.15>`
 
-设置自己的飞行速度，范围为 0.1 到 2.0（默认 0.05）。所有玩家均可执行。
+设置自己的飞行速度，范围为 0.01 到 0.15（默认 0.05）。所有玩家均可执行。
 
 ```
-/fly speed 1.5
+/fly speed 0.10
 ```
 
-- 数值越大飞行越快，2.0 为允许的最大速度
+- 数值越大飞行越快，0.15 为允许的最大速度
 - 设置后立即生效，无需重新开启飞行
+- 速度会与飞行状态一起保存，退出重进后仍然保留
 
 ### `/fly player <player>`
 
@@ -73,11 +74,11 @@
 
 ### 飞行速度
 
-使用 `/fly speed <数值>` 调整飞行速度（0.1–2.0）：
+使用 `/fly speed <数值>` 调整飞行速度（0.01–0.15）：
 
-- `/fly speed 0.5` — 较慢的飞行速度
-- `/fly speed 1.0` — 中速
-- `/fly speed 2.0` — 最快速度
+- `/fly speed 0.03` — 较慢的飞行速度
+- `/fly speed 0.05` — 默认速度
+- `/fly speed 0.15` — 最快速度
 
 ### 管理员操作
 
@@ -97,13 +98,13 @@
 
 ### 重连恢复
 
-如果玩家在飞行状态下断开连接，重新加入服务器时飞行状态会自动恢复。
+玩家的飞行状态（是否飞行）与飞行速度会持久化保存。退出游戏后重新加入，甚至服务器重启，都会自动恢复上次的飞行状态与速度。
 
 ## FAQ
 
 ### Q: 飞行状态会一直保留吗？
 
-A: 飞行状态在服务器运行期间持续有效。如果你关闭了飞行、或者服务器重启，飞行状态会被重置。但如果你是断开重连，飞行状态会自动恢复。
+A: 会。飞行状态（是否飞行）与飞行速度会保存到服务端的 `config/openfly_flight_data.json` 文件。玩家退出重进、服务器重启后都会自动恢复上次的状态。
 
 ### Q: 飞行时还会受到摔落伤害吗？