
博德之门3 Linux脚本扩展器 (BG3LE)
《博德之门3》原生 Linux 版本的脚本扩展器。完整的 BG3SE Lua API,无需 Proton 或 Wine;一条命令即可安装。
查看大图[size=5][b]bg3le:面向原生 Linux 版《博德之门 3》的脚本扩展器[/b][/size]
[size=4][b]支持[/b][/size]
如果 bg3le 对你有帮助,并且你愿意支持它的开发:
《博德之门 3》有原生 Linux 版本,但脚本扩展器仅支持 Windows 版,因此 Linux 玩家不得不通过 Proton 运行游戏才能使用脚本扩展器模组。[b]bg3le[/b] 直接附加到原生 Linux 游戏上,并在其上实现脚本扩展器的 Lua API。你的脚本扩展器模组可在 Linux 版本上运行,无需 Proton 或 Wine。
bg3le 基于 [url=https://github.com/Norbyte/bg3se]Norbyte 的 BG3 Script Extender[/url] 构建。它的游戏结构定义和 Lua 框架是复用而非重写,没有它们就不会有 bg3le。[b]感谢 Norbyte。[/b]
[size=4][b]功能[/b][/size]
[list] [][b]运行脚本扩展器模组[/b]:模组直接从其 .pak 文件加载,拥有与 Windows 扩展器相同的模组环境、引导程序和 require。[b]Mod Configuration Menu[/b] 可正常工作,包括菜单在内的全部功能。[/] [][b]完整的 Lua API[/b]:脚本扩展器注册的每个函数都存在,服务器和客户端上下文中均有,并对照扩展器自身的声明进行了检查。它涵盖 Osiris、实体与组件、属性、静态数据、模板、本地化、关卡与寻路、Ext.IO、Ext.Net、Ext.Audio、IMGUI 叠加层以及 Ext.UI。[/] [][b]存档兼容[/b]:模组数据(PersistentVars)以 Windows 扩展器的格式保存,因此存档可在两者之间转移。[/] [][b]启用模组时仍可获得成就[/b],与 Windows 扩展器允许的一样。[/] [][b]能挺过游戏更新[/b]:没有任何东西被固定到内存地址上。bg3le 会在正在运行的任意版本中找到它要挂钩的一切,并在使用前进行检查。如果某个补丁破坏了某些功能,只会关闭该功能,并在控制台中给出警告,而不是让游戏崩溃。[/] [][b]针对原生版本本身的修复[/b]:关卡加载快得多,卡顿更少。在作者的机器上,关卡加载从一分多钟缩短到约一秒。[/] [][b]Lua 控制台[/b]:捆绑的 bg3lua 客户端可连接到运行中的游戏以执行实时 Lua,类似于 Windows 扩展器的调试器。[/] [/list]
[size=4][b]要求[/b][/size]
[list] []来自 Steam 的《博德之门 3》[b]原生 Linux[/b] 版本。不是通过 Proton 运行的 Windows 版本。[/] []正常安装的 Steam。[b]尚不支持 Flatpak 版 Steam[/b],因为其沙箱无法看到 bg3le 的文件。[/] []用于安装程序的 python3。[/] [/list]
bg3le 是针对 Steam 自身的运行时构建的,因此它能在游戏可运行的任何 Linux 系统上加载。你无需安装任何其他库。
[size=4][b]安装[/b][/size]
[list=1] []下载并解压压缩包到任意位置。[/] []在终端中,进入解压后的文件夹,运行: [code]./install.py[/code][/] []像往常一样从 Steam 启动游戏。[/] [/list]
安装程序会将 bg3le 复制到 [i]~/.local/share/bg3le[/i],并将其启动包装器添加到游戏的 Steam 启动选项中,同时保留你原有的任何设置。该更改必须关闭 Steam 才能进行,因此如果它正在运行,安装程序会先询问再停止它。你原有的 Steam 设置会在原文件旁备份。
[list] [][b]先预览:[/b] [code]./install.py --dry-run[/code]会显示将要更改的内容而不实际更改任何内容。[/] [][b]更新:[/b] 运行新版本的 install.py。[/] [][b]卸载:[/b] [code]./install.py --uninstall[/code]会移除启动选项以及 bg3le 安装的所有内容。[/] [/list]
[size=4][b]安装模组[/b][/size]
模组放在 Linux 游戏所期望的位置:[i]Baldur's Gate 3/Mods[/i],加载顺序位于 [i]PlayerProfiles/Public/modsettings.lsx[/i]。使用游戏内模组管理器或你常用的工具来设置顺序。
[size=4][b]与 Windows 扩展器的差异[/b][/size]
有两处,均为有意为之:
[list] []模组完成加载后的 require 仍然有效;Windows 扩展器会引发错误。[/] []Ext.Enums 条目是标签而非 EnumValue 对象。[/] [/list]
[size=4][b]故障排除[/b][/size]
[list] [][b]bg3le 似乎没有加载:[/b] 检查 [i]~/.local/share/bg3le/launch.log[/i]。它会记录启动包装器是否找到了游戏。[/] [][b]崩溃后所有模组突然被禁用:[/b] 当游戏发现上次运行留下的崩溃标记时,会禁用所有模组。bg3le 会在启动时移除该标记,与 Windows 扩展器一样,但在 bg3le 加载之前发生的崩溃仍可能触发它。[/] [][b]控制台和 [i]/tmp/bg3le.log.<pid>[/i] 处的日志会为任何因游戏更新而损坏的内容显示一行 WARNING。[/b][/] [/list]
[b][size=4]源码与许可[/size][/b]
源码:[url=https://github.com/lenonk/bg3le]github.com/lenonk/bg3le[/url]
bg3le 自身的代码为 MIT。它包含 Norbyte' 的 MIT 附带 Commons Clause,因此所分发版本的 bg3le 不得出售。所有捆绑库的许可证均位于压缩包的 licenses 文件夹中。
[size=4]致谢[/size]
[list] [][b]Norbyte 以及 BG3 Script Extender 的贡献者,本作品基于他们的工作构建。[/b][/] [][b]Igor Tarasyuk,负责成就部分[/b][/] [/list]
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。