技能树中心框架

技能树中心框架

技能树模组的统一入口——一个中心枢纽,不再有重叠的标签栏。

技能树中心框架

技能树模组的统一入口——一个中心,不再有重叠的标签栏。

概述

技能树中心框架为《博德之门3》原版蝌蚪树 UI 添加了一个单一的、共享的“扩展技能树”入口。不再让每个技能树模组都占用蝌蚪树顶部的同一位置——导致它们的标签栏相互堆叠、变得无法阅读或无法点击——所有支持该框架的模组都将它们的入口注册到一个干净、可滚动的中心页面内。 该框架也可以完全独立运行。

问题

许多 BG3 技能树模组将其入口显示为原版灵吸怪(蝌蚪)能力界面顶部的一个标签。当安装两个或更多此类模组时,每个模组都会在同一位置绘制自己的标签。结果是标签栏重叠、无法阅读或无法点击——而且每增加一个模组,情况就会变得更糟。

解决方案

• 一个入口。原版蝌蚪树只增加一个按钮:“扩展技能树”。 • 一个中心。点击它会打开中心页面——一个干净的 3 列技能树入口网格,带有上/下滚动控制。 • 注册入口。支持该框架的模组将其入口注册到中心内,而不是绘制自己竞争性的顶部标签。 保护已兼容该框架的技能树,避免因加载不兼容的技能树而被破坏。

特性

• 一个入口,无冲突。 无论你运行多少个技能树模组,单个“扩展技能树”按钮都能保持蝌蚪树顶部整洁。 • 干净的 3 列中心网格。 内置入口以及为第三方入口预留的专属区域,带有上/下滚动按钮。 • 内置入口。 灵吸怪能力(打开原版蝌蚪树),以及安装相应模组时的猎魔人和海克斯科技技能树。 • 自动门控。 只有当所选角色实际拥有匹配的动作资源时,入口才会出现,因此你永远不会看到无法使用的技能树。 • 键盘和控制器支持。 两种 UI 布局均已覆盖。 • 设计上为增量式。 框架从不编辑其他模组;集成模组只添加自己的文件。

语言支持

兼容《博德之门3》支持的所有本地化语言。

需求

• 《博德之门3》(当前补丁)。 • Norbyte 的《博德之门3》脚本扩展器(BG3SE) —— 必需。该框架使用一个小型客户端脚本折叠旧版顶部标签栏;没有 BG3SE,该整合将不会生效。 • 无模组依赖。 该框架不依赖任何东西。它是其他技能树模组所依赖的模组。

加载顺序

将框架放置在任何与其集成的模组之上(之前),但位于基础游戏模块之下。在实践中:放在模组列表的靠前位置,紧接游戏自身模块和 BG3SE 之后。

兼容性

• 专为以下设计: 使用原版蝌蚪树界面的技能树和天赋树模组,以及任何选择集成的模组。 • 它解决“多个技能树模组争夺同一 UI 位置”这一类冲突——重叠的入口标签和争夺的入口空间。 • 它不解决其他冲突类型。属性、法术和状态 UUID、进度、本地化 ID,以及模组在其入口按钮之外更改的任何内容,均不在该框架的范围内。

致模组作者

集成只需在你自己的模组内进行三处小的、纯增量式更改。切勿编辑框架的文件。

添加入口控件 XX_HubEntry.xaml(键盘)和 XX_HubEntry_c.xaml(控制器)。两者都必须设置 ls:UIWidget.ContextName="TadpolePowersTree"。

在你的 GUI/StateMachines/Keyboard.xaml 中,添加框架状态的 Extend:

<ls:State Name="MUP_Hub" ModType="Extend">
    <ls:State.Widgets>
        <ls:StateWidget Filename="XX_HubEntry.xaml" Layer="PauseOverlay"/>
    </ls:State.Widgets>
    <ls:State.Events>
        <ls:StateEvent Name="OpenXXTree">
            <ls:StateEvent.Actions>
                <ls:PushState Name="XXTree"/>
                <ls:RemoveState/>
            </ls:StateEvent.Actions>
        </ls:StateEvent>
    </ls:State.Events>
</ls:State>

在 Controller.xaml 中,添加相同的 MUP_Hub Extend(仅控件)以及一个 MainPanels Extend,用 SetSubstate 打开你的技能树。

三条规则:(1) 仅增量——绝不编辑框架的文件;(2) 框架必须在你的模组之前加载;(3) 入口控件的 ContextName 必须是 TadpolePowersTree。 完整的集成指南(英文和中文)随框架包提供,涵盖控件模板、槽位位置公式、标签去重、飞行前检查清单以及常见陷阱。 保留的事件名称(请勿重用): OpenWitcherTree、OpenHextechTree、MUP_OpenIllithid、OpenMUPHub、CloseWidget、IE.UICancel、IE.UIToggleTadpolePowers、OpenPinnedTooltips。

常见问题

这会与其他模组冲突吗? 它消除了多个技能树模组在蝌蚪树上同一位置绘制入口标签的特定冲突。它不会——也无法——解决无关的冲突,例如重叠的属性或重复的 UUID。

我需要新的存档吗? 不需要。这是一个 UI 模组;你可以随时添加或移除它。

它需要 BG3 脚本扩展器吗? 需要。安装 BG3SE 以获得完整体验——没有它,旧版顶部标签栏将不会被折叠。

它支持控制器吗? 支持——键盘和控制器布局均受支持。

我是模组作者。我必须重写我的模组吗? 不需要。集成是增量式的:一个入口控件加上状态机中的一个小型 Extend。你现有的技能树保持原样。

致谢与权限

• 作者:RaphaelCHEN1