http://www.l2jfree-users.com/l2jfreeusers/posts/list/24.page JForum - http://www.jforum.net However, I remember having had quite some trouble finding how to edit and compile the given sources the first time I tried to. I followed one of the numerous incomplete and/or outdated tutorial for Eclipse, and didn't find a way to make it all work. Then I tried NetBeans, and suddenly everything was... simple.
Since noone has done it yet, and a little out of boredness, I wrote a tutorial that should help people get started with NetBeans and l2jfree.
Feel free to correct me if I'm mistaken at some point and... hope it helps. =)

[size=16][b]Tutorial : Downoad, edit sources and compile an l2jfree project with NetBeans.[/b][/size]
[i](Windows XP version)[/i]

[b]Notes : [/b]
[list] - This is the procedure I've followed for installing everything on my Asus Eee netbook, with standard Windows XP installation.
Hopefully this will be clean enough and standard enough for anyone with the same OS to follow these simple steps. And maybe other OS's too, but I wouldn't guarantee it

- In a few months I'll probably do this tutorial again for Windows Seven, if anything should be different.

- If you want to compile on an UNIX-based system, I enjoin you to follow this link, where it is clearly exposed how to do so. (FIXME: LINK IS MISSING)[/list]
[b]Step 1 : JDK.[/b]
[list]- Follow this link : http://java.sun.com/javase/downloads/index.jsp
- Choose the JDK 6 Update 16 (or any newer version that you may find at the time you read this tutorial) by clicking on the orange "Download" button.
- Choose Windows in the "platform" list. If you use Windows XP 64 of course, you should choose "Windows x64".
- Click on the checkbox and then "continue"
- On this page, click on the ".exe" link and download. Then install it as you would normally do with any windows program.
[/list]
[b]Step 2 : NetBeans[/b]
[list]- Go on this page : http://www.netbeans.org/downloads/
- Choose the "download" button in the first column. You don't need extra stuff if you just want to mess with the l2jfree project. However, feel free to look around if you're interested in working with netBeans on other projects or languages.
- Launch the install of the executable file you have just downloaded. At some point in the installation you will be asked to indicate the path to the JDK. If it isn't filled automatically by the installer, enter the path you have chosen in step 1 to install the JDK.
- Launch the application and do all the suggested updates.
[/list]
[b]Step 3 : Subversion[/b]
[list]- Go there : http://www.open.collab.net/downloads/netbeans/
- Choose the CollabNet Subversion Command Line Client v1.5.5 (for Windows)
- Click on the orange download button, create an account and get the .exe file.
- Install it
- Open your command line (cmd.exe). Type "svn --version" and then enter. If you get an error message, do the following :
[list] - Go to Configuration panel->System->Advanced->Environment variables
- In the system variables, Modify the path variable and add at the end the following :
";C:\Program Files\CollabNet Subversion Client" without the quotes. If you have installed subversion somewhere else, of course, enter the corresponding path in place of this one.
- Check if it works by relaunching cmd.exe and typing svn --version again.
[/list][/list]
[b]Step 4 : Checkout ![/b]
[list]- Restart NetBeans. All the updates should be done by now.
- In the team menu, choose Subversion -> Checkout...
- The repository URL is : http://svn.l2jfree.com/svn/l2j-free/
- Browse the repository folders. The unstable but most up-to-date version is the one contained in trunk. Stable versions are in archive (last stable for each chronicle/throne) and tags (each version of login/gameserver)
- Choose the local folder in which all the sources will be extracted.
- Click on finish.
- A project should have appeared in your left sidebar, called l2jfree-main something. Extend it, then choose module, and you should see the different parts : l2jfree-core, l2jfree-login, etc.
- Open them all by right-clicking and choosing "Open Project".
[/list]
[b]Step 5 : Maven[/b]
[list]- Well, now you've got all your sources, you can edit them as you like, but you might want to compile now.
- You need to download maven http://www.apache.org/dyn/closer.cgi/maven/source/apache-maven-2.2.1-bin.zip
- Unzip it wherever you like but remember the path !
- In NetBeans, open the Tools menu and select Options.
- Click on the "Miscellaneous" icon.
- Click on "Maven"
- In the "External maven home" textbox, enter the path I asked you to remember earlier.
- In the "global options definition" field, write "-Dmaven.test.skip=true" (without quotes of course)

[/list]
[b]Step 6 : Finally, compile ![/b]
[list]- Now right click on an opened project (first you need to compile l2j-commons and mmocore in order to make it work for login and core) and choose Custom -> Goals...
- There, in the "Goals" field, just write "assembly:assembly" and then click "OK". Compilation should start.
- If you get an error saying something like "Java heap space / out of resources", you need to go to your Maven directory, in the "bin" subdir, and edit the mvn.bat file :
[list] - Find the line beginning by the following string : "%MAVEN_JAVA_EXE% %MAVEN_OPTS% -classpath %CLASSWORLDS_JAR%"
- Replace it with "%MAVEN_JAVA_EXE% %MAVEN_OPTS% -Xmx1024m -classpath %CLASSWORLDS_JAR%"
- If you have 1 Go of RAM or less, you might want to write "-Xmx512m" instead, because your system won't be ale to allocate 1 Go for the heap.
- Retry compiling.
[/list]- Your server is now compiled and ready to be run.[/list]]]> http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2699.page http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2699.page GMT

