​

Server Troubleshooting Guide

Having issues with your game server? This comprehensive troubleshooting guide covers the most common problems and their solutions. Whether you’re dealing with connection issues, performance problems, or server crashes, we’ll help you get back up and running quickly.

​

Quick Diagnostic Checklist

Before diving into specific issues, run through this quick checklist:

• Is your server showing as “Online” in the control panel?
• Are you using the correct server IP address?
• Is your game client updated to the latest version?
• Have you restarted your server recently?
• Are there any error messages in the server console?

​

Common Connection Issues

​

Cannot Connect to Server

Symptoms: Game client shows “Connection failed”, “Server not found”, or timeout errors. Solutions:

1. Verify Server Status
   • Check if server is online in your control panel
   • Look for any error messages in the console
   • Restart the server if it appears stuck
2. Check Server IP and Port
   • Copy the exact IP address from your panel
   • Ensure you’re using the correct port number
   • Some games require specific port formats
3. Firewall and Network Issues
   • Temporarily disable your firewall to test
   • Check if your ISP blocks gaming ports
   • Try connecting from a different network
4. Game Version Mismatch
   • Ensure your game client matches the server version
   • Update your game client if needed
   • Check server version in the control panel

​

Server Shows Offline When It Should Be Online

Symptoms: Control panel shows server as offline despite being started. Solutions:

1. Force Server Restart
   • Stop the server completely
   • Wait 30 seconds
   • Start the server again
2. Check Server Resources
   • Monitor RAM and CPU usage
   • Upgrade if consistently at 100%
   • Clear unnecessary files
3. Review Server Logs
   • Check console for error messages
   • Look for crash reports
   • Identify problematic plugins/mods

​

Performance Issues

​

Server Lag and Low Performance

Symptoms: High latency, delayed responses, choppy gameplay. Solutions:

1. Resource Optimization
   • Monitor RAM usage (should stay below 80%)
   • Check CPU utilization
   • Consider upgrading your plan
2. Plugin/Mod Management
   • Disable unnecessary plugins/mods
   • Update all plugins to latest versions
   • Remove conflicting modifications
3. World Optimization
   • Reduce world size if possible
   • Clear unused chunks
   • Limit entity spawning
4. Server Settings Tuning
   • Adjust view distance settings
   • Optimize tick rate settings
   • Configure garbage collection (Java games)

​

High Memory Usage

Symptoms: Server running out of RAM, frequent crashes, slow performance. Solutions:

1. Memory Allocation
   • Check current RAM usage in panel
   • Upgrade to higher RAM plan if needed
   • Optimize Java heap settings (Minecraft)
2. Memory Leaks
   • Restart server regularly
   • Update plugins/mods
   • Remove problematic modifications
3. World Size Management
   • Use world border plugins
   • Pre-generate chunks efficiently
   • Clean up old/unused areas

​

Server Crashes and Errors

​

Frequent Server Crashes

Symptoms: Server stops unexpectedly, requires manual restart. Solutions:

1. Identify Crash Causes
   • Review crash logs in console
   • Check for out-of-memory errors
   • Look for plugin/mod conflicts
2. Update Everything
   • Update server software
   • Update all plugins/mods
   • Update Java version (if applicable)
3. Hardware Issues
   • Monitor server resources
   • Check for overheating
   • Contact support if hardware-related

​

Startup Errors

Symptoms: Server fails to start, shows error messages during boot. Solutions:

1. Configuration Issues
   • Check server.properties file
   • Verify all file permissions
   • Reset to default configuration if needed
2. File Corruption
   • Restore from recent backup
   • Re-upload server files
   • Verify file integrity
3. Dependency Problems
   • Install required dependencies
   • Check Java version compatibility
   • Update server software

​

Game-Specific Issues

​

Minecraft Servers

Common Issues:

• Connection Timed Out
• Exception in Server Tick Loop
• Failed to Check Session Lock
• Kicked for Flying

Quick Fixes:

• Use Aikar’s Flags for performance
• Configure RCON for remote management
• Set up Dynmap for world visualization

​

Palworld Servers

Common Issues:

• Server Crashes
• Xbox Platform Errors
• Connection Problems

Quick Fixes:

• Enable automatic backups
• Configure server settings properly
• Set up admin permissions

​

V Rising Servers

Common Issues:

• Admin Setup
• Player Management
• Server Configuration

​

Advanced Troubleshooting

​

Using Server Console

The server console is your best friend for troubleshooting:

1. Reading Logs
   • Look for ERROR or WARN messages
   • Note timestamps of issues
   • Search for specific error codes
2. Running Commands
   • Use admin commands to diagnose issues
   • Check player counts and connections
   • Monitor resource usage
3. Log Analysis
   • Download logs for detailed analysis
   • Use log analysis tools
   • Share logs with support when needed

​

Network Diagnostics

Testing Connectivity:

1. Ping Test
   Copy

   ping your-server-ip
   

2. Port Testing
   • Use online port checkers
   • Test from multiple locations
   • Verify port forwarding
3. Traceroute Analysis
   Copy

   traceroute your-server-ip
   

​

File System Issues

Common File Problems:

1. Permissions
   • Ensure proper file permissions
   • Check ownership settings
   • Reset permissions if needed
2. Disk Space
   • Monitor available storage
   • Clean up old logs and backups
   • Upgrade storage if needed
3. File Corruption
   • Verify file integrity
   • Restore from backups
   • Re-upload corrupted files

​

Prevention and Maintenance

​

Regular Maintenance Tasks

Daily:

• Check server status and performance
• Monitor player activity
• Review console for errors

Weekly:

• Create server backups
• Update plugins/mods
• Clean up old files

Monthly:

• Update server software
• Review and optimize settings
• Analyze performance trends

​

Monitoring Tools

Built-in Monitoring:

• Use panel resource graphs
• Set up alert notifications
• Monitor player connections

External Tools:

• Server monitoring services
• Performance analysis tools
• Uptime monitoring

​

When to Contact Support

Contact our support team when:

• Hardware issues are suspected
• Multiple troubleshooting attempts have failed
• You need assistance with complex configurations
• Server performance is consistently poor despite optimization

How to Contact Support:

• Live Chat: berrybyte.net/contact
• Email: support@berrybyte.net
• Discord: Community Server

Information to Include:

• Server ID and game type
• Detailed description of the issue
• Steps you’ve already tried
• Console logs or error messages
• Timeline of when issues started

​

Related Resources

​

Emergency Procedures

​

Server Down Emergency

1. Immediate Actions
   • Check server status in panel
   • Attempt server restart
   • Check for maintenance notifications
2. If Restart Fails
   • Review console logs
   • Contact support immediately
   • Inform players of the issue
3. Data Recovery
   • Restore from latest backup if needed
   • Document any data loss
   • Implement prevention measures

​

Security Incidents

1. Suspected Breach
   • Change all passwords immediately
   • Review access logs
   • Contact support for investigation
2. Malicious Activity
   • Ban problematic players
   • Restore from clean backup
   • Implement additional security measures

Remember: Most server issues can be resolved quickly with the right approach. Don’t hesitate to reach out to our support team if you need assistance!