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

Via Thunderstore (Recommended):

1. Download and install via Thunderstore Mod Manager
2. The mod will be automatically installed to the correct directory

Manual Installation:

1. Install BepInEx and SparrohUILib
2. Place DisplayGunStats.dll in your <Mycopunk Directory>/BepInEx/plugins/ folder

Building

dotnet build --configuration Release

Configuration

Access mod settings through the BepInEx configuration file at:

<Mycopunk Directory>/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

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

HUD

1. Equip a gun in-game
2. Stats appear on the HUD at the configured anchor (if enabled)
3. Adjust position via the HUD Positioning config options, or drag in-game if ModSettingsMenu is installed (F9)

Authors

• Sparroh

License

This project is licensed under the MIT License — see the LICENSE file for details.