Quickstart

Set up HopperLimiter in 3 steps.

Prerequisites

• Paper or Spigot 1.20+ server
• Java 17+
• No other dependencies

Step 1 — Install

1. Drop HopperLimiter.jar into plugins/
2. Start or restart your server

Console should show:

[HopperLimiter] Plugin enabled!

A default config.yml is generated at plugins/HopperLimiter/config.yml.

Step 2 — Set Your Limit

Open the config and pick a mode and cap:

# Simplest setup — one limit covers both block hoppers and hopper minecarts
counting-mode: COMBINED
combined-limit: 50

# What happens when a chunk is over the cap
overflow-action: BREAK   # BREAK or REMOVE

Save the file and run /hl reload.

Step 3 — Test It

1. Find or create a chunk on your test server
2. Place hoppers one by one until the 51st — you should be blocked with a message
3. Check /hl for confirmation that the plugin is active

Recommended Starting Values

Server Size	Recommended Limit
Small (< 20 players)	64 per chunk
Medium (20–50 players)	48 per chunk
Large (50+ players)	32 per chunk

These are starting points — adjust based on your TPS monitoring.

Next Steps

• Configuration Reference — Counting modes, overflow, validation
• Features — How each counting mode works
• Permissions — Bypass and reload permissions