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.
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.1, 1.20.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as ASPA-0.0.8.jar — drop this file into the mods folder
- Download size: 38.2 MB
- Download link checked 24 Aug 2026 — working
These come from our own check of the pack file, not from the source page.