BuildStendhalOnUbuntu

Building Stendhal is very simple if you use ant and you satisfy the dependencies.

But first... are you sure that you don't want to use an IDE?

This guide is aimed at those who just want to play the latest version of the game before it is officially released. If you intend to do modifications to the game, it is recommended that you follow Configure a development environment (IDE) instead.

Requirements

These are the requirements needed to build Stendhal:

• stendhal source as a stendhal-version-src.tar.gz
  http://arianne.sourceforge.net/?arianne_url=games/game_stendhal#downloads

After downloading it, unpack the stendhal source gzip. From command line:

cd ~
tar xzf stendhal-version-src.tar.gz

• OpenJDK or Sun's JDK 1.5 or higher e.g.:

sudo aptitude install sun-java6-jdk

Note: You need to have the PLF repositories to get the sun-j2re1.5 package

• ant
  http://ant.apache.org or e.g.:

sudo aptitude install ant

• ant-optional:

sudo aptitude install ant-optional

Note: You need to have your universe repositories enabled to get ant-optional

Building with ant

cd stendhal-version 
ant clean &&  ant dist

This will create the binaries you should be already familiar with, such as:

Client files

build/stendhal-version.zip

build/stendhal-FULL-version.zip

Server files

build/stendhal-server-version.zip

Source files

build/stendhal-src-version.tar.gz

Building just the jar files

Note: If you are unsure, follow the instructions described in the previous section (ant dist) to get a working system with all the files in the correct directory structure.

To only build the jar files, without putting them together inside a zip, you just write

ant

This will build a full set of JAR files at stendhal-version/build/lib folder:

Client files

build/lib/stendhal-version.jar

build/lib/stendhal-data-version.jar

build/lib/stendhal-sound-data-version.jar

Server files

build/lib/stendhal-server-version.jar

build/lib/stendhal-xmlconf-version.jar

build/lib/stendhal-maps-version.jar

Trouble shooting

If you have the message error:

stendhal_source/build.xml:42: Could not create task or type of type: replaceregexp.

For linux users this is corrected by installing the "ant-apache-regexp" package. If you use debian or another debian dist (like Ubuntu) this is included in the "ant-optional" package.

Finally

When you have successfully built Stendhal please reread the install documentation. It is available on the Wiki at InstallingStendhal.

In the future if you wish to just create the client and server jars (not zips and all release packages) then

ant clean compile

will suffice. Remember to "ant clean" before you "ant build" everytime - this is done automatically if you "ant dist", however.

CVS

Assuming you have CVS installed, you can instead download our source from our CVS HEAD:

cvs -d:pserver:anonymous@arianne.cvs.sourceforge.net:/cvsroot/arianne login
cvs -z3 -d:pserver:anonymous@arianne.cvs.sourceforge.net:/cvsroot/arianne co -P stendhal

Which will check out a copy of the stendhal source into a folder called stendhal. Then follow the steps to build using ant as before. If you are asked for a password during checkout, just leave it empty and hit enter.