Introduction
BusyFishing turns fishing into a full RPG for Paper and Folia servers. Players catch custom fish across six tiers, level up, spend skill points, put augments on their rods, build fishing totems, run deliveries and compete in tournaments. Every system is a module you can switch off, each with its own config, messages and menus.
Coming from PyroFishingPro? BusyFishing moves your settings, fish, menus and player progress over by itself on its first start, keeps Pyro items working and keeps Pyro addons running. See the Migration Guide.
What's in this guide
- Getting Started: install the plugin and land your first custom fish.
- Core Reference: every command, permission node and the in-game menus.
- Features & Modules: each system in detail, with its options.
- Configuration: module toggles, fish and bait files, messages and MySQL.
- Integrations: PlaceholderAPI, Vault, WorldGuard, seasons plugins and the developer API.
- Advanced Optimization: moving from PyroFishingPro, Folia specifics and troubleshooting.
- Support: FAQ, common issues and how to get help.
Key features
- Custom fish in six tiers (Bronze to Mythical) with biome, weather, time, height, world, region and season conditions. 71 fish ship by default.
- Progression: fishing levels, skill points, 8 skills and 14 rod augments.
- Economy: a fish shop with a rotating special fish, scales that gamble a fish's price, gutting for entropy and a personal fish bag.
- Server-wide play: tournaments with 9 types, party fishing bonuses, fishing totems, deliveries, bosses and the Frostfall winter event.
- Modular: 25 modules, each switchable, each with its own
config.yml,messages.ymlandgui.yml. - Native Folia support on Paper's region schedulers.
- Developer API with 14 events and catch hooks for addons.
Quick links
- Report an issue / request a feature: GitHub Issues
- Discord: discord.gg/abdm29q7af
Ready to go? Start with the Quick Start guide.