Documentation

Welcome to l2jsunrise documentation. Reading this, means you are interested on running your own lineage 2 private emulator. Do not worry if your knowledge is insufficient, you are on the right place to start from, since with l2jsunrise in a few minutes you can be online on your own lineage 2 server.

The first question that should come to you mind is, what is l2jsunrise? Well, l2jsunrise started 5 years ago as a private project by NeverMore and vGodFather based on l2jserver sources. Both as lineage 2 lovers tried their luck with l2jserver(project), but failed cause of bugs, stability and mostly cause of not properly tested updates. So thats how the idea was born. They started working by themselves on the sources and implemented hundreds of features and extra implementations. Since the interest of a well structured and stable l2 emulator was growing through the years on lineage 2 community, they decided to make their effort a public closed-source project.

Nowadays l2jsunrise is one of only alive H5 project working on l2jserver sources. There are hundreds of servers using our files with huge success, but also failures as well. Keep in mind that success does not always comes because of the files, but it also depends on the administration itself, but that's another story. Whatever enough with chatter lets get to the point.

In order to run a lineage 2 server, you need several programs and utilities. You can run l2jsunrise on your home personal computer, however to make it online and accessible from players all over the world , we suggest that you should rent a dedicated machine or a VPS. The reason is because most of the times, our home personal computers are not powerful enough to handle such operations. Even though you can start using l2jsunrise for testing purposes on your personal computer, and when you fill confident that your files are finally ready to get ONLINE, move them on a paid hosting company.

Of course the better your machine is, the better performance you will have on your server. You may have faster loads, faster database connections and faster control of your server in general. Running a server on a lower stat machine is not recommended but will not be a problem since our files lacks of memory and CPU power leaks.

There are 2 versions of l2jsunrise that can be used, XML version that stores NPC's static DATA on XML files and SQL version which stores them on the database. L2jsunrise started as SQL version, but for stability and performance issues we decided to move all NPC's static DATA to XML files with more accurate stats and spawns. So why SQL version still exists? Well, when we decided to make this upgrade from SQL to XML there was online servers running using the SQL version. So to avoid frustrations we keep working on both versions. After all we recommend the XML version especially for low/mid rate servers. The only negative part of XML version is that lacks of ingame DROPs editor so if you are newbie go for the SQL version.

1. Programs & Utilities

To run a l2jsunrise server you need in first place 2 programs installed on your computer. Latest Java 8 (JDK) and MySQL server. Follow the next chapters to install them.

1.1 Installation of Java (JDK) (click me to expand)

Download Java x64 (JDK) ← (version might be different on the images but the process is the same)

Run the file you just downloaded and follow the instructions to complete the installation

1.2 Installation of MySQL Server (click me to expand)

Download 5.6 MySQL Server ← (version might be different on the images but the process is the same)

Run the file you just downloaded and follow the instructions to complete the installation

2. Deploy the Server

Download your preferred version (XML or SQL), from l2jsunrise dashboard File Manager Section. Create a folder at c:\ with any name and put both Server and DataPack ZIP files into it. Then unzip them like the images below

3. Prepare Database

Navigate to "..\tools" folder and run database_installer.bat file. Then follow the image instructions to install the database.

4. Configure Server

GameServer

Navigate to "..\game\config\network" folder and open Server.ini file with notepad. Search for

# Database connection password
Password = 

type your MySQL password and save the file. It should look like

# Database connection password
Password = myPassword

LoginServer

Navigate to "..\login\config\network" folder and open LoginServer.ini file with notepad. Search for

# Database connection password
Password = 

type your MySQL password and save the file. It should look like

# Database connection password
Password = myPassword

5. Run Server

You are ready to run your server for the very first time. Simply run startGameServer.bat file located at "..\game" and startLoginServer.bat file located at "..\login" folder. Wait for the server to load, you should see something like the image below when your server is loaded successfully.

In order to connect to l2jsunrise server you will need latest H5 part 5 client installed on your computer. In case you don't have it already you can download it by clicking on the button bellow. If you do have it installed, download our official "Client Starter" and run it.

Download H5 Client Download Client Starter

Accounts are auto created by default on l2jsunrise. This means that while you are logging in, if the account ID does not exist, it will be created with the given password. Once you've made your account, select the available server online and proceed on character creation. Once your character is created DO NOT enter the game and logout.
Now for the next step, you will need to have configured and installed HeidiSQL or any other Database Management Software, as we gonna edit records on the database. So simply open HeidiSQL search for characters table into l2srgs database. On the Data tab locate the character you created before and change the accesslevel record from 0 to 8. Then save the changes and try to re-login. Use //admin command ingame and the Administrator panel will pop up.