T10 装备品质扩展和【更好的模组扩展版V3.X】【汉化】融合补丁

========================================================================

 T10 x BetterMods 融合补丁  (Z_T10BetterModsFusion)

========================================================================

引用来源【更好的模组扩展版V3.X】【汉化】【Better Mods Extended】 – 七日杀V3.X模组下载 – 七日杀中文网

                  【V3.2】T10 装备品质扩展-兼容CATUI&IZY武器包-V1.0.1 – 七日杀V3.X模组下载 – 七日杀中文网

【这个补丁是做什么的】

把下面两个模组的数据与机制衔接起来，让同一件“Superior 改装件”拥有一条

从 T1 连续延伸到 T10 的品质成长曲线：

  1) T10QualityExtension（十级品质扩展，DLL + Harmony）

     – 用 extendedTier“影子层级”实现 T7~T10，不改动原版品质字段。

     – 运行时只放大“正向效果”，负面/减益恒定。

     – 轴向策略：容量0.5 / 操控0.3 / 暴击0.25 / 防御0.5 / 通用0.3。

     – 层倍率：T7≈1.316、T8≈1.732、T9≈2.28、T10≈3.0。

  2) 更好的模组V3.X / BetterModsExtended（纯 XML，ServerSideOnly）

     – 提供 76 件 USN…Superior 改装件，正向效果按原生品质 tier=1~6 缩放。

     – 自带掉落（Stage 50+）与制造（出 T1）。

两者的分工天然互补：BetterMods 负责 T1~T6 的原生曲线，T10 负责在其 T6 结果上

继续叠加 T7~T10（T6→T7 约 +31.6%，衔接平滑）。本补丁负责“接通管道”。

————————————————————————

【安装位置与加载顺序】

把整个 Z_T10BetterModsFusion 文件夹放进：

   7 Days To Die/Mods/

务必保证两个前置模组也已启用，且本补丁最后加载：

   – 文件夹名以 “Z_” 开头，正常情况下会在

     T10QualityExtension 之后加载；

   – 本补丁的 DLL 不硬引用 T10 程序集，改用运行时反射解析，

     所以即使加载顺序有出入也不会报 TypeLoadException（只是可能

     暂时注册不到 adapter，日志会写明）。

————————————————————————

【补丁包含的内容】

ModInfo.xml                     模组清单（客户端 + 服务端，非 ServerSideOnly）

Z_T10BetterModsFusion.dll       IModApi 桥：向 T10 注册本融合层

Config/traders.xml              把 76 件 Superior 改装件上架到对应商人分组

                                （groupRangedMods / groupArmorMods /

                                  groupMeleeMods / groupVehicleMods）

Config/loot.xml                 新增任务奖励通道：把 Superior 件接入

                                groupQuestWeapons / groupQuestTools /

                                groupModAllT4，用 FusionSuperiorModQuest

                                概率模板按后期阶段(100/175/250/350)投放

src/                            FusionBridge.cs、csproj、build.ps1（可重新编译）

fusion_bridge.log               运行时生成，记录是否成功注册到 T10

————————————————————————

【两条机制是如何“结合”的（按你选择的获取通道）】

1) 制造 + 合并升级：

   – 用 BetterMods 的原配方造出 T1 的 USN…Superior 件（原生品质）。

   – 放进 T10 的合并(Combine)格子里逐级提升；T10 会自动把它推进到

     T7~T10 影子层级并放大正向数值。此过程由 T10 自身的补丁驱动，

     无需本补丁额外配置。

2) 商人 / 任务：

   – 本补丁的 traders.xml / loot.xml 让 Superior 件进入商人与任务奖励池。

   – 当商人阶段 / 游戏 Stage 达到 T10 的门槛（100/175/250/350）时，

     T10 的 trader / quest 适配器会给发下来的 Superior 件附带 T7~T10。

（注：你未选择“高级掉落”作为主通道。BetterMods 自带的 Stage 50+ 世界掉落

 仍然保留；在 Stage 100+ 时，那些掉落也会被 T10 自然提升到影子层级。）

————————————————————————

【调参与自定义】

– 想改投放节奏：编辑 Config/loot.xml 里 FusionSuperiorModQuest 的 level/prob，

  以及 Config/traders.xml 里的分组归属。

– 想改 T7~T10 的倍率/门槛/颜色：改 T10QualityExtension 自己的

  Config/T10Quality.xml（那是 T10 的专有配置，本补丁不覆盖它）。

– 术语口径：T1~T6 叫“原生品质”，T7~T10 叫“影子层级(extendedTier)”。

————————————————————————

【兼容性说明 / 已知边界】

– 本补丁不重复定义任何 item_modifier，避免与 BetterMods 冲突；

  Superior 件的数值曲线完全交给 BetterMods(T1~T6) + T10(T7~T10)。

– BetterMods 的负面效果恒定；T10 也只放大正向效果——两者理念一致，

  叠加后不会出现“高品质反而减益被放大”的问题。

– 若客户端为独立客户端连接专用服务器：BetterMods 是 ServerSideOnly，

  请把 BetterMods 也同时安装到客户端的 Mods/ 下（或改用联机/主机模式），

  否则客户端看不到 USN…Superior 的定义，T10 的层级显示会缺项。

  本补丁自身是客户端+服务端，显示桥接部分不受该限制。

————————————————————————

【重新编译 DLL（可选）】

需要 .NET SDK。进入 src/ 运行 build.ps1（或 dotnet build）。

若你的游戏安装路径不同，改 build.ps1 / csproj 里的 GameManaged 路径即可。

========================================================================