Common Fixes
Troubleshooting
Find solutions to common problems and learn how to debug server issues effectively.
Common Issues
Server Won't Start
Check these things in order:
- Check the console for error messages
- Verify port is not already in use
- Ensure you have allocated enough RAM
- Check if a required plugin is misconfigured
High Lag / Slow Server
Steps to resolve lag issues:
- Use /timings to profile plugin performance
- Disable problematic plugins temporarily
- Add more RAM allocation if possible
- Reduce simulation distance or view distance
- Update to the latest Java version
Players Can't Connect
Connection troubleshooting:
- Check if the server is actually running
- Verify firewall allows connections on the port
- Check port forwarding settings
- Test with localhost first
Crashes on Startup
When server crashes immediately after starting:
- Read the crash log file (usually in logs/)
- Remove recently added plugins
- Check Java version compatibility
- Restore world from backup if world data corrupted
Debugging Tips
Check Logs
Always check the latest.log file for error messages and stack traces.
Enable Debug Mode
Set debug: true in config files for verbose logging output.
Use Profilers
Use /timings and /spark for Java profiling and performance analysis.
Ask Community
Share logs and errors with community forums for expert help.
Useful Commands
/timings report
Generate performance profile (outputs URL)
/debug-block
Debug block operations and timing issues
/lag-report
Get detailed lag report information
/restart
Gracefully restart the server