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 managecommand 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.
- Database: You must provide valid database credentials in the config for the plugin to function.
- Performance: The scanner tick and visualisation interval tick settings significantly impact performance; adjust these values with caution.
- 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.