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://www.arianne.cx/ 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.

Create a MySql user and database for the game

Run the sql client (bin/mysql.exe on the windows noinstall package). Paste the following lines to the prompt that opens:

   create database stendhal;
   grant all on stendhal.* to <user>@localhost identified by '<password>';

It should produce output similar to this:

 Welcome to the MySQL monitor.  Commands end with ; or \g.
 Your MySQL connection id is 1 to server version: 4.1.10
 
 Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
 
 mysql> create database stendhal;
 Query OK, 1 row affected (0.03 sec)
 
 mysql> grant all on stendhal.* to testuser@localhost identified by 'testpass';
 Query OK, 0 rows affected (0.00 sec)
 
 mysql>

Edit the Marauro ini file

Fill in the correct values for the database related fields in the marauroa.ini file.

For example, like this:

marauroa_DATABASE=JDBCPlayerDatabase jdbc_url=jdbc:mysql://127.0.0.1/stendhal jdbc_class=com.mysql.jdbc.Driver jdbc_user=stendhal_user jdbc_pwd=stendhal_passwd

Copy Stendhal to the Maraurora classpath

For example copy the stendhal jar to the same folder where the compiled code for Maraurora is.

Start the server

Run the maraurora.bat file (or create an equivalent shell script if in unix).

Start the Stendhal client

TODO: We need a bat file or such for starting the client.