Chunk Hopper Plugin v1.0

Hopper​

High-Performance Chunk-Wide Item Collection System​

Revolutionize your server's item collection with intelligent chunk-wide hoppers.
Built for performance • Designed for scale • Optimized for large servers

---

Key Features​

Chunk-wide item collection • Smart filtering • Internal storage • Holograms • Auto-transfer • Async optimized

---

Overview​

Hopper is a next-generation Minecraft hopper system that allows a single hopper to collect every dropped item inside an entire chunk.

Instead of using dozens of vanilla hoppers and causing unnecessary lag, Hopper gives players a clean, optimized, and scalable alternative built specifically for modern survival, skyblock, prison, and faction servers.

Whether your server has 20 players or 500+, Hopper is designed to maintain smooth performance while handling massive item collection efficiently.

---

Features​

Core Functionality​

Chunk-Wide Collection​

Automatically collects all dropped items within the hopper's chunk.

Smart Internal Storage​

Each Chunk Hopper includes a built-in inventory with support for up to 54 storage slots.

Auto Transfer System​

Items can automatically move into connected containers including:

• Chests
• Barrels
• Other inventories

Instant Pickup​

Configure how quickly items are collected after dropping.

Stack Overflow Handling​

Large quantities of items are intelligently distributed across available storage.

---

Advanced Filter System​

Hopper includes a powerful filtering system with 3 modes:

Quick Filter Access​

Shift + Right Click the hopper to open the filter GUI instantly.

---

Performance Optimizations​

Hopper is engineered specifically for high-performance servers.

Included Optimizations​

• Async chunk operations
• Batch item processing
• Intelligent location caching
• Auto throttling system
• Reduced entity scanning
• Optimized transfer cycles

Auto Throttle System​

---

Security & Protection​

Anti-Dupe Protection​

UUID tracking prevents item duplication exploits.

Claim Plugin Support​

Fully respects:

• Towny
• HuskClaims
• SuperiorSkyblock2
• Other supported protection plugins

Permission Checks​

Players can only place or access hoppers where they have permission.

---

Supported Integrations​

Hologram Plugins​

• DecentHolograms
• FancyHolograms
• HolographicDisplays

Custom Item Plugins​

• ItemsAdder
• MythicMobs

Protection Plugins​

• Towny
• SuperiorSkyblock2
• HuskClaims

---

Hologram Support​

Each Chunk Hopper can display a live hologram above it.

Example Hologram​

Chunk Hopper
Owner: PlayerName
Items: 128/2916 (4%)
Filter: BLACKLIST

Supported Placeholders​

---

Requirements​

---

Installation​

1. Download​

Download the latest version of:

Hopper-1.0.0.jar

2. Install​

Move the jar file into your server's:

/plugins/

folder.

3. Restart​

Restart your server completely.

4. Configure​

Edit:

plugins/Hopper/config.yml

5. Reload​

Optionally reload the plugin using:

/hopper reload

---

Commands​

Main Command​

/hopper

Aliases​

/hp
/chunkhopper
/ch

---

Subcommands​

---

Permissions​

---

Configuration​

Location:

plugins/Hopper/config.yml

---

Storage Settings​

storage:
size: 54

---

Collection Settings​

collection:
interval-ticks: 1
collect-ground-items: true
item-check-interval: 10
item-persist-time: 0
max-items-per-cycle: 0

---

Transfer Settings​

transfer:
items-per-transfer: 8
interval-ticks: 20

---

Limits​

limits:
per-chunk: 3
per-player: 50

---

Filter Settings​

filter:
default-mode: BLACKLIST
max-items: 27
shift-click-filter: true

---

Hologram Settings​

hologram:
enabled: true
provider: AUTO
height-offset: 1.5
update-interval: 40
lines:
- "&6&lChunk Hopper"
- "&7Owner: &f{owner}"
- "&7Items: &a{items}&7/&c{max}"
- "&7Filter: &b{filter_mode}"

---

Crafting Recipe​

┌─────────────┬─────────────┬─────────────┐
│ Diamond │ Ender │ Diamond │
│ Block │ Eye │ Block │
├─────────────┼─────────────┼─────────────┤
│ Ender │ Hopper │ Ender │
│ Eye │ │ Eye │
├─────────────┼─────────────┼─────────────┤
│ Diamond │ Ender │ Diamond │
│ Block │ Eye │ Block │
└─────────────┴─────────────┴─────────────┘

---

Performance Tips​

Large Servers (100+ Players)​

Increase Item Check Interval​

collection:
item-check-interval: 20

Limit Collection Per Cycle​

collection:
max-items-per-cycle: 50

Enable Auto Throttle​

performance:
auto-throttle:
enabled: true

Use Paper​

Paper provides significantly better performance than standard Spigot.

---

FAQ​

Can I place multiple Chunk Hoppers in one chunk?​

Yes. Use:

limits:
per-chunk:

to configure the maximum amount.

---

Do hoppers work in unloaded chunks?​

No. Hoppers only operate while the chunk is loaded for performance reasons.

---

Can players steal items?​

No. Only the owner or players with bypass permission can access a hopper.

---

Does this replace vanilla hoppers?​

No. Vanilla hoppers continue functioning normally.

---

Will this lag my server?​

Hopper is optimized specifically for high-player-count servers and large item farms.

---

Troubleshooting​

---

Support​

Discord​

https://discord.gg/xctckUQukB

​