Jump to content
Sign in to follow this  

[Tutorial] aCis installation, from A to Z

Recommended Posts

Setup Eclipse & SVN

Well, in this tutorial I will explain how to setup Eclipse to work with aCis project. As you perhaps know, the project is located online on a Assembla server. You, as owner, have to take a copy of the project on your computer in order to work on it and make it custom.

Some vocabulary before :
- IDE* : Integrated Development Environment. Basically, your working environnement.
- Subversion : A software used to version a project, allowing to make revision. Eclipse uses his own Subversion plugin, named Subclipse.
- Checkout : the act to download sources  (at last revision if possible...) from the online repository.

*Some others IDEs are existing, but this tutorial will only cover Eclipse setup.

1. Download and extract Eclipse !

First of all, you must download Eclipse software on its website.

Eclipse IDE for Java EE Developers or Eclipse IDE for Java Developers are both good choices.
The archive have to be directly extracted, generally on the root of your drive (C:/, D:/)

2. First launch of Eclipse

At first launch, Eclipse will ask you where your workspace will be located. Try to use a safe partition or another drive, like that all your work will be secured.



3. Installation of Subclipse

Now you must install the plugin named subclipse in order to checkout the project : in the main bar, select Help->Install New Software.


From the new window that will popup, press Add site... and write the following link: http://subclipse.tigris.org/update_1.10.x

Eclipse will ask you if you agree about the plugin rules, accept, click on Install and in the end click on the Finish button.

4. Call the SVN Repositories window

Eclipse will perhaps ask to reload, accept and wait. We have to call a window, which will be used to checkout project, and which comes with the installation of Subclispe. Click at the bar Window->Show View->Other...


In the new window, select the little SVN folder type, then select SVN Repositories and click OK.



5. Write the SVN URL in the SVN Repositories window

On the new tab, click at SVN Repositories, then  right click anywhere inside and go to New->Repository Location....


Using the following url : http://xp-dev.com/svn/aCis_public/ you will link yourself to the project. Click Finish.

6. Checkout !

Last but not least, you must check out datapack and gameserver with the same way.
Select the new location, right click on the SVN link, select Checkout...


and click in the new window Finish.


Wait Eclipse download the whole project in order to work on it, depending of your connection it can be 2-10 minutes.

7. Configure compiler path.

Your eclipse will try to search the compiler in the wrong direction if you had an old version of JRE installed.

You have to change this direction, following those simple instructions :

- Window > Preferences. A window will popup.
- Java tab > Installed JREs.

Push "Search..." and give yourself the good path. It mustn't be JRE, but jdk.

Compilation of aCis project using Eclipse

In this short tutorial, I will explain how to compile aCis project using Eclipse.
Before starting compiling, you must setup eclipse & svn.

1. Checkout any revision & create java's path !

As you have clicked to datapack (or gameserver) checkout button, a window poped up.
You can checkout any version writing an existing revision number instead the xx on my screen.


If you check Check out HEAD Revision, it will automatically checkout the last revision. Others options will be grey.
Then, simply click on Finish.

2. Compile aCis project!

When projects' checkouts (gameserver/datapack) are over, you will have a local copy of aCis' files. Congratulations, you are ready to compile them.


On the image, we have only checkouted datapack sources. This is an exemple, normally you should have 2 distinct projects. You need to compile each project.

  • Click on the little + icon from datapack (once again, it could be gameserver, datapack is taken as exemple).
  • Right click at build.xml
  • Choose Run as -> 1 Ant Build

The compilation should normally begin. It will take some seconds / minutes depending of your own computer performances. At the end of any compilation you should have

Buildfile: C:\workspace\aCis_datapack\build.xml
    [mkdir] Created dir: C:\workspace\aCis_datapack\build\dist
    [mkdir] Created dir: C:\workspace\aCis_datapack\build\dist\gameserver
    [mkdir] Created dir: C:\workspace\aCis_datapack\build\dist\login
     [echo] aCis datapack revision: 170
     [sync] Copying 3949 files to C:\workspace\aCis_datapack\build\dist\gameserver\data
     [sync] Copying 84 files to C:\workspace\aCis_datapack\build\dist\sql
     [sync] Copying 4 files to C:\workspace\aCis_datapack\build\dist\tools
     [sync] Copying 1 file to C:\workspace\aCis_datapack\build\dist\login
