X-Clearlag

<div align="center"> (https://img.shields.io/badge/Available%20on-Spigot-orange?style=for-the-badge&logo=spigotmc&logoColor=white)](https://www.spigotmc.org/resources/x-clearlag-custom-cleaning-1-8-1-21-11.132713/) (https://img.shields.io/badge/Wiki-Documentation-blue?style=for-the-badge&logo=readme&logoColor=white)](https://wiki-x-proyects.vercel.app/) (https://img.shields.io/badge/Discord-Community-7289da?style=for-the-badge&logo=discord&logoColor=white)](https://discord.xproyects.qzz.io/) # **X-ClearLag** *Next-generation entity cleanup with Folia support, proximity protection, and multi-language modular tasks* </div> --- ## 📄 Description **X-ClearLag** is the ultimate, professional-grade entity management solution for modern servers. Completely rebuilt from the ground up, it offers **native Folia compatibility**, wall-clock precision tasks, and advanced performance optimizations. Protect your players' experience with the brand-new **Proximity Protection system**, automatically intervene during lag spikes with **TPS-based emergency cleanups**, and monitor your world smoothly using the **Interactive Chunk Inspector**. All of this without a single annoying console warning. Supports **Spigot, Paper, Purpur, and Folia (1.8.x - 26.1)**. ## ⚡ Main Commands **`/xcl `** (*Aliases: `/clearlag`, `/xclearlag`*) - **`help`** - Shows the interactive help menu. - **`reload`** - Hot-reloads configuration and language files. - **`clear`** - Manually triggers the main cleanup tasks instantly. - **`inspect`** - Opens the **Interactive Chunk Inspector** to hunt down entity clusters. - **`clearchunk <world> <x> <z>`** - Wipes all entities from a targeted chunk. - **`tpchunk <world> <x> <z>`** - Teleports instantly to a specific chunk coordinate. - **`update`** - Checks for the latest X-ClearLag updates. ## ⭐ Key Features - **Folia & Next-Gen Support** — 100% compatible with Folia's regional threading model. Built for elite performance. - **Player Proximity Protection** — Smartly ignores dropped items and entities that are right next to your active players. - **TPS Monitor & Auto-Cleanup** — Server lagging? X-ClearLag detects TPS drops and automatically triggers an emergency surgical cleanup. - **Batch Processing & Anti-Spike** — Removes thousands of entities in controlled batches over multiple ticks, preventing the classic "clearlag server freeze". - **Interactive Chunk Inspector** — View the Top 12 busiest chunks and manage them through interactive chat clicks. - **Internal Notifications & PAPI** — Use `, , , ` directly in config. Full PlaceholderAPI support. - **BossBar Countdown** — Elegant visual countdown bar for players during the last 60s (Requires 1.9+). - **Task-Based Architecture** — Create unlimited independent cleanup tasks. Make one run every 5 mins for drops, and another every 30 mins to run `save-all`. - **Granular Protection** — Secure mobs by name-tag, leash state, type whitelist, or world blacklists. ## 🌐 Multi-Language Support - **English** — `en` - **Español** — `es` - **Português** — `pt` - **日本語** — `ja` - **Русский** — `ru` - **Custom** — `custom` ## 🔑 Permissions - **`xclearlag.admin.*`** — Grants all admin permissions (Default: OP). - **`xclearlag.admin.reload`** — Access to `/xcl reload`. - **`xclearlag.admin.clear`** — Access to `/xcl clear`. - **`xclearlag.admin.inspect`** — Access to `/xcl inspect`. - **`xclearlag.admin.clearchunk`** — Access to `/xcl clearchunk`. - **`xclearlag.admin.tpchunk`** — Access to `/xcl tpchunk`. - **`xclearlag.admin.update`** — Access to `/xcl update`. - **`xclearlag.bypass`** — Bypass countdown messages (Default: false). - **`xclearlag.notify`** — Receive cleanup notifications (Default: true). ## 🧩 Developer API X-ClearLag provides a lightweight API for other plugins to interact with the cleanup engine. Support for custom events like `XPreClearEvent` (cancellable) and `XPostClearEvent` allows you to prevent cleanups during critical moments or track performance metrics easily. Full **PlaceholderAPI** support included! ## ⚙️ Configuration Example > > This is a basic example. For a full explanation of every setting and module, please visit our (https://wiki-x-proyects.vercel.app/). ```yaml prefix: "&8 &7" language: "en" tps-check: enabled: true threshold: 16.0 interval: 60 task-to-run: bossbar: enabled: false color: "RED" style: "SOLID" tasks: clearlag: enabled: true interval: 300 min-players: 3 remove-drops: true protect-named: true protect-leashed: true protect-near-player: false near-player-radius: 16 countdown: countdown-commands: 60: - ' &b&lX-ClearLag' - ' &7Cleanup in &c60s' - ' NOTE_PLING' 10: - ' &eEntities removed in &c10s&e!' entities: [ARROW, SNOWBALL,