ServerDoctor

ServerDoctor Lite is a modern diagnostic and recovery assistant for Spigot servers, designed to help server owners identify lag, monitor server health, analyze heavy chunks, detect performance spikes, and safely recover from common server issues.

Instead of only showing numbers, ServerDoctor Lite helps explain:

• where lag may be happening
  
• what may be causing it
  
• what admins should investigate next

Commands

• /doctor
• /doctor help
• /doctor about
  
• /doctor status
  
• /doctor report
  
• /doctor alerts
  
• /doctor discord
  
• /doctor spikes
  
• /doctor chunks
  
• /doctor tpchunk <world> <chunkX> <chunkZ>
  
• /doctor cleanup preview
  
• /doctor cleanup confirm
  
• /doctor export
  
• /doctor reload
  
• /doctor plugins
  
• /doctor history
  
• /doctor history spikes
  
• /doctor history performance
  
• /doctor schedule

Permissions

• serverdoctor.use
  
• serverdoctor.about
  
• serverdoctor.status
  
• serverdoctor.report
  
• serverdoctor.alerts
  
• serverdoctor.spikes
  
• serverdoctor.chunks
  
• serverdoctor.tpchunk
  
• serverdoctor.cleanup.preview
  
• serverdoctor.cleanup.confirm
  
• serverdoctor.export
  
• serverdoctor.reload
  
• serverdoctor.update.notify
  
• serverdoctor.update.check
  
• serverdoctor.plugins
  
• serverdoctor.history
  
• serverdoctor.history.spikes
  
• serverdoctor.history.performance
  
• serverdoctor.schedule

Features
Real-time Diagnostics
Monitor:

• TPS
  
• MSPT
• memory usage
  
• loaded chunks
  
• entity counts
  
• server health status

Chunk Analyzer
Identify potentially problematic chunks instantly.

Detect:

• high entity chunks
• item buildup
• hopper-heavy systems
• mob-heavy areas
• chunk overloads

Includes:

• clickable chunk teleport
• smart recommendations
• chunk ranking system

Smart Recommendations Engine
ServerDoctor Lite provides practical suggestions based on detected server conditions.

Examples:

• high MSPT warnings
• entity overload suggestions
• item buildup detection
• optimization guidance

Lag Spike Detection
Automatically detect:

• TPS drops
• MSPT spikes
• sudden performance degradation

Includes:

• in-game alerts
• console alerts
• Discord webhook support
• spike logging
• performance summaries

Safe Cleanup Tools
Preview and safely clean selected entity types.

Features:

• preview mode
• confirmation system
• cleanup cooldowns
• cleanup logs
• protected entity exclusions

Plugin Impact Scanner
Investigate possible plugin-related performance issues.

Detect:

• large plugin stacks
• excessive scheduled tasks
• high listener counts
• potential performance contributors

Historical Performance Tracking
Track performance trends over time without requiring databases.

Monitor:

• average TPS/MSPT
• recent lag spikes
• cleanup history
• performance degradation trends

Export Diagnostic Reports
Generate detailed diagnostic reports for:

• troubleshooting
• hosting support
• developer analysis
• performance reviews

Discord Integration
Optional Discord webhook alerts for:

• lag spikes
• cleanup events
• warnings
• scheduled summaries

Scheduled Reports
Automatically generate scheduled server health reports.

BETA NOTICE
ServerDoctor Lite is currently in beta.

Feedback, suggestions, and bug reports are highly appreciated as the plugin continues to evolve.