InfiniteItemBatteryMod

📖 About

InfiniteItemBatteryMod is a R.E.P.O. mod that prevents all battery-powered items from running out of battery. Affects every item using the ItemBattery component — guns, drones, flashlights, and anything else with a battery bar.

✨ Features

• Enable/Disable toggle: turn the mod on or off via in-game UI or hotkey
• Hotkey: press the configured key (default F6) to toggle on/off in real-time
• HUD overlay: shows ♾ Infinite Battery: ON or ⬜ Infinite Battery: OFF on screen for 2.5 seconds after toggling
• All items: affects every item with ItemBattery, including drones with time-based battery drain
• Battery stays at 100%: battery never decreases, always shows full bars
• Three-layer protection: blocks RemoveFullBar, autoDrain, and Drain
• Drone support: explicitly supports ItemDrone to prevent NoBattery state
• Host-side: only the host needs this mod — battery state syncs to all clients via Photon RPC

⚙️ How It Works

Patches multiple methods:

ItemBattery:

• RemoveFullBar() — called when a gun fires or an item uses a full bar; blocked entirely
• Update() — auto-drain logic runs here; battery is forced to 100% if it drops below
• Drain() — continuous drain calls are blocked

ItemDrone:

• StateSearching() — ensures battery stays at 100% while searching for targets
• StateBeamDeployed() — ensures battery stays at 100% while beam is active
• StateAttached() — ensures battery stays at 100% while attached to objects

🔧 Configuration

[General]
## Enable or disable infinite battery for all items.
## false = vanilla behavior.
# Default: true
Enabled = true

## Hotkey to toggle the mod on/off in-game.
## Enter a Unity KeyCode name: F5, F6, F7, Insert, Home, Keypad0, etc.
# Default: F6
ToggleKey = F6

🎮 Hotkey Usage

Press F6 (or your configured key) while in-game to toggle infinite battery on/off. A message will appear on screen showing the current state.

📦 Installation

1. Install BepInExPack REPO
2. Place InfiniteItemBatteryMod.dll in BepInEx/plugins/
3. Launch the game

📜 Changelog

v1.1.0

• Drone support: Now explicitly supports ItemDrone (drones with time-based battery drain)
• Battery stays at 100%: Battery never decreases, always shows full bars
• Enhanced battery protection with patches for drone state machines
• Uses Harmony Traverse to access private fields safely

v1.0.0

• Initial release
• Infinite battery for all items
• Enable/disable toggle via in-game UI (REPOConfig)
• Configurable hotkey (default F6)
• HUD overlay with fade-out showing ON/OFF state

📄 Dependencies

• BepInExPack_REPO >= 5.4.23

🧩 Compatibility

Patches ItemBattery and ItemDrone only. Does not modify EnemyDirector, LevelGenerator, or any other system.