Omniscye-StaminaToEnergy icon

StaminaToEnergy

Convert your stamina into weapon energy by holding the activation key while carrying or equipping a weapon. Fully synced. Simple, fast, and configurable.

Last updated a week ago
Total downloads 2543
Total rating 2 
Categories Mods Weapons Server-side
Dependency string Omniscye-StaminaToEnergy-1.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100

README

StaminaToEnergy v1.0.0

Hold a key to convert your stamina into weapon energy. Works for held or equipped battery items. Fully synced between all players.

What it does

  • This mod lets you charge battery-powered weapons by draining your own stamina.
  • Press and hold the activation key (default X) and your stamina will drain while the weapon recharges in real time.

ALL players must have this mod installed.

  • Energy charging is host authoritative and will not sync if someone is missing the mod.

How to Use

  • You can charge a weapon in two ways:

✔ 1. Hold the weapon in your hands

  • Hold X to drain stamina and add battery power.

  • ✔ 2. Have the weapon equipped

  • If the equipped item has an ItemBattery component, holding X will charge it.

  • Player stamina cannot drop below your configured MinStaminaReserve.

Multiplayer Sync Rules

  • This mod uses a system where the client drains stamina locally and the host performs the actual battery charging. Because both sides depend on the same values, every player must use identical configuration settings.
  • Nothing is host only. All config settings affect all players.

These settings must match for everyone:

  • ActivateKey
  • StaminaPerSecond
  • BatteryPercentPerStamina
  • MinStaminaReserve

If any player uses different settings, they may experience:

  • Incorrect stamina drain rate
  • Charge speed that appears slower or faster
  • Host charging at a different rate than the client expects
  • The client thinking they cannot charge while the host sees a valid charge request

To avoid all issues, ensure all players use the same configuration file.

Config Options

  • Found in:
    BepInEx/config/Empress.StaminaToWeaponEnergy.cfg
Setting Description Default
ActivateKey Key to hold to charge weapon energy X
StaminaPerSecond Stamina drained per second while charging 5
BatteryPercentPerStamina Battery percentage gained per stamina 0.5
MinStaminaReserve Minimum stamina that cannot be drained 5

Requirements

  • BepInEx 5 Pack
  • All players must install this mod for proper sync

Credits

  • Created by Omniscye / Empress
  • Thanks to Skript for help testing
  • Made for Ganzuto, from the ideas thread in the modding server

"If your stamina cries, your weapon smiles."