View source for Easy Stendhal Server Installation On Windows

{{Navigation for Stendhal Top|Building & Hosting}}

The install process for a Stendhal server on Windows is just a few easy steps.

This guide applies to Stendhal 0.81 and above. The current Stendhal version is {{version}}, but the pictures below show the version number blurred out (for future proofing!)

If you need any help then please connect to [https://web.libera.chat/#arianne #arianne], ask your question and hang around for a reply :)

__toc__

== Get server files ==

The server files are available as a .zip. 
* Go to [http://arianne.sourceforge.net/?arianne_url=games/game_stendhal#downloadsection download files] and download stendhal-server-{{version}}.zip
* Save it on your desktop
* Extract the files '''into a folder on your desktop called stendhalserver'''

{|
|-
|[[File:WinGuide1.jpg|thumb|400px|In Windows XP you extract the zip by right clicking and select ''Extract All'']]
|[[File:WinGuide1Vista.png|thumb|400px|In Vista you double click the zip to view the items and then click on ''Extract all files'']]
|[[File:WinGuide2.jpg|thumb|400px|In both cases, choose to extract to Desktop\stendhalserver (I typed it in, and the folder was created)]]
|}

Here is roughly what you should see inside the stendhalserver folder: 

[[File:StendhalH2WinGuide01.png‎|border]]

== Configure and run the server ==

Double click ''runserver.bat'' which is inside your stendhalserver folder.

[[File:StendhalH2WinGuide02.png]]

This will open a command window:

[[File:StendhalH2WinGuide03.png]]

Just '''hit enter twice''' to accept the defaults offered:

[[File:StendhalH2WinGuide04.png]]

'''Warning:''' If you decide to specify a RSA key size, then don't choose a value smaller than the default [512].

There will be a delay while the key is generated, please be patient.

[[File:StendhalH2WinGuide05.png]]

When the generation of the key has finished, the server will be run immediately.  Here are the first few lines you will see:

[[File:StendhalH2WinGuide06.png]]

And then you will see zones loading:

[[File:StendhalH2WinGuide07.png]]

And finally quests loading:

[[File:StendhalH2WinGuide08.png]]

When it is ready you will see 'marauroa is up and running' as below:

[[File:StendhalH2WinGuide09.png]]

'''To stop the server''' you just need to press '''CTRL+C''' in that window, and then type '''y''' to the yes/no question.

[[File:StendhalH2WinGuide10.png]]

'''To start the server again''', just double-click the ''runserver.bat'' file as in the beginning of this step.
The program will detect that the server has already been configured (i.e. that a ''server.ini'' file exists) and will just start the server.

== Connect to localhost ==
If you have already the client installed to connect to the public server, you can use it if it is the same version. However, you have to connect to ''localhost'' server and '''create a new account''' there.

If you didn't already have a Stendhal client, you need to download [http://sourceforge.net/project/platformdownload.php?group_id=1111&sel_platform=410 stendhal-FULL-{{version}}.zip]

Unzip the Folder that you get, wherever you choose. Then double-click the stendhal-{{version}}.jar file and create a new account, '''with ''Server Name'' localhost instead of the default server'''.

[[Image:CreateNewAccountLocalhost.png]]

'''Warning:''' :

And the same everytime you want to connect to your server: '''choose the ''localhost'' server'''.

[[Image:LoginLocalhost.png]]

== Make yourself an admin ==

There's already a folder called ''data'' in the stendhal server folder

* Go into ''data''

[[File:StendhalH2WinGuide11.png]]

* Go into ''conf''

[[File:StendhalH2WinGuide12.png]]

* Edit the ''admins.txt'' file ( it is named just ''admins'' if file extensions are hidden in your system ). You can use your favourite text editor, e.g. Notepad

[[File:StendhalH2WinGuide13.png]]

* Add the admin names to the list and hit enter at the end of the last one

[[File:StendhalH2WinGuide14.png]]

* Save the file and close the text editor

Now '''restart your server''', and it will read the names from ''admins.txt'' and give them [[Stendhal:Administration|adminlevel]] 5000!

'''Any problems? Please connect to [https://web.libera.chat/#arianne #arianne], ask your question and hang around for a reply :)'''

== See Also ==

[[StendhalServerTroubleShooting| Trouble shooting]]

[[StendhalPublicServer|How to host an online Stendhal server]]

[[H2 database control]]