Logo
MINECRAFTBIBLE
Items
Items

All game items

Blocks
Blocks

Building blocks

Mobs
Mobs

Creatures & monsters

Biomes
Biomes

World biomes

Structures
Structures

Generated structures

Recipes
Recipes

Crafting guides

Advancements
Advancements

Achievements

Loot Tables
Loot Tables

Drop rates

Tags
Tags

Item groupings

All Versions
View all data →
Capes
Cape ArchiveNEW

Browse rare Minecon capes, OptiFine capes, and custom capes from players worldwide

Browse

Player Database
Player DatabasePopular

Search any player

Skin Browser
Skin Browser

Browse & download skins

Cape Gallery
Cape GalleryNEW

Minecon & OptiFine capes

Seed Vault
Seed Vault

Curated seeds

Learn

Guides
GuidesNew

Tutorials & tips

Blog
Blog

News & updates

Community

Community Hub
Community HubHub

Posts, discussions & more

All Versions
View community →
Seed Analyzer
Seed Analyzer

World seed analysis

Loot Explorer
Loot Explorer

Drop rates

Crafting Calculator
Crafting Calculator

Material planning

Enchant Calculator
Enchant Calculator

Probability math

Redstone Lab
Redstone Lab

Signal timing

Trading Profit
Trading Profit

Villager ROI

All Versions
View all tools →
Mods
Mods

Browse all mods

Plugins
Plugins

Server plugins

Resource Packs
Resource Packs

Textures & sounds

Shaders
Shaders

Visual enhancements

Datapacks
Datapacks

World logic

Scanner
Mod Intelligence

Scan & analyze any mod

All Versions
View all mods →
Loading...
IntroductionIntroductionVersion HistoryVersion HistoryGuidesGuidesBlog & NewsBlog & News
ItemsItemsBlocksBlocksMobsMobsRecipesRecipesBiomesBiomesStructuresStructuresAdvancementsAdvancementsLoot TablesLoot TablesTagsTags
ModsModsPluginsPluginsResource PacksResource PacksShadersShadersDatapacksDatapacks

MinecraftBible

The Ultimate Wiki

Logo
MINECRAFTBIBLE

The ultimate Minecraft reference. Every item, block, mob, and recipe documented with precision.

Community

  • Player Database
  • Skin Browser
  • Cape Gallery
  • Community Hub
  • Seed Vault

Database

  • Items
  • Blocks
  • Mobs
  • Recipes
  • Biomes
  • Structures

Tools

  • Seed Analyzer
  • Mod Intelligence
  • Crafting Calculator
  • Enchant Calculator

Mods & Packs

  • Mods
  • Plugins
  • Resource Packs
  • Shaders
  • Datapacks

© 2026 MinecraftBible. Not affiliated with Mojang or Microsoft.

PrivacyTermsContact
PlayerStats API
PluginMIT

PlayerStats API

Lightweight vanilla player statistics via REST API for Paper servers

308
Downloads
10
Followers
1 months ago
Updated
📦
7
Versions
managementtechnologyutilitybukkitpaperpurpurspigot
Download Latestv2.1.3View on Modrinth

📖About PlayerStats API

PlayerStats API is a lightweight and stable Paper plugin for Minecraft 1.21.x that exposes vanilla player statistics via a simple and efficient HTTP / REST API.

The plugin is designed for external integrations such as web dashboards, analytics services, monitoring tools, and custom frontends.


Features

  • 📊 Reads vanilla player statistics from world/stats/*.json
  • 🧍 Supports online and offline players
  • 🔍 Fetch statistics by UUID or player name
  • 📈 Provides aggregated summaries (playtime, deaths, kills, distance, etc.)
  • 🌐 Built-in HTTP server with REST endpoints
  • ⚡ Data caching for improved performance
  • 🔒 Uses only public Bukkit / Paper API (no NMS, no CraftBukkit)

Compatibility

  • Minecraft / Paper: 1.21.x (1.21, 1.21.1 … 1.21.11)
  • Java: 21
  • Server type: Paper

The plugin is built against the stable Paper API 1.21 branch and is not tied to patch-specific versions, ensuring compatibility across all 1.21.x releases.


Configuration

StatsPlugin uses a simple YAML configuration file to control:

  • HTTP server port
  • Enabling / disabling the web server
  • World path for reading statistics

No rebuild is required after configuration changes.


API Endpoints

Base URL example: http://localhost:8080

🔹 Get all players

GET /players

Returns a list of players with basic summary statistics.


Get player summary by name

GET /players/{playerName}

Example:

GET /players/Notch

Get player summary by UUID

GET /players/uuid/{uuid}

Example:

GET /players/uuid/069a79f4-44e9-4726-a5be-fca90e38aaf5

Get full raw statistics

GET /players/{playerName}/stats

Returns the full vanilla statistics parsed from the stats JSON file.


Endpoint paths may slightly vary depending on configuration and version.
Always refer to the project README for the most up-to-date list.


Installation

  1. Download the plugin JAR file
  2. Place it into the plugins/ folder
  3. Start the server
  4. Adjust config.yml if needed

Stability & Safety

  • No usage of NMS or CraftBukkit
  • Safe across all Paper 1.21.x updates
  • Does not embed Paper API into the final JAR
  • Proper resource cleanup on server shutdown

Use cases

PlayerStats API is suitable if you:

  • Build a web-based player statistics dashboard
  • Collect and visualize server analytics
  • Need programmatic access to vanilla statistics
  • Develop external services around your Minecraft server

Screenshots & Examples

TODO

👥 Team & Contributors

AREKKUZZERA
AREKKUZZERAOwner

⚙️ Compatibility

Environment
🖥️ Server-side
Loaders
bukkitpaperpurpurspigot
Minecraft Versions
1.211.21.11.21.21.21.31.21.41.21.51.21.61.21.7+4 more

🔗 Links

Modrinth Page