Stellar Tool - 表格模组合并器

Stellar Tool - 表格模组合并工具

描述

Stellar Tool 是一款专为《星刃》打造的模组合并工具，旨在解决经典问题：当两个模组修改同一个表格文件（如 SkillTable、CharacterTable、EffectTable...）时，游戏只会加载其中一个，导致你安装的模组内容悄悄损失一半。

Stellar Tool 并非盲目合并，它会解码每个模组内的数据表，并以可读的格式呈现每一项改动：

EffectTable · Item_HP_RPotion · CalculationValue: 60 → 30 (-50%)
SkillTable · M_DroidTurret_Laser · AttackDamageRate: 1.5 → 4.5 (+200%)

你可以勾选想要的改动。当两个模组对同一数值做出不同修改时，工具会标记为冲突，并让你并排选择最终结果。随后它会重建表格，将所有内容打包成一个经过验证的完整容器。

主要功能

• 加载任意数量的模组：支持传统 .pak 文件、压缩包、零散 .uasset 文件夹，以及通过 CUE4Parse 支持的 Zen/IoStore 模组（Nexus 常见格式，.ucas/.utoc）。
• 逐项改动复选框：每个被修改的行/属性都是一条可保留或丢弃的选项。可一次性切换整个表格。
• 基于原始游戏文件显示真实的改动前后数值及百分比，让你清楚了解每个模组的作用。
• 数值级冲突检测（同一表格 + 同一行 + 同一属性不同值）。支持逐冲突解决或“全局优先使用此模组”。
• 非表格资源（如网格、纹理）作为整体文件替换处理，同样支持勾选和冲突逻辑。
• 输出为游戏原生 Zen/IoStore 容器（zzz_StellarTool_Merged_P），打包后经过验证。前缀 zzz 确保加载优先级。
• 可选的安装 .zip（Paks\ + 说明文件），可直接放入 Vortex 或任何模组管理器。
• 每个合并的表格在打包前都经过往返验证——如果某项改动无法完整保留，合并会失败报错，而不是破坏你的游戏。
• 项目文件（.stproj）：保存模组列表、选择和冲突解决方案，可稍后重新打开。
• 无头模式：支持脚本/自动化操作。
• 你的原始模组不会被修改。工具仅写入合并后的输出。

读取 Zen/IoStore 模组

大多数《星刃》模组以 Zen/IoStore 容器（.ucas/.utoc）形式发布。Stellar Tool 使用 CUE4Parse 读取它们——只需在设置中指定一次《星刃》游戏文件夹（支持自动检测 Steam 路径），即可分析并比较 Zen 模组与原始文件的差异。

合并 Zen 模组时，数值型改动（生命值、伤害、护盾、倍率等）会被写回并验证。非数值型改动（文本、枚举、数组、对象引用）会在差异对比中显示，但写入时会被跳过——目前这些内容无法可靠地往返写入 Zen 容器。工具会统计并报告跳过的改动数量。

它做不到的事

• 它不会手动编辑数值（目前版本）——它只是合并你的模组已有的改动。
• Zen 模组中的非数值型改动不会被写回（见上文）。

安装

1. 下载并解压到任意位置。
2. 运行 StellarTool.exe。
3. 拖入你的模组，点击分析，检查改动和冲突，然后合并。
4. 将生成的文件复制到 StellarBlade\SB\Content\Paks\~mods（或使用模组管理器安装生成的 zip 文件）。
5. 重要提示： 禁用/移除你已合并的原始模组，以免它们覆盖合并后的 pak 文件。

可选但推荐：准备原始游戏文件基线（这样你就能看到“原始 → 模组化”的数值，而非原始模组值）。GitHub 上的说明文档解释了如何通过一条命令从你的游戏副本中提取。

要求和冲突

• Windows 10/11。永远不会触及游戏文件；工具只读取模组并写入你选择的输出文件夹。
• 合并后的 pak 文件自然与你合并进去的模组冲突——请禁用那些模组。
• 开源（MIT 协议）：github.com/guideahon/StellarTool —— 包含代码、构建说明和问题追踪。欢迎提交涉及模组的错误报告。

鸣谢

• trumank，提供了 repak 和 retoc——本工具依赖的 pak/IoStore 工具。
• atenfyr，提供了 UAssetGUI / UAssetAPI——使得数值级合并成为可能的 uasset 解码工具。
• 感谢《星刃》模组社区为映射文件（.usmap）打下的基础。
• Raxdiam，他用“我们在修改同一个文件并冲突”来描述游戏模组，这启发了本工具的开发。