DisplayGunStats

DisplayGunStats

A BepInEx mod for Mycopunk that shows live gun stats both while editing weapons in the Gear Details menu and as an

in-game HUD overlay.

Features

Gear Details Stats Window

• Adds a Gun Stats button to the gear action bar while viewing a weapon
• Opens a draggable, non-modal stats preview window (via SparrohUILib)
• Displays weapon stats including:
• Bullet damage, bullets per shot, and bullet status effects
• Fire rate, burst size, and burst interval
• Magazine size, reserve ammo, and reload/charge duration
• Explosion size, range, recoil, and spread
• Fire mode
• Bullet speed, force, range, and gravity
• Live updates as you equip or change upgrades on the weapon grid
• Preview applies equipped modules on an isolated weapon clone (does not mutate the menu prefab or live gun)

In-Game HUD Overlay

• Shows current equipped gun stats on the HUD
• Tracks last-shot bullet damage from fired shots (optional)
• Configurable screen anchor position
• Configurable rich-text colors per stat category
• Optional drag repositioning via SparrohUILib + ModSettingsMenu (F9)
• Optional predictive ModifyBulletData for conditional damage (off by default for safety)
• Updates live while playing

Getting Started

Dependencies

• Mycopunk (base game)
• BepInEx — Version 5.4.2403 or compatible
• SparrohUILib — Version 1.2.0 or compatible

Installing (Recommended):

• Download and install Mod Manager
• The mod will be automatically installed to the correct directory

Manual Installation:

• Install BepInEx and SparrohUILib
• Place DisplayGunStats.dll in your /BepInEx/plugins/ folder

Building

dotnet build --configuration Release

Configuration

Access mod settings through the BepInEx configuration file at:

/BepInEx/config/sparroh.displaygunstats.cfg

General

| Option | Default | Description |

|------------------------|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|

| Enable Menu Window | true | Show the Gun Stats action-bar button and stats window when editing weapons in Gear Details |

| Enable Gun HUD | true | Show the gun stats HUD overlay while playing |

| Show Last Shot | true | On the HUD, show last-shot bullet damage next to effective (sheet/predicted) damage |

| Predictive Bullet Data | false | Run ModifyBulletData for live conditional damage prediction. Default off uses sheet GunData + last-shot only (safer vs self-damage from chance upgrades). When on, best-effort damage guards run during prediction |

HUD Positioning

| Option | Default | Description |

|-----------|---------|-------------------------------------|

| Display X | 0.031 | X anchor position for the HUD (0–1) |

| Display Y | 0.936 | Y anchor position for the HUD (0–1) |

Colors

| Option | Default | Description |

|-----------------|--------------|-------------------------------------------------------------|

| Damage Color | Rose | Color for bullet damage |

| Fire Rate Color | Macaroon | Color for fire rate, burst, bullets per shot, and fire mode |

| Ammo Color | Sky | Color for magazine, reserve ammo, reload, and charge |

| Explosion Color | Orchid | Color for explosion size |

| Range Color | Shamrock | Color for range, recoil, and spread |

| Default Color | Text primary | Fallback color for other stats |

Colors accept hex RRGGBB or #RRGGBB.

Config changes are hot-reloaded while the game is running.

Usage

Gear Details

• Open a weapon in the Gear Details menu
• Click Gun Stats on the gear action bar to open the preview window
• Click Hide Stats (or close the window) to hide it; the bar button remains available to reopen
• Drag the window by its title bar to reposition it
• Stats update live as you change equipped upgrades

HUD

• Equip a gun in-game
• Stats appear on the HUD at the configured anchor (if enabled)
• Adjust position via the HUD