BuildStendhalOnUbuntu: Difference between revisions
Jump to navigation
Jump to search
Content deleted Content added
imported>Kymara add todo as this is outdated. |
imported>Oslsachem a merger of two guides for building stendhal using ant in ubuntu that needs an update from an ubuntu user |
||
| Line 1: | Line 1: | ||
Building Stendhal is very simple if you use ant and you satisfy the dependencies. |
|||
{{TODO| Cleanup or delete, because this is outdated (e.g. you do not need to download any of those jars individually now.) It only seems to explain how to run the client and not build the server. [[StendhalLocalhostServerOnLinux]] is preferred. }} |
|||
This guide, taken from [http://arianne.sourceforge.net/wiki/index.php?title=HowToBuildStendhal a more generic guide] will tech you how to build (compile) Stendhal on an Ubuntu machine. This guide was initial written with a Kubuntu 6.06 machine as the tester, so it should be pretty current (at least for another 6 months). |
|||
== But first... are you sure that you don't want to use an IDE? == |
|||
= Requirements = |
|||
This guide is aimed at those who just want to play the latest version of the game before it is officially released. |
|||
These are the requirements needed to build Stendhal |
|||
If you intend to do modifications to the game, it is recommended that you follow [[Configure a development environment (IDE)]] instead. |
|||
* [http://sourceforge.net/project/showfiles.php?group_id=1111&package_id=145790 Latest stendhal.X.xx-src.tar.gz package] |
|||
* [http://arianne.cvs.sourceforge.net/arianne/stendhal/libs/ Libs (all .jar files from there)] |
|||
* Sun Java SDK 1.5: sun-j2re1.5 |
|||
** Note: You need to have the [http://doc.ubuntu-fr.org/doc/plf PLF repositories] to get the sun-j2re1.5 package |
|||
* ant |
|||
* ant-optional |
|||
** Note: You need to have your universe repositories enabled to get ant-optional |
|||
== Quick Req. Install == |
|||
sudo apt-get update |
|||
sudo apt-get install liblog4j1.2-java sun-j2re1.5 jython ant ant-optional |
|||
==Requirements== |
|||
These are the requirements needed to build Stendhal: |
|||
* stendhal source as a stendhal-''version''-src.tar.gz <br>http://arianne.sourceforge.net/?arianne_url=games/game_stendhal#downloads |
|||
After downloading it, unpack the stendhal source gzip. From command line: |
|||
cd ~ |
cd ~ |
||
tar xzf stendhal-''version''-src.tar.gz |
|||
mkdir build |
|||
cd build |
|||
* OpenJDK or Sun's JDK 1.5 ''or higher'' e.g.: |
|||
download the source from http://sourceforge.net/project/showfiles.php?group_id=1111&package_id=145790 |
|||
sudo aptitude install sun-java6-jdk |
|||
tar xvzf stendhal*.tar.gz |
|||
'''Note:''' You need to have the [http://doc.ubuntu-fr.org/doc/plf PLF repositories] to get the sun-j2re1.5 package |
|||
cd stendhal* |
|||
mkdir libs |
|||
* ant <br>http://ant.apache.org or e.g.: |
|||
cd libs |
|||
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 = |
|||
Now download the jar files from http://arianne.cvs.sourceforge.net/arianne/stendhal/libs/ |
|||
When you have successfully built Stendhal please reread the install documentation. It is available on the Wiki at [[InstallingStendhal]]. |
|||
* ant.jar |
|||
* jardiff.jar |
|||
* log4j.jar |
|||
* pircbot.jar |
|||
* tiled.jar |
|||
* groovy.jar |
|||
* junit-4.1.jar |
|||
* marauroa.jar |
|||
* simple.jar |
|||
* commons-lang.jar |
|||
& any other jars in that folder not listed here may be needed too (if this guide got out of date for example.) |
|||
In the future if you wish to just create the client and server jars (not zips and all release packages) then |
|||
Now go to stendhal dir (one level up) and start ant: |
|||
ant clean compile |
|||
will suffice. Remember to "ant clean" before you "ant build" everytime - this is done automatically if you "ant dist", however. |
|||
cd .. |
|||
ant clean && ant |
|||
=== Client Files === |
|||
Needed to play. |
|||
stendhal-X.xx.jar |
|||
stendhal-data-X.xx.jar |
|||
== CVS == |
|||
Needed if you make your own server |
|||
stendhal-server-X.xx.jar |
|||
stendhal-xmlconf-X.xx.jar |
|||
stendhal-maps-X.xx.jar |
|||
Assuming you have CVS installed, you can instead download our source from our CVS HEAD: |
|||
= To Play = |
|||
cvs -d:pserver:anonymous@arianne.cvs.sourceforge.net:/cvsroot/arianne login |
|||
To play stendhal, simply copy the compiled binaries over your existing game (make a backup first, unless you want to re-download stendhal if you mess up). |
|||
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. |
|||
If you want to start it from stendhal-X.xx/build/lib directory you have to copy the libs from stendhal-X.xx/libs/ there: |
|||
cd stendhal-X.xx/build/lib |
|||
cp ../../libs/* . |
|||
And to start type: |
|||
java -jar stendhal-X.xx.jar |
|||
[[Category:Stendhal]] |
[[Category:Stendhal]] |
||