BossMakerAPI

BossMakerAPI

A server-authoritative boss framework for How to Fish, by SkyLiN3.

This is a library, not a boss pack. Install a compatible content mod to add

bosses, or use the included documentation and source starter to make your own.

Neither Devourer of Light nor Voltfin is installed by this package. Both are

separate content mods; Voltfin also serves as the introductory creator tutorial.

Features

• Build bosses from verified vanilla creature templates while retaining their

network components, movement, physics, hitboxes and compatible native AI.

• Configure stats, phases, phase gates, telegraphs, bounded charges, ability

damage, forces, minions, rewards and catch-based encounters.

• Use the game's original boss bar and lifecycle for supported encounters.
• Validate host-controlled settings and synchronize them without overwriting

client configuration files. Live edits affect future catches and new bosses;

active encounters keep their captured balance.

• Opt into supported corpse identity/scale and living-encounter save checkpoints.
• Reject incompatible content or unsafe catch replacement while preserving the

original fish when the replacement transaction fails.

Version 0.10.4 refreshes exact How to Fish 1.1.x compatibility. It retains

0.10.3 behavior, which confirms supported custom-boss hit/kill feedback against the

server's accepted hit and actual death. Feedback does not apply damage again.

It retains encounter-local maximum HP and the native health bar; no artificial

bar fill or healing is used. The vanilla-creature feedback path is unchanged.

Installation

Use a -compatible mod manager to install BossMakerAPI and its

dependency, BepInExPack 5.4.2305, then add a compatible boss content mod.

For a manual installation:

• Close the game and back up the mod profile and any worlds you intend to use.
• Install BepInExPack in the game directory containing the game executable.
• Copy this package's BepInEx folder into that same directory.
• Install your chosen content mod and its dependencies, then launch the game.

Keep only one copy of each plugin. When upgrading, close the game before replacing

DLLs and update every multiplayer peer together. This public package includes no

game assemblies, loader binaries, personal CFGs or third-party ModMenu DLLs.

Installing only the API does not create a boss or enable a summon shortcut.

Content mods decide where encounters occur, their appearance chance and rewards.

Startup/developer options live in

BepInEx/config/com.skylin3.howtofish.bossmakerapi.advanced.cfg and require a restart.

Compatibility and multiplayer

• Primary inspected target: How to Fish 1.1.3, Steam build 25604825.
• Retained exact references: 1.1.3 / 25603657, 1.1.2 / 25597996,

1.0.12 / 25127368 and

1.0.11 / 25065888. Other hotfixes are not automatically supported.

• The general guard recognizes 1.0.10 / 24975015, but newer rod-return,

pickup-scale and native relocation adapters are audited only on the exact

references listed in docs/COMPATIBILITY.md. General recognition is not

full feature support.

• Runtime baseline: FishNet 4.6.12, Unity Mono 6000.4.4f1.

Compatibility checks use exact game assembly identities, not display versions

alone. Unknown builds disable custom prefab construction. An advanced override

does not make an unverified build supported or unlock narrowly guarded hooks.

The host and every client need matching API/content DLLs and required assets.

This is not a server-only mod and it does not download missing mods. Declared

numeric settings use the host's values during the session; local CFG files stay

local. Client menu edits are preferences for future hosting, not changes to the

connected host. Settings that a content author has not declared for host

configuration still require matching definitions.

Custom spawning waits for compatibility approval. The gate checks protocol,

game build, content structure, assets, reward providers and network prefab

assignments. Inspe