VisualGuideInstallingStendhal: Difference between revisions

'''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:

*[http://dev.mysql.com/downloads/mysql/5.0.html#downloads MySQL 5.0 Community Server - Generally Available]

*[http://www.java.com/en/download/manual.jsp?BundleId=18712?Sun Java Version 6 Update 5]

*[http://prdownloads.sourceforge.net/arianne/marauroa-2.6.zip?download Marauroa-2.6]

*[http://prdownloads.sourceforge.net/arianne/stendhal-server-0.69.zip?download Stendhal-server-0.69]

*[http://prdownloads.sourceforge.net/arianne/stendhal-FULL-0.69.zip?download?download 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 [[InstallingStendhal|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 <tt>irc.freenode.net</tt>, channel <tt>#arianne</tt> 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 <tt>#arianne</tt> at <tt>irc.freenode.net</tt>.<br>''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 "<tt>can't find symbol...</tt>". 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®:

*[[VisualGuideToInstallingStendhalStep1|Step 1. Install and configure MySQL]]

*[[VisualGuideToInstallingStendhalStep2|Step 2. Create a MySQL database]]

*[[VisualGuideToInstallingStendhalStep3|Step 3. Step removed!]] - because marauroa is included in the stendhal distribution now.

*[[VisualGuideToInstallingStendhalStep4|Step 4. Install Stendhal server]]

*[[VisualGuideToInstallingStendhalStep5|Step 5. Configure marauroa to access the MySQL database]]

*[[VisualGuideToInstallingStendhalStep6|Step 6. Run MySQL as a service (if it is not running already)]]

*[[VisualGuideToInstallingStendhalStep7|Step 7. Run Stendhal server as localhost]]

*[[VisualGuideToInstallingStendhalStep8|Step 8. Install and run Stendhal client as localhost]]

Go to [[VisualGuideToInstallingStendhalStep1|Step 1. Install and configure MySQL]]