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?​