ASPA
(Advanced Server Performance Analysis)
ASPA is a Spigot plugin that turns your server into a performance analytics platform. It continuously captures live health metrics, player session behavior, and long-term trends, then serves a built-in web dashboard and REST API for actionable insights.
This is a beta (snapshot) release. Expect rapid iteration, incomplete features, and potential breaking changes.
Contributions
Contributions to development are welcome. Feel free to me out on GitHub.
Key Features
- Live server health: TPS, MSPT, CPU, RAM, GC, ping, entities, and loaded chunks
- Historical metrics with anomaly detection and correlated factor analysis
- Player analytics: retention cohorts, punchcard heatmaps, geographic distribution, and session stats
- Forecasting engine for peak player activity windows
- Embedded web dashboard with authentication and user/role permissions
- Optional Pterodactyl integration (power actions, console commands, backups)
- Flexible storage: SQLite, MySQL, or MongoDB
- GeoIP support (MaxMind) for country/timezone insights
How It Works
ASPA runs as a single plugin that collects metrics at a configurable interval, stores them in a database, and exposes them through a local HTTP server. The web UI is served directly from the plugin, so no separate web host is required.
Commands and Permissions
- /aspa [reload|status|token]
- Permission: aspa.admin (default: op)
Setup Notes
- Install the plugin and start the server once to generate the default config.
- Configure your database and API token in config.yml.
- (Optional) Add GeoLite2-City.mmdb to the plugin data folder for GeoIP.
- (Optional) Enable Pterodactyl integration and set credentials.
Compatibility
- Spigot/Paper 1.20+
- Java 21+
Beta Disclaimer
This snapshot build is intended for testing and feedback purposes. Please ensure you use backups, as configuration or database changes are to be expected as the project matures. Note that this version and description may not always reflect the current state of development.
