VisualGuideInstallingStendhal

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.

oslsachem 14:22, 26 March 2006 (PST)

This guide was produced using:

• MySQL 5.0.19 Community Edition essential binary package
• Marauroa-1.31.1
• Stendhal-server-0.47.1
• Stendhal-0.47 (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!).

Warning: The marauroa version 1.31 was wrong. Now that is fixed: marauroa-1.31.1. Please try this guide again if you did it before.

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, who did not have any knowledge of MySQL or Java and did not really know what he was doing (so let's hope you do). However, oslsachem is a big enthusiast of Stendhal, so please contact him at IRC server irc.freenode.net, channel #arianne wether you have successfully installed the server or failed in doing it at any step with this guide (just don't blame him if your computer melts or if anything less spectacular happens).

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. Install marauroa server
• Step 4. Configure marauroa to access the MySQL database
• Step 5. Install Stendhal server and client
• 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