InstallingStendhal

Install MySQL

Download the appropriate MySQL install package from http://dev.mysql.com/downloads/

Also download the java connector library from the same place (it's called "MySQL Connector/J" ), unzip it, and make sure it is on the classpath when running maraurorad later.

Download Maraurora

Download Maraurora from http://arianne.sourceforge.net/ or check out the cvs version and build it.

Start MySQL

Refer to the MySql installation documentation for details.

If you used the noinstall package, you can run bin/mysqld.exe.

Make sure to edit the configuration files to disallow external access if you are just going to use it for local testing, or simply use a firewall to block external access to the database.

Configure MySQL and create .ini file

Read at [Marauroa configuration] how to create a database and how to create the configuration .ini file for marauroa.

Copy Stendhal to the Maraurora classpath

Marauroa is just the middleware to make everything run.
But you need to feed it with games. To make Marauroa run Stendhal, just copy the result of compiling stendhal to marauroa folder.

If you download Marauroa, and unzip it you will see this:

C:\...\marauroa-0.90>dir
19/02/2005  19:51    <DIR>          .
19/02/2005  19:51    <DIR>          ..
19/02/2005  13:28               133 AUTHORS
19/02/2005  13:28               141 BUGS
19/02/2005  13:28            18.332 COPYING
19/02/2005  13:28           719.950 jython.jar
19/02/2005  13:28            18.332 LICENSE
19/02/2005  13:28           149.364 marauroa-0.90.jar
19/02/2005  13:28             1.294 marauroa.ini
19/02/2005  13:28               162 marauroad.bat
19/02/2005  13:28           235.712 mysql-connector-java-3.0.15-ga-bin.jar
19/02/2005  13:28            13.930 README
              10 files      1.157.350 bytes
               2 dirs  19.775.102.976 bytes free

Using Stendhal source files

If you grabbed Stendhal source, you need to compile it now. So simply go to Stendhal folder and type

C:\...\stendhal>ant jar
<pre>
Buildfile: build.xml

init:
    [mkdir] Created dir: C:\....\stendhal\build
    [mkdir] Created dir: C:\....\stendhal\lib
    [mkdir] Created dir: C:\....\javadocs

client_compile:
   [delete] Deleting directory C:\....\stendhal\build
    [mkdir] Created dir: C:\....\stendhal\build
     [copy] Copying 3 files to C:\....\stendhal\build\sprites
    [javac] Compiling 18 source files to C:\....\stendhal\build

client_jar:
      [jar] Building jar: C:\....\stendhal\lib\stendhal-0.00.jar

server_compile:
   [delete] Deleting directory C:\....\stendhal\build
    [mkdir] Created dir: C:\....\stendhal\build
     [copy] Copying 3 files to C:\....\stendhal\build\games\stendhal\server\maps
    [javac] Compiling 6 source files to C:\....\stendhal\build

server_jar:
      [jar] Building jar: C:\....\stendhal\lib\stendhal-server-0.00.jar

jar:

BUILD SUCCESSFUL
Total time: 3 seconds

Now in lib folder you have two jar files:

C:\....\stendhal\lib>dir
19/02/2005  22:02    <DIR>          .
19/02/2005  22:02    <DIR>          ..
19/02/2005  22:02           109.104 stendhal-0.00.jar
19/02/2005  22:02            11.851 stendhal-server-0.00.jar
               2 files        120.955 bytes
               2 dirs  19.775.070.208 bytes free

Installing the Stendhal server module

Either if you compiled it or if you downloaded a compiled version from Website you need to copy stendhal-server-X.XX.jar file to Marauroa folder so server can see it.

Copy stendhal-server-0.00.jar into Marauroa folder:

  copy stendhal-server-0.00.jar D:\.....\marauroa

Go to Marauroa folder and edit marauroad.bat file, that should looks like:

set LOCALCLASSPATH=.;stendhal-server-0.00.jar;marauroa-0.90.jar;jython.jar;mysql-connector-java-3.0.15-ga-bin.jar
java -cp "%LOCALCLASSPATH%" marauroa.server.marauroad -c marauroa.ini -l

Did you noticed the added stendhal-server-0.00.jar file?

Congrats! You have successfully installed Stendhal in a Marauroa server.

Start the server

Now start marauroa server by running marauroad.bat

Start the Stendhal client

Refer to Initial steps with Stendhal guide.