Skip to main content

Required Software

  • Updated OS
  • Java
  • MariaDB (or MySQL)
  • Git

Update the OS

sudo -i
apt update

Get & Install Java

L2J is built using Java, to build you need Java JDK as well.

apt install -y temurin-21-jdk

Check the Java version

java -version

If you have multiple versions you can configure them by using alternatives:

update-alternatives --config 'java'
info

We recommend updating the JAVA_HOME environment variable.

info

As long as it's possible, L2J will be compatible with the latest LTS (Long-Term-Support) version of Java, you can check the roadmap for Java SE here.

Get & Install Git

L2J uses Git as version control system on BitBucket, use it to get the latest versions.

apt install -y git

Check the Git version

git --version
info

We recommend getting the source code directly from our public repositories.

Get & Install the Database Server

Download and install a database server and create a specific user.

apt install -y mariadb-server

Secure your database installation

mysql_secure_installation

Execute the following SQL statements to create a L2J specific database user:

mariadb -u root -p
create_user.sql
CREATE OR REPLACE USER 'l2j'@'%' IDENTIFIED BY 'l2jserver2019';
GRANT ALL PRIVILEGES ON *.* TO 'l2j'@'%' IDENTIFIED BY 'l2jserver2019';
FLUSH PRIVILEGES;
danger

We recommend changing the default database password. If you do it, you need to edit server.properties files inside the game server config folder and the login server config folder.

tip

We recommend (optionally) downloading and installing HeidiSQL or DBeaver to manage the database.

info

L2J is compatible with MySQL 8.0+, but we recommend MariaDB.