Skip to content

Bug-Labs/Collector

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📦 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 Add Collector friends collector.friend
/collector friend list List Collector friends collector.friend
/collector friend remove Remove Collector friends collector.friend
/collector give 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 for standard Collector usage are enabled by default for regular players.

🎫 Support

If you need any kind of support or have any questions, Contact me on my Discord Server

About

High Performance, Chunk based Collection Hopper to virtualize item management.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages