WebStats

插件

· 作者 kehlchen

此项目为网页添加了在线统计功能

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

最新 1.0.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

StatsWeb

StatsWeb 是一款轻量级、高性能的 Paper/Spigot 插件,可自动分析服务器上的玩家统计数据与成就,并通过内置的现代 Web 界面提供展示。

该插件直接基于 JDK 的轻量级 HTTP 服务器和虚拟线程构建,无需依赖外部 Web 服务器或复杂的数据库设置即可运行。


功能特性

  • 嵌入式 Web 服务器:开箱即用,在独立端口上运行,零配置要求。
  • 实时排行榜:动态排名涵盖挖掘方块数、击杀生物数、游戏时长、移动距离及自定义统计项。
  • 详细玩家档案:全面展示个人统计数据、已完成的进度(advancements)、全球排名及在线状态。
  • 自动数据解析:直接读取原生 Minecraft JSON 格式的统计数据与进度文件。
  • 高性能:采用异步后台文件加载与线程管理,确保对服务器 TPS(每秒刻数)无任何影响。
  • RESTful API:轻松以 JSON 格式获取服务器统计数据,便于用于外部仪表盘或 Discord 机器人。

命令与权限

命令

命令 描述 默认权限
/statsweb url 显示公共 Web 链接 所有玩家
/statsweb refresh 强制立即扫描统计文件 OP / Admin
/statsweb reload 重新加载 config.yml 并重启 Web 服务器 OP / Admin

权限

  • statsweb.use - 允许使用 /statsweb url
  • statsweb.admin - 允许使用 /statsweb refresh 和 /statsweb reload

REST API 端点

StatsWeb 提供了一个简单的只读 REST API,用于自定义集成:

  • GET /api/overview - 服务器概览,包括全服总统计、精选排行榜及在线玩家列表。
  • GET /api/players - 所有被追踪玩家的列表及其关键指标。
  • GET /api/player/{name|uuid} - 单个玩家的完整统计详情、进度列表及各统计项的全球排名。
  • GET /api/leaderboard?stat={category/stat}&limit={count} - 任意特定统计键的全球排名。
  • GET /api/catalog - 世界文件中存在的所有统计类别列表。

配置

默认的 config.yml 允许对服务器品牌标识、端口绑定、扫描间隔以及首页精选统计项进行全面定制:

web:
  bind-address: "0.0.0.0"
  port: 8080
  public-url: "http://localhost:8080"
  cors: false
  update-default-files: true

refresh:
  interval-seconds: 60
  save-online-players: true

display:
  server-name: "Minecraft Server"
  default-leaderboard: "custom/play_time"
  featured-size: 5
  featured:
    - "custom/play_time"
    - "total/mined"
    - "custom/deaths"
    - "custom/mob_kills"

data:
  stats-dir: "auto"
  advancements-dir: "auto"
  min-playtime-minutes: 0
  hide-inactive-days: 0
  exclude-recipe-advancements: true
  ignore-uuids: []

安装指南

  1. 将 StatsWeb.jar 放入服务器的 plugins/ 目录中。
  2. 启动服务器,将在 plugins/StatsWeb/ 目录下生成默认配置文件及 Web 前端文件。
  3. 在 plugins/StatsWeb/config.yml 中配置 web.port 和 web.public-url。
  4. 如有必要,请在防火墙或主机设置中开放指定的 Web 端口。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源