๐ŸŽฃ Hooked icon

๐ŸŽฃ Hooked v1.0.2

Enhance fishing with custom mechanics, dynamic rewards & 1.21+ support.

๐ŸŽฃ Hooked โ€” Reel in a better experience

Hooked is a lightweight and flexible fishing plugin for Bukkit-based Minecraft servers. Define custom fish, create fishing regions, assign rarity-based loot, and bring purpose back to casting a rod. Whether you're running a survival economy or a full-blown RPG, Hooked gives you full control over fishing mechanics.


โœจ Features

  • โœ… Add custom fish with unique identifiers
  • ๐Ÿ—บ๏ธ Define fishing regions with rarity-based loot tables
  • ๐Ÿ“Š Configure drop chances per rarity
  • ๐Ÿงฐ GUI-based assignment of fish per rarity
  • ๐Ÿ”„ Reload support โ€” no need to restart your server
  • ๐Ÿงฑ Built modular for future expansion

๐Ÿ“ฆ Installation

  1. Download the plugin jar
  2. Drop it into your /plugins folder
  3. Place the required texture.zip file in your serverโ€™s resource pack folder or somewhere accessible
  4. Configure your server to send the resource pack to players (e.g., via server.properties or a resource pack plugin)
  5. Start (or restart) your server

๐Ÿ“š Getting Started

Step 1: Add Fish

Register fish using:

/hooked addfish <identifier>

Example:

/hooked addfish tuna

Step 2: Create a Region

Edit the regions.yml file located at:

/plugins/Hooked/regions.yml

Example structure:

__GLOBAL__:
  LEGENDARY:
    chance: 1
  EPIC:
    chance: 5
  RARE:
    chance: 10
  UNCOMMON:
    chance: 20
  COMMON:
    chance: 64

You can replace __GLOBAL__ with your own region name.


Step 3: Reload the Plugin

Apply changes with:

/hooked reload

Step 4: View Your Fish

Check your database of added fish:

/hooked listfish

Step 5: Open the Region GUI

Use the following to open a region's fish assignment GUI:

/hooked listfish <region>

Example:

/hooked listfish __GLOBAL__

Step 6: Assign Fish via GUI

  • Click a rarity to edit it (e.g., RARE, LEGENDARY)
  • Drag fish into the GUI to assign them to that rarity

Step 7: Start Fishing!

Your configuration is now live! Players can start catching your custom fish with defined drop chances per region.


๐Ÿ”ง Commands

/hooked addfish <id> Add a new fish to the database
/hooked listfish List all registered fish
/hooked listfish <region> Open fish GUI for a region
/hooked listregions Show all defined regions
/hooked reload Reload the config and fish data

๐Ÿ—บ๏ธ Roadmap

Upcoming features include:

  • ๐Ÿ“ฑ Bedrock Edition support
  • ๐ŸŒ Biome-based fishing mechanics
  • ๐Ÿ’ก Community-suggested features โ€” submit yours!

๐Ÿ›‘ Developer API

A public developer API is not available yet, but itโ€™s planned for future releases.


๐Ÿ“ฎ Need Help?

Join our support Discord (coming soon).


๐Ÿ› Found a Bug?

Please report bugs or issues via the Discord server once available.


โค๏ธ Support the Project

If you like Hooked, consider leaving a review!

fishing

mechanics

custom