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

• Displays weapon stats while viewing gear details, including:
  • Damage type and damage
  • Fire rate, burst size, and burst interval
  • Ammo capacity and reload/charge duration
  • Range, recoil, and spread
  • Fire mode
  • Bullet speed, force, damage, range, gravity, and status effects
• Live updates as you equip or change upgrades on the weapon grid
• Toggle button to show or hide the stats window
• Draggable IMGUI window

In-Game HUD Overlay

• Shows current equipped gun stats on the HUD
• Tracks actual bullet damage from fired shots
• Configurable screen anchor position
• Updates live while playing

Getting Started

Dependencies

• Mycopunk (base game)
• BepInEx - Version 5.4.2403 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. 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

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

Usage

Gear Details

1. Open a weapon in the Gear Details menu
2. The gun stats preview window appears automatically (if enabled)
3. Use the Show Gun Stats / Hide Gun Stats button to toggle visibility
4. Drag the window by its title bar to reposition it

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

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