PinnacleStats

PinnacleStats is a lightweight statistics plugin for Paper 26.3 that turns Minecraft's built-in player statistics into clean, easy-to-use data for websites, dashboards, and other tools.

It reads the vanilla statistics Minecraft already saves, so players do not need to install anything and servers do not need a separate statistics database.

What's New in 1.1.1

Version 1.1.1 focuses on reliability, safer data handling, and keeping PinnacleStats running smoothly over time.

• Cleaner exports — old player files are handled more safely when players are renamed or removed.
• More reliable API — improved connection handling helps prevent stalled or excessive requests from tying up the API.
• Safer data processing — malformed, oversized, or unusually complex JSON data is rejected before it can cause problems.
• Better background stability — API workers, shutdowns, and reloads are handled more cleanly.

Overall, 1.1.1 is a stability-focused update designed to make PinnacleStats more dependable for servers that keep it running continuously.

What Does PinnacleStats Do?

PinnacleStats reads each player's normal Minecraft statistics and converts them into organized player profiles.

It can provide information such as:

• Playtime
• Deaths and kills
• Distance traveled
• Blocks mined
• Items used and crafted
• Mobs killed
• Fishing, breeding, and trading activity
• Other statistics already recorded by Minecraft

The plugin automatically keeps this information refreshed as players use the server.

Use Your Stats Anywhere

PinnacleStats gives server owners several ways to use their player data.

Local JSON Export
Player statistics can be exported as JSON files directly on the server.

Built-in API
An optional HTTP API allows websites or other applications to request current player statistics directly from the server.

GitHub Publishing
PinnacleStats can automatically publish generated statistics to a GitHub repository, making it useful for GitHub Pages and other static websites.

This means you can build a public server statistics page without needing a database or a complicated web backend.

Designed for Server Owners

PinnacleStats is designed to work quietly in the background.

• Uses Minecraft's existing vanilla statistics
• No client-side mods required
• Automatic stat refreshing
• Optional local exports
• Optional HTTP API
• Optional GitHub publishing
• Player-name tracking
• Configurable privacy options
• Safe export cleanup
• Built for Java 25 and Paper 26.3

You can use only the features you need and leave the rest disabled.

Great For

PinnacleStats works well for:

• SMP websites
• Player profile pages
• Statistics dashboards
• Community leaderboards
• Server history pages
• Static websites hosted through GitHub Pages or similar services

Whether you only want simple exported player data or a full website powered by your server's statistics, PinnacleStats provides the data in a clean format without requiring a separate database.