1 / 3Built interface — Overview
Overview
Server Analytics answers the questions a server owner asks after the launch weekend: who came back, when the server is busiest, which world people spend their evenings in, and what the TPS was doing when the complaints started. A Paper plugin records the events into its own database tables, and a small web report you run on your own hosting reads them back as cohorts, charts and heatmaps.
Retention is the centre of the report. Every new player joins a weekly cohort, and the report shows what share of that cohort returned after one day, seven days and thirty days. Playtime is broken down by rank, by world and by hour of the day, so a peak-hours chart tells you when staff need to be online and when a restart costs the fewest people.
Performance history sits beside the player data. TPS, MSPT and loaded chunk counts are sampled every minute and kept for ninety days, with markers for restarts and plugin reloads. A world activity heatmap plots where players actually stand, block by region, which is how you find the abandoned mall build or the redstone farm that eats a core.
Join sources are recorded from the server list ping and the hostname players connected through, so a Velocity network can see which forced host or listing brought people in. A weekly summary is posted to a Discord channel through a webhook. The plugin, the report and the SQL schema are delivered as files, with revisions while you are subscribed.
What you get
- Paper plugin that records joins, sessions, deaths, world changes and commands
- Self-hosted web report with cohorts, charts and heatmaps you run on your own hosting
- Retention cohorts by join week with one, seven and thirty day return rates
- Peak hours and playtime charts split by rank, world and hour
- TPS, MSPT and chunk load history with restart markers, kept for ninety days
- World activity heatmaps rendered per region from player positions
- Join source tracking from hostnames and forced hosts on a proxy
- Weekly summary posted to Discord through a webhook you create
Eligible resources
The plan covers these resource types. Individual resources are listed in your Gaming Library as they publish.
- Analytics plugin
- Web report
- SQL schema
- Report templates
- Discord summary
Features
- Cohorts, not totals
- A unique join count hides churn, so the report groups players by join week and shows how many of each week came back.
- Performance with context
- TPS and chunk history carry markers for restarts and reloads, so a dip can be matched to what changed rather than guessed at.
- Your database, your data
- Events stay in tables on your own MySQL or SQLite, and the web report reads them from hosting you control.
Compatibility and requirements
Works with
- Paper or Purpur 1.20.x and 1.21.x
- MySQL or SQLite for storage
- Velocity proxy for join source and forced host data
- PlaceholderAPI placeholders for playtime and session count
You need
- A Paper or Purpur server you control
- Node.js hosting for the web report, a VPS or a home machine
- A Discord webhook for the weekly summary, optional
Updates and content cadence
- The plugin, the report and the schema from your first day
- Report revisions and new charts published as they are written
- Plugin updates for each Paper release while subscribed
License
- Licensed for one server network you own or operate.
- You may edit, re-texture and configure resources for that network.
- Reselling, sharing or re-uploading the files is not permitted.
Installation
- 1Download Server Analytics from your Gaming Library.
- 2Drop the plugin jar into your plugins folder and set the database in config.yml.
- 3Restart the server so the plugin creates its tables.
- 4Deploy the report folder with npm install and point its .env at the same database.
If you cancel
- Access and updates continue until the end of the period you paid for.
- The licence to run the plugin and report ends with the subscription.
- Remove the plugin from live servers once access ends; your database tables stay with you.
More from DistroSource Gaming
Browse all
3MinecraftPlugins
Plugin Suite
Crates, shops, custom enchants and GUI menus for Minecraft servers, maintained for new game versions.
- Plugins
- Crates
- Shops
View details$95/mo
Subscription
3MinecraftPlugins
Quest & Battlepass Pack
Written quest chains, daily objectives and a configured battlepass with reward tiers — a new season of content every month.
- Quests
- Battlepass
- Monthly drop
View details$86/mo
Subscription
3MinecraftPlugins
Custom Items Forge
A Paper plugin and resource pack that add custom items without mods, using custom model data for weapons, armour, consumables and furniture, with a crafting GUI and ItemsAdder and Oraxen compatibility.
- Custom items
- Paper
- Update plan
View details$16/mo
Subscription
$11/mo
Server Analytics
