SyAPI

插件

· 作者 Shiyuan

为其他插件的开发提供一些晦涩的 API

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

最新 1.0.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)

SyAPI

SyAPI 是一款适用于 Minecraft Purpur/Paper 1.21.1 的服务器统计 API 插件,提供服务器运行状态、玩家统计数据等功能。

功能特性

  • ? 服务器在线时长统计
  • ? 昨日登录人数统计
  • ? 历史最高在线人数记录
  • ? 总登录次数统计
  • ⚡ 服务器最低 TPS 监控
  • ? 玩家延迟检测(最高延迟玩家)

支持版本

  • 服务端:Paper, Purpur 1.21.1
  • Java 版本:Java 17+
  • API 版本:1.21

使用方法

命令

命令 描述 权限节点
/syapi 查看服务器统计数据 syapi.use
/syapi info 查看服务器统计数据 syapi.use
/syapi reload 重载插件配置 syapi.admin
/syapi help 显示帮助信息 syapi.use

API 调用

其他插件可以通过以下方式调用 SyAPI:

import cn.shiyuan.syapi.SyAPI;
import cn.shiyuan.syapi.SyAPIProvider;

// 获取 API 实例
SyAPI syapi = SyAPI.getInstance();
SyAPIProvider api = syapi.getApiProvider();

// 获取服务器启动时间
long startTime = api.getServerStartTimeMillis();
String uptime = api.getServerUptime();
String startTimeFormatted = api.getServerStartTimeFormatted();

// 获取玩家统计数据
int yesterdayJoins = api.getYesterdayJoinCount();
int maxOnline = api.getMaxOnlinePlayers();
int totalJoins = api.getTotalJoinCount();

// 获取服务器性能数据
double minTps = api.getMinTps();

// 获取延迟信息
Player highestLatencyPlayer = api.getHighestLatencyPlayer();
String playerName = api.getHighestLatencyPlayerName();
long highestLatency = api.getHighestLatency();
long playerLatency = api.getPlayerLatency(player);

API 方法参考

服务器时间相关

方法 返回值类型 描述
getServerStartTimeMillis() long 获取服务器启动时间戳(毫秒)
getServerUptime() String 获取服务器在线时长(格式化字符串,例如 "2 days 5 hours 30 minutes")
getServerStartTimeFormatted() String 获取服务器启动时间(格式化日期,例如 "2026-04-03 12:30:00")

玩家统计相关

方法 返回值类型 描述
getYesterdayJoinCount() int 获取昨日登录人数(独立玩家数)
getMaxOnlinePlayers() int 获取历史最高在线人数
getTotalJoinCount() int 获取总登录次数

服务器性能相关

方法 返回值类型 描述
getMinTps() double 获取服务器最低 TPS
getHighestLatencyPlayer() Player 获取延迟最高的玩家对象
getHighestLatencyPlayerName() String 获取延迟最高玩家的名称
getHighestLatency() long 获取最大延迟值(毫秒)
getPlayerLatency(Player player) long 获取指定玩家的延迟值(毫秒)

项目结构

SyAPI/
├── src/
│   └── main/
│       ├── java/cn/shiyuan/syapi/
│       │   ├── SyAPI.java              # 主类
│       │   ├── SyAPIProvider.java      # API 提供者
│       │   ├── StatsManager.java       # 统计管理器
│       │   ├── PlayerListener.java     # 玩家事件监听器
│       │   └── SyAPICommand.java       # 命令处理器
│       └── resources/
│           ├── plugin.yml              # 插件配置
│           └── data.yml                # 数据存储
├── pom.xml                             # Maven 配置
└── README.md                           # 文档说明

权限节点

权限节点 描述 默认赋予
syapi.admin 管理员权限(重载等) OP
syapi.use 使用权限(查看统计) 所有玩家

数据存储

插件使用 YAML 文件存储数据,位于 plugins/SyAPI/data.yml:

  • total-join-count: 总登录次数
  • max-online-players: 历史最高在线人数
  • yesterday-join-count: 昨日登录人数
  • today-join-count: 今日登录人数(每日自动重置)
  • current-date: 当前日期
  • yesterday-players: 昨日玩家 UUID 列表

定时任务

插件在启动后会自动执行以下定时任务:

  • TPS 监控:每秒更新最低 TPS
  • 延迟更新:每秒更新玩家延迟数据
  • 日期检查:每分钟检查日期变化,自动重置今日统计数据
  • 数据保存:每 5 分钟自动将数据保存到文件

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源