VisualGuideToBuildingStendhal: Difference between revisions
Jump to navigation
Jump to search
Content deleted Content added
imported>Oslsachem m →Welcome |
imported>AntumDeluge add page categories |
||
| (27 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
=Building Stendhal on Windows |
=Visual Guide to Building Stendhal on Windows®= |
||
| ⚫ | |||
''Note: oslsachemmies is a non-registered trademark. Any ressemblance to the word "dummies" is purely coincidental.'' |
|||
The versions of the programs used in this guide may not be the most recent ones. You should use the most recent versions even if they look somewhat different than these versions. |
|||
[[User:Oslsachem|oslsachem]] 14:39, 27 March 2006 (PST) |
|||
This guide |
This guide uses the spanish version of Windows XP®. |
||
*[http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=jdk-1.5.0_06-oth-JPR&SiteId=JSC&TransactionId=noreg Java Development Kit (JDK) 5.0 Update 6] |
|||
*[http://ant.apache.org/bindownload.cgi Apache Ant 1.6.5] |
|||
*[http://prdownloads.sourceforge.net/arianne/stendhal_mapeditor-1.20.zip?download Stendhal_mapeditor-1.20] |
|||
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!). |
|||
== But first... are you sure that you don't want to use an IDE? == |
|||
==Welcome== |
|||
This guide is aimed at those who just want to play the latest version of the game before it is officially released. |
|||
If you intend to do modifications to the game, it is recommended that you follow [[Configure a development environment (IDE)]] instead. |
|||
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 is completely based on a more generic [[HowToBuildStendhal|guide]] by mblanch. |
|||
*[[VisualGuideToBuildingStendhalStep2|2. Install and Configure Ant]] |
|||
*[[VisualGuideToBuildingStendhalStep3|3. Install TortoiseGit]] |
|||
*[[VisualGuideToBuildingStendhalStep4|4. Get the Stendhal source using TortoiseGit]] |
|||
*[[VisualGuideToBuildingStendhalStep5|5. Build the Stendhal distribution using Ant]] |
|||
*[[VisualGuideToBuildingStendhalStep6|6. Locate the built server and client zip files]] |
|||
== Get started == |
|||
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 <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 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 <tt>#ariannne</tt> at <tt>irc.freenode.net</tt>.<br>''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 "<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: |
|||
**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'' |
|||
| ⚫ | |||
| ⚫ | |||
Go to [[VisualGuideToBuildingStendhalStep1|Step 1. Install the most recent version of JDK]] |
|||
*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 |
|||
[[Category:Stendhal]] |
|||
| ⚫ | |||
[[Category:Development]] |
|||
[[Category:Windows]] |
|||
Latest revision as of 00:23, 15 January 2022
Visual Guide to Building Stendhal on Windows®
Building Stendhal is very simple, but it is recommended that you first try installing your local stendhal server on Windows®.
The versions of the programs used in this guide may not be the most recent ones. You should use the most recent versions even if they look somewhat different than these versions.
This guide uses the spanish version of Windows XP®.
But first... are you sure that you don't want to use an IDE?
This guide is aimed at those who just want to play the latest version of the game before it is officially released. If you intend to do modifications to the game, it is recommended that you follow Configure a development environment (IDE) instead.
Overview
Listed below are the major steps required to install compiling tools and compile Stendhal source files on Windows XP®:
- 1. Install the most recent version of JDK
- 2. Install and Configure Ant
- 3. Install TortoiseGit
- 4. Get the Stendhal source using TortoiseGit
- 5. Build the Stendhal distribution using Ant
- 6. Locate the built server and client zip files