VisualGuideInstallingStendhal

NOTICE: Please look at Easy Stendhal Installation On Windows if you want a fast guide for installing windows without bothering with MySQL installation and configuration.

Stendhal localhost server on Windows XP® - Visual Installation Guide Step-by-step (for oslsachemmies)

Note: oslsachemmies is a non-registered trademark. Any resemblance to the word "dummies" is purely coincidental.

This guide was produced using:

• MySQL 5.0 Community Server - Generally Available
• Java Version 6 Update 5
• Marauroa-2.6
• Stendhal-server-0.69
• Stendhal-0.69 (the client)

So subsequent versions could look moderately or somewhat different from what you see in these versions. As the programs evolve, this guide could become outdated (let's hope not!).

Welcome

Welcome to a visual, screenshot-based step-by-step guide to getting Stendhal/marauroa localhost server installed on Windows XP®. In other words: your own local server to mess with.

This guide is completely based on a more generic guide by mblanch.

This guide was originally produced by oslsachem, and has been updated since by many contributors and developers. However it can still become out of date or have mistakes, so please contact any of the team at the IRC server irc.freenode.net, channel #arianne ifyou have any difficulty. Please let us know what steps are failing and provide the link to the specific page.

In places, this guide uses the spanish version of Windows XP®. Sorry for the inconveniences. :(

Introduction

Ok, first of all, why would you ever imagine installing Stendhal on your helpless computer?

• Because this is a required step (but not enough) to build Stendhal on your own local server so that you can:
  • Test your new NPCs, quests, maps, graphics... And this way you can see how they work before submitting them (not that this is necessary at all).
  • Know how it feels being an admin.
• Because you want to know how it feels being the Omega player: the last player on Stendhal.
• Because it's a good excuse to quit the IRC ang get rid at last of that bunch of pesters at #arianne at irc.freenode.net.
  Note: this server and channel have been used only for exemplifying purposes. Not further conclusions should be assumed.
• Because your dog ate your homework.
• Put a better reason here ...

This document presents a step-by-step walkthrough of the installing and running process. The whole process can be a bit long because of the number of steps and substeps but it isn't really difficult as you must only follow (obediently!) a sequence of (I hope) well defined steps.

The main cause of errors I have experienced in all this process is that the program used can't find certain files and so it shows errors like "can't find symbol...". This happens with:

• Files with the wrong name:
  • Because a file that is referenced by other file has an added suffix for version, like marauroa-1.31.1.jar instead of just marauroa.jar
  • Because a file that references other file has to be edited, like marauroad.bat file for stendhal-server-0.47.1 and later versions and for marauroa-1.31.1 and later versions.
• Files placed in the wrong folder (sometimes you can mistake binary server and binary client *.jar files that go into different folders)

Overview

Listed below are the major steps required to install and run Stendhal as a localhost server on Windows XP®:

• Step 1. Install and configure MySQL
• Step 2. Create a MySQL database
• Step 3. Step removed! - because marauroa is included in the stendhal distribution now.
• Step 4. Install Stendhal server
• Step 5. Configure marauroa to access the MySQL database
• Step 6. Run MySQL as a service (if it is not running already)
• Step 7. Run Stendhal server as localhost
• Step 8. Install and run Stendhal client as localhost

Go to Step 1. Install and configure MySQL

---

Back to stendhal main wiki page