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 分钟自动将数据保存到文件
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
46
Beds Always Explode
rabiesland
使床在所有维度中爆炸的模组
诅咒玩法机制
30
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