Levelled Fishingrod

LevelledFishingrod allows fishing rods to gain experience and level up as players successfully catch fish. As a rod becomes stronger, its bite time becomes shorter and it unlocks access to increasingly valuable fishing areas and catch tiers.

The plugin includes seven progression tiers, fully configurable catch pools, custom fishing lakes and administrative tools for managing rods and fishing areas. It is suitable for survival, RPG and economy servers looking to make fishing more rewarding.

Features

• Fishing rods gain experience from successful catches.
• Rod levels are stored directly on the individual fishing rod.
• Higher-level rods have shorter minimum and maximum bite times.
• Seven default progression tiers.
• Configurable experience requirements and maximum rod level.
• Fully configurable weighted catch pools.
• Custom fish names, materials, lore, amounts, chances and XP rewards.
• Optional automatic conversion of ordinary fishing rods.
• Configurable fishing lakes with tier requirements.
• Fishing outside a configured lake is always treated as Tier 1.
• No WorldEdit or other dependencies required.
• All messages and progression settings can be changed in the configuration.

Rod Progression
By default, rods can progress through seven tiers:

• Wooden – Level 0
• Stone – Level 10
• Copper – Level 20
• Iron – Level 30
• Gold – Level 40
• Diamond – Level 50
• Netherite – Level 60

The default maximum rod level is 69, but the maximum level and every tier requirement can be changed in the configuration.

Each rod displays its current level, tier, experience progress and bite-time range in its lore. When a rod reaches a new level or tier, the player receives a configurable notification.

Faster Fishing
Every rod level reduces the amount of time players must wait for a fish to bite.

The starting bite-time range, reduction per level and absolute minimum bite time are all configurable. This makes higher-level rods noticeably more useful without directly increasing their durability or enchantments.

Fishing Lakes
Administrators can create fishing lakes directly through commands. WorldEdit is not required.

Each lake can have:

• A minimum rod tier required to fish there.
• A maximum catch tier available in the lake.
• Its own name and configurable boundaries.

A rod below the lake's minimum tier cannot fish there. A rod above the lake's maximum tier can still be used, but the available catches are limited to the lake's maximum tier.

Any water that is not inside a configured lake is automatically treated as a Tier 1 Wooden fishing area. Players can therefore fish anywhere, but valuable higher-tier catches remain exclusive to configured lakes.

Catch Pools
Every tier has its own configurable catch pool. Each catch can have a custom:

• Minecraft material.
• Display name.
• Lore.
• Weighted catch chance.
• Minimum and maximum amount.
• Rod experience reward.

The default configuration contains 21 example catches spread across the seven tiers. These can be edited, removed or replaced with catches designed specifically for your server.

The plugin can also be configured to include catches from lower tiers when fishing in a higher-tier area.

Commands
The main command is /levelledfishingrod.
Aliases: /lfr and /levelledrod

/levelledfishingrod help - Displays the available commands.
/levelledfishingrod info - Displays information about the fishing rod currently being held.
/levelledfishingrod give [player] [level] - Gives a player a levelled fishing rod.
/levelledfishingrod setlevel <level> - Sets the level of the held fishing rod.
/levelledfishingrod addxp <amount> - Adds experience to the held fishing rod.
/levelledfishingrod reload - Reloads the plugin configuration.

/levelledfishingrod lake pos1 - Sets the first corner of a fishing lake.
/levelledfishingrod lake pos2 - Sets the second corner of a fishing lake.
/levelledfishingrod lake create <name> <minimum-tier> <maximum-tier> - Creates a lake using the selected corners.
/levelledfishingrod lake settiers <name> <minimum-tier> <maximum-tier> - Changes the tier limits of an existing lake.
/levelledfishingrod lake delete <name> - Deletes a configured lake.
/levelledfishingrod lake list - Lists all configured lakes.
/levelledfishingrod lake info <name> - Displays information about a lake.
/levelledfishingrod lake here - Shows whether the player is currently standing inside a configured lake.

Permissions
levelledfishingrod.use - Allows players to use and level managed fishing rods. Enabled by default.
levelledfishingrod.give - Allows access to the rod-giving command. Operators by default.
levelledfishingrod.setlevel - Allows rod levels and experience to be changed. Operators by default.
levelledfishingrod.lake - Allows fishing lakes to be created and managed. Operators by default.
levelledfishingrod.reload - Allows the plugin configuration to be reloaded. Operators by default.
levelledfishingrod.admin - Grants all LevelledFishingrod administrative permissions. Operators by default.

Creating a Lake
Creating a fishing lake only takes three commands:

1. Stand at the first corner and use /lfr lake pos1.
2. Stand at the opposite corner and use /lfr lake pos2.
3. Use /lfr lake create <name> <minimum-tier> <maximum-tier>.

For example:

/lfr lake create harbour wooden iron
This creates a lake named Harbour that requires at least a Wooden-tier rod and can provide catches up to the Iron tier.

Installation

1. Stop your server.
2. Place the LevelledFishingrod JAR inside the server's plugins folder.
3. Start the server to generate the configuration files.
4. Edit the catch pools, rod progression and messages as needed.
5. Use /lfr reload to apply configuration changes.

LevelledFishingrod has no required dependencies.

Compatibility
LevelledFishingrod is designed for Paper 26.1 and above.

Also check out my other plugins:
Resources from Herieman | SpigotMC - High Performance Minecraft Software