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

HUD Positioning

Colors

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.

Changelog

1.4.2

• Refactored into focused files: ConfigManager, GunStatsPatches, PredictDamageGuards, GunStatPreview, GunStatColors
• Replaced local HudRepositionClient with SparrohUILib HudAnchors + HudHandle.EnableReposition
• Config binds and hot-reload centralized in ConfigManager (AimAnyTime/Altimeter pattern)
• Requires SparrohUILib 1.2.0+

1.4.1

• Fixed Gear Details preview permanently stacking upgrade stats when opening the weapon config menu
• Preview applies equipped modules on an isolated weapon clone (never mutates the shared menu prefab or live gun)
• Fixed Gun Stats action-bar button never appearing when menu stats start enabled (idempotent Register; bar decoupled from stats window)
• Stats panel is lazy-created and non-modal (no full-screen backdrop blocking the gear bar)
• Closing the stats panel keeps the bar button so it can be reopened
• HUD bullet damage defaults to sheet GunData + last-shot only (no idle ModifyBulletData) so Home Cooking / DmgChance cannot self-damage from the HUD
• Optional config Predictive Bullet Data (default off) re-enables live conditional ModifyBulletData prediction; toggle is honored directly and refreshed on config hot-reload (damage guards are best-effort)
• Default for Enable Menu Window is now on

1.4.0

• Renamed mod from GunData to DisplayGunStats (sparroh.displaygunstats)
• Config file path is now sparroh.displaygunstats.cfg (previous settings will not carry over automatically)
• Thunderstore package and assembly name updated to DisplayGunStats
• Fixed gun stat accuracy across the upgrade/fire pipeline
• Shared GunStatSnapshot captures GunData after priority-sorted Apply, effective fire rate/reload, and post- ModifyBulletData bullet stats
• Gear Details preview resets to prefab baseline before applying equipped modules (correct stacking/order)
• HUD uses live FireInterval / GetReloadDuration instead of raw GunData-only values
• Last-shot damage now hooks Gun.ModifyBulletData on owner fire (works for guns that override fire paths without calling base)
• Config option Show Last Shot shows last-shot damage next to effective bullet damage on the HUD
• Cleaned up duplicate/confusing ammo and damage lines

1.3.0

• Merged MenuGunData and HUDGunData into a single mod (sparroh.gundata)
• Gear Details stats preview window
• In-game gun stats HUD overlay with configurable anchors
• Shared config hot-reload for both features
• Fixed double Harmony patch/unpatch from the HUD plugin

1.2.0

• Initial standalone release split from EnhancedUpgradeMenu
• Live gun stats preview window in Gear Details
• Configurable enable/disable toggle
• Show/hide button for the stats window

1.1.0

• Complete rebuild with enhanced gun statistics display
• Real-time HUD positioned near reticle showing current weapon stats
• Detailed weapon information including damage, fire rate, ammo capacity, recoil, spread, and more
• Color-coded stat displays for better readability
• F9 key toggle to enable/disable the display
• Auto-detection of currently active weapon
• Compatibility with DamageMeter and Speedometer HUD mods
• 0.5 second update interval for real-time stat tracking
• Burst fire, reload, and charge duration tracking
• Impact/explosion size display for explosives

1.0.0

• Add MinVer
• Add thunderstore.toml for tcli
• Add LICENSE and CHANGELOG.md