Mod F.I.S.H F. — Mod For Instant Sudden Homicidal Fish

Overview

Mod F.I.S.H F. is a small surprise-mechanic mod for Minecraft Java 1.20.1 (servers, singleplayer, and LAN worlds). When you reel in a fish, every so often that fish doesn't gently float toward you — it gets catapulted at you like a miniature projectile. Most casts are completely normal, so the event sneaks up on you when you least expect it.

Features

• Fish you catch can occasionally launch straight back at the angler at speed, instead of dropping softly into your inventory.
• Pufferfish get their own, slightly higher launch chance, and play a louder "threatening" launch sound to drive home the point.
• Two separate, fully independent gamerules let you tune each chance to taste or disable a category outright.
• Works on dedicated servers, integrated singleplayer, and LAN worlds.

How to Use

1. Install Fabric Loader 0.14.22+ for Minecraft 1.20.1, plus Fabric API.

2. Drop the mod JAR into your mods/ folder (and the server's mods/ folder if you run a dedicated server).

3. Start the world and fish as normal. Nothing new shows up in your inventory or crafting menu — the mod just alters what happens to a small fraction of your catches.

4. To change the chances, open the world/server console or chat and run /gamerule commands:

   • modfishfmodforinstantsuddenhomicidalfish:fishLaunchChance
     • Value = 1-in-N odds for any non-pufferfish catch (cod, salmon, tropical fish).
     • Default: 400 (about one in every 400 catches will be launched).
   • modfishfmodforinstantsuddenhomicidalfish:pufferfishLaunchChance
     • Value = 1-in-N odds for pufferfish catches.
     • Default: 150 (pufferfish are slightly more aggressive).
   • Set either value to 0 to disable that category entirely.

   Examples:

   /gamerule modfishfmodforinstantsuddenhomicidalfish:fishLaunchChance 100
   /gamerule modfishfmodforinstantsuddenhomicidalfish:pufferfishLaunchChance 25
   /gamerule modfishfmodforinstantsuddenhomicidalfish:fishLaunchChance 0
   

Tips & Tricks

• The launch event is independent per fish item, so a single cast that yields multiple items (very rare with vanilla fishing) can trigger on more than one of them.
• The launched fish behaves like a regular item entity — it can be picked up after a short delay, deal contact damage if it hits you, and despawn like any dropped item.
• If you want the mod to feel even rarer, raise the values (1000, 5000, 10000). If you want chaos, lower them (50, 10, 1 — value 1 means every catch in that category launches at you).
• Pufferfish still inflict their poison effect on contact, so a launched pufferfish is double the surprise.

Known Limitations

• The mod currently treats the supplied icon.jpg as the mod icon. Some launcher UIs prefer a PNG; if your launcher does not render the icon, converting the icon to PNG and re-naming it icon.png in the same location will fix it.
• The launcher sound is sent to all players within audible range of the bobber, not just the angler — this is by design so other players on the server can hear the chaos too.
• This is a server-side mod. On a vanilla client connecting to a server without the mod, the bobber will simply behave as if the mod were not installed (no errors, no extra behavior). For the feature to actually trigger, the mod must be present on the server side.