BG3WASD 无处不在

BG3WASD 无处不在

为原生 Linux 构建和 MacOS 移植 WASD + NativeCameraTweaks。

支持

如果你觉得 Linux 或 macOS 移植版对你有用,可以支持它的开发:

描述

https://github.com/xzert/BG3-WASD-everywhere

使用 WASD(或其他按键)直接控制《博德之门3》的角色移动:支持 Windows、游戏的 Linux 原生版本,以及面向 Apple Silicon 的 macOS 原生版本。

本模组是 Ch4nKyy 的 BG3WASD(Nexus Mods)的分支。此处的 Windows 模组为原始版本,未作改动。

该分支新增了游戏 Linux 原生版本的移植版。Larian 于 2025 年 9 月发布了该版本(Hotfix #34),Steam 会在 Steam Linux Runtime 中运行它。Windows DLL 无法在此加载,因此该移植版是一个独立的

LD_PRELOAD

库,位于

linux/[https://github.com/xzert/BG3-WASD-everywhere/blob/main/linux]。

该分支还新增了面向 Apple Silicon 的 macOS 原生版本移植版,位于

macos/[https://github.com/xzert/BG3-WASD-everywhere/blob/main/macos]。它是一个由小型启动器在 Steam 启动游戏时加载进游戏的库。

Linux 和 macOS 移植版还包含 ersh1 的 Native Camera Tweaks 的相机调整功能,大多数玩家会将其与 BG3WASD 一起使用:自由相机俯仰、更大的缩放限制、FOV 和偏移。

安装说明

在 Linux 上安装

  1. 从 Releases 下载 bg3-wasd-everywhere-linux-<version>.tar.gz 并解压到一个路径不含空格的文件夹,例如 ~/bg3-wasd-everywhere。
  2. 在 Steam 中打开《博德之门3》→ 属性 → 通用 → 启动选项,并填入你的路径:

LD_PRELOAD="/home/you/bg3-wasd-everywhere/libbg3-wasd-everywhere.so:$LD_PRELOAD" %command%

压缩包中的 INSTALL.md 也包含这些步骤。

如果要从源码构建,请在 linux/ 中运行 make,并将 LD_PRELOAD 指向 linux/build/libbg3-wasd-everywhere.so;参见 linux/README.md。以这种方式构建的库需要你系统的 glibc 版本。发布压缩包是在 Steam Runtime SDK 中构建的,只需要运行时的 glibc 2.31。

启动时,模组会将角色移动绑定到你的相机移动按键(默认是 W/A/S/D 和方向键)。它会在每个玩家配置文件的 inputconfig_p1.json 中执行此操作,并将原文件保留为 inputconfig_p1.json.bg3-wasd-everywhere.bak。

要检查是否生效,启动游戏并查看 ~/.local/state/bg3-wasd-everywhere/bg3-wasd-everywhere.log。其中应包含 WASD movement enabled。Caps Lock 在角色移动和相机移动之间切换,Shift+W 切换自动前进。热键、行走速度和旋转光标在库旁边的 bg3-wasd-everywhere.toml 中设置。

更多细节,包括移植版如何在游戏代码中定位,见 linux/README.md。

在 macOS 上安装

适用于 Apple Silicon Mac。

  1. 从 Releases 下载 bg3-wasd-everywhere-macos-<version>.tar.gz 并解压到一个路径不含空格的文件夹,例如 ~/bg3-wasd-everywhere。
  2. 这些文件未经 Apple 公证,因此在终端中移除下载标记,使用你的路径: xattr -dr com.apple.quarantine ~/bg3-wasd-everywhere
  3. 在 Steam 中打开《博德之门3》→ 属性 → 通用 → 启动选项,并填入你的路径:

/Users/you/bg3-wasd-everywhere/bg3-wasd-everywhere-launch %command%

  1. 通过“Play”启动游戏。首次启动时,macOS 会询问 Steam 是否可以访问“文稿”文件夹。请允许:游戏会在那里保存配置文件和存档。

压缩包中的 INSTALL.md 也包含这些步骤。日志位于 ~/Library/Logs/bg3-wasd-everywhere/bg3-wasd-everywhere.log。Caps Lock 在角色移动和相机移动之间切换,Shift+W 切换自动前进。热键、行走速度和旋转光标在库旁边的 bg3-wasd-everywhere.toml 中设置。

主要功能

Windows 版本是原始模组。Linux 和 macOS 版本是位于 linux/[https://github.com/xzert/BG3-WASD-everywhere/blob/main/linux] 和 macos/[https://github.com/xzert/BG3-WASD-everywhere/blob/main/macos] 的独立移植版,以相同版本号一同发布。

两个移植版均支持游戏版本 4.1.1.7631656(Hotfix #36)。

  • Linux 移植版通过字节签名定位游戏代码。在其他任何版本上它什么都找不到,会向日志写入错误并保持不活动;游戏本身不受影响。
  • macOS 移植版通过函数名定位游戏函数,macOS 构建保留了这些名称。
功能 Windows Linux macOS
WASD 角色移动、自动前进、行走、角色/相机移动模式 ✅ ✅ ✅
角色模式下移动键不会平移相机 ✅ ✅ ✅
使用不可见或居中光标进行相机旋转 ✅ ✅ ¹ ✅ ¹
战斗中自动相机模式 ✅ ✅ ⁴ ✅ ⁴
ToggleCameraRotation(无需按住按钮的鼠标视角) ✅ ✅ ✅
在菜单、对话、拾取和拍照模式中关闭旋转 ✅ ✅ ² ✅ ²
角色模式下无边缘平移 ✅ ✅ ✅
旋转 + 左键向前移动 ✅ ✅ ✅
角色模式下移动键会停止点击移动 ✅ ✅ ✅
不可点击的当前角色和相机遮挡物 ✅ ✅ ⁵ ✅ ⁵
相机调整:自由俯仰、缩放限制、FOV、偏移(Native Camera Tweaks) 单独模组 ✅ ⁶ ✅ ⁶
阻止点击移动(BlockInteractMove) ✅ ✅ ⁷ ✅ ⁷
移动模式跟随回合制模式(FTB) ✅ ✅ ✅ ⁴
自动绑定移动键 ✅ ✅ ³ ✅ ³
配置文件更改时重新加载 ✅ ✅ ✅

需求

Steam 版本的游戏(或使用 shell 包装器)

致谢

移植版建立在两位作者的工作之上。如果你喜欢它们,也请感谢并支持原作: