Welcome! Here’s how to get Ultra Chunk Collector running smoothly on your server.


1. Installation

• Download the plugin and place it into your server's /plugins folder.
• Start or restart your server.
• After first launch, you’ll find config.yml and lang.yml in /plugins/UltraChunkCollector/.

2. Core Configuration (config.yml)

This file controls how UCC behaves. Here are some useful options:

• requireSupportBlock & supportBlockMaterial – Set if hoppers need a block underneath, and what type.
• maxHoppersPerPlayer – Limit how many UCC Hoppers a player can place (0 = no limit).
• pickupSound & pickupEffect – Enable or disable sound/particle feedback when collecting items.
• filterItems & whitelistMode – Define what items should or shouldn’t be picked up.
• ✅ Fully compatible with RoseStacker — items are collected properly after stacking.

The config file is fully commented to explain every setting.


3. Language & Messages (lang.yml)

• Customize every player-facing message in lang.yml.
• Translate the plugin or match your server’s theme and tone.
• ⚙️ Even the command prefix can be changed here.

4. In-Game Setup

• Make sure players have the right permissions. (See the Permissions section above.)
• Admins: Use /ucc give <player> to get the UCC Hopper item.
• Place the hopper in a chunk (on the support block if required).
• ✨ You’ll see a confirmation effect when the UCC Hopper is active.
• From now on, all dropped items in that chunk go straight into the hopper.

5. Troubleshooting

• ️ Set debugMode: true in config.yml for detailed logs in the console.
• Need help? Reach out via:
  • Discord
  • Or use the Discussion tab on Spigot.