PinnacleStats

PinnacleStats is a Paper plugin that reads Minecraft's saved player statistics and turns them into structured JSON for websites, dashboards, and other integrations.

New to Minecraft plugins or website setup? Follow the complete step-by-step setup guide. It covers installation, GitHub Pages, other static website hosts, and the optional live API.

It can:

• Cache statistics for every player with a saved statistics file.
• Create local static JSON files that can be served by a website.
• Publish the generated files to a GitHub repository in one commit.
• Provide an optional read-only HTTP API.
• Refresh automatically, when a player leaves, when the server stops, or through commands.

PinnacleStats does not modify player statistics or gameplay.

Requirements

• A Paper server compatible with the plugin release.
• Java 25 for Paper 26.2 releases.
• Operator access or the pinnaclestats.admin permission for administrative commands.
• A GitHub token only if GitHub publishing is enabled.

Installation

1. Download the latest PinnacleStats JAR from the repository's Releases page.
2. Stop the Minecraft server.
3. Place the JAR in the server's plugins/ directory.
4. Start the server once to generate plugins/PinnacleStats/config.yml.
5. Review the statistics path and export settings.
6. Run /pstats status in-game or from the console.

The default configuration works as a local JSON exporter. The HTTP API and GitHub publishing are disabled until explicitly configured.