Collector

# 📦 What is Collector? Collector is a powerful and highly customizable item collection system designed for survival, prison, skyblock, and grinding-based servers. Collectors automatically gather dropped items and XP within a configurable chunk radius, helping players optimize farms, grinders, and resource generation setups without constant manual collection. Every Collector can be upgraded to improve: * Collection Radius * Collection Speed * Storage Capacity Developers can fully configure upgrade tiers, prices, limits, and requirements directly through the config using Vault economy support. ## 🎮 Core Gameplay * Place a Collector anywhere on your island, base, or farm * Automatically collect nearby dropped items and XP * Upgrade radius, speed, and capacity over time * Store millions of items in compressed virtual storage * Manage everything through an interactive GUI * Enable powerful automation features like Auto Sell or Auto Kill Collectors are built to reduce lag, improve automation, and give players a satisfying progression system while remaining fully balanced through permissions and configurable upgrades. ## ✨ Features 1. **Highly Customizable**: Customize configs, GUI item text, messages, upgrade tiers, prices, and nearly every aspect of the plugin. 2. **Upgradeable System**: Players can upgrade Collector Radius, Speed, and Capacity using fully configurable tiers. 3. **Infinite Item Storage**: Store millions of the same item type inside a single Collector slot. 4. **Advanced GUI System**: Withdraw items in custom amounts, manage upgrades, filters, XP, and settings directly from the GUI. 5. **Chunk Radius Collection**: Collect dropped items from a configurable chunk radius around the Collector. 6. **Auto Sell System**: Automatically sell collected items for money using Vault economy support. 7. **Auto Kill Support**: Instantly kill nearby mobs for automated farm setups. 8. **XP Collection**: Collect dropped XP and withdraw it later directly from the Collector GUI. 9. **Material Filters**: Add any item/block to whitelist or blacklist collection modes. 10. **Friend Whitelist**: Allow trusted players to access and manage your Collector. 11. **Collector Renaming**: Fully rename your Collector for personalization and organization. 12. **Hologram Support**: Optional holograms displaying Collector information above the block. 13. **Multiple GUI Pages**: Capacity upgrades unlock additional storage pages for more distinct item types. 14. **Permission Based Features**: Easily lock premium features like Auto Sell behind ranks or permissions. 15. **Performance Focused**: Optimized for large farms, grinders, and high player activity. # 🏆 Why Collector? Collector is designed to simplify large-scale farming and resource management while still providing meaningful progression and customization. Instead of relying on overflowing hoppers or lag-heavy item systems, Collectors provide a clean, optimized, and expandable solution for automated collection. Whether players are running mob farms, crop farms, grinders, or automated setups, Collector keeps resources organized, efficient, and accessible. # 🔨 Commands & Permissions | Commands | Description | Permissions | | --- | --- | --- | | /collector admin | Open the admin management GUI | collector.admin | | /collector friend add <player> | Add Collector friends | collector.friend | | /collector friend list | List Collector friends | collector.friend | | /collector friend remove <player> | Remove Collector friends | collector.friend | | /collector give <player> <tier> | Give a Collector item | collector.give | | /collector info | View information about your Collectors | collector.use | | /collector wipe | Wipe Collector data | collector.admin | | /collector reload | Reload plugin configuration files | collector.admin | | /collector rename | Rename a Collector you are looking at | collector.rename | # 🔑 Permissions | Permission | Description | | ----------------- | ----------------------------------- | | collector.* | Access to all Collector permissions | | collector.admin | Administrative permissions | | collector.bypass | Bypass Collector restrictions | | collector.filter | Access material filter features | | collector.friend | Manage Collector friends | | collector.give | Give Collector items | | collector.rename | Rename Collectors | | collector.toggle | Toggle Collector features | | collector.toggles | Access all Collector toggles | | collector.upgrade | Upgrade Collector stats | | collector.use | Use Collectors normally | | collector.xp | Access XP collection features | Many permissions can be used to create rank-exclusive features. For example: * Auto Sell only for VIP+ * XP Collection only for Premium ranks * Advanced filters for higher donor tiers Most permissions required f