Adaptive Range Mob Spawner (ARMS)

The Adaptive Range Mob Spawner (ARMS) plugin dynamically adjusts the activation range of spawners in Minecraft based on the server's TPS (Ticks Per Second), ensuring optimal performance while maximizing mob spawn rates. It improves gameplay by maintaining a balance between efficient mob farming and server stability, even during high player activity.

Key Features

Dynamic Activation Range Adjustment: Automatically adjusts the spawner's activation range between a low and high threshold based on the server’s TPS.

When TPS is high, the range increases to maximize mob spawning.

When TPS drops below the configured threshold, the range decreases to reduce server load.

Player-Defined Range Control:

Initial, low, and high ranges can be defined in the configuration to meet server needs.

Set a custom initial range for placed spawners.

Automatically revert to a vanilla range for naturally generated spawners (optional).

Intelligent Chunk Management:

Only updates chunks near active players to reduce unnecessary processing.

Preexisting spawners can optionally be treated as player-placed for backward compatibility.

Auto-Update on Chunk Load:

Ensures spawners update dynamically when a chunk is loaded or when the TPS status changes.

Persistent Player-Placed Spawner Tagging:

Spawners placed by players are marked with persistent data, ensuring that only marked spawners retain adjusted ranges while natural spawners can be left unaffected.

Startup and Manual Update Options:

Automatically updates all loaded chunks on server startup.

Force-update all spawners manually with a command.

Configuration Options

The plugin offers an extensive configuration file to customize its behavior:

Range Settings:

initial-spawner-range: Initial range for player-placed spawners.

spawner-range-high: Range when TPS is high.

spawner-range-low: Range when TPS is low.

TPS Thresholds:

tps-threshold-low: TPS level to reduce the range.

tps-threshold-high: TPS level to restore a higher range.

Chunk Management:

only-update-near-players: Limit updates to chunks near active players.

player-chunk-radius: Radius of chunks around players to monitor.

World Control:

disabled-worlds: List of worlds where the plugin should be disabled (e.g., the_nether, the_end).

Spawner Update Policies:

affect-naturally-generated: Whether to update naturally generated spawners.

update-preexisting-spawners: Whether to update preexisting spawners without a player-placed marker.

Commands

/adaptivespawner — View the current TPS, range, and status of the plugin.

/adaptivespawner reload — Reload the configuration file without restarting the server.

/adaptivespawner debug — Toggle debug mode to enable verbose logging.

/adaptivespawner update — Force a manual update of all loaded spawners.

Permissions

block4block.admin — Grants access to plugin commands and configuration reloading.

Use Cases

• Farms and Grinders: Maximize mob spawns while protecting TPS during high server load.
• Survival and Faction Servers: Dynamic range adjustment ensures that high mob spawning does not cause server lag.
• Creative and Custom Worlds: Fine-tune mob spawn mechanics to suit the specific needs of your server.

Performance Impact and Safety

Optimized for minimal impact using chunk caching and efficient TPS checks.

Asynchronous chunk processing where supported (for Paper servers) ensures smooth updates even during peak hours.

Debug mode for detailed logging and troubleshooting.

Installation and Setup

Download and place the plugin .jar file in the server's plugins folder.

Start or reload the server.

Customize the config.yml to fit your server's requirements.

Use /adaptivespawner reload to apply changes without restarting.

Compatibility

Compatible with Bukkit, Spigot, and Paper ( Paper is recommended for best performance).

Supports Minecraft versions 1.13 to 1.21+.

Fully configurable to adapt to various server types and world environments.

With Adaptive Range Mob Spawner, you can ensure efficient mob spawning, maintain optimal TPS, and provide a seamless experience for your players.