PlayerStats API

插件

· 作者 AREKKUZZERA

通过 REST API 为 Paper 服务器提供轻量级原版玩家统计

0 本站下载 0 关注 更新于 2 个月前

最新 2.2.0 · 26.2 · Bukkit / Paper

一键开服(送7天)

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 以获取最新列表。


安装

  1. 下载插件 JAR 文件
  2. 将其放入 plugins/ 文件夹
  3. 启动服务器
  4. 如有需要,调整 config.yml

稳定性与安全性

  • 不使用 NMS 或 CraftBukkit
  • 在所有 Paper 1.21.x 更新中安全运行
  • 不将 Paper API 嵌入最终 JAR 包
  • 在服务器关闭时正确清理资源

应用场景

如果您有以下需求,PlayerStats API 非常适合:

  • 构建 基于 Web 的玩家统计仪表盘
  • 收集并可视化 服务器分析数据
  • 需要以编程方式访问原版统计数据
  • 围绕 Minecraft 服务器开发外部服务

截图与示例

TODO

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源