HowToBuildStendhal: Difference between revisions

From Arianne
Jump to navigation Jump to search
← Older edit
Content deleted Content added
imported>Kymara
style, ant clean mention
imported>AntumDeluge
mNo edit summary
 
(125 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Navigation for Stendhal Top|Building & Hosting}}
Building Stendhal is very simple if you use ant and you satisfy the dependencies.
{{Navigation for Stendhal Builders and Hosters}}


=Requirements=
To compile Stendhal you will need:
* module stendhal<br>http://arianne.sourceforge.net/?arianne_url=games/game_stendhal
* module marauroa <br>http://arianne.sourceforge.net/?arianne_url=servers/server_marauroa
* Java SDK 1.5<br>http://java.sun.com
* Ant 1.6<br>http://ant.apache.org


⚫
= Build Tools =
Optionally:
* Tiled<br>http://tiled.rpgdx.net/


See [[HowToBuildStendhal/BuildTools|build tools page]].
You can download a compiled marauroa file but Stendhal CVS occaisonally requires 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=
= Components =
⚫
==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.


All component packages, other than Android client, can be built with a single Ant command: <span style="color:darkred;">''ant dist''</span>. This will output the following:
To build Stendhal first make sure you have the JAR files in the correct place.
<pre>
cd path/to/stendhal
cd ..
mkdir libs
cd stendhal
</pre>


* ''<span style="color:darkblue;">build/stendhal-&lt;version&gt;-src.tar.gz</span>''
Make sure you remove the version number from name or that you create links to the real file without any version number.
* ''<span style="color:darkblue;">build/stendhal-server-&lt;version&gt;.zip</span> (includes web client)''
Now just write:
* ''<span style="color:darkblue;">build/stendhal-&lt;version&gt;.zip</span> (Java client)''
ant dist
* ''<span style="color:darkblue;">build/stendhal-webclient-&lt;version&gt;.zip</span> (requires server)''
* ''<span style="color:darkblue;">build/stendhal-starter-&lt;version&gt;.zip</span> (obsolete)''


''<span style="color:darkblue;">'''TODO:''' Instructions for individual components.</span>''
This will build a full set of JAR files at stendhal/build/lib folder.


Client files
== Server and Web Client ==
stendhal-''version''.jar
stendhal-data-''version''.jar


== Desktop Client ==
Server files
stendhal-server-''version''.jar
stendhal-conf-''version''.jar
stendhal-quests-''version''.jar
stendhal-maps-''version''.jar


== Webstart ==
== Java Desktop Client ==
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:


== Android Client ==
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''


* [[BuildStendhalForAndroid#WebView_Client|Build Stendhal WebView Client for Android]]
= 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 =
= Systems =
When you have successfully built Stendhal please read the install documentation. It is available on the Wiki at [[InstallingStendhal]].


== Windows ==
In future if you wish to just create the client and server jars (not zips and all release packages) then
ant clean && ant
will suffice. Remember to "ant clean" before you "ant build" everytime - this is done automatically if you "ant dist", however.


* [[VisualGuideToBuildingStendhal|Visual Guide to Building Stendhal on Windows®]]
<br>
<br>
<br>
----


== GNU/Linux ==
[[Stendhal | Back to stendhal main wiki page]]


* [[BuildStendhalOnUbuntu|Building Stendhal on Ubuntu® - Installation Guide Step-by-step]]
⚫
[[Category:Stendhal]]

== Mac OS X ==

* [[BuildStendhalOnMacOsX|Build Stendhal On Mac Os X]]

== Android WebView Client ==

* [[BuildStendhalForAndroid#WebView_Client|Build Stendhal WebView Client for Android]]

= General Information =

* [[HowToGetLatestStendhal|How to get the latest version?]]


⚫
[[Category:Development]]

Latest revision as of 23:40, 12 January 2026



Build Tools

See build tools page.


Components

All component packages, other than Android client, can be built with a single Ant command: ant dist. This will output the following:

  • build/stendhal-<version>-src.tar.gz
  • build/stendhal-server-<version>.zip (includes web client)
  • build/stendhal-<version>.zip (Java client)
  • build/stendhal-webclient-<version>.zip (requires server)
  • build/stendhal-starter-<version>.zip (obsolete)

TODO: Instructions for individual components.

Server and Web Client

Desktop Client

Java Desktop Client

Android Client


Systems

Windows

GNU/Linux

Mac OS X

Android WebView Client

General Information

Retrieved from "https://meet.konsthol.eu/w/index.php?title=HowToBuildStendhal&oldid=118614"