Skip to content

About

A mod for Kerbal Space Program that adds realistic battery behavior, chemistry-based variants, and tech progression.

Resources

Stars

5 stars

Watchers

3 watching

Forks

Latest commit

 

History

305 Commits

Folders and files

Repository files navigation

logo

RealBattery Recharged is a complete overhaul of the stock electric system in Kerbal Space Program, originally designed by Blackliner. It brings a more realistic and engaging battery simulation, adding depth to spacecraft design and power management without overcomplicating gameplay.

Features

RealBattery Recharged replaces the simplistic stock EC storage system with a more nuanced model: batteries store energy (StoredCharge) and supply power (ElectricCharge) up to their rated capacity.
Discharge and recharge occur dynamically based on system demand, charge level, and efficiency.

Each battery reports its energy/power density, charge/discharge efficiency, current state (Idle / Charging / Discharging), and more.
The new system rewards thoughtful planning, buffering for peak loads, and progressive tech improvements.

This mod includes:

  • A dynamic battery module applied to all parts containing ElectricCharge
  • Realistic simulation of power (kW) and energy (kWh), based on internal capacity and output limits
  • Discharge and recharge mechanics with efficiency losses and power buffering
  • A range of battery chemistries inspired by real-world technologies
  • Tech-tree progression with unlockable battery upgrades per part
  • Seamless integration with B9PartSwitch and localization support
  • Optional language files to rename ElectricCharge and StoredCharge

See also the Changelog for a list of newly-released features.

Extras

Optional patches are included in the release to enhance immersion and realism. Extra patches are modular and can be removed or disabled if undesired:

  • Alternator Fix: disables alternators on most rocket engines (for realism), but enables them on multi-mode engines like the RAPIER.
  • EC-to-current and EC-to-kW localization packs: rename Electric Charge to Electric Current, or alternatively to kW/kWh (replacing EC/SC with power units). Only install one at a time! See the wiki for details.
  • Electric-pump-fed Engines: the Goldfish and Angora engines from Near Future Launch Vehicles now require electric charge to operate.
  • Fuel Cell Output: fuel cells internal buffer aligns with actual electrical output.
  • Remove toasted decals: removes the burnt-looking "toasted" variants from the battery label decals, leaving only the clean ones.

To install an extra, simply place the corresponding patch into your GameData folder. See the Extras/ folder in the release package for details.

Dependencies

Required:

Suggested/Recommended:

Installation

Via CKAN: coming soon — RealBattery Recharged is awaiting indexing. Once listed, search for RealBattery and dependencies will be installed automatically. The Extras/ patches are not installed by CKAN; copy them manually from the release zip if you want them.

Manually:

  1. Remove any previous RealBattery install.
  2. Download the latest release from the Releases page.
  3. Extract into your GameData folder.
  4. Ensure dependencies are installed.
  5. (Optional) Install the extras as you like.

Starting a new save is recommended to enjoy the full tech progression. Installing mid-career is possible, but may affect in-flight vessels' power balance.

External Mod Compatibility

RealBattery Recharged dynamically applies to any part with ElectricCharge, including most modded parts.
Known compatibility or special support includes:

  • Bon Voyage
  • Kerbalism
  • Airplane Plus
  • Planetside Exploration Technologies
  • Artemis Construction Kit
  • Shuttle Orbiter Construction Kit
  • Buran Orbiter Construction Kit
  • Bluedog Design Bureau
  • Grounded - Modular Vehicles
  • HabTech 2
  • Knes
  • Mk22 Cockpits
  • Mk3 Expansion
  • Near Future Technologies
  • OPT Spaceplane Continued
  • reDIRECT
  • Restock+
  • Starship Expansion Project
  • Stockalike Station Parts Redux
  • Tantares
  • Tundra Exploration
  • Universal Storage II

Parts from mods not listed above still benefit from RealBattery's automatic patching system. These will receive a default, generic set of subtypes. A number of third-party modules is also supported for background simulation. This includes SystemHeat, CryoTanks, Near Future Tech, SpaceDust, SCANsat, Snacks.

Bon Voyage compatibility

