VisualGuideInstallingStendhal: Difference between revisions

=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.''

[[User:Oslsachem|oslsachem]] 14:22, 26 March 2006 (PST)

<br>

--[[User:Javydreamercsw|Javydreamercsw]] 09:19, 5 March 2008 (PST) (Updated to Stendhal 0.67/Marauroa 2.5)

<BR>

---[[User:worldofours|worldofours]] 22:00, 7 April 2008 (EST) (Slight Revision)

<br>

--[[User:Gummipferd|Gummipferd]] 14:47, 4 May 2008 (PDT) (cleaned guide, made the it work with Stendhal 0.67/Marauroa 2.5)

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.5.zip?download Marauroa-2.5]

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

*[http://prdownloads.sourceforge.net/arianne/stendhal-FULL-0.67.zip?download?download Stendhal-0.67] (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, 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 <tt>irc.freenode.net</tt>, channel <tt>#arianne</tt> 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 <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. Install marauroa server]]

*[[VisualGuideToInstallingStendhalStep4|Step 4. Configure marauroa to access the MySQL database]]

*[[VisualGuideToInstallingStendhalStep5|Step 5. Install Stendhal server and client]]

*[[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]]