YKMobCatcher - A Premium Mob Catcher (Free Version)

■ What is YKMobCatcher?
A lightweight, feature-rich mob catcher that lets your players capture mobs and store them inside the vanilla Bundle item — no resource packs, no extra plugins, no mess. Catch a mob with one click, keep up to 5 mobs in a single catcher, then release the exact one you want from a clean menu.
■ Features

• Two catcher types — Small (holds 1 mob) and Large (holds 5 mobs)
• One-click catching — Right-click any mob with an empty catcher
• Release menu — Right-click a filled catcher to pick which mob to release
• Preserves stats — Health and custom names are saved on catch, restored on release
• Vanilla bundle — Uses the built-in bundle item, works without any resource pack
• Catch cooldown — Per-player cooldown with a bypass permission
• Blacklist system — Block bosses, villagers, or any mob you choose
• Fully configurable — Names, colors, lore, capacities, and every message in config.yml + messages.yml
• Folia & Paper ready — Runs on modern servers out of the box

■ How it works

1. Give a catcher with /ykmobcatcher give <player> small|large [quantity]
2. Right-click a mob to capture it
3. Right-click the filled catcher to open the release menu
4. Click a mob to release it back into the world

■ Free vs Premium

Feature	Free​	Premium​
Small catcher (1 mob)	✔​	✔​
Large catcher (5 mobs)	✖​	✔​
Catch & release MythicMobs	✖​	✔​
Release menu	✖​	✔​
Everything else	✔​	✔​

■ Commands

Command	Description
/ykmobcatcher help	Shows all commands
/ykmobcatcher give <player> <type> [quantity]	Gives an empty catcher (1/small or 5/large)
/ykmobcatcher reload	Reloads config and messages

Aliases: /yk, /mobcatcher, /ykmob
■ Permissions

Permission	Description	Default
ykmobcatcher.use	Use mob catchers	true
ykmobcatcher.catch	Catch mobs	true
ykmobcatcher.release	Release mobs	true
ykmobcatcher.bypass.cooldown	Ignore the catch cooldown	op
ykmobcatcher.admin	/give and /reload	op

■ Requirements

• Server software: Paper (or a Paper fork) 1.21+
• Java: 17+
• Premium only: MythicMobs (for catching Mythic mobs)

■ Installation

1. Drop YKMobCatcher.jar into your plugins folder
2. Restart your server
3. Configure plugins/YKMobCatcher/config.yml and messages.yml to taste
4. Enjoy catching!

■ Support
Found a bug or have an idea? Leave a comment or review — every report helps make the plugin better.