SN2PowerTweaks

SN2PowerTweaks

Three sliders for the things that actually run out of power in Subnautica 2. A lightweight UE4SS Lua mod that lets you tune battery capacity, charger speed, and base power generation independently — all configurable in-game via SN2ModSettings.

No `.pak` overrides, no save-file modification, no permanent changes — slide a value to `1` and the mod is effectively off for that category.

Please note: this mod only works on craftables such as batteries after you install the mod and create new items (batteries etc)

What it does

Battery Capacity Multiplier - 1> 10× - Multiplies `MaxEnergyLevel` on every battery and power cell. Covers Basic Battery, Acid (Advanced) Battery, Power Cell, and Fusion Power Cell V2. Preserves current charge ratio — a half-full battery stays half-full at the new cap.

Charger Speed Multiplier - 1>10× - Multiplies `ChargeRate` on every Battery Terminal and Power Cell Terminal.

Power Generation Multiplier - 1> 10× Multiplies `BasePowerGeneration` on every power generator component — solar panels, thermal plants, bioreactors, and hydro turbines. Sunlight / temperature / fuel scaling still applies on top, so the multiplier is to your **peak** output. 

Each multiplier has its own enable toggle. A debug-logging toggle is included for troubleshooting.

Requirements

1. **UE4SS for Subnautica 2** — [Nexus](https://www.nexusmods.com/subnautica2/mods/36) / [GitHub](https://github.com/Subnautica2Modding/Subnautica2-UE4SS)

2. **SN2ModSettings** — [Nexus](https://www.nexusmods.com/subnautica2/mods/20) — provides the in-game slider UI. The mod will load without it, but you'll have no way to change the defaults short of editing `enabled.txt`.

Installation

• 1. Make sure UE4SS is installed correctly: `dwmapi.dll` next to `Subnautica2-Win64-Shipping.exe`, and the `ue4ss/` folder beside it.[/*]

• 2. Extract this archive so the `SN2PowerTweaks/` folder lands inside:[/*]

  <game> Subnautica2 Binaries Win64 ue4ss Mods

  Final structure should look like:

  ue4ss Mods SN2PowerTweaks

  ├── enabled.txt

  ├── README.md

  ├── LICENSE

  └── Scripts

      ├── ConfigManager.lua

      └── main.lua

• 3. **Important:** open `ue4ss Mods mods.txt` and add this line anywhere:[/*]

  SN2PowerTweaks : 1

 This ensures the mod loads *before* SN2ModSettings, otherwise the SN2ModSettings UI won't see Power Tweaks until you restart the game a second time. (See **Troubleshooting** for the reasoning.)

• 4. Launch the game. Open **Settings → Mods** — you should see **"Power Tweaks"** in the list with three sliders.[/*]

Configuration

In-game (recommended): open Settings → Mods → Power Tweaks, move the sliders, changes apply within ~1 second to every existing battery / charger / generator in your save.

Manual file edit: the live values live in `ue4ss Mods SN2ModSettings saved SN2PowerTweaks.lua` after you've touched the settings once. Edit while the game is closed if you prefer.

Compatibility

- Other power mods (Better Batteries, Faster Chargers, PowerBoost 10x, etc.): technically they all target the same underlying properties. If you stack them, the effects multiply — e.g. Better Batteries x1.5 + Power Tweaks 2× = ~3× capacity. Stable, but easy to over-tune. Pick one approach.

- Save files: no save-file modifications. Uninstall the mod at any time and your save reverts cleanly — values snap back to vanilla on next load.

- Multiplayer / co-op: untested. Should be safe for the host, but joining players will likely see desync if they don't have the same multipliers.

Troubleshooting

• "Power Tweaks doesn't show up in Settings → Mods"[/*]

SN2ModSettings only scans its `registrations/` folder once at startup. If SN2PowerTweaks loads *after* that scan, its registration file is written too late and the UI won't see it.

Fix: make sure `SN2PowerTweaks : 1` is in `ue4ss Mods mods.txt`. Mods listed in `mods.txt` load before auto-discovered ones, so the registration file is on disk before SN2ModSettings scans.

Alternative quick fix: just restart the game once. The registration file persists between runs, so on the second launch SN2ModSettings will see it during its startup scan regardless of load order.

• Values don't seem to apply[/*]

Toggle **Enable Debug Logging** on in the mod's settings, reproduce the issue, then check `ue4ss UE4SS.log` for lines starting with `[SN2PowerTweaks]`. The mod logs every snapshot and apply. If nothing logs at all, the mod isn't running — check that `enabled.txt` exists in the mod folder.

• "I uninstalled but my batteries still have the boosted capacity!"[/*]

The mod only modifies values in-memory while the game is running — it doesn't write anything to your save. Loading your save without the mod will restore vanilla values. If a battery still looks boosted, it's because UE4SS injected old values into that object before you removed the mod. Drop and re-pick the battery, or save-and-reload.

How it works (technical)

Three target classes, identified from a UE4SS CXX header dump:

`/Script/UWEEquipment.UWEBattery`  `EnergyLevel`, `MaxEnergyLevel` (float)  Parent class of every battery type. One FindAllOf catches all subclasses. 

`/Script/UWEPower.UWEPowerTerminal`  `ChargeRate` (float) | Parent class of both Battery and Power Cell terminals. 

`/Script/UWEPower.UWEPowerGeneratorComponent`  `BasePowerGeneration` (float) Component attached to every generator (solar / thermal / bio / hydro). Updates are applied via the `SetPowerGeneration()` UFunction, which fires `OnRep_BasePowerGeneration` so UI elements update too. 

For each instance, the mod snapshots the vanilla base value on first sight (using the object's full name as a stable key), then enforces `current = base × multiplier`. This means sliding the multiplier later always computes from the true vanilla baseline, never compounds.

Spawn-time hooks via `NotifyOnNewObject` catch newly built / crafted items immediately (with a 100 ms delay so the game has finished initialising the object). A 1 Hz check polls SN2ModSettings for slider changes and re-applies when something moves.

Credits

- **UE4SS** by the UE4SS team, ported for Subnautica 2 by the [Subnautica2Modding](https://github.com/Subnautica2Modding/Subnautica2-UE4SS) group.

- **SN2ModSettings** by [Just-Chaldea](https://github.com/Just-Chaldea/SN2-ModSettings) — provides the in-game slider UI.

- **ConfigManager pattern** adapted from **Capacity & QuickBar Tweaks** by [iTestor](https://www.nexusmods.com/subnautica2/mods/252). The pattern of writing a settings manifest into `SN2ModSettings/registrations/` is theirs.

- Inspired by the existing power-tweak `.pak` mods (Better Batteries, Faster Chargers, PowerBoost 10x) — same targets, just driven by Lua so you get sliders.

License

MIT — see [LICENSE](./LICENSE). Use it, fork it, ship modified versions, no need to ask.

---

## Changelog

### 1.0.0

- Initial release.

- Battery capacity, charger speed, power generation multipliers (1–10× each).

- SN2ModSettings UI integration.

- Per-instance baseline snapshotting so slider changes never compound.