Show Enemy HP (Megabonk)

Real-time HP above every enemy.
No more guesswork—see exact health values during combat with clean, readable UI.

Tested on: Megabonk v1.0.19
Loader support: MelonLoader v0.7.1 and **BepInEx 6 **

---

Features

• HP values are rendered over enemies in world space.
• Display modes: Choose numeric text (default) or a minimal HP bar.
• Fast toggle: Press F2 to show/hide during a run.
• Font Styles: Choose between Default and NotoSansSC .
• Color gradients: 4 color schemes to customize HP coloring
  • Classic
  • Cosmic
  • Electric
  • Aurora
• Hot reload: Ctrl+R to reload ShowEnemyHP.cfg without restarting.
• Lightweight: Minimal overhead; only updates visible UI when needed.

---

Install

⚠️ Do not use MelonLoader and BepInEx in the same game folder.
Use separate installs or a manager like r2modman (BepInEx profiles are isolated).

Option A — Thunderstore / r2modman (BepInEx)

1. Install BepInEx 6 for Megabonk via r2modman.
2. Place ShowEnemyHp.dll into your profile:
   …\r2modmanPlus-local\Megabonk\profiles\<YourProfile>\BepInEx\plugins\
3. Launch the game from r2modman.

Logs: …\BepInEx\LogOutput.log

Option B — MelonLoader

1. Install MelonLoader v0.7.1 into the game directory.
2. Put ShowEnemyHp.dll into:
   …\Megabonk\Mods\
3. Launch the game normally.

Logs: …\MelonLoader\Latest.log

---

Usage

• Toggle UI: F2
• Reload config: Ctrl+R (updates scale, offset, color scheme, display mode, and font live)

---

Config

The mod writes an annotated config on first run:

…\UserData\ShowEnemyHP.cfg (for MelonLoader)
…\BepInEx\config\ShowEnemyHP.cfg (for BepInEx)

Options

• Scale (float) — world-space scale of the HP canvas
  Range: 0.005–0.200 (default 0.03)

• VerticalOffset (float) — vertical offset from the enemy head position
  Range: -5.0–5.0 (default -0.25)

• ColorScheme (enum) — gradient used to render HP
  Options: Classic, Cosmic, Electric, Aurora
  Default: Classic

• DisplayMode (enum) �?" choose how HP is rendered
  Options: Numeric, Bar
  Default: Numeric (text). Bar shows a simple fill bar with the same gradient.

• Font (string) — TMP font asset selection (whitelisted)
  Options: Default, NotoSansSC (falls back to Default if Noto is missing)

Example

# Show Enemy HP configuration

# Scale adjusts the size of the floating HP canvas.
#   Range: 0.005 – 0.200 (default 0.03)
Scale = 0.03

# VerticalOffset moves the label relative to the enemy head (positive is up).
#   Range: -5.0 – 5.0 (default -0.25)
VerticalOffset = -0.25

# ColorScheme controls the HP gradient.
#   Options: Classic, Cosmic, Electric, Aurora
ColorScheme = Electric

# DisplayMode switches between numeric text and the HP bar.
#   Options: Numeric, Bar
DisplayMode = Numeric

# Font selects the TextMeshPro font asset used for HP numbers.
#   Options: Default, NotoSansSC
Font = NotoSansSC

---

Troubleshooting

No HP shown in-game

• Confirm the mod is loaded:
  • MelonLoader: check MelonLoader/Latest.log for “Show Enemy HP”.
  • BepInEx: check BepInEx/LogOutput.log for the plugin entry.
• Make sure you launched via the correct loader (r2modman for BepInEx; vanilla exe for Melon).
• Disable other overlay/UI mods briefly to rule out conflicts.

Config changes not applying

• Press Ctrl+R in-game to hot reload.
• If the file is malformed, the mod logs a warning and keeps previous values.

---

Compatibility & Performance

• Works with MelonLoader v0.7.1 and BepInEx 6 (IL2CPP).
• Update path is event-driven to minimize per-frame costs.

---

Uninstall

• Remove ShowEnemyHp.dll from Mods/ (Melon) or BepInEx/plugins/ (BepInEx).
• Optional: delete UserData/ShowEnemyHP.cfg.

---

Changelog

1.0.5

• Config system with hot reload (Ctrl+R)
• New color schemes: Cosmic, Electric, Aurora
• Fonts : Default, NotoSansSC (no global font scanning)
• HP Bar or HP Text options