SN2动力调整

SN2 功率调整
为《Subnautica 2》中真正会耗尽电力的三项内容提供了三个滑块。这是一个轻量级的UE4SS Lua模组，可让你独立调节电池容量、充电器速度以及基地发电量——全部可通过SN2ModSettings在游戏内配置。

无需覆盖`.pak`文件，无需修改存档，无需任何永久改动——将数值调至`1`即可关闭该分类对应的模组效果。

请注意：安装此模组后，只有新制作的物品（如电池等）才会生效。

功能说明
电池容量倍率 - 1> 10倍 - 将每块电池和能量电池的`最大能量等级`提升至10倍。涵盖基础电池、酸性（高级）电池、能量电池和聚变能量电池V2。维持当前电量比例——半满的电池在新上限下仍保持半满。
充能速度倍率 - 10× - 使所有电池接线端和电力电池接线端的`ChargeRate`翻倍。
发电倍率 10× 使所有发电组件的基础发电量乘以10倍——包括太阳能板、热能电厂、生物反应器和水力涡轮机。阳光/温度/燃料的缩放比例仍然在倍增基础上生效，因此该倍率适用于你的**峰值**输出。 

每个倍率均有独立的启用开关。同时内置调试日志开关，便于排查问题。

需求
**《Subnautica 2》的 UE4SS** — [Nexus](https://www.nexusmods.com/subnautica2/mods/36) / [GitHub](https://github.com/Subnautica2Modding/Subnautica2-UE4SS)
**SN2ModSettings** — [Nexus](https://www.nexusmods.com/subnautica2/mods/20) — 提供游戏内滑条界面。没有该模组游戏也能正常运行，但除编辑 `enabled.txt` 外，你将无法更改默认设置。

安装

• 确保UE4SS正确安装：`dwmapi.dll`需位于`Subnautica2-Win64-Shipping.exe`旁边，且`ue4ss/`文件夹与其同级。
  

• 2. 解压此压缩包，使 `SN2PowerTweaks/` 文件夹位于：
  

  <game>\Subnautica2\Binaries\Win64\ue4ss\Mods\
 
  最终结构应如下所示：
  
  ue4ss\Mods\SN2PowerTweaks\
  ├── enabled.txt —— 已启用.txt
  ├── README.md
  ├── 许可证
  ```directory └── Scripts\ ```
      ├── ConfigManager.lua
      └── main.lua
 

• 3. **重要提示：** 打开 `ue4ss\Mods\mods.txt`，在任意位置添加以下这行内容：
  

 
  SN2力量调整：1

 这可确保模组在 SN2ModSettings **之前**加载，否则SN2ModSettings的界面要等你重启游戏第二次后，才会显示Power Tweaks。（原因详见 **常见问题排查**。）

• 4. 启动游戏。打开**设置 → Mods**——你应该能在列表里看到**“Power Tweaks”**，带有三个滑块。
  

设置
游戏内（推荐）： 打开设置→模组→电力调整，拖动滑块，约1秒后更改将应用于存档中所有已有的电池/充电器/发电机。

手动编辑文件实时数值在您调整过一次设置后，会保存在`ue4ss\Mods\SN2ModSettings\saved\SN2PowerTweaks.lua`中。如果愿意，您可以在游戏关闭时进行编辑。

兼容性
其他电力模组（如Better Batteries、Faster Chargers、PowerBoost 10x等）：从技术上讲，它们都作用于相同的基础属性。如果叠加使用，效果会相乘——例如Better Batteries的1.5倍加上Power Tweaks的2倍，大约等于3倍容量。稳定性没问题，但很容易调过头。建议只选一种方案。
- 存档文件：不修改存档文件。随时卸载模组，存档即可干净还原——数值将在下次加载时恢复至原版默认。
多人模式/合作模式：未经测试。对主机玩家而言应该安全，但加入的玩家若未使用相同的倍率设置，很可能会遇到不同步问题。

故障排除

• “Power Tweaks”未显示在“设置 → Mod”中。
  

SN2ModSettings仅会在启动时扫描一次其`registrations/`文件夹。若SN2PowerTweaks在该扫描*之后*加载，其注册文件便写入过晚，界面将无法识别。

修复：确保`SN2PowerTweaks : 1`位于`ue4ss\Mods\mods.txt`中。`mods.txt`中列出的模组会先于自动发现的模组加载，因此在SN2ModSettings扫描前，注册文件已就绪。

替代快速修复：只需重启游戏一次。注册文件在多次运行之间会保留，因此第二次启动时，SN2ModSettings 将在其启动扫描期间看到该文件，无论加载顺序如何。

• 数值似乎未生效
  

在模组设置中开启 **启用调试日志**，复现问题，然后查看 `ue4ss\UE4SS.log` 中以 `[SN2PowerTweaks]` 开头的行。该模组会记录每一次快照与应用操作。如果完全没有日志输出，说明模组未运行——请检查模组文件夹中是否存在 `enabled.txt`。

• “我都卸载了，电池容量怎么还是增强的？！”
  

此模组仅在游戏运行时修改内存中的数值，不会对存档写入任何内容。未加载模组时读取存档，将恢复原版数值。若电池仍显示强化状态，是因为UE4SS在移除模组前已向该对象注入了旧数值。丢弃并重新拾取电池，或保存后重新加载即可。

运作方式（技术细节）
从UE4SS的CXX头文件转储中识别出三种目标类型：

`/Script/UWEEquipment.UWEBattery` `EnergyLevel`, `MaxEnergyLevel`（浮点数）所有电池类型的父类。一次FindAllOf即可捕获所有子类。 
`/Script/UWEPower.UWEPowerTerminal` `ChargeRate` (浮点型) | 电池与电源终端共用的父类。 
`/Script/UWEPower.UWEPowerGeneratorComponent` `BasePowerGeneration`（浮点数）附加于所有发电机（太阳能/热能/生物能/水能）组件。通过调用`SetPowerGeneration()`函数更新数值，该函数触发`OnRep_BasePowerGeneration`事件，使UI元素同步更新。 

对于每个实例，该模组在首次出现时记录原版基础值（以对象的完整名称作为稳定键），随后强制执行`当前值 = 基础值 × 倍率`。这意味着之后调整倍率时，始终基于真实的原版基准进行计算，绝不会产生叠加效应。

通过 `NotifyOnNewObject` 的生成时钩子可立即捕获新建/制造物品（延迟 100 毫秒，以确保游戏完成对象初始化）。每秒一次的检查会轮询 SN2ModSettings 中的滑块变更，并在数值变动时重新应用。

制作人员名单
**UE4SS** 由 UE4SS 团队开发，[Subnautica2Modding](https://github.com/Subnautica2Modding/Subnautica2-UE4SS) 小组为其移植了《深海迷航2》版本。
**SN2模组设置** 由 [Just-Chaldea](https://github.com/Just-Chaldea/SN2-ModSettings) 提供 — 用于支持游戏内滑块界面。
- **ConfigManager 模式**改编自 [iTestor](https://www.nexusmods.com/subnautica2/mods/252) 的 **Capacity & QuickBar Tweaks**。将设置清单写入 `SN2ModSettings/registrations/` 的写法模式归功于该作者。
灵感源自现有的功率微调`.pak`模组（更耐用电池、更快充电器、功率提升10倍）——目标相同，但由Lua驱动，因此带滑条调节。

许可证

MIT — 详见[许可证](./LICENSE)。你可以自由使用、分叉或发布修改版本，无需特别申请许可。

请提供需要翻译的游戏文本内容，我会为您进行专业的本地化翻译。

## 更新日志

### 1.0.0
- 初始版本发布。
电池容量、充电速度、发电倍率（各1–10倍）。
SN2模组设置界面集成。
- 每实例基线快照，确保滑块调整不会叠加累积。