LagXpert Free - Official Documentation
LagXpert Free is a modular plugin that helps server owners monitor and reduce lag caused by overloaded chunks, redstone circuits, entities, storage blocks, and dropped items.
Installation
- Download the latest LagXpert Free jar.
- Place it in your /plugins folder.
- Start or restart your server.
- Configuration files will be generated automatically.
Modules
Each system in LagXpert is modular and can be enabled or disabled independently via config.yml:
Code (Text):
modules:
mobs: true
storage: true
redstone: true
alerts: true
task: true
Each module has its own .yml file:
- mobs.yml: entity limits
- storage.yml: block limits (hoppers, chests, furnaces)
- redstone.yml: redstone behavior control
- alerts.yml: alert system
- task.yml: chunk auto-scanner settings
- itemcleaner.yml: dropped item cleanup settings
️ Commands
/lagxpert
Main command with subcommands:
- /lagxpert reload – Reload all config and message files (requires lagxpert.admin)
- /lagxpert inspect <chunkX,chunkZ> – Inspect usage of a specific chunk (admin use)
- /lagxpert help – Show help menu
/chunkstatus
- Displays usage of the player’s current chunk: mob, hopper, chest, and furnace counts.
- Requires: lagxpert.use
/abyss
- Allows players to recover recently cleared dropped items.
- Requires: lagxpert.abyss
Permissions
Permission
Description
Default
lagxpert.use Use basic commands true
lagxpert.admin Reload, inspect other chunks op
lagxpert.abyss Use the /abyss command true
lagxpert.bypass.mobs Exempt from mob limit checks false
lagxpert.bypass.hoppers Exempt from hopper limit checks false
lagxpert.bypass.chests Exempt from chest limit checks false
lagxpert.bypass.furnaces Exempt from furnace limit checks false
lagxpert.bypass.redstone Exempt from redstone disruption false
Configuration Overview
All limits and control values are defined in their respective files:
Example: mobs.yml
Code (Text):
limits:
mobs-per-chunk: 40
Example: storage.yml
Code (Text):
limits:
hoppers-per-chunk: 8
chests-per-chunk: 20
furnaces-per-chunk: 10
Example: redstone.yml
Code (Text):
control:
enabled: true
redstone-active-ticks: 100
♻️ Item Cleaner System
- Automatically removes dropped items after a configured interval.
- Sends warning messages before cleanup.
itemcleaner.yml
Code (Text):
enabled: true
interval-ticks: 6000 # 5 minutes
excluded-items:
- DIAMOND
- NETHER_STAR
warning:
enabled: true
seconds-before: 10
message: "&e[LagXpert] &7Items will be cleared in &c{seconds}&7s."
Metrics
LagXpert integrates
bStats to collect anonymous statistics and help improve the plugin.
Developer API
LagXpert exposes events for plugin developers:
ChunkOverloadEvent
Called when a chunk exceeds a defined limit.
Code (Text):
@EventHandler
public void onChunkOverload(ChunkOverloadEvent event) {
Chunk chunk = event.getChunk();
String cause = event.getCause(); // "mobs", "hoppers", etc.
}
More API utilities will be added in future updates.
Support
Need help or want to report a bug? Join our community:
Discord Support Server
Planned Features
- Multilanguage support (messages_es.yml, etc.)
- More granular block/entity types
- Redstone clock detection (Pro version)
- GUI support (Pro version)
Thanks for using
LagXpert Free!