HowToBuildStendhal
Building Stendhal is very simple if you use ant and you satisfy the dependencies.
Requirements
To compile Stendhal you will need:
- module stendhal
http://arianne.sourceforge.net/?arianne_url=games/game_stendhal - module marauroa
http://arianne.sourceforge.net/?arianne_url=servers/server_marauroa - Java SDK 1.5
http://java.sun.com - Ant 1.6
http://ant.apache.org
Optionally:
You can download compiled marauroa file but Stendhal CVS somtimes require Marauroa CVS as well.
We do not include dependencies in the source download, to keep the size small. They are in CVS, however, and you can download them via the CVS webfrontend at http://arianne.cvs.sourceforge.net/arianne/stendhal/libs/
Build
Build using ant
First you need ant properly installed on your system to build Stendhal. Second you need to compile successfully Marauroa using the compile task.
To build Stendhal first make sure you have the JAR files in the correct place.
cd path/to/stendhal cd .. mkdir libs cd stendhal
Make sure you remove the version number from name or that you create links to the real file without any version number. Now just write:
ant dist
This will build a full set of JAR files at stendhal/build/lib folder.
Client files
stendhal-version.jar stendhal-data-version.jar
Server files
stendhal-server-version.jar stendhal-conf-version.jar stendhal-quests-version.jar stendhal-maps-version.jar
Webstart
In order for webstart to work, the client .jar-files have to be signed. There is some documentation on http://java.sun.com how this works. So i will put here only a small piece of information to get it integrated into the build process:
Put your private key into a file called keystore.ks into the stendhal-root folder Create a file called build.ant-private.properties with theses lines (replacing the values):
keystore.alias=miguelangelblanchlardin@hotmail.com keystore.password=secret
Trouble shooting
If you have the message error:
stendhal_source/build.xml:42: Could not create task or type of type: replaceregexp.
Solution:
If you have linux: You need the "ant-apache-regexp" package, if you use debian or another debian dist (like Ubuntu) you need install the "ant-optional" package
Finally
When you have successfully built Stendhal please read the install documentation. It is available on the Wiki at InstallingStendhal.