LessLag

<h1 align="center"><img src="https://github.com/BridgerSilk/LessLag/blob/main/img/lesslag_logo_small.png?raw=true" width="30px" alt="logo banner" style="margin-bottom: 12px; border-radius: 10px;"> LessLag</h1> <p align="center"> LessLag is a <b>performance optimization</b> plugin for Minecraft servers that <b>reduces lag automatically</b> by controlling worlds, entities, redstone, mob AI, and much more. Designed to keep TPS high without sacrificing gameplay. </p>

<p align="center"> <img src="https://badgen.net/badge/minecraft/1.16-1.21.8/blue" alt="Minecraft Version"> <img src="https://badgen.net/badge/server/paper%20|%20spigot/green" alt="Server Type"> <img src="https://badgen.net/badge/performance/optimized%20for%20lag%20reduction/purple" alt="Performance"> <img src="https://badgen.net/badge/java/17+/orange" alt="Java Version"> </p>

---

💡 About

LessLag dynamically monitors server performance and automatically disables or throttles keeps your server smooth. From unloading inactive worlds to merging dropped items, disabling redstone during TPS drops, and controlling entity AI—LessLag keeps your server smooth with minimal change of vanilla features.

<img src="https://badgen.net/badge/⚠/IMPORTANT/red" width="150px" alt="important notice"> <br> Requires Protocol Lib to work!

---

✨ Key Features

* ⚙️ Smart TPS Handling – Every feature can be customized in the config (`plugins/LessLag/config.yml`) * 🗺 Smart TPS Handling – Unload inactive worlds automatically * 🧹 Smart TPS Handling – Auto-clear dropped items, stack drops, cap entities per world and per chunk * 🚷 Smart TPS Handling – Kick packet spammers, block teleportation when TPS are low, anti-chat spam * 🔌 Smart TPS Handling – Disable redstone, fluids, explosions, falling blocks * 🧠 Smart TPS Handling – Freeze mobs when no players nearby * 🧭 Smart TPS Handling – Prevent mass chunk load during lag spikes * 📊 Smart TPS Handling – Real-time TPS, MSPT, CPU, RAM, player ping tracking * ⚡ Smart TPS Handling – Auto-disable heavy operations when TPS drops

---

📂 Commands

| Command | Description | | ------------------ | ------------------------------ | | `/lesslag` / `/ll` | Main command | | `/ll reload` | Reloads configuration | | `/ll info` | Shows plugin info | | `/ll profiler` | Toggles performance profiler | | `/ll worlds` | Lists loaded worlds with stats |

---

🔑 Permissions

| Permission | Description | | ------------------ | ------------------------------ | | `lesslag.admin` | Access `/ll` command & get notified about performance related data |

---

✨ Showcase

<div align="center"> <img src="https://github.com/BridgerSilk/LessLag/blob/main/img/feature_item_stacking.png?raw=true" width="90%" alt="item stacking"> </div> <p align="center"><b>Improved item stacking, also works with un-stackable items, no item amount limit</p>

<br> <div align="center"> <img src="https://github.com/BridgerSilk/LessLag/blob/main/img/feature_customizable.png?raw=true" width="90%" alt="item stacking"> </div> <p align="center">Everything is customizable, even the item stack holograms</p>

<br> <div align="center"> <img src="https://github.com/BridgerSilk/LessLag/blob/main/img/feature_performance_profiler.png?raw=true" width="90%" alt="item stacking"> </div> <p align="center">Performance Profiler</p>

<br> <div align="center"> <img src="https://github.com/BridgerSilk/LessLag/blob/main/img/feature_world_list_command.png?raw=true" width="90%" alt="item stacking"> </div> <p align="center">World list command <code>/ll worlds</code></p>

<br> <div align="center"> <img src="https://github.com/BridgerSilk/LessLag/blob/main/img/feature_anti_spam.png?raw=true" width="90%" alt="item stacking"> </div> <p align="center">Anti chat spam</p>

<br> <div align="center"> <img src="https://github.com/BridgerSilk/LessLag/blob/main/img/feature_disable_blocks.png?raw=true" width="90%" alt="item stacking"> </div> <p align="center">Disable Fluids, Redstone and more when TPS are low</p>

<br> <div align="center"> <img src="https://github.com/BridgerSilk/LessLag/blob/main/img/feature_item_clear.png?raw=true" width="90%" alt="item stacking"> </div> <p align="center">Auto-clear dropped items</p>

<br> <div align="center"> <img src="https://github.com/BridgerSilk/LessLag/blob/main/img/feature_smart_entity_removal.png?raw=true" width="90%" alt="item stacking"> </div> <p align="center">Smart entity removal</p>

<br> <div align="center"> <img src="https://github.com/BridgerSilk/LessLag/blob/main/img/feature_world_unload.png?raw=true" width="90%" alt="item stacking"> </div> <p align="center">Auto-unload inactive worlds</p></b>

---

⚙️ Requirements

* Minecraft 1.16+ * Java 17 or higher * Paper / Spigot server *(or forks of those)* * Protocol Lib

---

🤝 Contribute

I welcome contributions!

1. Fork the repository on github 2. Create a feature branch (`feature/my-feature`) 3. Commit changes 4. Open a Pull Request

---

❓ Support

Having problems with this plugin? Create a new issue in the github repository and I will help you fix it.

---

❤️ Donate

If you enjoy LessLag and want to support its development:

* Buy me a coffee with Ko-fi

--- Have a nice day <3