PyDirectInput鼠标移动过于灵敏导致Minecraft视角转动异常如何解决？

问题根因 #

• Minecraft默认启用原始输入模式，该模式下游戏直接读取鼠标硬件的原始输入数据，绕过Windows系统的鼠标配置层。pydirectinput默认传递的是系统级像素移动单位，会被游戏识别为量级远超预期的硬件移动量，哪怕传入偏移量为1，也会被解析为数百单位的鼠标硬件位移，导致视角猛转。
• pydirectinput底层调用Windows SendInput API时，未针对游戏的原始输入模式做参数适配，连续调用时还可能出现输入堆叠的问题，进一步放大移动偏差。
• 游戏内开启的鼠标平滑、视角平滑选项会对输入的移动量做插值计算，会加重异常转动的表现。

修复方案 #

• 调整游戏内设置
  • 进入「键鼠设置」页面，关闭原始输入开关
  • 关闭鼠标平滑、视角平滑两个选项
  • 适当调低游戏内鼠标灵敏度，方便后续参数微调
• 调整pydirectinput调用逻辑
  配置pydirectinput的全局间隔参数，同时封装适配Minecraft的视角移动函数，示例代码如下：

  import pydirectinput
  
  # 配置每次输入后的等待间隔，避免输入堆叠
  pydirectinput.PAUSE = 0.005
  # 俯仰视角控制函数：y_offset正为向下低头，负为向上抬头，sensitivity可根据实际需求调整
  def adjust_pitch(y_offset: int, sensitivity: float = 0.0015):
      actual_move = int(y_offset * sensitivity)
      if actual_move != 0:
          pydirectinput.moveRel(0, actual_move, relative=True)
  

  如果需要控制左右水平视角，同理修改moveRel的第一个参数即可。
• 适配显示模式
  将Minecraft调整为无边框窗口模式运行，避免全屏模式下游戏独占输入权限导致的输入值解析异常。

内容的提问来源于stack exchange，提问作者Kamil Poreba