
๐ฃ 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
- Download the plugin jar
- Drop it into your
/plugins
folder - Place the required
texture.zip
file in your serverโs resource pack folder or somewhere accessible - Configure your server to send the resource pack to players (e.g., via
server.properties
or a resource pack plugin) - 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!