PerformanceAnalyzer

## Why PerformanceAnalyzer? Most monitoring plugins tell you *that* your server is lagging. PerformanceAnalyzer tells you **why**. When a TPS drop or MSPT spike occurs, the plugin automatically captures a full snapshot of your server state — loaded chunks, entity counts, player activity, suspect plugins — so you can diagnose the problem instantly instead of guessing. > ### ⚡ New in v3.0.0 > - **AntiCheat is now its own plugin.** PerformanceAnalyzer is now a focused, pure performance monitor. The XRay/Movement detection lives on in the standalone **BSAntiCheat** plugin — install it alongside PerformanceAnalyzer and the GUI will link the two together automatically. > - **Per-second drop detection** — performance drops are now sampled every second (decoupled from the database logging interval), so short-lived spikes are no longer missed. > - **REST API is live** — JSON endpoints for Grafana/Prometheus dashboards. > - **Developer API** — other plugins can read live TPS/MSPT/heap/entity data. --- ## Key Features ### Real-Time Performance Monitoring - **TPS, MSPT & Heap** tracking with historical data and ASCII sparklines - **Spark Integration** for highly accurate TPS (10s/1m/5m), MSPT (avg/p95/max), and CPU data - **ProtocolLib Integration** for packet analysis and flood detection - **Database Logging** (SQLite or MySQL) with async batch writes via HikariCP - **Fallback File Logging** — if the database goes down, metrics are written to a file instead of being lost ### Automatic Lag Diagnosis - **Performance Drop Detection** — triggers automatically when TPS drops or MSPT spikes, sampled every second - **Full Server Snapshots** — captures chunks, entities, memory, and player locations at the moment of the drop - **Accurate Low/High Tracking** — reports the actual worst TPS/MSPT seen during the drop window - **Lag Source Analysis** — identifies the players and plugins most likely responsible - **Problematic Chunk Detection** — finds chunks overloaded with tile entities or redstone - **Chunk Thrashing Detection** — spots chunks that load/unload too frequently - **Throttled & quiet** — the expensive deep analysis is rate-limited and stays out of the console unless debug mode is on, so the diagnostics never make the lag worse ### Interactive GUI System - **Performance Dashboard** — live TPS, MSPT, heap with auto-refresh - **Lag Analysis Page** — top 5 active players and suspect plugins with risk scores - **Performance Drops Page** — browse up to 21 recent drops, click for detailed reports - **Config GUI** — toggle settings without touching files - **Companion detection** — shows BSAntiCheat status when the AntiCheat plugin is installed - Multi-page navigation, color-coded items, intuitive design ### Silent Mode / Streamer Mode - `/perfsilent` — mute **all** alert notifications in chat - `/perfsilent performance` — mute just the performance alert category - `/perfsilent list` — view your current preferences - `/perfsilent reset` — receive all alerts again - **Persistent** across server restarts - Perfect for streamers, builders, or admins who don't need constant notifications ### Discord Webhook Integration - Automatic notifications for TPS drops, high MSPT, heap warnings, and packet floods - Color-coded embeds per alert type - Configurable: choose exactly which events get reported - Async, rate-limited HTTP requests — zero performance impact - SSRF-protected: only valid Discord webhook URLs are accepted ### Auto Entity Cleaner - Priority-based removal: items > projectiles > monsters > animals - Protects named entities, tamed animals, villagers, and boss mobs - Per-world and per-chunk limits - Dry-run mode for safe testing before enabling ### Additional Tools - **World Statistics** (`/worldstats`) — entities, chunks, density, trend analysis per world - **Entity Analysis** (`/entitystats`) — breakdown by category, hotspot detection - **Chunk Statistics** (`/chunkstats`) — load tracking, problematic chunks, thrashing - **REST API** — JSON endpoints for Grafana/Prometheus dashboards with API key auth - **Developer API** — `PerformanceAPI` for other plugins to read live metrics - **Auto Database Cleanup** — configurable retention (default: 30 days) - **Multi-Language** — English & German, easily extensible --- ## Commands | Command | Description | Permission | |---------|-------------|------------| | `/perfstatus` | Live TPS, MSPT, heap data | `performance.status` | | `/perfhistory ` | Historical MSPT sparkline & stats | `performance.history` | | `/perfgui` | Open the interactive GUI | `performance.gui` | | `/perfreload` | Reload plugin configuration | `performance.admin` | | `/perfsilent ` | Toggle alert notifications (streamer mode) | `performance.admin` | | `/perfdrops ` | View/analyze performance drops | `performance.admin` | | `/worldstats ` | Per-world statistics (alias `/ws`) | `performance.admin` | | `/entitystats ` | Entity analysis & hotspots (alias `/es`) | `performan