Spark Web API

插件

· 作者 lines-of-codes

Spark 的 Web API

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

需要前置:spark

最新 1.0.2 · 1.21.11 · Paper

一键开服(送7天)

Spark Web API

一个用于托管 Spark Web API 的小型插件。

此插件专为 Paper 制作。您可以自由地在 GitHub 上 Fork 该项目,并将其移植到其他模组加载器。

本 README 是项目 GitHub README 的简化版本。

安装

首先,在您的 Paper 服务器上安装 Spark。 尽管 Minecraft 1.21 及更高版本的 Paper 服务器已内置 Spark,但此插件仍需独立的插件版本。

然后,安装 Spark Web API。通常您应下载文件名以 -all 结尾的 JAR 文件。

启动服务器时,请务必将 paper.preferSparkPlugin 系统属性设置为 true。

以下是操作示例:

java -Dpaper.preferSparkPlugin=true -jar paper-1.21-129.jar

配置

首次使用该插件启动服务器时,插件会生成一个配置文件。 配置文件允许您更改服务器的端口、启用的路由以及向响应中添加额外的标头。

port: 3000
routes:
  tps: true
  mspt: true
  sys_cpu: false
  proc_cpu: false
  gc: false
headers:
  enabled: false

API 路径

/api/tps

返回过去 10 秒、1 分钟、5 分钟和 15 分钟的 TPS(每秒刻数)。

示例响应:

{
  "tenSeconds": 19.999926688268733,
  "oneMinute": 20.000035730063832,
  "fiveMinutes": 20.00000458740105,
  "fifteenMinutes": 19.94021043987079
}

如果 Spark 无法获取服务器的 TPS,此路由将返回 500 Internal Server Error。

/api/mspt

返回过去 10 秒和 1 分钟的 MSPT(每刻毫秒数)值。

示例响应:

{
  "tenSeconds": {
    "min": 6.523605,
    "max": 2692.747083,
    "mean": 66.92731750515465,
    "median": 23.108289
  },
  "oneMinute": {
    "min": 6.523605,
    "max": 2692.747083,
    "mean": 66.92731750515465,
    "median": 23.108289
  }
}

如果 Spark 无法获取服务器的 MSPT,此路由将返回 500 Internal Server Error。

/api/gc

返回有关垃圾回收器的信息。

示例响应:

{
  "G1 Young Generation": {
    "name": "G1 Young Generation",
    "frequency": 22328,
    "avgTime": 81,
    "totalCollections": 3,
    "totalTime": 243
  },
  "G1 Old Generation": {
    "name": "G1 Old Generation",
    "frequency": 0,
    "avgTime": 0,
    "totalCollections": 0,
    "totalTime": 0
  }
}

/api/cpu/sys

返回系统 CPU 使用率(百分比)。

示例响应:

{
  "tenSeconds": 0.20461582280862525,
  "oneMinute": 0.31800215079510524,
  "fifteenMinutes": 0.39118254849183964
}

/api/cpu/proc

返回 Minecraft 进程的 CPU 使用率(百分比)。

示例响应:

{
  "tenSeconds": 0.025064927938294894,
  "oneMinute": 0.030417615615548597,
  "fifteenMinutes": 0.06684861042724896
}

许可证

本插件根据 MIT License 授权。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源