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 urlstatsweb.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: []
安装指南
- 将
StatsWeb.jar放入服务器的plugins/目录中。 - 启动服务器,将在
plugins/StatsWeb/目录下生成默认配置文件及 Web 前端文件。 - 在
plugins/StatsWeb/config.yml中配置web.port和web.public-url。 - 如有必要,请在防火墙或主机设置中开放指定的 Web 端口。
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
28
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
旅行地图
mysticdrew
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
冒险实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