alp-AdvancedBIOCOM icon

AdvancedBIOCOM

Holographic ammo readout next to your weapon. Hot-reloadable config, works with EWC and EMP.

By alp
Last updated 6 days ago
Total downloads 106
Total rating 0 
Categories Client Mods
Dependency string alp-AdvancedBIOCOM-1.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack_GTFO-3.2.3 icon
BepInEx-BepInExPack_GTFO

BepInEx pack for GTFO. Preconfigured and includes Unity Base DLLs.

Preferred version: 3.2.3

README

Advanced BIOCOM

Adds a holographic projection next to your weapon that shows ammunition information: the current magazine, a segmented ammo bar and the reserve count. It behaves like a small piece of equipment attached to the gun rather than a corner HUD widget.

Everything is configurable through a plain text file, and the file is hot-reloadable — edit and save while the game is running, changes apply within a second.

Features

  • Ammo readout — magazine count, segmented bar, reserve count, drawn next to the weapon.
  • Low ammo warning — turns red when the magazine drops to or below a configurable percentage (25% by default).
  • Follows the gun — the widget is projected from a point on the weapon and scales with distance and FOV.
  • Aim-down-sights mode — while scoped, the widget glides to a fixed screen position (bottom-left by default) so it never covers the sight.
  • Smooth transitions — position and scale are interpolated, so drawing and aiming do not snap.
  • Hides with the HUD — opening the map, the ESC menu or the end screen hides it, via the game's own HUD visibility call.
  • EMP aware — detects the EMP mod's suppression state (see compatibility below).
  • Hot reload — BepInEx\config\AdvancedBIOCOM.cfg is re-read while the game runs.

Configuration

BepInEx\config\AdvancedBIOCOM.cfg, eight sections:

Section What it controls
1-General master switch, hide in menus, FOV scaling, hot reload
2-Content show clip / reserve / bars, number of bars
3-Size overall size multiplier, font sizes, bar width/height/gap
4-Position weapon-local offset (hip fire) and screen pixel offset
5-Style colours, low-ammo percentage, opacity, outline
6-Scaling reference distance/FOV, min/max scale, smoothing speed
7-ADS ADS detection FOV, viewport anchor (X/Y), extra scale
8-EMP EMP detection, IgnoreEMP to keep the widget visible during EMP
9-Debug verbose logging

Every option has a Chinese + English comment.

Compatibility

  • Vanilla weapons — reads ammo through the vanilla BulletWeapon / PlayerAmmoStorage APIs.
  • Extra Weapon Customization (EWC) — supported; custom magazine sizes are read from the weapon itself.
  • EMP (EOSExt_EMP) — supported. The widget hides while the player HUD is EMP-suppressed by default; set IgnoreEMP = true to keep it visible during EMP. EMP interaction has not been tested in depth yet.
  • Third-party map weapons — works with most modded guns added by custom maps, since they use the same inventory item pipeline. Weapons that do not derive from BulletWeapon are ignored.
  • Other UI mods — the widget lives on its own overlay canvas and does not modify the game's HUD objects.

Installation

  1. Install BepInEx-BepInExPack_GTFO with your mod manager.
  2. Install this package.
  3. Start the game with Play Modded.

Notes

  • Some weapon types (pistols, and custom pistols from modded maps) sit at a slightly different spot because the anchor offset is expressed in weapon-local space. Adjust [4-Position] OffsetX/Y/Z or [7-ADS] ViewportX/Y in the config; hot reload makes tuning quick.
  • The config file is created on first launch.

Questions

DC: astlibar x2