ClearLAGGG

ClearLAGGG

A lag-reduction plugin for Paper servers. It targets the usual suspects behind poor tick times: runaway entity counts, spawner farms, mob-egg spam, uncontrolled breeding, dropped items that never expire, and TNT chain reactions. On top of the limiters it ships the monitoring tools you need to find out what is actually costing you ticks: TPS/RAM tracking, chunk analysis, a tick sampler and a memory sampler.

The design goal is prevention rather than brute force. Clearing entities every five minutes hides the symptom; the limiters keep the entities from piling up in the first place.

Requirements

• Paper (or a fork) on Minecraft 1.21+
• Java 21

PlaceholderAPI is optional. If it is installed, ClearLAGGG registers its placeholders automatically; if not, everything else works unchanged.

Commands

All commands live under /lagg (aliases: /clearlag, /clearlagg, /clearlaggg).

Each subcommand has a matching permission (lagg.clear, lagg.check, and so on), all defaulting to op. lagg.* grants everything. lagg.notify controls who receives the automatic threshold notifications.

Configuration

config.yml is split into one section per feature, each documented inline:

• settings - prefix, language, update checks, startup banner
• entity-clear / kill-mobs - what gets removed, on which schedule, with warnings
• limiters - per-chunk and per-world entity caps
• spawner-limiter, mob-egg-limiter, breeding-limiter - caps on the common farm exploits
• item-livetime - per-item despawn times
• tnt - chain-reaction and block-damage limits
• chunk-analysis, chunk-unloader - finding and unloading expensive chunks
• ai-limiter - distance-based mob AI throttling
• tps-meter - run commands when TPS or RAM crosses a threshold
• tick-sampler, memory-sampler, profiler - the measurement tools
• halt - what /lagg halt actually freezes

Twelve languages ship in lang/; pick one with settings.language.

tps-meter triggers are opt-in. No trigger is enabled by default, so ClearLAGGG will not broadcast anything to your players unless you configure it to.

Placeholders

Available when PlaceholderAPI is installed:

%clearlaggg_tps%                %clearlaggg_entities_world%
%clearlaggg_tps_colored%        %clearlaggg_entities_total%
%clearlaggg_ram_used%           %clearlaggg_chunks_loaded%
%clearlaggg_ram_max%            %clearlaggg_last_clear_amount%
%clearlaggg_ram_percent%        %clearlaggg_halted%

Building

mvn clean package

The shaded jar lands in target/clearlaggg-1.1-RELEASE.jar. bStats is shaded and relocated into de.empireblocks.clearlaggg.libs.bstats; paper-api and PlaceholderAPI are provided and stay out of the jar.

License

GNU General Public License v3.0. See LICENSE.