Wild Events

Random wildlife and combat events for How to Fish.

Wild Events adds recurring random encounters while you explore the islands. Events happen around the player and are designed as short, chaotic interruptions to normal gameplay.

Events

Seahorse Stampede

A group of Seahorses suddenly appears around the player.

Catch or kill them before they escape back into the water.

Default amount: 10–20 Seahorses

Piranha Rain

A large group of normal Piranhas rains down around the player.

When no real boss is active, the event uses the native Boss UI as a progress bar and plays native boss-style music.

The event ends when all tracked Piranhas have died or disappeared.

Default settings:

• 25–40 Piranhas
• Spawn height: approximately 15.78 m
• Boss UI: enabled
• Boss music: enabled

Urchin Invasion

A large group of Sea Urchins appears around the player.

Clear them all to finish the event.

When no real boss is active, this event also uses the native Boss UI and boss-style music.

Default settings:

• 18–25 Sea Urchins
• Boss UI: enabled
• Boss music: enabled

Event timing

By default, Wild Events schedules a random event every 2–4 minutes:

• Minimum: 120 seconds
• Maximum: 240 seconds

Only one Wild Event can run at a time.

Spawn behaviour

Event creatures spawn close to the player instead of across the whole island.

Approximate spawn ranges:

• Seahorse Stampede: 5–14 m
• Piranha Rain: up to about 9 m horizontally
• Urchin Invasion: 6–16 m

This helps keep events visible and reduces creatures spawning too far away and dying before the player can react.

Boss-style events

Piranha Rain and Urchin Invasion are presented as temporary boss-style encounters.

Wild Events:

• Uses the native How to Fish Boss UI.
• Shows event progress based on how many creatures remain.
• Plays native boss-style music.
• Stops the event music when the event finishes.
• Does not register event creatures as the game's real global boss.
• Avoids taking over the Boss UI when a real boss is active.

Configuration

Configuration file:

BepInEx/config/com.howtofish.wildevents.cfg

Wild Events uses standard BepInEx configuration entries and can also be edited through HTF Mod Manager if installed.

Configurable options include:

• Enable/disable the mod
• Minimum and maximum event interval
• Enable/disable individual events
• Spawn counts
• Piranha spawn height
• Boss UI
• Boss music
• Debug hotkeys

Debug hotkeys

Debug hotkeys are disabled by default in the public release.

If enabled in the config:

Numpad1 - Force Seahorse Stampede
Numpad2 - Force Piranha Rain
Numpad3 - Force Urchin Invasion
Numpad0 - Wild Events diagnostic dump

Requirements

• How to Fish
• BepInEx 5.4.23.5

Installation

Install with a Thunderstore-compatible mod manager, or manually place WildEvents.dll inside:

BepInEx/plugins/WildEvents/

Then launch the game normally.

Compatibility

Built for the Mono version of How to Fish using BepInEx 5.4.23.5.

Version 1.0.0

Initial public release.

Includes:

• Seahorse Stampede
• Piranha Rain
• Urchin Invasion
• Random events every 2–4 minutes
• Close-to-player spawning
• Native Boss UI integration
• Native boss-style music for combat events
• Configurable event settings
• HTF Mod Manager-compatible BepInEx configuration