# HopperRange

Increase the pickup range of Rust industrial hoppers, allowing items to be collected from a larger area.

Features

* Configurable hopper pickup radius.
* Applies the range to existing hoppers when the plugin loads.
* Automatically applies the configured range to newly spawned hoppers.
* Changing the range updates all currently modified hoppers immediately.
* Preserves the original hopper range and movement speed.
* Restores original hopper settings when the plugin is unloaded.
* Includes protection against invalid or extremely small range values.
* Startup scanning is performed gradually to reduce server performance impact.

Configuration

The configuration file is located at:

oxide/config/HopperRange.json

Hopper Range

{
  "Hopper Range (Radius)": 3.0
}

The default range is 3.0. The minimum allowed range is 0.1.

Permission

hopperrange.admin

This permission is required to change the hopper range using the commands.

Commands

Chat

/hopperrange <radius>

Console

hopperrange.set <radius>

Example:

hopperrange.set 5

The new range is saved to the configuration and immediately reapplied to all currently modified hoppers.

How It Works

The plugin modifies the hopper's item trigger collider and synchronizes the hopper's item movement speed with the configured radius. Original values are stored so they can be restored when the plugin is unloaded.

HopperRange