自由肩部 - 肩部交换模组

自由肩部 - 肩部交换模组

GTA IV完整版的换肩功能。

自由肩部 - 肩部交换模组预览查看大图

关于此模组

这是 GTA IV 完整版的独立换肩模组。举起枪，按下一个按键或手柄按钮，第三人称瞄准视角就会切换到另一侧肩膀。

它只改变瞄准视角。行走视角保持原样，这样也不会与 FusionFix 产生冲突。

工作原理

默认情况下（[b]SwapMethod CAMERA[/b]），插件会翻转 GTA IV 自身的 CCamAimWeapon 调校表中的横向焦点偏移，将每个档案的右肩数值切换为对应的左肩数值。

旧版的 [b]SwapMethod PROP[/b] 方法仍可使用。它会在玩家旁边附加一个隐形、冻结、可碰撞的物体，让游戏自身的镜头碰撞将视角推绕过去。这是 Liberty Tweaks 的技术。由于该阻挡物是真实的碰撞几何体，它可以吸收近距离射击和近战攻击，行人也有可能撞到它。

较旧的 INI 中没有 SwapMethod 键会保留 PROP 模式。如果你从 v0.1.0 升级并希望使用直接模式，请添加 [b]SwapMethod CAMERA[/b]。

包含文件

  • [b]LibertyShoulder.asi[/b] — 主插件
  • [b]LibertyShoulder.ini[/b] — 设置（启动时读取一次）
  • [b]README.txt[/b] — 压缩包内的简短安装说明

所需环境

  • GTA IV：完整版
  • ASI 加载器（FusionFix、Ultimate ASI Loader 或同类型工具）

无需 .NET Framework、IV-SDK .NET 或 Clonk 的 Coding Library。

安装

  1. 将 [b]LibertyShoulder.asi[/b] 和 [b]LibertyShoulder.ini[/b] 复制到 [b]GTAIV\plugins\[/b] 文件夹中
  2. 启动游戏，举起枪，按下 [b]B[/b] 键（键盘）或 [b]左肩键[/b]（手柄）
  3. 再次按下即可换回

设置会在启动时读取一次。编辑 INI 后请重启游戏。

运行时日志（如需要）：

[code]GTAIV\LibertyShoulder.log[/code]

操作方式

  • [b]键盘：[/b] 瞄准时按 B 键（Windows 虚拟键码 66）。将 ToggleKey 设为 0 可禁用。
  • [b]手柄（XInput）：[/b] 左肩键（按钮 4）。将 ToggleControllerButton 设为 -1 可禁用。
  • 再次按下可换回另一侧肩膀。

默认情况下，选择的肩膀会在收枪和重新瞄准之间保持记忆，进入载具时会重置为右肩。如果你想每次新瞄准都从默认肩膀开始，请设置 [b]ResetWhenNotAiming TRUE[/b]。

设置（LibertyShoulder.ini）

  • [b]Enable[/b] — 总开关（TRUE / FALSE）
  • [b]SwapMethod[/b] — CAMERA（默认）或 PROP
  • [b]ToggleKey[/b] — Windows 虚拟键码；66 为 B；0 禁用键盘
  • [b]ToggleControllerButton[/b] — 4 LB、5 LT、6 RB、7 RT、14 方块/X、16 叉/A、17 圈/B；-1 禁用手柄
  • [b]ToggleDebounceMs[/b] — 接受切换输入的最小间隔（默认 200）
  • [b]DefaultShoulder[/b] — 启动/重置时的初始肩膀，RIGHT 或 LEFT
  • [b]ResetWhenNotAiming[/b] — FALSE 记忆肩膀；TRUE 在停止瞄准时重置
  • [b]SwapInCover[/b] — 在蹲伏或掩体中保持换肩（默认 TRUE）
  • [b]SwapWithScopedWeapons[/b] — 狙击镜/第一人称武器保持换肩（默认 FALSE）
  • [b]RequireGun[/b] — 仅对枪械换肩，不适用于近战（默认 TRUE）
  • [b]PropModel / PropOffsetX/Y/Z / PropSpawnHeight / PropCreateRetryLimit[/b] — 仅在使用 SwapMethod PROP 时生效
  • [b]ShowDiagnosticLog[/b] — 详细的过渡日志输出（默认 FALSE）

兼容性

  • 为 GTA IV 完整版编写。旧版 1.0.7.0 / 1.0.8.0 未测试。
  • CAMERA 模式不创建物理对象。PROP 模式因会生成碰撞几何体，可能与 FusionFix 的固定物理子步骤产生交互。

当前限制

  • PROP 模式保留了碰撞副作用（近距离射击、近战、行人碰撞）。
  • 狙击镜默认不换肩，除非启用 SwapWithScopedWeapons。

致谢

  • [b]ServalEd[/b] 和 [b]catsmackaroo[/b] — Liberty Tweaks 中的道具阻挡换肩技术
  • [b]DK22Pac[/b] — plugin-sdk