Minetest游戏自由移动模式下的潜行锁定问题分析与修复方案

问题背景
在Minetest 5.12.0-dev版本中，当玩家启用自由移动(freemove)模式时，若同时开启了潜行锁定(sneak lock)功能，会导致飞行状态下的垂直移动控制异常。具体表现为：玩家按住潜行键下降后，无法通过跳跃键正常回升，严重影响飞行体验。

技术原理

1. 自由移动模式：允许玩家无视重力自由飞行，通过方向键控制三维移动
2. 潜行锁定机制：将潜行动作从"按住生效"改为"切换生效"的持久状态
3. 冲突根源：当潜行锁定激活时，跳跃指令无法自动解除潜行状态，导致上升/下降控制逻辑冲突

影响范围
该问题影响所有同时满足以下条件的场景：

• 游戏版本 ≥ 引入潜行锁定功能的版本
• 自由移动模式激活状态
• 潜行锁定功能启用状态

解决方案
核心修复思路是建立状态互斥机制：

1. 自动解除锁定：当激活自由移动时自动解除潜行锁定状态
2. 输入事件处理：在跳跃事件处理逻辑中增加潜行状态重置
3. 模式切换保护：确保自由移动模式切换时会重置相关控制状态

实现建议
建议在客户端控制模块中增加以下处理：

function on_freemove_enable()
    if sneak_locked then
        unlock_sneak()
    end
end

function handle_jump_input()
    if is_flying and sneak_locked then
        unlock_sneak()
    end
    -- 原有跳跃处理逻辑
end

用户建议
临时解决方案：

1. 在自由移动时手动禁用潜行锁定功能
2. 通过快捷键快速切换移动模式
3. 等待官方修复版本发布后升级

该修复已纳入开发路线，预计将在下一个稳定版本中发布。对于模组开发者，建议在涉及飞行控制的模组中注意处理类似的输入状态冲突问题。