T10 装备品质扩展和海克斯系统 兼容优化mod

Z_Q131TierIsolation —— 让 Q131 内容独立于 T10QualityExtension 等级系统

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

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

【V3.1~V3.2小型mod】海克斯系统09-01新增丧尸海克斯选装，适配V3.2 V3.1通用 – 钻石模组 – 七日杀中文网

【作用】

本补丁让下列两个 mod 的全部物品”不进入” T10QualityExtension（十级品质扩展）的

T7-T10 影子等级系统，表现为：既不会被生成/roll 出 T7-T10，也不会被 T10 缩放数值，

UI 上也只显示原版 1-6 品质——等同于”没有装 T10″时的行为。

  – Q131HexDraft      （物品名 q131Hd* / q131Rune*）

  – Q131LeagueEquipment（物品名 q131Le*，共 243 个物品 + 其改装件）

【不改动任何源文件】

Q131HexDraft、Q131LeagueEquipment、T10QualityExtension 三个 mod 的文件均不被修改，

本补丁是独立的一个 mod 文件夹，只在运行期生效。

【原理】

T10 所有的等级行为（掉落/制作/商人/任务是否 roll 出高级、ItemValue.ModifyValue 的

按等级缩放、以及基于 TryGetTier 的品质颜色/星级显示）都统一经过它内部唯一的分类

闸口：ExtendedTierService.CanHaveExtendedTier(ItemClass)。

本补丁给该方法加一个 postfix（后处理）：当被判断物品的名字以 “q131” 开头时，把结果

强制改为 false。因为这是所有路径共同的总闸，改这一处即可让 Q131 物品在生成、缩放、

显示三条链路上全部脱离 T10，且不影响任何其他物品（武器/护甲/工具/其它 mod 照常）。

它与另一个补丁 Z_T10ToolQuality 挂钩的是同一个方法，但谓词互斥：

  – Z_T10ToolQuality：把 meleeTool* 的 false 翻成 true（让工具吃到 T7-T10）

  – 本补丁：把 q131* 的 true 翻成 false（让 Q131 内容不吃 T7-T10）

两者判断的名字前缀不重叠，可同时安装、互不干扰。

【”独立”的准确含义与边界】

– 本补丁隔离的是 T10 的等级系统（T7-T10 影子层级）。Q131 物品仍会正常受游戏原版

  1-6 品质影响（那是七日杀本体机制，不属于 T10），这符合”独立于第三个 mod 的等级系统”。

– 判断依据是物品注册名以 q131 开头（覆盖两个 mod 的所有物品与改装件）。若作者以后

  发布了不以 q131 命名的物品，需在 src 的 IsolatedNamePrefixes 增加前缀后重新编译。

– 隔离只作用于 Q131 物品”本身”。若你把某个 Q131 改装件装到一把非 Q131 的武器上，

  那把武器仍按它自己的等级被 T10 缩放，这是预期行为。

【文件结构】

  ModInfo.xml                 —— mod 元数据

  Z_Q131TierIsolation.dll     —— 编译产物（供游戏加载，6656 字节）

  src\Q131TierIsolationMod.cs —— 源码

  build.rsp                   —— 离线重编译参数

  说明.txt                    —— 本文件

【安装】

1. 把整个 Z_Q131TierIsolation 文件夹放入游戏的 Mods 目录。

2. 必须与 T10QualityExtension 同时启用（本补丁正是为压制它对这些物品的影响而存在）。

3. 关闭 EAC / 反作弊（含自定义代码的 mod 需要）。

   本 mod 文件夹名以 Z_ 开头，会晚于 T10QualityExtension 加载，确保挂钩时目标方法已存在；

   即便顺序有变，补丁内置了 AssemblyLoad 事件重试，加载顺序不影响正确性。

【验证】

进游戏后看日志（Player.log / log.txt）应出现：

  [Z_Q131TierIsolation] Patched T10QualityExtension.ExtendedTierService.CanHaveExtendedTier

  [Z_Q131TierIsolation] Z_Q131TierIsolation loaded: Q131 items are isolated …

之后 Q131 的装备/物品品质条应停在原版 1-6，不再出现 T10 的 T7-T10 影子等级与对应加成。

【卸载】

删除本 mod 文件夹即可；不残留、不改动其它任何文件。

【重编译】

装了 .NET SDK 后，在本目录执行（PowerShell）：

  dotnet “C:\Program Files\dotnet\sdk\8.0.425\Roslyn\bincore\csc.dll” @build.rsp

（csc.dll 路径以你机器上实际的 SDK 版本目录为准。）