Performancez — Lag Reduction & Server Optimization
Performancez is a Spigot/Paper 1.16–1.21 plugin that reduces server lag by limiting entities, merging items, freezing empty worlds, monitoring TPS, and protecting against crash exploits, Built By 786kurulus.
✨ Performancez Plugin Documentation
📖 Overview
Performancez is a comprehensive server optimization plugin for Spigot and Paper servers running Minecraft 1.16.x through 1.21.x. It targets the most common sources of server lag including entity overcrowding, memory pressure, TPS degradation, ping spikes, chunk overloading, and crash exploits — all configurable with every feature individually toggleable.
💡 Set any numeric limit to
-1to disable that specific check without turning off the whole system.
⚙️ Systems
👾 Entity Limiter
Caps mobs and dropped items per chunk at spawn time and via periodic scans. Supports global limits, per-type limits (zombies, villagers, chickens, etc.), and a separate item cap. Players are never affected. (Enable it in config
🗺️ Chunk Manager
Tracks last-used timestamps for every loaded chunk and automatically unloads chunks with no nearby players after a configurable idle time. Respects force-loaded chunks and world-specific max chunk counts.
🧠 Memory Manager
Monitors JVM heap usage and triggers garbage collection suggestions when usage exceeds a configurable threshold. Notifies admins in-game when memory is critically high.
📊 TPS Monitor
Reads server TPS every few seconds and reacts to two configurable thresholds — a low threshold triggers admin notifications, a critical threshold triggers emergency entity culling and optional view distance reduction.
📡 Ping Guard
Samples all player pings on a regular interval. Warns admins when average server ping is high. Supports optional auto-kick for players exceeding a max ping limit.(Enable in config)
📈 Lag Spike Profiler
Measures actual tick duration every tick. Spikes exceeding the threshold are logged with the worst-performing world's entity and chunk counts. Keeps a rolling history of the last 20 spikes and continuously snapshots chunk entity counts for the top-chunks list.
🛡️ Anti-Crasher
Blocks known crash exploits at the event level — oversized books, oversized chat packets, and oversized sign lines. Kicks violating players and logs every incident.
🧊 World Freeze
Detects worlds with no players and freezes their time cycle, weather, and mob AI entirely. Resumes instantly when a player enters. Specific worlds can be excluded.(Enable in config)
📬 Async Player Loader
Moves expensive player pre-login processing off the main thread. Includes a join-flood detector that warns admins when the same IP joins in rapid succession.
🧹 Auto Clear Lagg
Runs on a configurable timer with broadcast countdown warnings. Clears dropped items, projectiles, and experience orbs. Protects items near players.
📋 Commands
| Command | Description |
|---|---|
/pz help | 📜 Lists all commands |
/pz status | 🖥️ Full server overview — TPS, memory, players, entities, chunks, frozen worlds |
/pz clearlagg | 🧹 Instantly culls entities, unloads stale chunks, merges items, and suggests GC |
/pz tps | 📊 Shows 1m, 5m, and 15m TPS averages color-coded green/yellow/red |
/pz memory | 🧠 Shows JVM heap usage in MB and percentage |
/pz chunks | 🗺️ Shows loaded chunk counts per world |
/pz ping | 📡 Shows every online player's ping with color coding |
/pz top | 🔝 Shows top 10 laggiest chunks ranked by entity count |
/pz history | 🕐 Shows last 20 lag spike reports with timestamps |
/pz freeze | 🧊 Shows which worlds are currently frozen |
/pz crasher | 🛡️ Shows current anti-crasher limits |
/pz reload | 🔄 Reloads config.yml without restarting the server |
Aliases:
/performancez·/pz·/perf
🔐 Permissions
| Permission | Default | Description |
|---|---|---|
performancez.admin | 👑 OP | Access to all commands |
performancez.notify | 👑 OP | Receive in-game lag spike and warning alerts |
performancez.bypass.entitylimit | ❌ false | Bypass entity spawn limiting |
performancez.bypass.anticheat | 👑 OP | Bypass anti-crasher checks |
🛠️ Configuration
Every system has its own section in config.yml and can be individually enabled or disabled. Setting any numeric limit to -1 disables that specific check without turning off the whole system. Key settings include:
- ⏱️ Scan intervals & check frequencies
- 📉 TPS & memory thresholds
- 🐾 Per-type entity limits
- ⏳ Countdown warning timings
- 🌍 Excluded worlds per system
- 💬 All in-game messages including the plugin prefix
