VisualGuideToBuildingStendhal
Building Stendhal on Windows XP® - Visual Installation Guide Step-by-step (for oslsachemmies)
Note: oslsachemmies is a non-registered trademark. Any ressemblance to the word "dummies" is purely coincidental.
oslsachem 14:39, 27 March 2006 (PST)
This guide was produced using:
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 building Stendhal on Windows XP®. In other words: your own version of Stendhal to mess with.
This guide assumes and requires that you have performed the previous guide: installing your stendhal server as localhost on Windows XP®.
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 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 compiling stendhal on your helpless computer?
- Because this way 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 it's a yet another good excuse to quit the IRC ang get rid at last of that bunch of pesters at #ariannne at irc.freenode.net.
Note: this server and channel have been used again only for exemplifying purposes. Not further conclusions should be assumed. - Because your dog ate your binary Stendhal files.
- Put a better reason here ...
This document presents a step-by-step walkthrough of the installing the compiling tools and compiling source files and building 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.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 and later versions.
- Files placed in the wrong folder:
- you have mistaken binary server and binary client *.jar files that go into different folders
- you have put files in a folder created as \lib instead of \libs
- you have not moved a file to a parent or child folder like moving tiled.jar from \development to \development\libs
Overview
Listed below are the major steps required to install compiling tools and compile Stendhal source files on Windows XP®:
- Uninstall JRE and install JDK
- Install and Configure Ant
- Install Stendhal-server sources or map editor CVS sources
- Compile Stendhal using ant
- Move compiled files to server and client folders