Boss Timer

Shows the exact time remaining before the active boss leaves.

The game's standard boss UI exposes its numeric countdown only during the final ten seconds. This mod displays the same synchronized countdown throughout the entire active fight in a compact native-style HUD.

Features

• Reads the authoritative FishNet boss leave tick and tick rate.
• Works in singleplayer and multiplayer without changing network state.
• Automatically appears during a boss fight and hides on death, despawn, timeout, or return to the main menu.
• Hides together with the native HUD while pause, Options, or another game menu is open.
• Fades away in half a second when the game's native final countdown appears, avoiding any overlap.
• Changes from white to orange during the final ten seconds and red during the final five seconds.
• Supports HUD scale, opacity, vertical position, label, and decimal display settings through BepInEx config.

Compatibility

• How to Fish 1.0.5
• BepInEx 5.4.23.5

Development disclosure

This project was developed with substantial assistance from OpenAI Codex. The packaged code was reviewed and compiled against the game before release.

Changelog

0.1.6

• Replaced the package icon with a real in-game boss countdown preview and a readable BOSS TIMER title.
• No countdown or HUD behavior changed in this release.

0.1.5

• Attached the extended countdown to the native boss bar shake-and-rotation transform.
• The countdown now moves and rotates exactly with the official HP and timer bars when the boss takes damage.

0.1.4

• Shortened the extended timer fade-out from one second to half a second.
• Uses unscaled time so the fade speed remains stable regardless of gameplay time scale.

0.1.3

• Hides the extended timer whenever the game's native boss HUD is hidden.
• Covers pause, Options, other game menus, thinking mode, disabled HUD, and the main menu.

0.1.2

• Crossfades the extended timer out with the inverse alpha of the game's native final countdown.
• Fully hides the extended timer once the native Boss leaves in... display has appeared.

0.1.1

• Moved the countdown below the native boss health bar.
• Migrated the original 125-pixel offset to the new 175-pixel default.

0.1.0

• Uses the short public name Boss Timer.
• Added a full-fight synchronized boss departure countdown.
• Added native font and outline matching.
• Added warning colors for the final ten and five seconds.
• Added configurable scale, opacity, vertical offset, label, and tenths display.