LagXpert Free icon

LagXpert Free -----

Modular lag management for every server.



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
  1. Download the latest LagXpert Free jar.

  2. Place it in your /plugins folder.

  3. Start or restart your server.

  4. 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!
Resource Information
Author:
----------
Total Downloads: 68
First Release: May 5, 2025
Last Update: May 22, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings