🎣 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

🗺️ 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!