Exhausted Batteries

Author: Solo00n

Flexible, host-authoritative control over the battery of every item in Lethal Company: capacity, starting charge, the ship charging station, lightning, and flashlight dimming.

Language / Язык: English · Русский

English

What it does

• Store-bought battery items arrive fully discharged.
• Change battery capacity with a global multiplier, per-item multipliers, or both (per-item wins over global).
• Per-item multipliers are auto-discovered into the config as you meet items in-game, including modded ones.
• The ship charging station gets a limited number of uses, shown as a counter in its hover text, e.g. Charge item : [E] [3].
• The charging-station counter is a single shared pool for the whole lobby, refreshed on take-off, with optional carry-over of unused charges and an optional explode-when-empty.
• Lightning can charge items it strikes; a bolt intercepted by the ship's lightning rod can add a charge to the station.
• Flashlights dim as their battery drains (optional).
• Russian localization, auto-detected alongside RTLC.

How it works

Capacity is scaled through the item's run-time (batteryUsage), and the starting charge is set on spawn. The charging-station limit, the take-off refresh, lightning-to-items, lightning-to-the-ship (via the roof lightning rod / ship power surge), and flashlight dimming each hook a single game method. There is no batteryCharge field in Lethal Company: charge lives in insertedBattery (0..1) and the "capacity" is the item's run-time, which the multiplier scales.

Multiplayer (host-authoritative)

On connect, clients receive the host's config over the network and only apply effects while synced, or while they are the host. A client cannot give itself an advantage in someone else's lobby. The charging-station counter is one shared, host-owned pool, so co-op players draw from the same charges. Only Unity Netcode named messages are used, never a custom NetworkObject, so it cannot crash lobbies. Language and VerboseLogging stay local. Everyone should install the mod; the host's config is what the whole lobby plays with.

Requirements

• Lethal Company (V81)
• BepInEx 5.4.21+ (BepInExPack)

Installation

• Mod manager (recommended): install through r2modman, Thunderstore Mod Manager, or Gale. Dependencies are pulled automatically.
• Manual: install BepInEx, then place ExhaustedBatteries.dll into Lethal Company/BepInEx/plugins/.

Launch the game once to generate BepInEx/config/ExhaustedBatteries.cfg, then edit it.

Configuration

[General]

[ChargingStation]

[Lightning]

[Flashlight]

[Localization]

[IndividualMultipliers] / [ModdedItems]

Integrations / Compatibility

• Works with vanilla and modded battery items automatically (matched by name or class).
• Mapper (restoremapper) and Geigercounter (facilitymeltdown) are pre-declared in the config.
• RTLC and other Russian localization mods are auto-detected for the Russian language.

Credits

• Author: Solo00n
• Built with BepInEx and HarmonyX.
• Flashlight dimming inspired by FadingFlashlights.

Русский

Что делает

• Купленные в магазине предметы с батареей прилетают полностью разряженными.
• Меняет ёмкость батареи глобальным множителем, индивидуальными множителями или обоими (индивидуальный важнее глобального).
• Индивидуальные множители создаются автоматически в конфиге по мере появления предметов, включая модовые.
• Зарядная станция получает ограниченное число использований со счётчиком в hover-тексте, напр. Charge item : [E] [3].
• Счётчик станции — единый общий пул на всё лобби, обновляется при взлёте, с опциями переноса неиспользованных зарядов и взрыва при пустой станции.
• Молния заряжает предметы, в которые бьёт; удар в громоотвод корабля может добавить заряд станции.
• Фонарики тускнеют по мере разряда (опционально).
• Русская локализация, автоопределение вместе с RTLC.

Как работает

Ёмкость масштабируется через время работы предмета (batteryUsage), начальный заряд задаётся при спавне. Лимит станции, обновление при взлёте, молния в предметы, молния в корабль (через громоотвод на крыше / скачок питания) и затухание фонарика — каждая фича вешается на один метод игры. В Lethal Company нет поля batteryCharge: заряд хранится в insertedBattery (0..1), а «ёмкость» — это время работы предмета, которое масштабирует множитель.

Мультиплеер (авторитет хоста)

При подключении клиент получает конфиг хоста по сети и применяет эффекты только при синхронизации либо когда сам является хостом. Клиент не может дать себе преимущество в чужом лобби. Счётчик станции — единый пул, которым владеет хост, поэтому в кооперативе все берут заряды из общего запаса. Используются только named messages Unity Netcode, без своего NetworkObject, поэтому лобби не крашится. Language и VerboseLogging остаются локальными. Мод желательно поставить всем; лобби играет по конфигу хоста.

Требования

• Lethal Company (V81)
• BepInEx 5.4.21+ (BepInExPack)

Установка

• Через менеджер (рекомендуется): установи через r2modman, Thunderstore Mod Manager или Gale. Зависимости подтянутся сами.
• Вручную: установи BepInEx, затем положи ExhaustedBatteries.dll в Lethal Company/BepInEx/plugins/.

Запусти игру один раз, чтобы создался BepInEx/config/ExhaustedBatteries.cfg, затем настрой его.

Настройка

[General]

[ChargingStation]

[Lightning]

[Flashlight]

[Localization]

[IndividualMultipliers] / [ModdedItems]

Совместимость

• Работает с ванильными и модовыми предметами автоматически (по имени или классу).
• Mapper (restoremapper) и Geigercounter (facilitymeltdown) заранее объявлены в конфиге.
• RTLC и другие русификаторы определяются автоматически для русского языка.

Авторы

• Автор: Solo00n
• Собрано на BepInEx и HarmonyX.
• Затухание фонарика вдохновлено FadingFlashlights.

Changelog

1.1.0

Added

• Host-authoritative config sync: clients apply the host's config over the network, effects only under host authority (Thunderstore-compliant, no client-side advantage).
• Charging station is now a single shared pool for the whole lobby (was per-player).
• Lightning: a bolt that strikes a battery item fully charges it (LightningChargesItems).
• Lightning: a bolt intercepted by the ship's lightning rod (ship power surge) adds a charge to the station (LightningChargesStation).
• Carry-over of unused charging-station charges to the next day (CarryOverUnusedCharges).
• Explode-when-empty: using an empty charging station makes it explode (ExplodeWhenEmpty).
• Flashlight dimming as the battery drains (EnableFlashlightDimming, DimStartCharge, MinBrightness).
• Russian localization, auto-detected alongside RTLC, with a Language option.
• InitialChargeMultiplier for the starting charge of non-discharged (loot) items.

Changed

• Charging-station reset / carry-over now happens on ship take-off (ShipLeave), not on landing, so the charge carries through the whole expedition and only refreshes when you leave the moon.
• Charging-station explosion now uses a mine-like lethal radius and spawns inside the station.

Fixed

• Flashlight dimming had no effect (was patching the wrong Update); now patches FlashlightItem.Update.
• Ship lightning is detected via the ship power surge (lightning rod), not by strike position (vanilla lightning never lands near the ship).

1.0.0

• Initial release.
• Global and per-item battery capacity multipliers, including pre-declared modded items (Mapper, Geigercounter).
• Store-bought battery items arrive fully discharged.
• Ship charging-station use limit with a remaining-count shown in the hover text.