ReversibleBatteryDrone

ReversibleBatteryDrone

Makes the charge drone reversible: each activation alternates between Charge Mode and Drain Mode (draining items, monsters, or players into battery life). Fully configurable.

👥 Multiplayer: Only Host Needed (Clients Optional)

Your friends do NOT need to install this mod to join and play!

• For Clients WITHOUT the mod (Vanilla):
• ✅ 100% full gameplay (draining batteries, monster damage, aggro chase, smart overrides, and alternating toggles).
• ℹ️ The laser beam displays in the game's default yellow color.
• For Clients WITH the mod (Enhanced):
• ✅ Full gameplay + vibrant red laser beam, red LED indicators, and custom audio cues.

Preview

How to Use

• Pick up the Drone: Grab any standard Charge Drone in your hands.
• Press E (Interact) to Toggle:
• Charge Mode (Yellow Beam): Points at depleted items to recharge them. Press E again when done to turn OFF.
• Drain Mode (Red Beam): Siphons energy from other batteries or leeches monster/player life directly into the drone. Press E again to turn OFF.
• Smart Override: If the drone is completely dead (0% battery), it turns ON directly in Drain Mode so you can recharge it immediately!

Features

• Alternating Activation Mode: Use your standard interaction key (E by default) while holding the charge drone to toggle it ON/OFF. Each activation cleanly alternates modes:
• 1st Activation: Turns ON in Charge Mode (vanilla yellow beam & LED), charging low-battery items. Turn OFF when done.
• 2nd Activation: Turns ON in Drain Mode (vibrant red beam & LED for modded clients), reversing energy flow to siphon batteries and leech monster/player health. Turn OFF when done.
• Smart Battery Overrides:
• When Completely Empty (0% Battery): Automatically skips the unusable charge mode and activates directly in Drain Mode (Red), allowing you to immediately recharge the empty drone!
• When Full (100% Battery): Automatically skips drain mode and activates directly in Charge Mode.
• Battery Siphoning & HUD Feedback: In Drain mode, the drone attaches to items with remaining energy and siphons their power directly into its own battery. The target's floating battery HUD is visible during draining with visual feedback.
• Dynamic In-Hand HUD Prompts: When holding the drone, the on-screen interaction prompt dynamically updates to reflect the active or upcoming mode ("Recharge Droid [E]" vs. "Drain Droid [E]"), giving immediate visual clarity before activating.
• Life Leeching: If deployed near monsters or other players in Drain mode, the drone latches onto them, leeching small amounts of health over time and converting it into battery charge.
• Monster Aggression & Chase Alerts: Attaching the drone to an enemy or detaching/removing it from them alerts the monster and triggers a direct chase against the responsible player (enabled by default, customizable).
• Anti-Exploit & Energy Conservation:
• Direct 1:1 energy transfer prevents infinite battery loops.
• Items in the shop (shopItem) cannot be siphoned.
• Non-rechargeable items (isUnchargable) cannot be siphoned.
• Player stamina/energy is completely unaffected.
• 100% Host-Only Multiplayer: Only the host needs to install the mod! Drone AI, flight physics, battery transfers, and monster damage execute authoritatively on the host and synchronize across all connected clients. Clients with the mod installed also receive full visual effects (vibrant red beam & LEDs).
• Fully Configurable: Easily tweak drain rates, monster/player damage per tick, health-to-battery conversion gain, and PvP friendly-fire toggles.

Requirements

• BepInEx Pack for R.E.P.O.

Installation

• Install the latest BepInEx Pack.
• Place ReversibleBatteryDrone.dll into your BepInEx/plugins folder (or install via r2modman Mod Manager).
• Launch the game once — the configuration file will be generated automatically inside BepInEx/config.

Configuration

All settings are controlled through com.osmar.ReversibleBatteryDrone.cfg located in Bep