LagReducer Plugin – Quick Summary
📜 Commands
| Command | Description | Usage |
|---|---|---|
| /lag | Shows current TPS, lag status and basic statistics. | /lag |
| /lag reload | Reloads the plugin’s configuration without a server restart. | /lag reload |
| /lag toggle | Enables or disables automatic lag‑reduction actions on the fly. | /lag toggle |
| /lag info | Detailed view of recent TPS spikes, entity counts and memory usage. | /lag info |
All lag commands require the permission lagreducer.use. The reload and toggle sub‑commands additionally need lagreducer.admin.
⚙️ Configuration (config.yml)
# Minimum TPS before the plugin starts taking action
tps-threshold: 15.0
# How many seconds the TPS must stay below the threshold before actions trigger
grace-period: 30
# Actions to perform when lag is detected (set to true/false)
entity-cleanup: true # removes excess mobs and items
world-save: true # forces a world save to free memory
broadcast-warning: true # warns players in chat
kick-players: false # optional auto‑kick for extreme lag
# Entity cleanup settings
max-entities-per-chunk: 30
exclude-entities:
- VILLAGER
- PLAYER
Edit the values to suit your server’s performance needs and reload with /lag reload.
🔐 Permissions
lagreducer.use– Allows use of/lag,/lag info.lagreducer.admin– Allows/lag reloadand/lag toggle.
🚀 Key Features
- Real‑time TPS monitoring via
TpsMonitor; updates every second. - Automatic lag mitigation: when TPS drops below the configured threshold for the defined grace period, the plugin can clean up excess entities, force world saves, broadcast warnings, and (optionally) kick players.
- Live statistics:
/lagshows current TPS, recent average TPS, memory usage and entity count. - Dynamic control: toggle the automatic system on/off without restarting the server.
- Config‑driven: all thresholds and actions are fully configurable in
config.yml.
🎨 Assets
No custom textures or models are used by this plugin.
That’s all you need to start using LagReducer – monitor server performance, automatically reduce lag, and keep your world running smoothly!

