BatteryIndicator

BATTERY INDICATOR

Live battery percentage on every toolbar slot.

[line]

WHAT IT DOES

• Live % shown above each toolbar tool that uses a battery[/*]

• Color coded. Red below 33%, yellow 33 to 66%, green 66 to 99%, cyan FULL at 100%[/*]

• Always on. Refreshes every second, no hotkey needed[/*]

• Read only. Never moves or modifies items. Safe in coop (host AND client)[/*]

• Compatible with More Quick Slots (tested from 5 up to 28 toolbar slots). Indicators follow the active slot count automatically.[/*]

[line]

REQUIRES

• Subnautica 2 (Early Access)[/*]

• UE4SS for Subnautica 2[/*]

[line]

INSTALL

• Install UE4SS first[/*]

• Drop the BatteryIndicator folder into

Subnautica2 Binaries Win64 ue4ss Mods [/*]

• Launch the game[/*]

[line]

COVERED TOOLS

Shows %: Scanner, Flashlight, Repair Tool, Sonic Resonator, Wakemaker, Habitat Builder, Lightstick

Ignored: Survival Multitool, Flares, Air Bladder (no battery)

[line]

CONFIG

Edit Scripts config.lua, save, relaunch.

debug = false  -- true = verbose console logs[line]

LIMITATIONS

• Toolbar only. Items inside the inventory grid or standalone batteries are not currently supported (would require deeper widget injection).[/*]

• Refresh rate: 5 second. Small lag when tools swap between toolbar and inventory.[/*]

[line]

CHANGELOG

1.0.2

• Fix: tool detection rewritten to use explicit class name whitelist. No more false positives on Multitool.[/*]

• Fix: indicators no longer disappear after a few seconds (cached pawn / toolbar refs were going stale, now auto refresh every 5 s).[/*]

• Perf: pawn / toolbar cached with periodic expire, slot index re-read throttled. Try to fixes the 2 second lag.[/*]

1.0.1

• New: cyan FULL label at 100% (replaces the green 100% text so you instantly see a fully charged battery)[/*]

• Fix: slot indexing under More Quick Slots. Percentages now align with the correct tool at any slot count from 5 up to 28.[/*]

• Fix: ghost HUD widget instances filtered out (parent class check on UWESimpleGrid only). No more wrong percentages on empty slots.[/*]

• Improved: cache auto refreshes when the toolbar slot count changes during gameplay (More Quick Slots progressive unlock).[/*]

• Perf: pawn / toolbar / battery flag cached across ticks, periodic widget rescan throttled (1s -> 5s). Fixes stutter reported on high end rigs.[/*]

1.0.0

• New: Initial release[/*]

[line]

CREDITS

• Special thanks to the developers of Subnautica 2[/*]

• Built with UE4SS by the UE4SS team and the Subnautica 2 fork maintainers[/*]

• Special thanks to 1uv (Discord: 1uv0305) for testing during development[/*]

• Special thanks to Kallie23 for the More Quick Slots mod (compat target for 5 to 28 toolbar slots)[/*]

Compatible with other UE4SS Lua mods.