CategoryHopper

CategoryHopper
Smart Sorting for Modern Servers.

Stop building massive, laggy sorting systems that require a separate chest for every single item type. With CategoryHopper, you can sort entire groups of items—like "Food", "Redstone", or "Logs"—using a single hopper.

️ What does it do?
CategoryHopper adds a special Filter Hopper to your server.

1. Craft & Place: Create the hopper using a custom recipe

1. Select a Category: Sneak + Right-Click the hopper to open a beautiful GUI.
   
   
2. Filter: Choose a category (e.g., Ores, Foliage, Combat).
   
   • The hopper will only accept items from that category.
     
     
   • Example: A "Food" hopper will accept Apples, Bread, and Steak, but reject Cobblestone.
     

It essentially turns one hopper into a smart filter for hundreds of items at once.

✨ Key Features

• GUI Configuration: easy-to-use menu with glowing indicators for the active category.
  
  
• 28+ Built-in Categories: Comes pre-loaded with categories like REDSTONE, STONE, TOOLS, ARMOR, and more.
  
  
• JSON Customization: Fully editable categories.json file. Create your own categories or modify existing ones!
  
  
• Optimized: Uses fast caching to prevent lag, even with many hoppers.
  
  
• Secure: Built-in protection against GUI theft (anti-drag/shift-click) and permission management.
  

Commands
Command Description Permission
/givehopper <player> [amount] Gives a specific amount of Category Hoppers to a player. categoryhopper.admin
/chreload Reloads the categories.json file from disk without restarting the server. categoryhopper.admin
Permissions
You can manage exactly who can use the plugin using the following nodes:

• categoryhopper.admin – Allows use of /givehopper and /chreload.
  
  
• categoryhopper.craft – Allows the player to craft the Filter Hopper in a workbench.
  
  
• categoryhopper.place – Allows the player to place the block.
  
  
• categoryhopper.use – Allows the player to open the GUI and change the filter category.
  
  
• categoryhopper.* – Grants all permissions.
  

⚙️ Setup & Configuration

1. Install: Drag and drop the CategoryHopper.jar into your server's /plugins folder.
   
   
2. Restart: Restart your server to generate the default configuration files.
   
   
3. Customize (Optional):
   
   • Open plugins/CategoryHopper/categories.json.
     
     
   • You can add new categories or remove items from existing ones.
     
     
   • Note: Ensure you use valid Bukkit Material names (e.g., OAK_LOG, not Oak Log).
     
4. Reload: If you edited the file, run /chreload to apply changes instantly.
   

Example categories.json snippet:

JSON
"FOOD": {
"displayName": "Food & Consumables",
"displayMaterial": "APPLE",
"items": [
"APPLE", "BREAD", "COOKED_BEEF"
]
}

Requirements

• Server Version: Minecraft 1.21 (Spigot, Paper, or Purpur).
  
  
• Java Version: Java 21 or higher.
  
  
• Dependencies: None. (This plugin is standalone).