FishMon
Catch fish, level them up, evolve them and have them fight bosses with you. Now with 14 new ocean species to find across the islands. Party, Box, Fishdex, moves, types and multiplayer.
| Last updated | 2 hours ago |
| Total downloads | 29 |
| Total rating | 0 |
| Categories | Mods |
| Dependency string | Mazqo-FishMon-1.3.1 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2305README
FishMon — I made catching fish into Pokemon
Catch a fish, beat it up and then you can use it to fight enemies and potentially other players...
FishMon
Ever wanted to have your own fish fight alongside you? Well, now you can!
FishMon adds a Pokemon-like system to the game where you can catch fish, level them up, evolve them, and have them fight alongside you against bosses and other hostile creatures.
There are a LOT of features included, from catching and evolving fish to a full party system, different moves, stats, and even multiplayer support!
Installing
Easiest way: get it from Thunderstore with a mod manager like r2modman. It installs BepInEx for you too.
Manual way:
- Install BepInEx 5 if you don't have it (unzip it into your How to Fish folder and run the game once).
- Download
FishMon-x.x.x.zipfrom the Releases page. - Unzip it into your How to Fish folder. You should end up with
BepInEx/plugins/HowToFishMon/HowToFishMon.dll.
In multiplayer, the host needs the mod for everyone to see each other's FishMon.
How To Use FishMon
All the keys below are the defaults. You can change any of them in the Mod Menu (F9) → Controls.
| Feature | How it works |
|---|---|
| Catching FishMon | The catching mechanic is pretty simple. You play the game normally, catch a fish using your own fishing rod, and then beat it up until it's no longer flopping around. Once it's dead, you can pick it up with E to try to add it to your collection! Most fish are caught, but rarer (more valuable) and higher-level fish can break free. You only get one try per fish; if it breaks free you keep it as a normal fish to sell or eat. The "hooked!" message tells you roughly how likely the catch is (common fish ~90%, very rare ones ~50%, change it with Catch difficulty in the Mod Menu). When it works you'll get a little "Gotcha!" message showing its level, IVs, and nature. Fish you buy or find won't count unless you change OnlyCatchHooked = false in the config. |
| F6 - Main Menu | Pressing F6 opens the main menu where you'll find your party, Fishdex, moves, and other features. You can check your FishMon's stats, change your party around, rename them, heal them, and more. |
| F7 - Send Out / Recall | This lets you throw out or recall your currently selected FishMon. It'll roam around near you (mostly where you're looking, so you don't have to turn around to see it) and even swim when you're in the water! Turn off Roam around you in the Mod Menu if you'd rather it trail behind you. |
| F8 - Switch FishMon | Using F8 switches to your next FishMon in order from top to bottom. It'll automatically skip any FishMon that have fainted. |
| F9 - Settings Menu | I added a settings menu that lets you mess around with a LOT of the mod's features. You can change things like HP, damage, EXP rates, boss levels, and even the size of your FishMon. Want a massive fish following you around? You can do that too! |
| G - Attack | Look at a creature and press G to tell your FishMon to attack it. You'll see a red target marker appear over whatever you're looking at. Press G again while looking at nothing to call it back. |
| H - Stay / Follow | Press H to make your FishMon stay in one place. It'll still attack anything you specifically target with G. Press H again to have it follow you. |
| Automatic Fighting | You don't actually have to do anything for this one! Your FishMon will automatically attack bosses when they're nearby, or hostile creatures that get too close. Just fight alongside your little buddy! |
FishMon Stats
Every FishMon has its own stats, and depending on what you catch, some can be a LOT stronger than others.
Each FishMon has:
- Base Stats: HP, Attack, Defense, Special Attack, Special Defense, and Speed. These are based on the fish species. Generally, more expensive and tougher fish have higher stats, while lighter fish tend to be faster.
- IVs: These are randomly generated when you catch a FishMon. Each stat gets a value between 0 and 31. Drip (shiny) fish always have 3 perfect IVs and get a special ★.
- Nature: There are 25 different natures. Each one increases a stat by 10% while lowering another by 10%.
- EVs: These are earned by defeating bosses and help improve your FishMon.
- Types: Every FishMon gets a type based on its species. For example, Eels are Electric, Sharks are Dark, Pufferfish are Poison, and Seahorses are Dragon. There's also a full type effectiveness system with all 18 types!
- Moves: Your FishMon learns new moves as it levels up. By default, it'll automatically keep its 4 strongest moves.
Abilities
Every FishMon rolls one ability when you catch it. Most are Common, some are Uncommon or Rare, and a few are Legendary. Drip fish are more likely to get a rarer one. You can see a FishMon's ability in the F6 menu, switch it off, or pay to reroll it.
| Ability | Rarity | What it does |
|---|---|---|
| Merchant | Common | Picks up fish you drop near it and sells them for you. |
| Scholar | Common | Gains 25% more EXP. |
| Thick Scales | Common | Takes 20% less damage. |
| Speedster | Common | Moves and attacks 25% faster. |
| Guard | Uncommon | Stays close (within 3.5 m) and goes after anything that hurts you. |
| Angler | Uncommon | Helps you fish: bites come about a third sooner. |
| Berserker | Uncommon | Hits up to 50% harder the lower its HP is. |
| Mentor | Uncommon | Party members on the bench get 30% of the EXP it earns. |
| Medic | Rare | Heals you 2 HP every 4 seconds while it's out. |
| Treasure Hunter | Rare | Every 2-4 minutes digs up a dead fish (sometimes a Drip!) or $15-60. |
| Leech | Rare | Heals itself for 15% of the damage it deals. |
| Haggler | Rare | Fish you sell while it's out are worth 25% more. |
| Lucky Charm | Legendary | Fish you catch while it's out get better IVs and levels (each is rolled twice, the better roll wins). |
Merchant: drop a dead fish within about 14 m of you and leave it for a couple of seconds. Your Merchant runs over and sells it, the same as the sell box. It also sells loot nobody has picked up yet, like dead baby piranhas and boss meat chunks. It won't touch fish you've hooked but haven't picked up yet (so you still get to catch them), fish other players dropped, boss trophies, tools, or anything on a grill. In someone else's world, the host needs the mod for selling to work.
Guard: when you lose health, your Guard goes after the closest hostile creature near you (or the boss, if nothing else is close). It won't override a target you picked with G.
Abilities in multiplayer: Medic, Angler, Treasure Hunter and Haggler work through the host, so in someone else's world the host needs this version of the mod for them to work. The rest work anywhere.
FishMon caught before abilities were added get a random one the first time you load the new version.
Held Items
Each FishMon can hold one item. Open F6, pick a FishMon and go to its Item tab. There you can buy items into your bag and give them to it. Giving a FishMon a new item puts its old one back in your bag, and releasing a FishMon keeps its item. One-use items are used up when they trigger, and items go with a FishMon when you trade it.
| Item | Price | What it does |
|---|---|---|
| Lucky Egg | $600 | Gains 50% more EXP. |
| Leftovers | $500 | Heals 1/16 of its HP every 5 seconds while it's out. |
| Choice Band | $450 | Physical moves do 30% more damage. |
| Choice Specs | $450 | Special moves do 30% more damage. |
| Quick Claw | $350 | Attacks 20% more often. |
| Expert Belt | $350 | Super-effective hits do 20% more damage. |
| Scope Lens | $300 | Lands critical hits twice as often. |
| Focus Sash | $150 | One use: at full HP, survives a hit that would knock it out, with 1 HP left. |
| Sitrus Berry | $60 | One use: heals 25% of its HP when it drops below half. |
| Lum Berry | $50 | One use: cures a status condition. |
You can scale every price (or make them free) with Item prices in the Mod Menu.
Evolution
Every FishMon can evolve twice, meaning you'll eventually have some pretty crazy-looking fish following you around.
Here are a few examples of evolution chains:
| Caught as | First Evolution | Final Evolution |
|---|---|---|
| Shrimp | Prawn (Lv 20) | Lobster (Lv 40, gains Fighting type) |
| Crab | King Crab (Lv 25) | Titan Crab (Lv 45, gains Steel type) |
| Cod | Big Cod (Lv 20) | The Codfather (Lv 40, gains Dark type) |
| Mackerel | Mackerelite (Lv 22) | Mackerel Monarch (Lv 42) |
| Shark | Great Shark (Lv 30) | Megalodon (Lv 50, gains Dragon type) |
| Eel | Volt Eel (Lv 25) | Thunder Eel (Lv 45) |
| Seahorse | Sea Dragon (Lv 30) | Leviathan (Lv 50) |
| Everything Else | Big ___ (Lv 25) | Mega ___ (Lv 45) |
Evolving your FishMon increases all of its base stats by around 20% and makes its model about 30% bigger.
Fully evolved FishMon also get a glow effect based on their type, which makes them stand out a little more.
Don't worry about nicknames either! They'll carry over when your FishMon evolves.
If you catch a FishMon that's already past its evolution level, it'll evolve the next time you send it out. Higher-level catches will also come already evolved.
Fighting With Your FishMon
Here's how the combat works:
- Automatic Attacks: Your FishMon will automatically attack bosses within 60 meters. If there isn't a boss nearby, it'll attack hostile creatures like crabs and piranhas within 20 meters.
- Move Selection: Every time your FishMon attacks, it'll use one of its learned moves. It usually picks whichever move has the best type matchup against the enemy.
- Real Boss Damage: The damage your FishMon deals actually affects the boss's real health bar! You'll also see the normal hitmarkers, damage numbers, and kill score.
- Attack Speed: The higher your FishMon's Speed stat, the more frequently it'll attack.
- Attack Effects: Every move has its own effects based on its type. Water moves splash, Fire moves spit lava, Electric moves call down lightning, Poison moves leave clouds, and so on. Strong attacks and critical hits also get bigger effects. You can turn these off using
AttackEffectsin the config. - Bosses Fight Back: Bosses have their own levels, types, and moves. They'll actually hit your FishMon back, knocking them around and taking away their HP.
- EXP and EVs: Your FishMon gains EXP every time it lands a hit. Once a boss is defeated, every FishMon that participated gets a bonus and earns EVs.
- Automatic Switching: If your active FishMon faints, the next healthy one in your party will automatically come out.
- HP Display: Your FishMon has a nameplate with its HP bar, and there's also a panel in the bottom-left corner showing its HP, EXP, and current action.
Your lead FishMon also gets a little EXP boost every time you catch a fish!
Status Conditions
Some moves can inflict a status on whatever they hit. It works both ways: your FishMon can inflict them on foes, and bosses can inflict them on your FishMon. Statuses wear off after a few seconds, and a FishMon or foe can only have one at a time.
| Status | Comes from | What it does |
|---|---|---|
| Burn (BRN) | Fire moves | Loses 1/16 of its HP every 3 seconds for 15 seconds, and its physical moves do half damage. |
| Poison (PSN) | Poison moves | Loses 1/12 of its HP every 3 seconds for 15 seconds. |
| Paralysis (PAR) | Electric moves, Dragon Breath | 40% slower for 20 seconds, and 1 in 4 attacks fail. |
| Sleep (SLP) | Psychic moves | Can't move or attack for 3-6 seconds. |
| Freeze (FRZ) | Ice moves | Can't move or attack for 2-5 seconds. A Fire move thaws it out straight away. |
Fire types can't be burned, Poison and Steel types can't be poisoned, Electric types can't be paralyzed, and Ice types can't be frozen. Bosses only take a quarter of the burn and poison damage, and shake off sleep and freeze twice as fast. You'll see the status next to your FishMon's name and above whatever it's fighting. Heal All and Revive cure it. Each move's status chance is listed in the Moves tab.
Healing and Reviving
Your FishMon can take quite a beating, so you'll need to keep an eye on their HP.
- Natural Healing: Injured FishMon recover 10% HP every minute.
- Heal All: For $25, you can heal all your injured FishMon through the F6 menu.
- Revive: If one of your FishMon faints, it'll stay fainted until you revive it. Reviving costs $100 and brings it back with 50% HP.
One thing to keep in mind: Heal All won't revive fainted FishMon. You'll have to use the Revive option separately.
If you're playing as a guest in someone else's game, revive payments go through the bait shop, and you'll also receive 1 cheap bait each time.
Multiplayer
FishMon also supports multiplayer!
If other players have the mod installed, you'll actually be able to see their FishMon running around in the world.
You'll see:
-
Their FishMon model.
-
The owner's name above it.
-
Their level and current HP.
-
Their attacks, move names, trails, and effects.
-
Status conditions on their FishMon (BRN, PAR...) and on whatever it's fighting.
Trading
You can trade FishMon with other players who have the mod:
- Press F6 and open the Players tab. Everyone in the world with the mod is listed on the left.
- Press Trade next to a player. They get a message and can accept from their own Players tab.
- Each of you picks a FishMon from your party or Box. You'll see the other player's offer with its level, types, nature, ability, IVs and moves.
- When you're both happy, you both press Confirm trade. Confirming locks your offer in. If either of you changes your offer, both confirmations reset.
Traded FishMon keep their nickname, level, IVs, EVs, moves and ability. They count towards your Fishdex, and their info page says who you got them from. If your party is full, they go to your Box.
Battles
You can battle other players' FishMon:
- Get within 50 m of another player, press F6 and open the Players tab.
- Press Battle next to them. They get a message and can accept from their own Players tab.
- The FishMon you each have out (or your lead, if none is out) head to an arena halfway between you. After a 3 second countdown, they fight it out with their moves, types, abilities and held items.
- You can close the menu and walk around to watch. Other players with the mod can watch too, and everyone hears who won.
Some rules:
- Both FishMon start at full HP. When the battle ends, HP, status conditions and any one-use items that got used up go back to how they were, so you can't lose anything.
- The winner gets EXP, the loser gets a bit less, and a draw splits the difference.
- The battle ends when a FishMon faints, someone forfeits (Forfeit in the Players tab), or after 3 minutes (a draw).
- You forfeit if you recall your FishMon, send out a different one, or walk more than 80 m from the arena.
- You can't start a battle while a boss is up.
There are a couple of things to know:
- The host MUST have the mod installed. Multiplayer messages go through the host, so without it, other players won't see anyone else's FishMon.
- Players who don't have the mod installed won't be affected. They simply won't see any FishMon.
- Other players' FishMon are just copies on your screen. You can't attack or control someone else's FishMon.
- All combat happens on the owner's game, but damage dealt to bosses still counts for everyone.
- The host's preset and balance settings are used by the whole lobby (see Presets).
Moves
Your FishMon can learn moves as they level up.
Every FishMon can learn all moves associated with its own types, along with Normal-type moves, as long as it reaches the required level.
By default, your FishMon automatically chooses its 4 strongest moves. However, you can change these yourself!
To do this:
- Press F6 to open the menu.
- Select the FishMon you want to change.
- Go to the Moves tab.
- Click the move slot you want to change.
- Pick a move from the list.
You can also use Back to Auto if you want your FishMon to go back to choosing its own best 4 moves.
Once you've manually selected moves, the game won't automatically replace them anymore. Instead, you'll get a notification whenever a new move becomes available so you can decide whether you want to switch it out.
One more thing! Moves that match your FishMon's type get a 50% damage bonus, so keep that in mind when building your team.
Your FishMon will still automatically choose which of its selected moves to use during combat based on the enemy's type.
Fishdex
I also added a full Fishdex system!
The Fishdex contains every creature found in the game's journal, including their stats, evolutions, and moves.
You can access it by pressing F6 and opening the Fishdex tab.
Each entry has a few different states:
- ??? - You haven't discovered this creature yet.
- Seen - You've been close to it, hooked it, or fought it. Creatures you've already killed in the game's normal journal will also count.
- Caught - You've successfully caught this FishMon!
Once you've caught a creature, you'll unlock even more information about it, including:
- Base stats.
- Full list of learnable moves.
- Evolution chain.
- Number of times you've caught it.
- Your best IVs.
- Highest level you've caught.
- Whether you've caught a Drip (shiny) version.
You can also view a spinning 3D model of each creature! Just drag it around to get a better look.
Bosses are included at the very end of the Fishdex, along with how many times you've defeated each one.
Fishdex Rewards
Filling in your Fishdex pays off:
- New species bonus: the first time you catch a species you get $25 to $150, more for rarer fish.
- Milestones: press Rewards at the bottom of the Fishdex tab to see them. When you reach one, press Claim. Items go in your bag, ready to give to a FishMon from its Item tab.
| Milestone | Goal | Reward |
|---|---|---|
| Rookie Angler | Catch 5 species | $150, 2× Sitrus Berry |
| Keen Angler | Catch 10 species | $300, 2× Lum Berry, Focus Sash |
| Fish Collector | 25% of the Fishdex | $500, Scope Lens |
| Fish Expert | 50% of the Fishdex | $1000, Lucky Egg |
| Fish Professor | 75% of the Fishdex | $1500, Leftovers |
| Fishdex Master | The whole Fishdex | $3000, Choice Band, Choice Specs, Expert Belt |
FishMon you get in trades count towards milestones too, but only your own catches give the new species bonus. You can scale the money with Reward money in the Mod Menu. In multiplayer, the host needs this version for guests to get the money.
Settings / Config
The Mod Menu can be opened by pressing F9, or by clicking the Settings button inside the F6 menu.
Presets
At the top of the Mod Menu you pick a preset:
- Normal (the default) - the way FishMon is meant to be played. Bosses, wild creatures and catches get stronger island by island: main bosses go from Lv. 10 on the first island to Lv. 50 on the last (the whale), mini bosses are about 70% of that and wild creatures about 40%. New catches go up to 5 levels under the island's boss.
- Challenge - same island levels, but tougher: 1.5x HP instead of 2x, bosses hit 25% harder, half the regen, Heal All and Revive cost double, and fish break free a bit more. This is the only preset where you can earn boss badges.
- Custom - change everything yourself, including fixed boss and catch levels.
On Normal and Challenge the balance settings are greyed out, because the preset sets them. Controls, size, roaming, attack effects and detection ranges are always yours to change. Your Custom values are kept while you play on a preset, and come back when you switch to Custom. If you'd already changed settings before presets existed, you start on Custom so nothing changes.
In multiplayer, everyone plays on the host's preset and balance settings (so on Challenge, guests can earn badges too). As a guest you'll see them greyed out in the Mod Menu. Your own settings aren't changed, and come back when you leave. The host and guests need version 1.3.1 or later for this.
Boss Badges
On the Challenge preset, beat a boss with a low-level team to earn a badge for it:
| Badge | Every FishMon that fights is at or under | Points |
|---|---|---|
| Bronze | the boss's level | 1 |
| Silver | 80% of the boss's level | 2 |
| Gold | 60% of the boss's level | 3 |
Each FishMon's level counts from when it first joins the fight, so levelling up mid-fight is fine, but sending in a stronger FishMon isn't. During a boss fight on Challenge, the level each badge needs is shown under the boss's HP bar, along with which badge you're on track for. It changes straight away if an over-levelled FishMon joins the fight. See all your badges with F6 → Fishdex → Badges.
Badge points unlock perks, which work on every preset: +10% EXP, half-price Heal All, +10% damage to bosses, +1 party slot, +5% catch chance and another +10% EXP. Each one needs a share of all the points there are (10%, 25%, 40%, 60%, 80% and 100%).
Everything else
There's quite a bit you can change here, including:
- Controls - rebind every FishMon key (Mod Menu, Party menu, Send Out / Recall, Swap, Attack, Stay / Follow). Click a key, then press the new one. Esc cancels. If the key is already used by another FishMon action, the two swap. You'll also see a warning if a key is also one of the game's own keys.
- EXP rate.
- FishMon HP.
- Damage dealt and received.
- Attack speed.
- Boss and creature levels.
- Detection ranges.
- Healing and revive costs.
- Catch levels.
- Party size.
- Roaming: whether your FishMon wanders around you, and how far.
- Attack effects.
FishMon HP is set to 2x by default. If your FishMon are getting knocked out too quickly, you can increase their HP or lower the Damage Taken setting.
You can also manually edit the config file here:
BepInEx/config/com.howtofish.fishmon.cfg
Your FishMon data is saved separately here:
BepInEx/config/FishMon_save.json
By default your FishMon are shared between all your worlds. The first time you load a world you're hosting, you'll be asked if you want to bring your FishMon or start fresh. Starting fresh gives that world its own party, Box and Fishdex, saved in BepInEx/config/FishMon_worlds/. You only get asked once per world. If you want to be asked again, delete that world's line from FishMon_worlds/choices.json.
When you join someone else's world, you always bring your shared FishMon.
Building the Mod
If you want to build the mod yourself, you'll need the .NET SDK (version 6 or higher).
Run the following command:
dotnet build -c Release
To make the zips for a release (they go in dist/), run:
powershell -ExecutionPolicy Bypass -File package.ps1
The build should automatically copy HowToFishMon.dll into:
<game>/BepInEx/plugins/HowToFishMon/
If your game is installed somewhere else, you may need to change GameDir inside HowToFishMod.csproj.
Project Files
Here's a quick breakdown of what each file does:
src/Plugin.cs- Main BepInEx entry point and configuration.src/Patches.cs- Handles catching when picking up fish, input blocking, and cursor behavior.src/FishMon.cs- FishMon data, stats, and species/type generation.src/Companion.cs- Handles your FishMon in the world, including following and attacking bosses.src/Combat.cs- Handles combat calculations, boss stats, and damage.src/FishMonController.cs- Handles hotkeys, switching, healing, menus, and HUD elements.src/ModMenu.cs- The in-game settings menu.src/ModelPreview.cs- Handles the 3D models in the Fishdex.src/Fishdex.cs- Handles the Fishdex and seen/caught records.src/DexRewards.cs- Catch chances (breaking free), the new species bonus and Fishdex milestones.src/Presets.cs- The Normal / Challenge / Custom presets and the island-based levels.src/Badges.cs- Boss badges and their perks.src/Battle.cs,src/BattleCompanion.cs,src/BattleMenu.cs- Battles between players' FishMon.src/Trade.cs,src/TradeMenu.cs- Trading, and the Players tab.src/Net.cs- Handles multiplayer communication.src/RemoteCompanion.cs- Handles displaying other players' FishMon.src/Fx.cs- Handles attack effects, trails, sounds, and other visual effects.src/Styles.cs- UI drawing helpers.src/Data/- Contains the type chart, moves, natures, evolution chains, and the ability list.src/Abilities/- The abilities that hook into the game: Merchant, Guard, Medic, Treasure Hunter, Haggler and Angler. (The simpler ones, like Scholar and Leech, are a line or two where EXP and damage are worked out.)
README brought to you by Claude because I hate writing README's lol
Credits
- Some ocean species are built on models from Lowpoly Animated Fish by Quaternius (CC0).
- The custom species system is adapted from MoreFishAPI by hiccup444 (MIT).