Getting Started

Overview

XAntiLag is an all-in-one server optimization addon for XCore. It bundles every common anti-lag tool into a single package — chunk limits, mob & item stackers, custom mob AI, villager throttling, hopper rate limiting, redstone clock detection, anti-chunkloader, TNT throttling, scheduled clearlag, gradual TPS monitor, anti-AFK, and a chunk profiler GUI.

Key highlights:

  • Chunk limiter — Per-block, per-entity and per-tile-entity caps with full event coverage
  • Mob & item stackers — Adventure-formatted display tags, drop multiplication, slime split handling
  • Custom mob AI — Distance-based pathfinding reduction with NMS pathfinder injection
  • TPS monitor — Gradual optimization levels that scale view distance, spawn rate and clearlag dynamically
  • Chunks GUI — Paginated view of every loaded chunk with full breakdown and click-to-teleport
  • Folia-ready — Region-thread aware sampling so getTileEntities never crashes
  • Web dashboard — REST endpoints exposed through XCore's web panel

Requirements

  • Paper 1.21.1+ (or Folia)
  • Java 21+
  • XCore 1.0.0+ installed as a plugin
  • Optional: PlaceholderAPI for placeholders

Installation

  1. Install XCore in your server's plugins/ folder if you haven't already.
  2. Place XAntiLag.jar in plugins/XCore/addons/.
  3. Start the server. XAntiLag generates its configuration files in plugins/XCore/addons/XAntiLag/.
  4. Edit config.yml to enable / disable each feature and tune their thresholds.
  5. Use /xantilag reload to apply changes without a restart.

Every feature can be independently toggled in config.yml. If you only need stackers, disable the rest — XAntiLag won't register the listeners or schedulers it doesn't need.

Chunk Optimization