Skip to main content

Overview

HopperLimiter is a lightweight, performance-focused plugin that enforces a maximum number of hoppers (and hopper minecarts) per chunk. Excessive hoppers are one of the most common causes of server lag — HopperLimiter gives server owners a simple, configurable cap without needing to ban hoppers entirely.

Why Use HopperLimiter?​

Each hopper checks for items every game tick. Even a few hundred hoppers in a small area can measurably raise your server's TPS cost. HopperLimiter stops the problem at the source by preventing placement beyond a defined threshold and periodically validating existing chunks.

Key Features​

  • Per-Chunk Limits — Independent caps for block hoppers and hopper minecarts
  • Three Counting Modes — Combined, Separate, or Weighted to fit any server design
  • Automatic Overflow Handling — Break or silently remove excess hoppers above the cap
  • Periodic Validation — Background scan removes any hoppers that bypassed placement checks
  • Permission Bypass — Trusted players/staff can exceed the limit
  • Player Notifications — Friendly messages when a placement is blocked
  • No Per-Tick Overhead — Event-driven; background validation runs on a configurable interval
  • Folia Compatible — Safe for multi-threaded region servers

Supported Versions​

ComponentRequirement
MinecraftPaper/Spigot 1.20+
JavaJava 17+
API Version1.20
FoliaSupported

Dependencies​

None — HopperLimiter is standalone with zero required dependencies.

Quick Example​

# config.yml — allow 50 combined hoppers per chunk
counting-mode: COMBINED
combined-limit: 50
overflow-action: BREAK

Players placing a 51st hopper will be blocked and notified immediately.

How It Works​

  1. Placement Prevention — BlockPlaceEvent is intercepted; if the chunk is already at its cap, placement is cancelled
  2. Periodic Validation — Every validation-interval seconds the plugin scans loaded chunks and removes any excess
  3. Overflow Action — When excess hoppers are found, they are either broken (drops items) or silently removed, based on config
  4. Bypass — Players with hopperlimiter.bypass can always place freely

What's Next?​