Lightweight Minecraft server performance monitoring with TPS, MSPT, CPU, RAM, entity tracking, diagn

ServerOps — Minecraft Server Performance Monitor
ServerOps is a lightweight performance monitoring and diagnostics plugin for Paper servers.

Monitor your server's health in real time with TPS, MSPT, CPU, memory, entity, world, and uptime statistics — without unnecessary background processing or external services.

Features
Performance Monitoring

• TPS: 1-minute, 5-minute, and 15-minute averages
  
  
• MSPT monitoring
  
  
• JVM CPU usage
  
  
• System CPU usage
  
  
• JVM memory usage
  
  
• Allocated and maximum memory
  
  
• Server uptime
  
  
• Player count
  

Entity Monitoring

• Total entity count
  
  
• Entity counts by type
  
  
• Top entity types
  
  
• Quickly identify unusually high entity populations
  

World Monitoring

• World count
  
  
• Loaded chunk information
  
  
• Entity information per world
  

Diagnostics
ServerOps provides simple diagnostic information when performance conditions are detected:

• Detected condition
  
  
• Likely cause
  
  
• Possible cause
  
  
• Current server health state
  

The plugin is designed to help server administrators identify potential performance problems without requiring external monitoring software.

Discord Alerts
Optional Discord webhook integration can notify administrators when configured thresholds are reached.

Supported alerts include:

• Low TPS
  
  
• High MSPT
  
  
• High memory usage
  
  
• High entity count
  
  
• Recovery notifications
  
  
• Configurable alert cooldown
  

Discord integration is completely optional.

Commands
/serverops
/sops

/serverops status
/serverops performance
/sops perf

/serverops entities
/sops entities

/serverops worlds
/sops worlds

/serverops alerts
/sops alerts
/serverops alerts test

/serverops reload
/sops reload

/serverops version

Permissions
serverops.admin

Access to administrative commands such as reload and alert testing.

serverops.status

Access to ServerOps monitoring information.

Example
TPS: 20.0 / 20.0 / 20.0
MSPT: 2.2ms — Healthy
JVM CPU: 1%
System CPU: 8%
Memory: 946 MB / 2.0 GB
Players: 3
Entities: 182

Performance
ServerOps is designed with server performance in mind.

• No expensive scans every tick
  
  
• No blocking HTTP requests on the main server thread
  
  
• Discord requests are handled asynchronously
  
  
• Lightweight scheduled monitoring
  
  
• Safe executor shutdown
  
  
• Configurable thresholds
  
  
• No mandatory external database or backend
  

Installation

1. Download the ServerOps JAR.
   
   
2. Stop your Paper server.
   
   
3. Place the JAR into your server's plugins folder.
   
   
4. Start the server.
   
   
5. ServerOps will automatically generate its configuration.
   
   
6. Configure thresholds or Discord alerts in plugins/ServerOps/config.yml.
   
   
7. Use /serverops status or /sops perf to view server performance.
   

Discord Setup
Discord alerts are optional.

Add your Discord webhook URL to the configuration file and enable Discord alerts.

You can test the configuration with:

/serverops alerts test

Never share your Discord webhook URL publicly.

Requirements

• Paper
  
  
• Java 21
  
  
• No external database required
  
  
• No mandatory external account
  
  
• Internet access is only required if optional Discord webhook alerts are enabled.
  

Privacy
ServerOps does not require user accounts or a remote backend.

The plugin does not send server monitoring data to an external service by default.

If Discord alerts are enabled, configured alert information is sent to the Discord webhook selected by the server administrator.

Configuration
All monitoring thresholds, alert settings, cooldowns, and Discord options can be configured through config.yml.

ServerOps validates configuration values and uses safe defaults where appropriate.

Support
If you encounter an issue, please provide:

• Minecraft version
  
  
• Paper version
  
  
• Java version
  
  
• ServerOps version
  
  
• Console error/log
  
  
• Relevant configuration (remove private webhook URLs)
  

Changelog
1.0.0

• Initial release
  
  
• TPS monitoring
  
  
• MSPT monitoring
  
  
• CPU monitoring
  
  
• JVM memory monitoring
  
  
• Entity monitoring
  
  
• World monitoring
  
  
• Server health diagnostics
  
  
• Configurable thresholds
  
  
• Discord webhook alerts
  
  
• Recovery alerts
  
  
• Command system
  
  
• Permissions
  
  
• Lightweight asynchronous Discord handling