Total time: 46 seconds

From the moment you got BUILD SUCCESFULL, it means compilation succeeded. You have to do same actions for gameserver project.

3. Find compiled files on your drive !

The path fully depends of where you put your workspace. Don't take those informations at first degree.

As my workspace is setup in C:/, let's go at C:\workspace\aCis_datapack\build to see what new files / folders have been created from compilation. For gameserver project, the location is C:\workspace\aCis_gameserver\build\dist.

As you have build/compile datapack & gameserver, you should have also create a folder with name(for ex.)MyServer at C: and copy paste the folders inside there.
So now at MyServer folder you should have folders: gameserver, login, sql, tools.

Installing aCis


Well, don't laugh, but some people asked for it. You have to know this tutorial is useful at any case, from L2J IL to Freya, using my pack or not.

Important things :

  • In this tutorial, some things aren't essential (shortcuts, etc), but they're presented to make your life easier & reduce the installation / upgrade time.
  • We use 2 different locations : the sources location, which got compiled version and sources, and the server installation location, which got your server files organized. It's IMPORTANT TO DON'T USE SAME PLACE FOR BOTH USES. Using your build location as server installation will result in a big mess. You're warned. So be clever and simply create a new folder. I personally use a folder Sources and another named Servers.
  • My windows is in French, just use common sense in order to find good paths...

So, you compiled both gameserver and datapack. How to install the crap then ?


Okay, as you have all necessary files in one folder, now you can configure them and install.


I don't give any hints on how to install mySQL/WAMP/whatever nor paramatering it. You're enough old to use Google, or to check existing tutorials in specialized websites.

You have to create your database first in navicat / phpMyAdmin. Continuing this tutorial without doing it will result in a fail at database installation.

We will first install the database, so go on tools folder, right click on database_installer.bat and click on Modify option.
You have to edit this square with your own informations.

REM ############################################
REM ## You can change here your own DB params ##
REM ############################################
set mysqlBinPath=C:\Program Files\MySQL\MySQL Server 5.5\bin

set lsuser=root
set lsdb=acis
set lshost=localhost

set gsuser=root
set gsdb=acis
set gshost=localhost
REM ############################################

Don't forget to save modifications, then run database_installer.bat double clicking on it. For a full install, just type f and type y anew to confirm you want to delete all characters table. Wait it install tables, than verify (who knowns, you are perhaps the unlucky type) if the database is installed.


After you verified database is populated, move from tools folder to login.

Open config folder, then edit loginserver.properties

#                    Database informations

URL = jdbc:mysql://localhost/acis
#URL = jdbc:hsqldb:hsql://localhost/acis
#URL = jdbc:sqlserver://localhost/database=acis/user=sa/password=

Login = root

The same you have to do with gameserver.properties located inside gameserver/config folder.

As you have set correct database path, now you can register your gameserver / create hexid file.

Go to login folder and run RegisterGameServer.bat

When the window pops up, type 1 and press enter. If you (previously) correctly configured the db path, the result should be following


Now, select the hexid(server 1) and rename it to hexid. Cut the file and paste it inside gameserver/config folder.

And that's it, you have successfully configured your server files. Now you can launch the server (startLoginServer.bat and startGameServer.bat).

Updating server

If you made java developement like adding customs etc, you have to use Team Synchronize from Eclipse to keep your customs but refresh code.

If you "only" talk of updating your server from revision xxx to revision xxx+1, you have first to checkout/synchronize latest version, then compile, then :

- in near 90% of case, pick the l2jserver.jar and copy/paste it in the libs folder of your server. It is needed if there was core additions. In some very rare cases, you will have to update the loginserver l2jserver lib too, but in 95% of time it's not needed.

- add DP (can be HTMs added, drop/update of a SQL table for another with better content, and such). Use the timeline to see what files have been changed, it's useful for DP.

- configs file are rarely updated, but sometimes they are. Like the addition of floodProtector. You can keep old configs in server.properties or delete them at hand, but you have to add the new .properties in order you want to change values. By default it will use values written in core so even if you forget the file, that works, but you can't configure it.




Tutorial Created by aCis team and Tryskell (Owner of aCis Project).

You can find this topic on their Official Forum as well by clicking HERE.

Share this post

Link to post
Share on other sites

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now

Sign in to follow this  

  • Recently Browsing   0 members

    No registered users viewing this page.