# \u2728 Performancez Plugin Documentation<\/p>\n
—<\/p>\n
## \ud83d\udcd6 Overview
\nPerformancez 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 \u2014 all configurable with every feature individually toggleable.<\/p>\n
> \ud83d\udca1 Set any numeric limit to `-1` to disable that specific check without turning off the whole system.<\/p>\n
—<\/p>\n
## \u2699\ufe0f Systems<\/p>\n
### \ud83d\udc7e Entity Limiter
\nCaps 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 <\/p>\n
### \ud83d\uddfa\ufe0f Chunk Manager
\nTracks 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.<\/p>\n
### \ud83e\udde0 Memory Manager
\nMonitors JVM heap usage and triggers garbage collection suggestions when usage exceeds a configurable threshold. Notifies admins in-game when memory is critically high.<\/p>\n
### \ud83d\udcca TPS Monitor
\nReads server TPS every few seconds and reacts to two configurable thresholds \u2014 a low threshold triggers admin notifications, a critical threshold triggers emergency entity culling and optional view distance reduction.<\/p>\n
### \ud83d\udce1 Ping Guard
\nSamples 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)<\/p>\n
### \ud83d\udcc8 Lag Spike Profiler
\nMeasures 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.<\/p>\n
### \ud83d\udee1\ufe0f Anti-Crasher
\nBlocks known crash exploits at the event level \u2014 oversized books, oversized chat packets, and oversized sign lines. Kicks violating players and logs every incident.<\/p>\n
### \ud83e\uddca World Freeze
\nDetects 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)<\/p>\n
### \ud83d\udcec Async Player Loader
\nMoves 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.<\/p>\n
### \ud83e\uddf9 Auto Clear Lagg
\nRuns on a configurable timer with broadcast countdown warnings. Clears dropped items, projectiles, and experience orbs. Protects items near players.<\/p>\n
—<\/p>\n
## \ud83d\udccb Commands<\/p>\n
| Command | Description |
\n|—|—|
\n| `\/pz help` | \ud83d\udcdc Lists all commands |
\n| `\/pz status` | \ud83d\udda5\ufe0f Full server overview \u2014 TPS, memory, players, entities, chunks, frozen worlds |
\n| `\/pz clearlagg` | \ud83e\uddf9 Instantly culls entities, unloads stale chunks, merges items, and suggests GC |
\n| `\/pz tps` | \ud83d\udcca Shows 1m, 5m, and 15m TPS averages color-coded green\/yellow\/red |
\n| `\/pz memory` | \ud83e\udde0 Shows JVM heap usage in MB and percentage |
\n| `\/pz chunks` | \ud83d\uddfa\ufe0f Shows loaded chunk counts per world |
\n| `\/pz ping` | \ud83d\udce1 Shows every online player’s ping with color coding |
\n| `\/pz top` | \ud83d\udd1d Shows top 10 laggiest chunks ranked by entity count |
\n| `\/pz history` | \ud83d\udd50 Shows last 20 lag spike reports with timestamps |
\n| `\/pz freeze` | \ud83e\uddca Shows which worlds are currently frozen |
\n| `\/pz crasher` | \ud83d\udee1\ufe0f Shows current anti-crasher limits |
\n| `\/pz reload` | \ud83d\udd04 Reloads config.yml without restarting the server |<\/p>\n
> **Aliases:** `\/performancez` \u00b7 `\/pz` \u00b7 `\/perf`<\/p>\n
—<\/p>\n
## \ud83d\udd10 Permissions<\/p>\n
| Permission | Default | Description |
\n|—|—|—|
\n| `performancez.admin` | \ud83d\udc51 OP | Access to all commands |
\n| `performancez.notify` | \ud83d\udc51 OP | Receive in-game lag spike and warning alerts |
\n| `performancez.bypass.entitylimit` | \u274c false | Bypass entity spawn limiting |
\n| `performancez.bypass.anticheat` | \ud83d\udc51 OP | Bypass anti-crasher checks |<\/p>\n
—<\/p>\n
## \ud83d\udee0\ufe0f Configuration
\nEvery 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:<\/p>\n
– \u23f1\ufe0f Scan intervals & check frequencies
\n– \ud83d\udcc9 TPS & memory thresholds
\n– \ud83d\udc3e Per-type entity limits
\n– \u23f3 Countdown warning timings
\n– \ud83c\udf0d Excluded worlds per system
\n– \ud83d\udcac All in-game messages including the plugin prefix<\/p>\n","protected":false},"excerpt":{"rendered":"
Performancez is a Spigot\/Paper 1.16\u20131.21 plugin that reduces server lag by limiting entities, merging items, freezing empty worlds, monitoring TPS, and protecting against crash exploits, Built By 786kurulus.<\/p>\n","protected":false},"featured_media":120484,"template":"","meta":{"_minecraft_slug":"performancez","_minecraft_project_id":"OKpeMEk3","_minecraft_author":"786kurulus","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":682,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"performancez.zip","_minecraft_size_bytes":27177852,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T09:50:33.038921Z","_minecraft_date_created":"2026-03-17T02:21:02.117997Z","_minecraft_date_modified":"2026-04-19T07:13:52.472770Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/performancez","_minecraft_icon_attachment_id":120484,"_minecraft_imported_at":"2026-06-07T02:08:56+00:00","_minecraft_import_hash":"4c959219d033182f4a648ffb8e900136","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,90,127,128,129,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-120483","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n