PlayerStats API 是一款轻量且稳定的 Minecraft 1.21.x Paper 插件,通过简洁高效的 HTTP / REST API 暴露 原版玩家统计数据。
该插件专为外部集成设计,例如 Web 仪表盘、分析服务、监控工具和自定义前端。
功能特性
- ? 从
world/stats/*.json读取原版玩家统计数据 - ? 支持 在线和离线 玩家
- ? 可通过 UUID 或玩家名称 获取统计数据
- ? 提供聚合摘要(游戏时长、死亡次数、击杀数、移动距离等)
- ? 内置带有 REST 端点的 HTTP 服务器
- ⚡ 数据缓存以提升性能
- ? 仅使用公开的 Bukkit / Paper API(无 NMS,无 CraftBukkit)
兼容性
- Minecraft / Paper: 1.21.x (1.21, 1.21.1 … 1.21.11)
- Java: 21
- 服务端类型: Paper
该插件基于 稳定版 Paper API 1.21 分支 构建,不绑定特定补丁版本,确保与所有 1.21.x 发行版的兼容性。
配置
StatsPlugin 使用简单的 YAML 配置文件来控制:
- HTTP 服务器端口
- 启用/禁用 Web 服务器
- 用于读取统计数据的存档路径
更改配置后无需重新编译。
API 端点
基础 URL 示例:
http://localhost:8080
? 获取所有玩家
GET /players
返回包含基本汇总统计信息的玩家列表。
按名称获取玩家摘要
GET /players/{playerName}
示例:
GET /players/Notch
按 UUID 获取玩家摘要
GET /players/uuid/{uuid}
示例:
GET /players/uuid/069a79f4-44e9-4726-a5be-fca90e38aaf5
获取完整原始统计数据
GET /players/{playerName}/stats
返回从 stats JSON 文件解析出的完整原版统计数据。
端点路径可能因配置和版本略有不同。 请参阅项目 README 以获取最新列表。
安装
- 下载插件 JAR 文件
- 将其放入
plugins/文件夹 - 启动服务器
- 如有需要,调整
config.yml
稳定性与安全性
- 不使用 NMS 或 CraftBukkit
- 在所有 Paper 1.21.x 更新中安全运行
- 不将 Paper API 嵌入最终 JAR 包
- 在服务器关闭时正确清理资源
应用场景
如果您有以下需求,PlayerStats API 非常适合:
- 构建 基于 Web 的玩家统计仪表盘
- 收集并可视化 服务器分析数据
- 需要以编程方式访问原版统计数据
- 围绕 Minecraft 服务器开发外部服务
截图与示例
TODO
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
- Download the plugin JAR file
- Place it into the
plugins/folder - Start the server
- Adjust
config.ymlif 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
下载 PlayerStats API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerStats API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerStats API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerStats API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerStats API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerStats API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerStats API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerStats API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
- 更新至 26.2
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