Installation

Requirements

Requirement	Version
Minecraft Server	Paper or Spigot 1.20+
Java	17 or higher
External Dependencies	None

Installation Steps

1. Download

Obtain HopperLimiter.jar from the official releases page.

2. Place the JAR

server/
└── plugins/
    └── HopperLimiter.jar   ← place here

3. Start the Server

The plugin generates its config on first run:

plugins/
└── HopperLimiter/
    └── config.yml

4. Verify

Console output on successful load:

[HopperLimiter] Plugin enabled!

File Layout

File	Purpose
config.yml	All settings — limits, modes, messages, validation

Updating

1. Stop your server
2. Swap the old JAR for the new one
3. Start the server

Your config.yml is preserved. Check the release notes for any new config keys you may want to add.

Uninstalling

1. Stop the server
2. Remove HopperLimiter.jar from plugins/
3. Optionally delete plugins/HopperLimiter/ to remove config

note

Removing HopperLimiter does not affect existing hoppers. All hoppers placed while the plugin was active remain in place.