Common
Errors

Installation Errors

Database Connection Failed

Error: "Could not connect to database"

Solutions:

• Check your database credentials in the configuration file
• Ensure the database server is running
• Verify the database name exists
• Check if the database user has proper permissions
• Ensure the database host is accessible from your web server

File Permission Errors

Error: "Permission denied" or "Cannot write to directory"

Solutions:

• Set proper file permissions (755 for directories, 644 for files)
• Ensure the web server user owns the files
• Make sure uploads and cache directories are writable
• Check SELinux settings if applicable

API Connection Errors

Invalid API Key

Error: "Invalid API key" or "Authentication failed"

Solutions:

• Verify the API key is correct and copied without extra spaces
• Check if the API key has been regenerated in the admin panel
• Ensure the API key is for the correct store
• Check if the API key has expired

Server Communication Failed

Error: "Cannot connect to server" or "Connection timeout"

Solutions:

• Check if your game server has internet access
• Verify the store URL is correct and accessible
• Check firewall settings on both server and web server
• Ensure the API endpoint is not blocked

Payment Processing Errors

PayPal Integration Issues

Error: "PayPal payment failed" or "Invalid PayPal configuration"

Solutions:

• Verify PayPal client ID and secret are correct
• Check if PayPal is in sandbox mode for testing
• Ensure PayPal webhook URL is configured correctly
• Verify the PayPal account is verified and active

Stripe Integration Issues

Error: "Stripe payment failed" or "Invalid Stripe key"

Solutions:

• Check if you're using the correct Stripe keys (test vs live)
• Verify the Stripe webhook endpoint is configured
• Ensure the Stripe account is properly set up
• Check if the payment method is supported in your region

Game Server Plugin Errors

Plugin Not Loading

Error: "Plugin failed to load" or "Addon not found"

Solutions:

• Check if the plugin files are in the correct directory
• Verify file permissions are correct
• Ensure all dependencies are installed
• Check the server console for specific error messages

Commands Not Executing

Error: "Commands not working" or "Actions not triggered"

Solutions:

• Verify the command syntax is correct
• Check if the player is online when the command executes
• Ensure the server has permission to execute the commands
• Test commands manually in the server console

Email Configuration Errors

Email Not Sending

Error: "Email delivery failed" or "SMTP connection error"

Solutions:

• Check SMTP server settings and credentials
• Verify the email address is valid
• Check if the SMTP server requires authentication
• Ensure the server can connect to the SMTP port

General Troubleshooting Tips

• Check Logs: Always check error logs for specific error messages
• Test Incrementally: Test each component separately
• Update Dependencies: Ensure all software is up to date
• Backup First: Always backup before making changes
• Document Changes: Keep track of configuration changes