Configuration
All settings are in plugins/HopperLimiter/config.yml. Apply changes with /hl reload.
Full Config Reference
Counting Mode
counting-mode: COMBINED # COMBINED, SEPARATE, or WEIGHTED
| Mode | Description |
|---|---|
COMBINED | Block hoppers + hopper minecarts share a single limit |
SEPARATE | Block hoppers and hopper minecarts each have their own limit |
WEIGHTED | Each type has a weight; total weighted score must stay under max |
Limits
COMBINED mode
combined-limit: 50
SEPARATE mode
block-hoppers-limit: 30
hopper-minecarts-limit: 20
WEIGHTED mode
weighted:
block-hopper-weight: 1
hopper-minecart-weight: 2
max-weight: 50
In WEIGHTED mode, placing a block hopper costs 1 unit and a hopper minecart costs 2 units. The chunk's total weight must stay at or below max-weight.
Overflow Handling
overflow-action: BREAK # BREAK or REMOVE
removal-priority: distance # distance, y-level, or age
| Key | Options | Description |
|---|---|---|
overflow-action | BREAK, REMOVE | BREAK — drops items; REMOVE — silent deletion |
removal-priority | distance, y-level, age | Which hoppers are removed first when the limit is exceeded |
Validation
validation-interval: 60 # seconds between background scans (30–120 recommended)
chunks-per-tick: 5 # chunks scanned per scheduler tick (3–10 recommended)
The periodic validator catches any hoppers that may have been placed in ways that bypass the placement event (e.g. pistons, commands). Lowering chunks-per-tick reduces CPU usage at the cost of slower validation.
Bypass
permission-bypass:
enabled: true
Players with hopperlimiter.bypass can place hoppers beyond the limit when this is true.
Messages
messages:
placement-blocked: "&cYou cannot place more than {limit} hoppers in this chunk! ({current}/{limit})"
reload-success: "&aHopperLimiter configuration reloaded!"
Use {limit} and {current} as placeholders in the blocked message.
Summary Table
| Setting | Default | Recommended Range |
|---|---|---|
combined-limit | 50 | 32 – 64 |
block-hoppers-limit | 30 | 20 – 40 |
hopper-minecarts-limit | 20 | 10 – 25 |
validation-interval | 60 | 30 – 120 |
chunks-per-tick | 5 | 3 – 10 |