ChunkingHopper

ChunkingHopper is a Spigot/Paper plugin that primarily provides chunk collectors that pick up items within its range.

This plugin supports Minecraft 1.21 and is tested on Paper 1.21.10.

---

Features

Collector Mechanics

• Upgradable: Collectors can be upgraded to increase its collection range. The plugin uses PlayerPoints
  for currency.
• Filtering: Each collector has a configurable item filter which can be set to whitelist or blacklist items.
• Range Visualisation: Enable collector range visualisation to identify the area it'll collect items from.
• Storage Linking: Collectors to function must be linked to a storage container, using the storage linking tool.
• Naming: Collectors can be given custom names for better organisation.
• Redstone Sensitivity: Collectors can have redstone sensitivity enabled, in which case they will only pick up items
  when they do not have a signal.

Management and Menus

• Easy Management: The /chh manage command can be used to view all the collectors you own in a paginated menu.
• Live Stats: View storage link status, location, container fullness and collector pickup rates in real-time.
• Remote Access: From the Management menu, you can open a collector's main menu to manage or teleport to it with the teleport permission.
• Fullness Indicator: The collector icon visually changes in the manage menu when storage is full.
• Control Access: You can grant or revoke players access to your collectors via the trust command.

Performance

• Optimized Scanning: Uses an in-memory index and chunk-based item scanning to minimize impact on performance..

---

Commands & Permissions

Commands

Command	Description
/chh	General command alias.
/chh give <item> <player> <amount>	Gives collector items to a specific player.
/chh manage [player]	Opens the collector management menu.
/chh reload	Reloads the configuration files.
/chh repair	Attempts to repair broken collectors in the player's current chunk.
/chh trust <player|reset> <allow|deny>	Manages player access to your collectors.

Permissions

Permission	Description
chunkinghopper.manage	Access the management command.
chunkinghopper.manage_others	Manage collectors belonging to other players.
chunkinghopper.give	Access the give command.
chunkinghopper.reload	Access the reload command.
chunkinghopper.teleport	Allows teleporting to collectors via the management menu.
chunkinghopper.max_collectors.<amount>	Limits the number of collectors a player can place (use unlimited for no limit).
chunkinghopper.repair	Access the chunk repair command.
chunkinghopper.manage_trust	Access the trust command.

---

Setup & Configuration

Upon the first launch, the plugin generates config.yml and messages.yml.

1. Database: You must provide valid database credentials in the config for the plugin to function.
2. Performance: The scanner tick and visualisation interval tick settings significantly impact performance; adjust these values with caution.
3. Localization: All messages and menus support MiniMessage syntax and can be modified in messages.yml.

---

Integrations

RoseStacker

No additional setup is required for RoseStacker support. The plugin will detect RoseStacker automatically and accurately process stacked items and mob drops.

WorldGuard

If WorldGuard is installed on your server, the plugin will add a new flag chunkinghopper-access which you can use to restrict accessing and linking collectors in a region. This plugin does not check WorldGuard-specific permissions for placing or breaking blocks; that is left to the existing WorldGuard permissions.

Superior Skyblock 2

Minor setup is required if you are using Superior Skyblock 2, by default, players will need to give access to other island members or players with the ChunkingHopper island privilege. And linking a collector to a storage container is prevented across islands. See plugin Github repository for setup details.

Feel free to request features or integrations on Github, this plugin was initially created for the ElysiumMC server, as such other integrations have not been considered.

API

ChunkingHopper has a small API for developers. See plugin Github repository.