幸运掉落系统

幸运掉落系统

每次打开容器时掷一次骰子。你的属性决定锻造进容器中的战利品品质。神界:原罪2的幸运 charm 系统,为BG3重制版。

[center][color=#00ffff][size=6][b]幸运掉落系统[/b][/size][/color]
[color=#00ffff][size=4]《博德之门3》的神界风格幸运护符战利品[/size][/color]

[i]每次打开容器时掷一次骰子。掷出的点数决定你能找到什么。[/i][/center]
[center][i]每开一个容器掷一次骰,点数决定锻造出什么品质的战利品。也就是说只要运气好,内裤也可以是神装;[/i][/center]
[center][i]中文详细介绍在可选文件。
[/i][/center]
[line]

[b][color=#00ff00][size=5]概述[/size][/color][/b]

幸运掉落系统在《博德之门3》中重现了《神界:原罪2》的[b]幸运护符[/b]战利品系统。

你打开的每个容器都会被判定一次:游戏掷一次骰子,加上开启者的[b]力量/敏捷/感知[/b]加成,最终总点数决定添加到该容器中的战利品品质和数量。

本模组是[b]纯附加式[/b]的。它从不编辑、替换或重新生成原版战利品表——它只会额外添加新物品。你现有的战利品、任务物品以及其他模组的掉落物均不受影响。

[line]

[b][color=#00ff00][size=5]特性[/size][/color][/b]

[list]
[][b]骰子驱动战利品。[/b]每次打开容器时进行一次d20掷骰加上属性加成。[/]
[][b]五个品质档位[/b]对应BG3稀有度:罕见/稀有/史诗/传奇(外加可选的普通档位)。[/]
[][b]大成功。[/b]掷出自然20(可配置)可锻造出一件带有额外词缀的传奇物品,并根据角色等级额外获得多份副本。[/]
[][b]词缀锻造。[/b]战利品是动态构建的——一个基础装备模板加上随机词缀(属性加成、主动技能、被动技能)。两件图标相同的物品可能拥有完全不同的威力。[/]
[][b]斜杠风格命名。[/b]我在开发前缀/后缀功能时遇到了一些棘手的问题。在解决之前,我已禁用相关功能。目前,本模组掉落的物品将保留其原始名称。[/]
[][b]完全可配置[/b],通过BG3MCM——每个阈值、词缀数量、物品数量和池过滤器都在游戏内开放。[/]
[][b]多人游戏兼容。[/b]所有判定均由主机在服务器端执行;客户端仅显示只读信息面板。[/]
[][b]存档友好。[/b]如果你禁用模组,已生成的物品仍会保留在你的存档中(见卸载部分)。[/]
[/list]
[line]

[b][color=#ff0000][size=5]前置要求[/size][/color][/b]

[list]
[][b][url=https://www.nexusmods.com/baldursgate3/mods/2172]Baldur's Gate 3 Script Extender[/url] — 必需。[/b]幸运掉落系统完全使用Lua编写,没有它无法运行。[/]
[][b][url=https://github.com/AtilioA/BG3-MCM]BG3MCM / 模组配置菜单[/url] — 可选,但强烈推荐。[/b]没有它模组仍可正常运行,但你无法在游戏内更改任何设置;它将使用内置默认值。[/]
[][b]ImprovedUI[/b] — 可选,仅当你启用模组的可选自定义MCM标签页时需要(默认关闭)。在Nexus Mods上搜索“ImprovedUI ReleaseReady”。[/]
[/list]
这些都不是硬性依赖:如果缺少BG3MCM或ImprovedUI,幸运掉落系统会在运行时检测到并优雅降级,而不是拒绝加载。

[line]

[b][color=#ff0000][size=5]安装[/size][/color][/b]

[b]第1步 — 安装Script Extender(必需)[/b]

幸运掉落系统是一个Script Extender模组,没有它什么也做不了。从它的
[url=https://www.nexusmods.com/baldursgate3/mods/2172]Nexus页面[/url]获取并按照其说明操作。
最简单的方法是[b]BG3 Mod Manager → Tools → Download & Extract the Script Extender[/b]。

[b]第2步 — (可选)安装BG3MCM[/b]

仅当你想要在游戏内更改设置时需要。没有它模组仍可运行,使用内置默认值。

[b]第3步 — 安装幸运掉落系统[/b]

[b]选项A — BG3 Mod Manager(推荐)[/b]
[list]
[]打开BG3MM,将[i]LuckyLoot.pak[/i]拖拽到窗口中,或使用[i]File → Import Mod[/i]。[/]
[]将其移动到[b]Active[/b]列。[/]
[]按[i]Export Order to Game[/i]。[/]
[]本模组不关心加载顺序(关于唯一在意此事的设置,见下方“加载顺序”)。[/]
[/list]
[b]选项B — Vortex[/b]
[list]
[]照常安装和部署——Vortex的《博德之门3》扩展会放置.pak文件并更新你的加载顺序。[/]
[]Vortex[b]无法[/b]为你安装Script Extender;请单独执行第1步。[/]
[/list]
[b]选项C — 手动[/b]
[list]
[]将[i]LuckyLoot.pak[/i]复制到
[code]%LocalAppData%\Larian Studios\Baldur's Gate 3\Mods[/code][/
]
[]使用BG3 Mod Manager激活它,或手动添加到[i]modsettings.lsx[/i]。[/]
[/list]
[b]第4步 — 验证[/b]

启动游戏并打开任意容器。如果没有反应,打开Script Extender日志,查找幸运掉落系统的启动行。

[b]存档兼容性:[/b]纯附加式,可安全添加到现有存档——无需新游戏。

[line]

[b][color=#ff0000][size=5]模组管理器支持[/size][/color][/b]

[code]
  Tool                            Supported  Notes
  -----------------------------------------------------------------------------
  BG3 Mod Manager (BG3MM)        YES        Recommended. Full support.
  Vortex (Nexus Mod Manager)      YES        Works. Install SE separately.
  In-game mod manager (Patch 7+)  NO          Cannot load Script Extender mods.
  Manual (edit modsettings.lsx)  YES        Works, but no order management.[/code]
[list]
[][b]Vortex(Nexus Mod Manager)[/b] — [b]支持。[/b]Vortex的《博德之门3》扩展会部署.pak文件并管理你的加载顺序,幸运掉落系统无需特殊处理。Vortex唯一做不到的是安装[b]Script Extender[/b]——请先单独安装(第1步)。[/]
[][b]游戏内模组管理器[/b](Patch 7添加的mod.io管理器)— [b]不支持。[/b]该管理器仅处理通过mod.io分发的数据模组。幸运掉落系统是一个Script Extender模组:其逻辑在Lua中,无法转换为纯数据.pak。[/]
[][b]BG3 Mod Manager[/b]仍然是BG3社区的标配,对Script Extender模组的加载顺序处理最为可靠。如果不确定,请使用它。[/]
[/list]
[line]

[b][color=#00ff00][size=5]工作原理 — 规则详解[/size][/color][/b]

[b]两套规则预设 — 一键选择[/b]

幸运掉落附带两套完整规则集。在
[b]Dice Rules → Quick Presets[/b]下切换;之后每个单独的滑块仍然可编辑。

[code]
  Preset        Die    Total points                    Band thresholds
  ------------------------------------------------------------------------------
  Standard      d20    d20 + STR/DEX/WIS bonus        13 / 16 / 21 / 26
  Pure Dice    d50    die only, no bonuses at all    25 / 38 / 45 / 49[/code]
[b]标准(默认)[/b] — 你获得的点数取决于开启者的属性,因此
投资力量/敏捷/感知会直接获得回报。高属性使史诗和传奇触手可及。

[b]纯骰子[/b] — 完全忽略属性。只有骰子决定,提供固定、
可预测的概率,任何构筑都无法影响:
[code]
    roll        result                                  odds
    ---------------------------------------------------------------------
    1  – 24    nothing                                  48%
    25 – 37    Uncommon      3 affixes                  26%
    38 – 44    Rare          5 affixes                  14%
    45 – 48    Epic          7 affixes                  8%
    49          Legendary    11 affixes                  2%
    50          CRITICAL    14 affixes, 1-3 by level    2%[/code]

[b]1. 触发[/b]

每次打开容器时,模组会检查它:
[list]
[]只有真正的容器才算([i]Osi.IsContainer[/i])。门、书、拉杆及类似物体从不触发。[/]
[]角色背包内的容器(你的背包、营地箱子)会被跳过。[/]
[]商人/交易者库存会被跳过。[/]
[]模板名称匹配[i]TUT、CAMP*、CINE*、DEV*、DONOTUSE*、TEST*[/i]的容器会被跳过(教程箱子、营地箱子、过场道具、仅脚本箱子)。[/]
[/list]开启者被确定为距离容器最近的玩家角色(约6米内);如果失败,则使用主机角色。

[b]每个容器每个存档只判定一次[/b]。关闭并重新打开它,或重新加载存档,都不会重新掷骰。(如果你想要刷取,这两种行为都可以在MCM中关闭,但默认情况下重新掷骰是被阻止的。)

[b]2. 掷骰[/b]

[code]
    total  =  d20 roll  +  floor((STR - 10) / 2) x multiplier
                        +  floor((DEX - 10) / 2) x multiplier
                        +  floor((WIS - 10) / 2) x multiplier[/code]
[list]
[
][b]只有力量、敏捷和感知[/b]有贡献(在D&D的语境中,“感知”应更倾向于“觉察”)。体质、智力和魅力被刻意忽略——它们与生存能力、施法和对话相关,而非翻箱倒柜。[/]
[
][b]倍率[/b]是单个游戏内设置(x0 / x1 / x2 / x3)。在x1(默认)下,属性18提供+4。基础公式本身被有意锁定,以保持规则可预测。[/]
[
]单属性上限为±6,三项总和上限为±30(均可配置,最高±30)。[/]
[
]属性10恰好提供+0。低于10的值提供[b]负[/b]加成——弱角色真的会找到更少。[/]
[/list]
[b]属性参考(倍率x1):[/b]
[code]
    Attribute:    6  8  10  12  14  16  18
    Bonus:      -2  -1  +0  +1  +2  +3  +4[/code]
[b]3. 品质档位[/b]

总点数决定战利品落入哪个档位。档位从高到低检查;第一个满足阈值的档位胜出。

[code]
    Total points      Band          Affixes  Items
    --------------------------------------------------------
    below 13          nothing      -        0
    13 - 15          Uncommon      3        1
    16 - 20          Rare          5        1
    21 - 25          Epic          7        1
    26 and above      Legendary    11        1
    --------------------------------------------------------
    natural 20        CRITICAL      14        1-3 (by level)[/code]
[list]
[
]以上每个阈值、词缀数量和物品数量均可在MCM中调整。[/]
[
]每个档位都有自己的[b]开/关切换[/b]。关闭一个档位[b]不会[/b]将战利品降级到更低档位——落入已禁用档位的点数只会什么都不产出。[/]
[
]档位表被特意设计为恰好[b]20[/b]点落入[i]稀有[/i]:掷出自然20是大成功,而通过加成达到20仅仅是“还不错”。[/]
[/list]
[b]4. 大成功[/b]

当[b]原始骰子恰好显示配置的值[/b](默认20=自然20)时触发大成功。“至少20”不算——必须是自然掷骰。

[list]
[
]词缀数量默认14。[/]
[
]物品数量随开启者的[b]角色等级[/b]缩放:
[code]
    Level  1 - 3  ->  1 item
    Level  4 - 8  ->  2 items
    Level  9+      ->  3 items[/code][/]
[
]等级阈值和物品数量均可在MCM中配置。[/]
[/list]
[b]5. 战利品如何被锻造[/b]

战利品不是从预制物品列表中挑选的。它是被[b]锻造[/b]出来的:

[list]
[
]从战利品池中抽取一个[b]基础物品[/b](任何适合箱子的武器或护甲,任何稀有度——只使用其模型、图标和基础属性)。[/]
[
]其词缀和稀有度被[b]清空[/b],并根据掷出的档位从头重新生成。[/]
[
]物品的稀有度(=边框颜色)被设置为匹配档位,其价值相应缩放。[/]
[
]词缀从三个池中随机生成:数值属性加成、主动技能和被动技能。技能概率和技能数量取决于档位(传奇物品保证至少一个技能,最多三个)。[/]
[
]结果是一件全新的物品,[b]外观与基础物品完全相同[/b],但威力与你掷出的档位匹配。[/]
[/list]
这就是为什么你能找到一把看似普通却最终是传奇的匕首——这就是《神界:原罪2》基础装备系统的运作方式。

[b]命名:[/b]罕见和稀有物品获得前缀(“Vicious Longsword”);史诗和传奇物品获得前缀+后缀(“Dire Longsword of the Bear”)。(我在开发前缀/后缀功能时遇到了一些棘手的问题。在解决之前,我已禁用相关功能。目前,本模组掉落的物品将保留其原始名称。)

[b]6. 战利品池[/b]

该池在会话开始时构建一次,扫描所有武器、护甲和物体统计条目,然后过滤它们:
[list]
[
]匹配[i]CINE_、TEMP_、DELETEME、DONOTUSE、TEST、QUEST、BOOK_、LOW_、DEN_[/i]的统计条目被排除(过场道具、任务物品、开发遗留物)。[/]
[
]低于[b]最低价值[/b]的条目被排除(默认:1)。[/]
[
]每个稀有度上限为120个条目,随机采样,因此池保持多样性。[/]
[
]本模组创建的的战利品始终被排除(防止退化性自我强化)。[/]
[
]五种稀有度中的每一种都可以单独开/关。[/]
[/list]
[i]提示:[/i]如果你在游戏中途安装了新的装备模组,按MCM中的[b]Rebuild Loot Pool[/b]按钮(或使用控制台命令)即可获取其物品,无需重启游戏。

[line]

[b][color=#00ff00][size=5]配置(BG3MCM)[/size][/color][/b]

所有设置分为五个页面:

[code]
    General      - enable/disable the mod, log level, notifications, language
    Dice Rules  - dice sides, attribute multiplier, critical settings,
                  per-band thresholds / affixes / item counts
    Quality Tiers- forging budget multiplier, affix scaling
    Loot Pool    - auto-build, mod items, equipment-only, min value,
                  per-rarity toggles, pool rebuild button
    Test        - hidden by default (see below)[/code]
[b]语言:[/b]模组附带完整的中英文文本,用于信息面板和MCM页面。在[i]General → Language[/i]下设置:[i]Follow game language / Chinese / English[/i]。

[b]Test页面默认隐藏。[/b]它包含开发者工具(强制总点数、生成特定品质、清除“已判定”记录)。要显示它,打开Script Extender控制台(客户端侧)并输入:
[code]
    !ll_dev[/code]再次输入并加上[i]off[/i]可再次隐藏该页面。

[line]

[b][color=#00ff00][size=5]加载顺序与兼容性[/size][/color][/b]

[b]加载顺序[/b]

幸运掉落系统[b]不会[/b]覆盖任何原版记录,因此不需要最后加载,也不会与其他模组争夺优先级。

话虽如此,[b]有一个设置受加载顺序影响[/b]:

[list]
[
][b]“Include Items From Other Mods” — 开启(默认):[/b]使用完整统计表。来自你[b]所有[/b]模组的物品都有资格作为战利品,[b]无论加载顺序如何[/b]。这是默认值,也是大多数玩家想要的。[/]
[
][b]“Include Items From Other Mods” — 关闭:[/b]切换到“仅在幸运掉落系统之前加载的物品”。如果你将幸运掉落系统放在加载顺序的[b]早期[/b],这实际上意味着“仅原版”。如果你将它放在[b]后期[/b],其上方模组的物品仍会被包含。[/]
[/list]
[b]建议:[/b]将设置保持默认,并将幸运掉落系统放在任何位置。如果你特别想要仅原版的池,将幸运掉落系统放在加载顺序的[b]靠顶部[/b]并关闭该设置。

[center][b]幸运掉落系统可以安全地加载在模组列表的[u]任何位置[/u]。[/b][/center]

[b]与其他战利品模组的兼容性[/b]

[list]
[
][b]纯附加式。[/b]幸运掉落系统从不写入[i]TreasureTable[/i]或[i]TreasureCategory[/i],从不编辑现有容器内容,也从不重新生成其他模组放置的任何东西。因此两个战利品模组可以并排运行——你只需获得两个模组的贡献。[/]
[
][b]不覆盖原版物品。[/b]基础游戏或其他模组已放入容器的物品保持原样。幸运掉落系统在其之上添加自己的物品。[/]
[
][b]欢迎其他模组的装备。[/b]启用“Include Items From Other Mods”后,其他模组添加的装备可以被抽取作为锻造的基础模板。它们的词缀被清空并重新生成,因此你获得该模型的一个幸运掉落风格版本——该物品在基础游戏中的原始副本不受影响。[/]
[
][b]随机化器和全面改造。[/b]战利品随机化器、难度改造和经济模组在设计上兼容,因为幸运掉落系统只添加从不减少。如果某个模组整体替换容器内容,你仍将获得幸运掉落系统的额外物品,与该模组产出的一切并列。[/]
[
][b]叠加。[/b]如果你运行多个战利品模组,每个容器的物品数量自然会增加。如果你想要更精简的体验,在MCM中减少档位物品数量。[/]
[
][b]模组检查自身输出。[/b]幸运掉落系统生成的物品被永久排除在战利品池之外,因此锻造的物品永远不会被用作另一个锻造物品的基础。这防止了同一模型的失控复制。[/]
[/list]
[b]已知限制[/b]

[list]
[
][b]模组容器[/b]如果未通过游戏自身API报告为容器,或使用黑名单模板前缀,将不会触发。[/]
[
][b]商人、营地箱子和玩家背包[/b]故意从不触发。营地箱子被有意排除——否则你可以永远刷同一个箱子。[/]
[
][b]Script Extender是强制性的。[/b]这不是数据模组,无法转换为数据模组。[/]
[
][b]控制台命令[/b]和开发者Test页面仅支持英文/中文。[/]
[/list]
[line]

[b][color=#00ff00][size=5]多人游戏[/size][/color][/b]

[list]
[
]支持多人游戏,最多4名玩家。[/]
[
]所有掷骰和物品生成都发生在[b]主机[/b]上。客户端从不做任何决定,因此不会不同步。[/]
[
]每个客户端都可以打开只读信息面板,查看队伍的属性和最近的掷骰。[/]
[
]战利品根据[b]打开容器的角色[/b]授予,而非主机——你自己的力量/敏捷/感知才是关键。[/]
[/list]
[line]

[b][color=#00ff00][size=5]卸载[/size][/color][/b]

[b]请先阅读[/b]

模组已锻造的物品[b]会留在你的存档中[/b]。它们的属性由模组在每次加载存档时重新创建,因此一旦模组被移除,这些物品可能会失去词缀或显示为空白。这是唯一的副作用——它从不损坏存档,也从不触碰原版战利品表。

[b]推荐替代方案——只需将其关闭[/b]

你不必卸载。打开[b]MCM → General → Enable Mod[/b]并将其关闭:
[list]
[
]没有新掷骰,没有来自容器的新战利品。[/]
[
]现有的幸运掉落系统物品完全照常工作。[/]
[
]完全可逆——随时可以重新开启。[/]
[/list]
[b]如果你确实想完全移除它[/b]

[b]1.[/b](推荐)先在游戏内关闭模组,然后出售、存放或销毁你的幸运掉落系统物品。
[b]2.[/b]在[b]BG3MM[/b]中:将幸运掉落系统移回[i]Inactive[/i]并按[i]Export Order to Game[/i]。
    在[b]Vortex[/b]中:禁用它或卸载,然后部署。
[b]3.[/b]从以下位置删除[i]LuckyLoot.pak[/i]
[code]%LocalAppData%\Larian Studios\Baldur's Gate 3\Mods[/code][b]4.[/b](可选)若要同时清除其保存的设置,删除残留的配置文件文件夹:
[code]%LocalAppData%\Larian Studios\Baldur's Gate 3\Script Extender\BG3MCM\Profiles\<your profile>\LuckyLoot[/code]
[b]不受影响的内容[/b]
[list]
[
]你的存档文件——移除模组不会损坏或破坏它。[/]
[
]原版战利品表——模组从不写入它们,因此没有任何东西会还原或损坏。[/]
[
]其他模组——它们的战利品和物品照常工作。[/]
[
]Script Extender和BG3MCM——保留它们安装,它们被许多模组共享。[/]
[/list]
[line]

[b][color=#00ff00][size=5]控制台命令[/size][/color][/b]

打开Script Extender控制台并输入[i]!ll_help[/i]查看完整列表。最有用的几个:

[code]
    !ll_help        show all commands
    !ll_panel      open/close the info panel
    !ll_rebuild    rebuild the loot pool immediately
    !ll_attr        show or override attribute bonuses
    !ll_dev        reveal/hide the hidden Test page in MCM[/code]
[line]

[b][color=#00ff00][size=5]故障排除[/size][/color][/b]

[b]打开容器时没有任何反应。[/b]
按顺序检查:(1) Script Extender确实已安装并运行;(2) 模组在[i]General[/i]下已启用;(3) 你的总点数足够高——三项属性均为10时你掷出1-20,低于13的任何值都不产出,因此基线情况下大约40%的开启会产生战利品。提高倍率或你的属性可以增加这个概率。

[b]我不再从已经打开过的箱子获得战利品。[/b]
这是预期行为:每个容器每个存档只判定一次。如果你在测试,使用Test页面([i]!ll_dev[/i])清除记录。

[b]新装备模组的物品从不掉落。[/b]
按MCM中的[b]Rebuild Loot Pool[/b](Loot Pool页面)——该池每个会话构建一次,不会自动注意到新安装的模组。

[b]MCM页面语言不对。[/b]
更改语言后关闭并重新打开MCM菜单;MCM自身的页面文本在页面构建时生成。

[line]

[b][color=#00ff00][size=5]更新日志[/size][/color][/b]

[b]1.7.0[/b] — 预发布打磨:信息面板和MCM页面的完整中英文本地化、属性加成倍率、大成功等级缩放、实时战利品池过滤器、战利品池重建按钮、MCM页面语言切换。

[b]1.6.x及更早[/b] — 内部开发版本:骰子系统、品质档位、词缀锻造、容器规则、多人游戏支持。

[line]

[b][color=#00ff00][size=5]鸣谢与权限[/size][/color][/b]

[list]
[
]作者:[b]FFFing[/b][/]
[
]灵感来自《神界:原罪2》(Larian Studios)的[b]幸运护符[/b]战利品系统。[/]
[
]感谢[b]BG3 Script Extender[/b]、[b]BG3MCM[/b]和[b]ImprovedUI[/b]团队。[/*]
[/list]
[b]权限:[/b]你可以翻译本模组并重新发布翻译,前提是链接并注明原模组。未经许可,不要在其他地方重新上传模组本身或其资源。不要将其包含在付费模组包中。

[line]

[center][i]发现了bug或有建议?请使用Posts标签——附带Script Extender日志的bug报告是获得修复的最快途径。[/i][/center]