SyAPI

SyAPI is a server statistics API plugin for Minecraft Purpur/Paper 1.21.1, providing server runtime status, player statistics, and more.

Features

• 📊 Server uptime statistics
• 📈 Yesterday's login count statistics
• 👥 Historical maximum online players record
• 📝 Total login count statistics
• ⚡ Server minimum TPS monitoring
• 🌐 Player latency detection (highest latency player)

Supported Versions

• Server: Paper, Purpur 1.21.1
• Java Version: Java 17+
• API Version: 1.21

Usage

Commands

Command	Description	Permission
/syapi	View server statistics	syapi.use
/syapi info	View server statistics	syapi.use
/syapi reload	Reload plugin configuration	syapi.admin
/syapi help	Display help information	syapi.use

API Usage

Other plugins can call SyAPI in the following way:

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

// Get API provider
SyAPI syapi = SyAPI.getInstance();
SyAPIProvider api = syapi.getApiProvider();

// Get server start time
long startTime = api.getServerStartTimeMillis();
String uptime = api.getServerUptime();
String startTimeFormatted = api.getServerStartTimeFormatted();

// Get player statistics
int yesterdayJoins = api.getYesterdayJoinCount();
int maxOnline = api.getMaxOnlinePlayers();
int totalJoins = api.getTotalJoinCount();

// Get server performance data
double minTps = api.getMinTps();

// Get latency information
Player highestLatencyPlayer = api.getHighestLatencyPlayer();
String playerName = api.getHighestLatencyPlayerName();
long highestLatency = api.getHighestLatency();
long playerLatency = api.getPlayerLatency(player);

API Method Reference

Server Time Related

Method	Return Value	Description
getServerStartTimeMillis()	long	Get server start timestamp (milliseconds)
getServerUptime()	String	Get server uptime (formatted string, e.g., "2 days 5 hours 30 minutes")
getServerStartTimeFormatted()	String	Get server start time (formatted date, e.g., "2026-04-03 12:30:00")

Player Statistics Related

Method	Return Value	Description
getYesterdayJoinCount()	int	Get yesterday's login count (unique players)
getMaxOnlinePlayers()	int	Get historical maximum online players
getTotalJoinCount()	int	Get total login count

Server Performance Related

Method	Return Value	Description
getMinTps()	double	Get server minimum TPS
getHighestLatencyPlayer()	Player	Get player object with highest latency
getHighestLatencyPlayerName()	String	Get name of player with highest latency
getHighestLatency()	long	Get maximum latency value (milliseconds)
getPlayerLatency(Player player)	long	Get specified player's latency (milliseconds)

Project Structure

SyAPI/
├── src/
│   └── main/
│       ├── java/cn/shiyuan/syapi/
│       │   ├── SyAPI.java              # Main class
│       │   ├── SyAPIProvider.java      # API provider
│       │   ├── StatsManager.java       # Statistics manager
│       │   ├── PlayerListener.java     # Player event listener
│       │   └── SyAPICommand.java       # Command handler
│       └── resources/
│           ├── plugin.yml              # Plugin configuration
│           └── data.yml                # Data storage
├── pom.xml                             # Maven configuration
└── README.md                           # Documentation

Permission Nodes

Permission	Description	Default
syapi.admin	Admin permissions (reload, etc.)	OP
syapi.use	Usage permissions (view statistics)	All players

Data Storage

The plugin uses YAML files to store data, located at plugins/SyAPI/data.yml:

• total-join-count: Total login count
• max-online-players: Historical maximum online players
• yesterday-join-count: Yesterday's login count
• today-join-count: Today's login count (automatically resets daily)
• current-date: Current date
• yesterday-players: Yesterday's player UUID list

Scheduled Tasks

The plugin automatically runs the following scheduled tasks after startup:

• TPS Monitoring: Updates minimum TPS every second
• Latency Update: Updates player latency data every second
• Date Check: Checks for date changes every minute, automatically resets today's statistics
• Data Save: Automatically saves data to file every 5 minutes