Bon Voyage's rover autopilot needs to know how much battery capacity a vessel has and drain it as the rover travels. Because RealBattery replaces stock ElectricCharge storage with its own StoredCharge resource, Bon Voyage can't see that capacity without a small integration. There are two ways this is provided, and you don't need to do anything for either of them:

  • Native support (preferred): a pull request to Bon Voyage /L teaches it to read RealBattery's StoredCharge directly. If you're running a Bon Voyage build that already includes it, that's what you're using — nothing else is involved.
  • Fallback bridge: for players on a Bon Voyage build that predates native support, RealBattery ships an optional companion plugin, RealBatteryBVBridge.dll, that applies the same integration at runtime via HarmonyKSP. It only activates if both Bon Voyage and HarmonyKSP are installed, and automatically detects and steps aside if it finds native support already present — so upgrading Bon Voyage never causes the two to conflict. If HarmonyKSP isn't installed, RealBattery itself is entirely unaffected; only this optional bridge is inactive.

Kerbalism compatibility

Kerbalism runs its own resource simulation (deferred, vessel-wide, and continuing on unloaded vessels) and warns about any producer that bypasses it on a loaded vessel above 1000x warp. When Kerbalism is installed RealBattery adapts automatically:

  • all ElectricCharge the batteries deliver or absorb goes through Kerbalism's resource system, so no "incoherent behavior" warning and no forced warp drop; a RealBattery entry shows up among the ElectricCharge producers/consumers in Kerbalism's UI;
  • batteries on unloaded vessels are simulated by Kerbalism through RealBattery's background hook: they keep powering life support, comms and processes while the vessel is away, with wear and self-discharge applied, and no spurious "life support off" while StoredCharge is still available;
  • RealBattery's own background estimate, depletion alarms and low-power toast are switched off (Kerbalism's low/empty battery messages take over), and the related difficulty options are greyed out with a note. RESOURCE_EXTRA flows are not simulated on unloaded vessels in this configuration.

Everything else (chemistries, charge/discharge thresholds, wear, thermal effects, EVA service, staging, MFD pages) behaves exactly as without Kerbalism. You don't need to change Kerbalism's EnforceCoherency setting.

MFD Extended integration

If MFD Extended is installed, RealBattery ships its own BMS bay on the shared IVA multi-function display — no configuration needed, it's detected automatically. It has three screens, cycled with the BMS button or the NEXT/PREV softkeys (EPS → BATT → FLEET → EPS):

  • EPS Summary (the entry page): a vessel-wide power dashboard — a bidirectional LOAD gauge (draw or charge vs. the batteries' rated capacity), RESERVE, an EC LEVEL indicator, expected time to depletion (EXP TIME), and battery/fault counts.
  • Battery Management: the active vessel's overall charge, net power, and time to depletion, plus a per-battery table with chemistry, charge, health, and any fault state (overheating, thermal runaway, disabled, etc.).
  • Fleet Overview: every RealBattery-equipped vessel in the save at a glance — charge, net rate, and time-to-empty, marked as live data or an estimate depending on whether that vessel is currently loaded — sorted alphabetically with your own ship pinned at the top.

Longer lists scroll with the monitor's UP/DOWN/HOME keys. With System Monitor (Dynamic Battery Storage) installed, the EPS Summary leaves EC LEVEL to that mod's own ELEC page. Without MFD Extended installed, RealBattery behaves identically in every other respect.

Contributing

Pull requests, translations, and feedback are welcome!
Please fork the repository and submit a PR against the master branch.
To report bugs or suggest features, open an issue or post in the KSP Forum Thread.

Translations

Localization is supported. If you'd like to help translate RealBattery into your language, check out the /Localization folder and submit a pull request.

Current languages:

  • English (en-us)
  • Italian (it-it)
  • Spanish (en-es)
  • French (fr-fr)
  • Simplified Chinese (zh-cn) by Aebestach
  • Russian (ru) by ostrkrs

Licensing

Original mod by Blackliner, expanded and maintained by Rjoande.

Licensed under the MIT licence.

About

A mod for Kerbal Space Program that adds realistic battery behavior, chemistry-based variants, and tech progression.

Resources

Stars

5 stars

Watchers

3 watching

Forks

Releases

Used by

Contributors

Languages