蛇形派对选择器

蛇形派对选择器

该模组允许用户通过MCM选择队伍中同伴的数量及其身份,最多可达30名同伴。模组会在长休息和乘船期间自动修正游戏对同伴数量的限制。无需法术或角色互动。

[size=4][b][size=6]队伍选择器(Party Picker)[/size]
[url=https://github.com/Shiney1965/bg3-party-picker]github.com/Shiney1965/bg3-party-picker[/url]

为什么做这个模组:无需法术、对话,也不占用快捷栏空间,就能选择队伍成员的数量和身份。

通过 MCM 菜单选择谁在你的队伍中。[/b]打开模组配置菜单(Mod Configuration Menu)中的“队伍”标签页,勾选你想带在身边的同伴和雇佣兵,然后按“应用”。将队伍上限提高到最多 30 人。当游戏只能处理四人时,在长休和灰矮人熔炉(Grymforge)的木筏上,队伍选择器会为你处理:长休前它会询问今晚保留哪四人,并在你醒来后把其他人带回来;在木筏上,它会确保整支队伍都登陆。

[b]正常招募和解散同伴意味着要走到每个人面前,逐一与他们交谈。队伍规模变大后,游戏中的四人限制也会造成阻碍:营地只有四张床,幽暗地域的木筏只有四个登陆点。队伍选择器把整个名单放在一个界面上,并处理这两个场景。[/b]

[b]为什么还要做另一个队伍模组?[/b]我想要通过一个列表来替换同伴,不用快捷栏法术,并且能在长休和木筏穿越期间维持大队伍。你的偏好可能不同,所以我并不是说这个模组比其他模组更好,只是不同而已。

[b]不替换游戏文件,不修改可执行文件。[/b]队伍选择器使用游戏自身的招募和解散流程,与同伴对话和“解散”按钮所用的流程相同,因此游戏的记录保持正确。只需要一个 pak 文件。

[size=5][b]使用方法——请阅读[/b][/size]
[b]队伍选择器需要模组配置菜单(MCM)。队伍列表和所有设置都在 MCM 中。将 MCM 加载在队伍选择器之上。[/b][/size]

[list]
[][size=4][b]先设置你的队伍上限。打开 MCM(INSERT 键,或从 ESC 菜单进入),找到 Party Picker,在“设置”标签页设置[i]队伍最大人数[/i](4 到 30,默认 6)。它包含你自己的角色。不能设置得低于你当前队伍中已有的人数:请先将成员送回营地。[/b][/size][/]
[][size=4][b]在“队伍”标签页选择你的队伍。所有已招募的人员都会以复选框列出。勾选你想带在身边的人,取消勾选应回营地的人,然后按“应用”。按钮下方的文字会说明发生了什么,例如[i]队伍已更新。加入:卡菈克。送回营地:盖尔。[/i][/b][/size][/]
[][size=4][b]灰色的名字表示被锁定,旁边会显示原因。你自己的角色、你当前控制的同伴、已死亡的队伍成员,以及在多人游戏中由其他玩家控制的每个角色,都不能被送回营地。处于场外(当前不在世界中)的角色不能被招募。哈尔辛在剧情允许他加入之前是锁定的(在赛尼尔获救之后,与游戏中一致),明萨拉和明斯克在剧情阻止他们被招募期间也是如此。[/b][/size][/]
[][size=4][b]把所有人送回营地:“队伍”标签页上的一个按钮。它会先询问一次,然后送回所有能回去的人。你自己的角色始终留下。[/b][/size][/]
[][size=4][b]超过四人的长休:照常按“结束这一天”。队伍选择器会暂停长休并打开一个小窗口:勾选今晚与你一起留下的四人(你自己的角色始终是其中之一),按“保留这 4 人”,然后再次按“结束这一天”。其他人会在营地等待,并在你醒来几秒后重新加入。或者按“这次保留所有人”,然后在两分钟内再次按“结束这一天”:游戏随后会像没有该模组时一样进行长休,只让四人上床。[/b][/size][/]
[][size=4][b]灰矮人熔炉的木筏:无需操作。带整支队伍登船;所有人都会登陆。[/b][/size][/]
[][size=4][b]希望之邸:无需操作。当霍普分发“负债者装束”时,队伍中的每个人都会获得一套。[/b][/size][/]
[/list][size=4][b]
[size=5]功能[/size]
[/b][/size]
[list]
[][size=4][b]一个列表管理你的整个名单——玩家角色、起源同伴、雇佣兵,以及其他模组添加的同伴。维瑟斯、召唤物、魔宠、追随者和营地追随者(沃罗、埃尔明斯特、挠挠、塔拉等)永远不会被列出。[/b][/size][/]
[][size=4][b]一步完成加入和解散。“应用”会一次性完成所有更改。新成员会被带到你的角色旁边(可切换)。[/b][/size][/]
[][size=4][b]更大的队伍。上限从 4 到 30,每次加载存档时都会重新应用。它永远不会设置得低于你已有的队伍:如果存档的队伍大于你的设置,则保留所有人,队伍选择器会提示你一次。超过 16 人的队伍作者尚未测试。[/b][/size][/]
[][size=4][b]一键把所有人送回营地。“队伍”标签页会先询问一次,然后送回除你自己角色之外的所有人(以及其他无法移动的人)。再次勾选他们并按“应用”即可带回。[/b][/size][/]
[][size=4][b]哈尔辛在剧情允许时加入。与游戏中一样,哈尔辛在第二章赛尼尔获救之前不能加入;“队伍”标签页会锁定他直到那时。一个可选设置[i]让哈尔辛提前加入[/i]可在第二章解除该锁定,“队伍”标签页上有一个按钮,可在抵达最后之光前让他的任务重回正轨(见下文)。[/b][/size][/]
[][size=4][b]大队伍的长休。营地只有四张床,游戏只让四名队伍成员上床。队伍选择器会询问今晚保留哪四人;其他人在营地等待,并在你醒来后重新加入(在上限允许的范围内)。绝不会为了给他们腾位置而送走任何人。谁在等待的记录会随游戏保存,因此中途存档和读档不应丢失(尚未在游戏中测试)。[/b][/size][/]
[][size=4][b]灰矮人熔炉的木筏(黑湖,第一章幽暗地域)。木筏能载所有人上船,但每个码头只有四个登陆点,因此第五个及之后的成员会被留在船上,隐藏且无法移动。队伍选择器会增加登陆点,让整支队伍都能抵达。[/b][/size][/]
[][size=4][b]希望之邸的负债者装束(第三章)。游戏只有四套霍普分发的伪装,因此第五个及之后的成员一套也得不到。当霍普分发时,队伍选择器会给府内其他每位队伍成员一套并穿上。游戏会像对待自己的套装一样对待这些额外套装,包括在警报响起时销毁它们。[/b][/size][/]
[][size=4][b]每次拒绝都会说明原因。无法进行的更改(战斗中、某人当前无法旅行、场外角色)会整体被拒绝,原因保留在“队伍”标签页上,并写入 Script Extender 日志。[/b][/size][/]
[][size=4][b]战斗中安全。默认情况下,当你的角色或任何加入/离开的人处于战斗中时,不会进行队伍更改。[/b][/size][/]
[/list]

[line]
[size=4][b]
[size=5]需求[/size]
[/b][/size]
[list]
[][size=4][b]博德之门 3,当前 Steam 发行版(2026 年 10 月测试)。[/b][/size][/]
[][size=4][b]BG3 Script Extender(版本 29+)。必需——队伍选择器完全由 Script Extender Lua 构成。已用 v33 测试。[/b][/size][/]
[][size=4][b][url=https://www.nexusmods.com/baldursgate3/mods/9162]模组配置菜单(BG3MCM)[/url],版本 1.38 或更高——必需,并在队伍选择器的元数据中列为依赖项。已用 v1.41.0 测试。将其加载在队伍选择器之上。[/b][/size][/]
[][size=4][b]模组管理器(推荐 BG3 Mod Manager)——队伍选择器必须在你的加载顺序中处于激活状态。[/b][/size][/]
[][size=4][b]仅限 Windows(Script Extender 仅支持 Windows)。MCM 的窗口通过鼠标和键盘操作。[/b][/size][/]
[/list][size=4][b]
[size=5]安装 / 卸载[/size]
[/b][/size]
[list]
[][size=4][b]将 PartyPicker.pak 放入 %LocalAppData%\Larian Studios\Baldur's Gate 3\Mods,在 BG3MM 中激活它,将模组配置菜单放在队伍选择器之上,保存加载顺序,启动游戏。[/b][/size][/]
[][size=4][b]验证:Script Extender 日志显示 [PartyPicker] server loaded (v1.1.0),并且在加载存档后显示 [PartyPicker] party size limit set to 6(或你自己的上限);在控制台输入 server 然后输入 !pp_roster,第一行显示 Party Picker v1.1.0 roster:。[/b][/size][/]
[][size=4][b]游戏中途安装没问题。你已招募的同伴会立即列出。[/b][/size][/]
[][size=4][b]卸载:先在“队伍”标签页将队伍缩减到四人并保存(队伍选择器移除后大队伍会怎样尚未测试),然后停用并删除 pak。如果哈尔辛提前加入了,请在最后之光按下[i]让哈尔辛的任务重回正轨[/i]之前保留队伍选择器:没有该模组,那个按钮就没了,他的任务不会自行开始。队伍选择器不添加法术或状态;它添加的唯一物品是希望之邸中额外的负债者装束套装。[/b][/size][/]
[][size=4][b]荣誉模式只有一个存档。在那里尝试任何新模组之前,请备份存档文件夹。[/b][/size][/]
[/list][size=4][b]完整说明、设置参考和控制台参考见下载中的 README 和 INSTALL 文件(Markdown、Word 和 PDF)。

[/b][/size]
[line]
[size=4][b]
[size=5]配置——设置和队伍标签页[/size]
[/b][/size]
[list]
[][size=4][b]设置,队伍规模——[i]队伍最大人数[/i](4–30,默认 6;从不低于你已有的队伍);[i]将新成员带到你身边[/i](开启:从营地加入的同伴会被移动到你的角色旁边);[i]战斗中不进行队伍更改[/i](开启)。[/b][/size][/]
[][size=4][b]设置,游戏需要四人的地方——[i]长休前询问[/i](开启);[i]长休后带回所有人[/i](开启;关闭:当你想要他们回来时按“恢复”);[i]让整支队伍乘坐灰矮人熔炉的木筏[/i](开启);[i]为整支队伍提供负债者装束(希望之邸)[/i](开启)。[/b][/size][/]
[][size=4][b]设置,剧情同伴——[i]让哈尔辛提前加入[/i](关闭)。勾选后,哈尔辛可在第二章赛尼尔获救前加入,但只能在他于最后之光的任务开始之前。一旦他提前加入,他在最后之光的任务不会自行开始,即使你把他送回营地:一旦你的队伍抵达最后之光,并且在你与阿尔特·库拉格交谈之前,按“队伍”标签页上的[i]让哈尔辛的任务重回正轨[/i](你首次抵达时会有一个消息窗口提醒你)。它会把他送到营地并重置他的任务;然后在营地与他交谈并让他先行。之后在赛尼尔获救之前他不能再加入。[/b][/size][/]
[][size=4][b]队伍——带有复选框的名单和[i]已选 N / 上限[/i]计数器;应用(一次性完成所有更改;如果某项检查失败,则什么都不变并显示原因)、刷新、把所有人送回营地(会先询问一次)、恢复(仅在你的一些队伍成员长休后仍在营地等待时出现),以及让哈尔辛的任务重回正轨(仅在哈尔辛提前加入时出现)。勾选超过上限并按“应用”不会改变任何内容,消息窗口会说明需要取消勾选多少人。[/b][/size][/]
[/list][size=4][b]所有更改立即生效。设置按 MCM 配置文件保存,位于你的存档之外。

[/b][/size]
[line]
[size=4][b]
[size=5]兼容性[/size]
兼容:通过游戏正常队伍流程招募的同伴模组和雇佣兵模组、外观模组,以及改变营地内容的模组。

不兼容——不要与队伍选择器同时运行这些:
[/b][/size]
[list]
[][size=4][b]Party Limit Begone 以及任何其他设置队伍上限的模组。两者设置相同的上限,后应用的生效。选一个。如果 Configurable Party Limit 处于激活状态,队伍选择器会在加载存档时向 Script Extender 日志写入警告。[/b][/size][/]
[/list][size=4][b]注意事项:[/b][/size]
[list]
[][size=4][b]改变长休或营地床位的模组尚未与队伍选择器的长休暂停功能一起测试。如果长休出现异常,请关闭[i]长休前询问[/i],在长休前将队伍缩减到四人,之后再重新勾选所有人。[/b][/size][/]
[][size=4][b]某些模组会为了自己的用途将雇佣兵移出场外(例如作为替代角色)。此时队伍选择器会将该雇佣兵显示为灰色并标注“不可用:场外”,而不是招募他们。[/b][/size][/]
[][size=4][b]多人游戏:只有主机能更改队伍;其他玩家看到的“队伍”标签页是只读的,由其他玩家控制的角色永远不会被移动。每位玩家都需要相同版本的队伍选择器、Script Extender 和 MCM。注意,当有玩家加入时,游戏本身会解散一名同伴。尚未在实时多人游戏会话中测试;欢迎反馈。[/b][/size][/]
[/list]

[line]
[size=4][b]
[size=5]已知限制[/size][/b][/size]
[list]
[][size=4]游戏内对话仍然只能让说话者加三人就座。这是游戏的过场动画系统,未作更改。[/size][/]
[][size=4]负债者装束:仅限霍普分发那一刻在队伍中的人。之后加入队伍,或那一刻在希望之邸外的成员,一套也得不到。游戏本身会将其四套分发给前四名队伍成员,无论他们在哪里;队伍选择器不会将这些套装转移给别人。[/size][/]
[][size=4]在木筏的湖中停靠点,第五个及之后的成员会共用木筏上的四个站立点。尚未在游戏中测试;如果有人在湖上被落下,请重新加载或前往他们那里。[/size][/]
[][size=4]已在你的队伍中但处于场外的人,无法被队伍选择器送回营地。“队伍”标签页会说明这一点。[/size][/]
[][size=4]剧情为某个场景留在营地的同伴仍然可以被勾选,因为游戏的加入流程不会重复其招募对话所做的检查。在同伴自己的剧情时刻,请将他们留在营地。[/size][/]
[][size=4]其他模组添加的、游戏未标记为同伴的同伴,在他们以正常方式加入你的队伍一次之前不会被列出。之后,队伍选择器会记住他们。[/size][/]
[][size=4]长休后你可能会在 SE 日志中看到[i]请求被拒绝:队伍更改已在进行中。[/i]。队伍选择器监听两个长休结束信号;当第一个恢复尝试运行时,第二个会被拒绝。这无害。[/size][/]
[/list][size=4]
[size=5][b]控制台命令[/b][/size]
Script Extender 控制台,先输入 server:!pp_roster(所有人,在队伍中或在营地中,以及任何人被锁定或未列出的原因) !pp_set Name1,Name2(将队伍设置为这些人;被锁定的角色会保留) !pp_restore(带回长休期间在营地等待的人) !pp_size(重新应用上限) !pp_forget Name(从“在你的队伍中见过”记录中删除某人) !pp_halsin(哈尔辛的任务状态;repair 和 haven 修复过早加入的哈尔辛)。在客户端上下文(输入 client)中,!pp 会在自己的窗口中打开队伍列表,无需 MCM。完整表格见 README。[/size]


[line]
[size=4][b]
[size=5]致谢[/size]
[/b][/size]
[list]
[][size=4]作者:Serpentine(NexusMods:SerpentineShel)[/size][/]
[][size=4]BG3 Script Extender:Norbyte——队伍选择器完全基于它构建[/size][/]
[][size=4]模组配置菜单:AtilioA 及贡献者——“队伍”标签页和所有设置都在其中[/size][/]
[][size=4]Larian Studios——为队伍选择器所借助的队伍和营地脚本[/size][/]
[][size=4]感谢 BG3 模组社区对游戏剧情脚本的公开研究,以及首先摸清四人限制的队伍规模模组作者们[/size][/]
[/list][size=4]
[size=5][b]AI 使用披露[/b][/size]
队伍选择器在代码、研究和文档方面得到了 AI 编码助手(主要是 Claude Opus 5.5)的大量协助。它不包含 AI 生成的图像、图片、音频或其他媒体——只有代码和文本。所有设计决策、测试和最终发布均由作者完成。

[size=5][b]源代码[/b][/size]
队伍选择器是开源的。完整源代码(Script Extender Lua、MCM 蓝图、pak 构建器、测试和研究笔记)在 GitHub 上:
[url=https://github.com/Shiney1965/bg3-party-picker][b]github.com/Shiney1965/bg3-party-picker[/b][/url]

[size=5][b]许可证[/b][/size]
MIT——完整文本随下载以[i]LICENSE[/i]提供。队伍选择器不捆绑任何第三方文件;见下载中的 LICENSE-THIRD-PARTY.md。可在你自己的模组中自由复用代码;只需保留其版权声明。[/size]