Skip to main content
CatalystAnalytics is a Paper and Purpur plugin bundled with Catalyst. When enabled during server creation, Catalyst copies the plugin JAR into plugins/. The plugin writes a local analytics JSON file that Catalyst reads from the desktop app.
CatalystAnalytics is file-based in the current app integration. It does not require you to expose an HTTP API for Catalyst to read analytics.

​
Enable analytics

1

Create a Paper or Purpur server

Analytics installation is offered only for platforms that can run Bukkit-style plugins.
2

Turn on CatalystAnalytics

Leave the analytics toggle enabled during creation.
3

Start the server

The plugin creates plugins/CatalystAnalytics/config.yml and writes data under plugins/CatalystAnalytics/data/.
4

Open Analytics

Use the server detail analytics tab or the global Analytics page. Catalyst polls analytics while the app is open.

​
Dashboard sections

Online players, peak online, unique players, average playtime, uptime, joins, new players, deaths, and a player-count timeline.

​
Tracking settings

The analytics tab displays the plugin tracking configuration in read-only form. Edit the plugin config file when you need to change collection behavior:
Common settings include player joins, playtime, client versions, client brands, operating system, TPS, RAM, FPS, and optional geolocation.
Geolocation is disabled by default. If enabled, the plugin can call the configured geolocation provider for player IP metadata. Review your privacy obligations before turning it on.

​
Commands

The plugin registers:
The command permission is catalystanalytics.admin and defaults to server operators.