# PerformanceAnalyzer<\/p>\n
**The all-in-one server monitoring, lag diagnosis & AntiCheat plugin for Paper 1.21.x**<\/p>\n
Monitor your server in real-time, find the source of lag spikes in seconds, detect cheaters, and keep your players happy \u2014 all from a single plugin.<\/p>\n
—<\/p>\n
## Why PerformanceAnalyzer?<\/p>\n
Most monitoring plugins tell you *that* your server is lagging. PerformanceAnalyzer tells you **why**.<\/p>\n
When a TPS drop occurs, the plugin automatically captures a full snapshot of your server state \u2014 loaded chunks, entity counts, player activity, suspect plugins \u2014 so you can diagnose the problem instantly instead of guessing.<\/p>\n
—<\/p>\n
## Key Features<\/p>\n
### Real-Time Performance Monitoring
\n– **TPS, MSPT & Heap** tracking with historical data and ASCII sparklines
\n– **Spark Integration** for highly accurate TPS (10s\/1m\/5m), MSPT (avg\/p95\/max), and CPU data
\n– **ProtocolLib Integration** for packet analysis and flood detection
\n– **Database Logging** (SQLite or MySQL) with async batch writes via HikariCP<\/p>\n
### Automatic Lag Diagnosis
\n– **Performance Drop Detection** \u2014 automatically triggers when TPS drops or MSPT spikes
\n– **Full Server Snapshots** \u2014 captures chunks, entities, memory, and player locations at the moment of the drop
\n– **Lag Source Analysis** \u2014 identifies the players and plugins most likely responsible
\n– **Problematic Chunk Detection** \u2014 finds chunks overloaded with tile entities or redstone
\n– **Chunk Thrashing Detection** \u2014 spots chunks that load\/unload too frequently<\/p>\n
### Interactive GUI System
\n– **Performance Dashboard** \u2014 live TPS, MSPT, heap with auto-refresh
\n– **Lag Analysis Page** \u2014 top 5 active players and suspect plugins with risk scores
\n– **Performance Drops Page** \u2014 browse up to 21 recent drops, click for detailed reports
\n– **Config GUI** \u2014 toggle all settings without touching files
\n– **AntiCheat GUI** \u2014 status overview, whitelist info, XRay settings
\n– Multi-page navigation, color-coded items, intuitive design<\/p>\n
### AntiCheat Module (Beta)
\n– **XRay Detection** \u2014 frequency analysis, ore\/stone ratio, per-ore thresholds, Y-level pattern analysis
\n– **Restricted World Zones** \u2014 instant alerts when ores are mined in protected worlds
\n– **Movement Checks** \u2014 speed, fly, and teleport detection with movement type awareness
\n– **Smart False-Positive Reduction** \u2014 lag compensation (sqrt-scaled), knockback immunity, potion effects, vehicle awareness
\n– **Bundled Alerts** \u2014 one summary in chat, full details via command
\n– **Whitelist System** \u2014 per-player UUIDs and LuckPerms groups<\/p>\n
> **Note:** The AntiCheat module is experimental. For production use, we recommend dedicated plugins like Matrix, Vulcan, or Spartan.<\/p>\n
### Silent Mode \/ Streamer Mode (New in v2.3.1)
\n– `\/perfsilent` \u2014 mute **all** alert notifications in chat
\n– `\/perfsilent xray` \/ `movement` \/ `performance` \u2014 mute individual categories
\n– `\/perfsilent list` \u2014 view your current preferences
\n– **Persistent** across server restarts
\n– Perfect for streamers, builders, or admins who don’t need constant notifications<\/p>\n
### Discord Webhook Integration
\n– Automatic notifications for TPS drops, high MSPT, heap warnings, packet floods, and AntiCheat alerts
\n– Color-coded embeds per alert type
\n– Configurable: choose exactly which events get reported
\n– Async HTTP requests \u2014 zero performance impact<\/p>\n
### Auto Entity Cleaner
\n– Priority-based removal: items > projectiles > monsters > animals
\n– Protects named entities, tamed animals, villagers, boss mobs
\n– Per-world and per-chunk limits
\n– Dry-run mode for safe testing before enabling<\/p>\n
### Additional Tools
\n– **World Statistics** (`\/worldstats`) \u2014 entities, chunks, density, trend analysis per world
\n– **Entity Analysis** (`\/entitystats`) \u2014 breakdown by category, hotspot detection
\n– **Chunk Statistics** (`\/chunkstats`) \u2014 load tracking, problematic chunks, thrashing
\n– **REST API** \u2014 JSON endpoints for Grafana\/Prometheus dashboards with API key auth
\n– **Auto Database Cleanup** \u2014 configurable retention (default: 30 days)
\n– **Multi-Language** \u2014 English & German, easily extensible<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description | Permission |
\n|———|————-|————|
\n| `\/perfstatus` | Live TPS, MSPT, heap data | `performance.status` |
\n| `\/perfhistory [min]` | Historical MSPT sparkline & stats | `performance.history` |
\n| `\/perfgui` | Open the interactive GUI | `performance.gui` |
\n| `\/perfreload` | Reload plugin configuration | `performance.admin` |
\n| `\/perfsilent [type]` | Toggle alert notifications | `performance.admin` |
\n| `\/perfdrops [#]` | View\/analyze performance drops | `performance.admin` |
\n| `\/worldstats [world]` | Per-world statistics | `performance.admin` |
\n| `\/entitystats [world]` | Entity analysis & hotspots | `performance.admin` |
\n| `\/chunkstats [sub]` | Chunk load tracking & problems | `performance.admin` |
\n| `\/xrayalerts [player]` | XRay suspicion alerts | `performance.admin` |
\n| `\/movealerts [player]` | Movement suspicion alerts | `performance.admin` |
\n| `\/xrayores [sub]` | Manage XRay ore exclusions | `performance.anticheat.manage` |
\n| `\/acwhitelist [sub]` | Manage AntiCheat whitelist | `performance.anticheat.manage` |<\/p>\n
—<\/p>\n
## Permissions<\/p>\n
| Permission | Description | Default |
\n|————|————-|———|
\n| `performance.status` | Use `\/perfstatus` | Everyone |
\n| `performance.history` | Use `\/perfhistory` | Everyone |
\n| `performance.gui` | Use `\/perfgui` | Everyone |
\n| `performance.admin` | Admin commands, alert notifications | OP |
\n| `performance.anticheat.manage` | Manage whitelist & ore exclusions | OP |
\n| `performance.anticheat.bypass` | Bypass all AntiCheat checks | false |<\/p>\n
—<\/p>\n
## Configuration Highlights<\/p>\n “`yaml “`yaml All thresholds are adjustable for your hardware:<\/p>\n “`yaml # Chunk thresholds (Standard | Powerful | Weak) # World thresholds “`yaml xray_thresholds: # Per-ore (rare = lower threshold) # Restricted zones: instant alerts in specific worlds Deepslate variants are automatically included.<\/p>\n<\/details>\n “`yaml speed_thresholds: Automatically accounts for: potions, soul speed, vehicles, elytra, riptide, swimming, climbing, knockback, and player ping.<\/p>\n<\/details>\n “`yaml “`yaml Endpoints: `\/api\/health`, `\/api\/metrics`, `\/api\/worlds`, `\/api\/trends` “`yaml —<\/p>\n ## Language Support<\/p>\n English and German included. Language files are in `plugins\/PerformanceAnalyzer\/lang\/` and fully customizable.<\/p>\n **Adding a new language:** —<\/p>\n ## Optional Dependencies<\/p>\n | Plugin | Benefit | All integrations are optional \u2014 the plugin works fully standalone.<\/p>\n —<\/p>\n ## Requirements<\/p>\n – **Java 21** —<\/p>\n ## Config Auto-Migration<\/p>\n When updating, your existing config is **never overwritten**. New settings are automatically added with sensible defaults. Just replace the JAR and restart.<\/p>\n —<\/p>\n ## Special Thanks<\/p>\n To **ELITEK3V** for testing.<\/p>\n","protected":false},"excerpt":{"rendered":" PerformanceAnalyzer gives you clear visibility into how your server is performing live and over time. With database-backed statistics, an in-game GUI, optional Discord alerts, and a helper-level AntiCheat\/X-Ray module, it\u2019s a handy toolkit for anyone.<\/p>\n","protected":false},"featured_media":120437,"template":"","meta":{"_minecraft_slug":"perfomanceanalyzer","_minecraft_project_id":"xcpph8Xo","_minecraft_author":"boondocksulfur","_minecraft_license":"MIT","_minecraft_downloads":383,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"perfomanceanalyzer.zip","_minecraft_size_bytes":165149475,"_minecraft_version_count":12,"_minecraft_updated_at":"2026-05-16T11:04:55.323161Z","_minecraft_date_created":"2025-11-23T05:12:50.378712Z","_minecraft_date_modified":"2026-05-07T08:25:37.467580Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/perfomanceanalyzer","_minecraft_icon_attachment_id":120437,"_minecraft_imported_at":"2026-06-07T02:05:57+00:00","_minecraft_import_hash":"707be101d518ba7466aaa0294680d90d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,90,127,128,129,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-120436","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","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"],"yoast_head":"\nDatabase (SQLite or MySQL)<\/summary>\n
\ndatabase:
\n type: sqlite # or ‘mysql’
\n sqlite_file: “plugins\/PerformanceAnalyzer\/perf.db”
\n retention_days: 30 # Auto-cleanup (0 = disabled)
\n pool:
\n max_pool_size: 10
\n minimum_idle: 2
\n“`<\/p>\n<\/details>\nPerformance Thresholds<\/summary>\n
\nthresholds:
\n mspt: 50.0 # MSPT warning (ms)
\n heap_usage_percent: 80.0 # Heap warning (%)
\n tps_drop: 19.0 # TPS drop warning
\n packet_flood_per_tick: 1000.0 # Packet flood detection
\n“`<\/p>\n<\/details>\nLag Analysis Thresholds<\/summary>\n
\nlag_analysis:
\n player_tracking: true
\n plugin_analysis: true
\n chunk_analysis_timeout_ms: 5000<\/p>\n
\n chunk_tile_entities_threshold: 10 # 10 | 20-30 | 5-8
\n chunk_redstone_threshold: 30 # 30 | 50-100 | 15-20
\n chunk_entity_warning: 50 # 50 | 80-100 | 30-40
\n chunk_entity_critical: 100 # 100 | 150-200 | 60-80<\/p>\n
\n world_entity_warning: 5000
\n world_entity_critical: 10000
\n“`<\/p>\n<\/details>\nAntiCheat \u2014 XRay Detection<\/summary>\n
\nanticheat:
\n xray_detection: true
\n xray_timewindow_seconds: 60
\n xray_stone_ore_ratio: 0.10 # Normal: 2-5%, Suspicious: >10%
\n ops_bypass: false
\n xray_excluded_ores: [] # e.g. [“COAL_ORE”, “IRON_ORE”]<\/p>\n
\n coal: 20
\n iron: 15
\n diamond: 6
\n emerald: 4
\n ancient_debris: 3<\/p>\n
\n restricted_worlds: [] # e.g. [“mining_world”]
\n restricted_world_ores: [] # e.g. [“DIAMOND_ORE”, “EMERALD_ORE”]
\n“`<\/p>\nAntiCheat \u2014 Movement Detection<\/summary>\n
\nanticheat:
\n movement_checks: true
\n speed_detection: true
\n fly_detection: true
\n teleport_detection: true<\/p>\n
\n walk: 0.5
\n sprint: 1.0
\n fly: 1.5
\n vertical: 3.5
\n teleport: 15.0
\n violations_before_alert: 5
\n fly_violations_before_alert: 10
\n“`<\/p>\nDiscord Webhook<\/summary>\n
\ndiscord:
\n enabled: false
\n webhook_url: “”
\n alert_types:
\n high_mspt: true
\n tps_drop: true
\n high_heap: true
\n packet_flood: true
\n anticheat: true
\n“`<\/p>\n<\/details>\nREST API<\/summary>\n
\napi:
\n enabled: false
\n port: 8080
\n key: “changeme” # IMPORTANT: Set a secure key!
\n“`<\/p>\n
\nAuthentication: `Authorization: Bearer Auto Entity Cleaner<\/summary>\n
\nentity_cleaner:
\n enabled: false
\n interval_seconds: 300
\n world_limit: 5000
\n chunk_limit: 100
\n dry_run: true # Test mode (logs only, no removal)
\n protect_villagers: true
\n protect_item_frames: true
\n blacklist: [“ENDER_DRAGON”, “WITHER”, “WARDEN”]
\n“`<\/p>\n<\/details>\n
\n1. Copy `en.yml` to your language code (e.g. `fr.yml`)
\n2. Translate all messages
\n3. Set `language: fr` in `config.yml`
\n4. Run `\/perfreload`<\/p>\n
\n|——–|———|
\n| spark | Accurate TPS (10s\/1m\/5m), MSPT (avg\/p95\/max), CPU monitoring |
\n| ProtocolLib | Packet analysis & flood detection |
\n| LuckPerms | Group-based AntiCheat whitelist |<\/p>\n
\n– **Paper 1.21.4 \u2013 1.21.x**
\n– Thread-safe, async operations, minimal performance overhead<\/p>\n