Enemy Health Bar Mod

Displays customizable health bars above enemies in Megabonk.

Features

• Health Bars: Health bars above enemies, optionally with numbers
• Damage Flash Animation: White flash effect when enemies take damage
• Death Animation: Red explosion effect when enemies die
• Distance Fading: Health bars fade based on distance to reduce clutter
• Performance Optimized: Uses Unity's transform hierarchy for efficient positioning
• Highly Customizable: Adjust colors, size, position, and behavior

Configuration

All settings can be adjusted via the config file.

General

ShowHealthBars (bool)

Enable/disable health bars

Options: true, false

Default: true

ShowHealthText (bool)

Show HP numbers on bars

Options: true, false

Default: true

Appearance

BarWidth (float)

Width of health bar in pixels

Range: 50 - 400

Default: 200

BarHeight (float)

Height of health bar in pixels

Range: 5 - 50

Default: 20

BarYOffset (float)

Vertical offset above enemy

Range: 0.5 - 5.0

Default: 1.75

UseColorGradient (bool)

Color bars by health percentage

Options: true, false

Default: true

FullHealthColor (string)

Color at full health (hex RRGGBBAA)

Default: 14E64CFF (green)

MidHealthColor (string)

Color at mid health (hex RRGGBBAA)

Default: FFD90CFF (yellow)

LowHealthColor (string)

Color at low health (hex RRGGBBAA)

Default: FF1F1FFF (red)

BackgroundColor (string)

Bar background color (hex RRGGBBAA)

Default: 1A1A1ACC (dark gray)

TextSize (float)

Font size for HP numbers

Range: 12 - 48

Default: 24

EnableDeathAnimation (bool)

Red explosion when enemies die

Options: true, false

Default: true

ShowDamageFlash (bool)

White flash when damaged

Options: true, false

Default: true

DamageFlashLingerMs (float)

Flash duration in milliseconds

Range: 50 - 500

Default: 125

Performance

FadeStartDistance (float)

Distance where fade begins (meters)

Range: 10 - 100

Default: 30

FadeEndDistance (float)

Distance where bars disappear (meters)

Range: 20 - 150

Default: 50

MaxBarsPerFrame (int)

Max bars to create per frame

Range: 1 - 20

Default: 5

UpdateFrequencyFar (int)

Update every N frames for distant bars

Range: 1 - 10

Default: 3

SkipUpdateDistance (float)

Distance beyond which bars stop updating (meters)

Range: 50 - 200

Default: 100

Debug

EnableDebugLogs (bool)

Enable detailed logging

Options: true, false

Default: false

Installation

1. Install BepInEx IL2CPP
2. Extract this mod to BepInEx/plugins/

Changelog

[0.1.0] - 2025-11-20

Added

• Initial release
• Customizable health bars above enemies with optional HP text display
• Damage flash animation (white bar shows damage taken, configurable linger time)
• Death animation (bar explosion effect)
• Distance-based fading (configurable start and end distances)
• Color gradient system (full/mid/low health colors)
• Customizable colors, sizes, offsets, and text size