Some extra I would tell:

1. Even for 64bit systems, 32bit JDK is a good choice, if you don't need want to run programs with bigger heap than 32bit could have.

2. -

3. Actually any type of svn tool can be used which provides command line svn. (So "svn --version" response well..) - http://subversion.tigris.org/
About the version there is only one rule: You must use the same base version of the svn tools u are using. 1.4.x OR 1.5.x OR... because they have different format, so there is no guarantee that the svn files touched by the newer will be readable by the older.
(for the "Check if it works by typing svn --version again." part you have to restart your command prompt to get the new variables...)

4. Myself I prefer external checkout without the IDE, and importing the project later. For example typing "svn co http://svn.l2jfree.com/svn/l2j-free/trunk/ l2j-free" in the workspace is way more handy for me. (... and not every IDE has got perfect maven support already, so from my experiences imported maven projects usually has got less problems...)

5. http://maven.apache.org/download.html ... and I prefer to add maven to environmental variables too, so maven compilation works from command line/batch scripts too. (see step 3 part 2 how...)

6. trunk/tools/build-all.bat ... and actually the conventional way to increase maven heap limits is to add "MAVEN_OPTS" as environment variable too with the proper Xms/Xmx values ]]> http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2700.page http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2700.page GMT
I have followed the Eclipse tutorial too, but this one is more "short" and you got less errors.]]> http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2708.page http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2708.page GMT ]]> http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2710.page http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2710.page GMT [/quote]

+1]]> http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2714.page http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2714.page GMT thanks ! and thanks for the sticky too :o

On the comments discussing your preferences, I could probably agree with you, but I made this tutorial mainly for people that are maybe not yet familiar with Java, maven, subversion, etc. but know other programming languages and want to have an easy entry point un the l2jfree project. That's why I tried to keep it simple, and as much as possible in the GUI's (another reason for that would be that I'm not really familiar with the Windows command line interface ^^")
And the reason for prefering CollabNet Svn to another one is... simply because it is what Netbeans recommends.

About 6, I... haven't paid attention to this script yet. I probably should, I guess
]]> http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2715.page http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2715.page GMT
[code]svn co http://svn.l2jfree.com/svn/l2j-free/trunk/ l2j-free
cd l2j-free
cd tools
build-all.bat OR ./build-all.sh
[/code]]]> http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2718.page http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2718.page GMT http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2728.page http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2728.page GMT
I'm listing only the differences compared to the guide above. Btw don't forget to read my comments posted above also, because it could be useful for this.

... I also recommend to check this topic also: http://l2jfree-users.com/l2jfreeusers/posts/list/9.page

[b]Step 2: Eclipse[/b]
[list]- Download http://www.eclipse.org > Downloads > Eclipse IDE for Java Developers
- Extract it where you want.
- You will need the maven plugin, so follow the guide: http://maven.apache.org/ > IDE Integration > Eclipse
- ... and probably an svn plugin, for example this: http://subclipse.tigris.org/ > Download and Install
[/list]

[b]Step 4: Checkout[/b]
[list]- I still do not prefer checking out l2jfree from inside the IDE, as it's complicated so I won't tell that way.
- Go to your workspace, and open a command prompt/shell/bash whatever, and execute this (of course bat for win, sh for linux):
[code]svn co http://svn.l2jfree.com/svn/l2j-free/trunk/ l2j-free
cd l2j-free
cd tools
initialize-eclipse-environment.bat OR ./initialize-eclipse-environment.sh[/code][/list]

[b]Step 6: Initialization, compiling, import[/b]
[list]- Go to the /tools folder located in the just checkouted l2j-free folder!
- Execute initialize-eclipse-environment.bat OR ./initialize-eclipse-environment.sh
- When it's done you have everything compiled - so you could launch a server if you want to.
- Open Eclipse, and > File > Import > General > Existing Projects into Workspace, select all of the 5 projects it can find inside l2j-free folder.
- The wait until it finishes. Could take from a few sec to over a minute - it depends on your PC and especially on your HDD.
[/list]


In the future if you want to compile it you can do it from Eclipse, or - like me - by launching /tools/build-all.bat OR /tools/build-all.sh. I prefer the last one, as it's faster for me.]]> http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2732.page http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2732.page GMT [code]set CLEAN=
set COMPILE=
set INSTALL=
set DEPLOY=
set ASSEMBLY_ASSEMBLY=
set ECLIPSE_CLEAN=
set ECLIPSE_ECLIPSE=
set ECLIPSE_M2ECLIPSE=[/code]
in the build-all.bat


thanks in advance
]]> http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2820.page http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2820.page GMT
Btw file names where changed to be more clear, and to choose the proper it depends what you want...

initialize-eclipse-environment.* must be used for eclipse initialization, but for nothing else....

build-all.* is what you need for Netbeans, or if you aren't using an IDE.]]> http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2822.page http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/2822.page GMT
It seems that i can compile some of the files, but not the l2jfree-mmocore and l2jfree-core. Anyone else got this problem?]]> http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/3021.page http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/3021.page GMT http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/3067.page http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/3067.page GMT
Check your workspace project's folder for a folder called "target".]]> http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/3071.page http://www.l2jfree-users.com/l2jfreeusers/posts/preList/493/3071.page GMT