ServerOptimizer

<!-- Header Banner --> <div align="center"> !(https://capsule-render.vercel.app/api?type=waving&color=0:0f0c29,50:302b63,100:24243e&height=200&section=header&text=ServerOptimizer&fontSize=60&fontColor=ffffff&fontAlignY=38&desc=High-Performance%20Spigot%20%2F%20Paper%20Optimization%20Plugin&descAlignY=58&descSize=18&animation=fadeIn) <!-- View Counter --> !(https://komarev.com/ghpvc/?username=serveroptimizer-modrinth&color=6366f1&style=for-the-badge&label=PLUGIN+VIEWS) <!-- Badges --> (https://img.shields.io/badge/Minecraft-1.20.4+-00AA00?style=for-the-badge&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAAOCAYAAAAfSC3RAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAAdgAAAHYBTnsmCAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZxjeSdoAAABySURBVCiRY2AYBfQ/AAj/GYqLixkYGBj+M5AHBpVBuIMiDFSGIbSNmEYSNBIzCGonTiNBJ34jUSduI34j/hD+j9+I34TfhN+E34TfhN+E34TfhN+E3oTehN6E3oTehN6E3oTehN6E3oTOhM6EzoTOhM6EzgBxHxsmdzxiEAAAAABJRU5ErkJggg==&logoColor=white)](https://papermc.io) (https://img.shields.io/badge/Paper-API-00B4D8?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0xMyAxNEg3di0yaDZtNC00SDd2Mmgxem0wLTRIN3YyaDEwbTItNEg1djE0aDE0VjZoLTR6TTMgNGgxMnYySDN6Ii8+PC9zdmc+&logoColor=white)](https://papermc.io) (https://img.shields.io/badge/Java-17+-ED8B00?style=for-the-badge&logo=openjdk&logoColor=white)](https://adoptium.net) (https://img.shields.io/badge/Maven-Build-C71A36?style=for-the-badge&logo=apachemaven&logoColor=white)](https://maven.apache.org) (https://img.shields.io/badge/License-MIT-purple?style=for-the-badge&logo=opensourceinitiative&logoColor=white)](LICENSE) <!-- Social --> (https://img.shields.io/badge/Discord-allay__gaming__x-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com) (https://img.shields.io/badge/Author-Pawan-ff6b6b?style=for-the-badge&logo=github&logoColor=white)](https://github.com) </div> --- ## 🧩 What is ServerOptimizer? **ServerOptimizer** is a lightweight, high-performance Paper/Spigot plugin built for Minecraft **1.20.4+** that surgically targets the three most common causes of server lag: | 🎯 Target | 📉 Problem Solved | |---|---| | ⚙️ **Entity Tick Lag** | Too many mobs/items in a single chunk crushing TPS | | 🗺️ **Chunk Loading Spam** | Idle chunks staying loaded and draining memory | | 🪣 **Hopper Overhead** | Thousands of hopper events per second on farm servers | All heavy computation runs **asynchronously** — the main thread stays at a clean **20 TPS**. --- ## ✨ Features ### ⚙️ Entity Optimizer - 🔍 Periodic **async entity scans** across all loaded chunks - ✂️ **Culls excess entities** when a chunk exceeds your configured cap - 🧲 **Item merging** — stacks nearby dropped items instead of deleting them - 🏷️ **Named entity protection** — entities with name tags are never removed - 🚫 **Spawn-time gating** — cancels spawns *before* the entity is created (cheaper than culling) - 🌍 Per-world enable/disable support ### 🗺️ Chunk Optimizer - ⏱️ **Idle chunk unloading** — automatically requests unload after configurable inactivity - 📡 **Player-radius tracking** — keeps only chunks near active players loaded - 📊 **Async load rate limiting** — prevents chunk-generation spam from overwhelming the server - 🪶 Uses `WeakHashMap` so unloaded chunk references are garbage-collected automatically ### 🪣 Hopper Optimizer - 🐌 **Configurable hopper tick rate** — slow down hoppers from vanilla 8-tick to your preference - 😴 **Lazy mode** — skips hoppers with empty source inventories entirely - 📦 Per-hopper transfer rate tracked with `ConcurrentHashMap` - 🗑️ Auto-purges stale hopper entries every 5 minutes — zero memory leaks ### 🛡️ Plugin Compatibility - ✅ **WorldGuard** — entity listener uses `HIGH` priority, after WorldGuard's region checks - ✅ **EssentialsX** — softdepend declared, no hard conflicts - ✅ All listeners use `ignoreCancelled = true` to skip already-processed events ### 🔧 Developer Quality - 🔁 **Hot-reload** via `/sopt reload` — no server restart needed - 🧵 Thread-safe throughout (`ConcurrentHashMap`, `WeakHashMap`, `AtomicInteger`) - 📝 Full `config.yml` with comments on every setting - 📋 Tab-completion on all commands --- ## 📋 Commands | Command | Alias | Description | Permission | |---|---|---|---| | `/serveroptimizer reload` | `/sopt reload` | Hot-reload config from disk | `serveroptimizer.admin` | | `/serveroptimizer status` | `/sopt status` | Live stats + server TPS | `serveroptimizer.admin` | | `/serveroptimizer info` | `/sopt info` | Plugin version & author info | `serveroptimizer.admin` | --- ## 🔑 Permissions | Permission | Default | Description | |---|---|---| | `serveroptimizer.admin` | `OP` | Access all admin commands | | `serveroptimizer.bypass` | `false` | Bypass entity limits | --- ## ⚙️ Configuration ```