HandSwing 切换

HandSwing Toggle 是一款轻量级客户端模组，可让您关闭第一人称手臂摆动动画——每次挥动、攻击或放置方块时，手持物品会做出的快速下-上弧线运动。原版游戏没有提供相关设置：视角摇晃控制行走时的晃动，但每次挥动的手臂动画始终开启。

功能

• 一个按键（默认 K）可切换第一人称手臂摆动动画的开启或关闭。
• 当关闭时，您在挖掘、攻击和放置方块时，手持物品在视角中保持稳定。伤害、方块破坏、物品使用、命中判定和数据包发送完全不受影响——仅本地动画被抑制。
• 其他玩家在第三人称视角中仍能看到您正常的手臂摆动——服务器端的手臂摆动数据包照常发送，因此多人游戏行为一致。
• 每次切换时，动作栏会显示新的状态确认信息。

为何需要

• 辅助功能/晕动症。 部分玩家会因每次点击时的持续手臂动画而感到不适，尤其在快速挖掘或 PvP 时。原版的视角摇晃：关闭无法禁用摆动弧线——本模组可做到。
• 直播画面洁净。 希望获得更平静第一人称视角的主播或录制者（尤其在高攻击速度战斗或快速建造时）可完全稳定手持物品。
• 专注。 手臂摆动弧线消失后，准星区域保持视觉稳定——更便于读取HUD、耐久条或使用弓箭瞄准。

操作方式

• K — 切换手臂摆动动画开启/关闭。默认状态为开启（原版行为）。按下按键时，动作栏会显示 手臂摆动：开 / 手臂摆动：关。

说明

• 纯客户端模组，无需服务端安装。可在任何 Fabric 服务器上运行，完全兼容原版——服务端无法检测到该模组的存在。
• 一个轻量 Mixin 注入 LivingEntity.swingHand(Hand) 方法，仅在切换关闭时对本地客户端玩家执行空操作。其他实体和数据包路径不受影响。
• 无配置文件；设置为每个会话独立（重启后重置）。默认开启，因此安装模组后您的游戏体验不会有任何变化，直到您按下 K 键。
• 约 80 行代码，除 Fabric API 外无额外依赖。

兼容性

Minecraft 1.21.8, 1.21.9, 1.21.10, 1.21.11 — Fabric Loader 0.16+。一个 JAR 涵盖所有四个版本。放入 mods/ 文件夹中，与 Fabric API 一同使用。