Troubleshooting

Common issues and their solutions. If you can't find your issue here, contact support.

Server Won't Start

License Validation Failed

Error: "Invalid license key" or "License expired"

Solutions:

Verify the license file is located at config/license.key
Check that your subscription is active in your account dashboard
Ensure the license matches your server's tier
Re-download the license key from your account
Verify the file is not corrupted (should be exactly 256 bytes)

Database Connection Failed

Error: "Could not connect to database" or "Connection refused"

Solutions:

Verify PostgreSQL is running: systemctl status postgresql
Check database credentials in config/database.properties
Ensure the database exists: psql -l
Verify the user has correct permissions
Check PostgreSQL is listening on the correct port (default 5432)

Port Already in Use

Error: "Address already in use" or "Port 7777 is already bound"

Solutions:

Check if another server is running: netstat -tulpn | grep 7777
Kill the process using the port or use a different port in config
On Windows, check Task Manager for java.exe processes

Players Can't Connect

Connection Timeout

Players see "Connection timeout" or can't see the server in the list

Checklist:

Verify server.external_ip is set to your public IP
Check firewall allows ports 7777 and 9014
If using a router, forward ports 7777 and 9014 to your server
Ensure both LoginServer and GameServer are running
Test connection from localhost first to isolate network issues

Wrong Client Version

"Client/Server version mismatch" error

Solutions:

Ensure players are using Interlude (C6) client
Verify client patches match server version
Check the system message files (*.dat) are correct

Performance Issues

Server Lag or High CPU Usage

Optimizations:

Increase JVM memory allocation (see Configuration Guide)
Reduce AI update frequency in ai.properties
Optimize database with VACUUM ANALYZE
Disable unnecessary features in features.properties
Check for infinite loops in custom scripts

Database Slow Queries

Solutions:

Enable PostgreSQL slow query log
Add indexes to frequently queried columns
Increase database connection pool size
Consider using a dedicated database server

Frequently Asked Questions

How do I create an admin account?

Connect to the database and update a user's access level:

UPDATE characters SET accesslevel=100 WHERE char_name='YourCharName';

Access levels: 1-99 = GM, 100+ = Admin

How do I change server rates?

Edit config/rates.properties and restart the server.

Note: Available rate ranges depend on your subscription tier.

Can I run multiple servers with one license?

No, each license is valid for one server instance. If you need to run multiple servers, purchase additional licenses.

How do I upgrade my subscription tier?

Log in to your account dashboard and navigate to the subscription page. You can upgrade at any time and the price difference will be prorated.

Where are the server logs?

Server logs are located in the log/ directory:

log/game.log - Game server log
log/login.log - Login server log
log/error.log - Error log

Getting Support

Still Need Help?

If you couldn't find a solution here, our support team is ready to help.

Discord:Join our Discord community

Email:support@l2jexalted.com

Tickets:Open a support ticket from your account dashboard

Response times: BASIC (24h) • ADVANCE (12h) • FULL (4h priority)

Server Won't Start

License Validation Failed

Error: "Invalid license key" or "License expired"

Solutions:

Verify the license file is located at config/license.key
Check that your subscription is active in your account dashboard
Ensure the license matches your server's tier
Re-download the license key from your account
Verify the file is not corrupted (should be exactly 256 bytes)

Database Connection Failed

Error: "Could not connect to database" or "Connection refused"

Solutions:

Verify PostgreSQL is running: systemctl status postgresql
Check database credentials in config/database.properties
Ensure the database exists: psql -l
Verify the user has correct permissions
Check PostgreSQL is listening on the correct port (default 5432)

Port Already in Use

Error: "Address already in use" or "Port 7777 is already bound"

Solutions:

Check if another server is running: netstat -tulpn | grep 7777
Kill the process using the port or use a different port in config
On Windows, check Task Manager for java.exe processes

Players Can't Connect

Connection Timeout

Players see "Connection timeout" or can't see the server in the list

Checklist:

Verify server.external_ip is set to your public IP
Check firewall allows ports 7777 and 9014
If using a router, forward ports 7777 and 9014 to your server
Ensure both LoginServer and GameServer are running
Test connection from localhost first to isolate network issues

Wrong Client Version

"Client/Server version mismatch" error

Solutions:

Ensure players are using Interlude (C6) client
Verify client patches match server version
Check the system message files (*.dat) are correct

Performance Issues

Server Lag or High CPU Usage

Optimizations:

Increase JVM memory allocation (see Configuration Guide)
Reduce AI update frequency in ai.properties
Optimize database with VACUUM ANALYZE
Disable unnecessary features in features.properties
Check for infinite loops in custom scripts

Database Slow Queries

Solutions:

Enable PostgreSQL slow query log
Add indexes to frequently queried columns
Increase database connection pool size
Consider using a dedicated database server

Frequently Asked Questions

How do I create an admin account?

Connect to the database and update a user's access level:

UPDATE characters SET accesslevel=100 WHERE char_name='YourCharName';

Access levels: 1-99 = GM, 100+ = Admin

How do I change server rates?

Edit config/rates.properties and restart the server.

Note: Available rate ranges depend on your subscription tier.

Can I run multiple servers with one license?

No, each license is valid for one server instance. If you need to run multiple servers, purchase additional licenses.

How do I upgrade my subscription tier?

Log in to your account dashboard and navigate to the subscription page. You can upgrade at any time and the price difference will be prorated.

Where are the server logs?

Server logs are located in the log/ directory:

log/game.log - Game server log
log/login.log - Login server log
log/error.log - Error log