Custom-Fishing: Transform Server Fishing Into Minigames

If you run a Paper server and fishing feels boring to your players, Custom-Fishing solves that with a fully customizable plugin that turns fishing into actual minigames. Instead of right-click-and-wait, your players encounter dynamic challenges, weighted loot pools, and minigames that make every cast feel different. Whether you want lava fishing, void fishing, or treasure hunts, this plugin delivers with minimal server overhead.

What Custom-Fishing Does

At its core, Custom-Fishing is a Paper server plugin (131 stars on GitHub, Java-based) that replaces vanilla fishing with a condition-and-action system. Catch something? Conditions check what happened. Actions determine the reward. Simple concept, endlessly configurable.

You define fishing "games" - these are minigame mechanics the player triggers when they fish. One game might be a timed bar you have to stop at the right moment. Another could be matching symbols. A third might be pure luck with weighted loot chances. The plugin handles all the boring stuff: tracking the bobber, checking conditions, executing the reward system.

What makes it different from just tweaking fishing loot is the weight system. Instead of "20% chance for diamond," you assign weights based on fishing location, player level, time of day, or custom conditions you define. A player fishing in the ocean at night gets different odds than someone in a river at noon.

Why You'd Install This

Most server admins ignore fishing. It's not combat, building, or exploration - it's just... standing there. Custom-Fishing gives you three good reasons to change that.

First, minigames make participation fun. If fishing involves a timed reaction or pattern-matching, players engage with it instead of AFK-ing in a farm. Your survival server suddenly has another activity people actually want to do.

Second, loot balance becomes granular. You can weight rewards based on conditions like player location, liquid type (water vs. lava vs. void), time of day, or even custom conditions if you code plugins. A player fishing in dangerous End cities shouldn't get the same loot odds as someone in spawn lake.

Third, it's performant. The plugin doesn't spam checks or create lag - it runs on event-based logic. Even with hundreds of fishing games active, server TPS stays stable.

Setting It Up

Installation is straightforward if you know your way around a Paper server.

Download the latest version from the Polymart marketplace or BuiltByBit. Drop the JAR into your plugins folder.

cp CustomFishing-X.X.X.jar /path/to/server/plugins/

Restart your server. The plugin generates default configuration files in plugins/CustomFishing/.

java -Xmx1024M -Xms1024M -jar paper.jar nogui

Once booted, you'll have folders for games, loot, weights, and translations. Vanilla fishing still works - you're building on top of it, not replacing it wholesale.

If you're a developer integrating Custom-Fishing into another plugin, add the Maven dependency:

repositories {
 maven("https://repo.momirealms.net/releases/")
}

dependencies {
 compileOnly("net.momirealms:custom-fishing:2.3.7")
}

Key Features That Matter

The weight system is the star here. Instead of static drop rates, you can define weights based on multiple conditions. A player fishing at night in deep water gets higher odds of rare loot. Fish in shallow water? Common catches only. The latest release added new conditions like player presence, first-loot detection, and liquid depth - giving you even finer control.

Minigames are where the fun happens. The plugin ships with several built-in games, each with different mechanics. Some require timing. Others test your reflexes. You can register custom games if you want to extend functionality - the API supports it. The point is that every fishing session can be different.

The condition and action system is powerful for server admins. You define what triggers (e.g., fishing in lava, catching between 2 AM and 6 AM, player has achievement X). Then you define what happens (e.g., give this loot, play a sound, send a message). Combine enough conditions and you create fishing experiences tailored to your server's needs.

Lava and void fishing come built-in. Why? Because some servers want players exploring dangerous areas for better rewards. The plugin handles fishing in non-standard liquids without breaking a sweat.

NPC and marketplace integration exists too. One recent release added ShopGuiPlus compatibility, so fishing rewards can tie directly into your server economy or shop systems.

Common Gotchas and Tips

Config files matter. Look, a lot.

The plugin uses YAML configuration, and if your weights, conditions, or actions don't align, fishing just... doesn't trigger as expected. Double-check that your custom game is actually registered and that conditions use valid syntax. The maintainer publishes wiki documentation covering this - read it before blaming the plugin.

One thing that trips people up: localization. The plugin supports multiple languages (including a pt_br translation added in a recent release). If you want custom messages for your server, you'll need to override the language file. It's not hard, just easy to miss.

Performance is generally solid, but if you define hundreds of complex conditions, you might see checks take longer. Keep your condition logic tight. Don't check "is the player in region X" 10 times per cast if you can store it once.

Compatibility matters with other plugins. If you're running Nexo (for custom items) or other loot mods, make sure Custom-Fishing is configured to play nicely. Recent releases added explicit compatibility - check the changelog if you're mixing plugins.

If You Want Alternatives

CMI has fishing add-ons, but it's heavier and less specialized. If you only need simple custom loot, vanilla loot tables might actually be enough. But for minigames and weighted conditions, Custom-Fishing is the focused choice.

For multiplayer servers, it's worth the download. If you're running a small server and fishing economy doesn't matter much, you might skip it. But if fishing is part of your gameplay loop - especially on survival or economy servers - this plugin earns its place.

And if you're serious about server economy, tying fishing rewards into your server's ecosystem is cleaner when the loot system is this flexible.

Worth it? Yes.