Getting Started

Installation - Windows systems

From a blank Windows machine to a running login + game server you can connect to.

Step 01

Install JDK 25

Download the JDK 25 MSI from the link above and run the installer with defaults.

Step 02

Download and extract Eclipse

Preferably to C:\eclipse\ and set the workspace to C:\eclipse\workspace.

At this point make sure Eclipse is using the right Java version: Window → Preferences → Java → Installed JREs. If your JDK 25 install folder isn't listed, add it with the Add... button.

Step 03

Enable Eclipse Git support

  1. Open Eclipse.
  2. Click the top menu item Window.
  3. Select Show View.
  4. Click Other....
  5. From the Git folder select Git Repositories.
Step 04

Check out the project

  1. In the Git Repositories view, click Clone a Git repository.
  2. URI: https://gitlab.com/MobiusDevelopment/L2J_Mobius.git
  3. Click Next > twice.
  4. Directory: C:\eclipse\workspace\L2J_Mobius
  5. Click Finish and wait for the clone to complete.
  6. Double click L2J_Mobius [master], then Working Tree.
  7. Right click any project → Import Projects...Finish.

If you get "JRE System Library [JavaSE-25]" warnings, re-add JDK 25 from Window → Preferences → Java → Installed JREs.

Step 05

Compile the project

  1. In the Package Explorer, expand the project to find build.xml.
  2. Right click build.xmlRun as...1 Ant Build.
  3. Wait for the BUILD SUCCESSFUL console message.
  4. Find your compiled L2J_Mobius.zip in C:\eclipse\workspace\L2J_Mobius\build.
Step 06

Install XAMPP

Download and install XAMPP from the link above. The L2JMobius database runs on the MySQL service that ships with it.

Step 07

Install the MySQL service

  1. Go to C:\xampp.
  2. Run xampp-control (the one with the orange icon).
  3. Click the X button next to MySQL.
  4. Click Yes to install it as a Windows service.
  5. Use the Start button to launch the service.
Step 08

Run the server

  1. Extract your compiled L2J_Mobius.zip to a folder. Preferably C:\L2J_Mobius.
  2. Go to db_installer and run DatabaseInstaller.vbs to install the schema.
  3. Go to login and run LoginServer.vbs.
  4. Go to game and run GameServer.vbs.

Tuning notes

• Consider checking the MySQL setting optimizations post on the forum.

• Don't allocate more than ~28 GB of RAM in java.cfg, even if you can spare it, bigger heaps hurt GC latency more than they help.

• If you're a visual learner there is a YouTube walkthrough covering the same steps.