StendhalLocalhostServerOnLinux: Difference between revisions

Content deleted Content added
imported>Immibis
MAJOR CHANGES AND BROUGHT UP-TO-DATE
imported>Kymara
Please lets keep X.XX as version else the guide gets out dated with every new release!!!
Line 1:
This guide applies to:
*Marauroa 2.1
*Stendhal 0.64 and above
*Stendhal server 0.64
 
= Setting up a localhost server =
This guide will teach you how to set up a server on your Linux machine. The server will be a local one, so people from around the world cannot get to your server. Only those who are directly connected to you via a LAN can connect to this server. The required packages are:
*Marauroa version 2.1, see below
*A compiled version of the Stendhal Server, version 0X.64XX
*MySQL
*GNU/Linux (This may be others, the directions should apply almost exactly to any *nix system)
Line 14 ⟶ 13:
<!-- This is heavily based on the Visual Guide to Setting up a Localhost Server on Windows XP (c) -->
== Getting the materials ==
Download a current version of Stendhal. If you want to use the current release of the Stendhal server, go to httptohttp://arianne.sourceforge.net/?arianne_url=games/game_stendhal#downloadsection and download the stendhal-server-X.XX.zip from that page.
 
If you want to compile it yourself from CVS or the source code provided at the downloads link, then see [[HowToBuildStendhal|How to build Stendhal]] for more info. If you run a Linux System, then you have the necessary tools to get everything else. I recommend ViM for those command-line lovers, and GEdit/Kate for those GUI people. Command line access shouldn't be a problem, though if it is, ask your system administrator if you do and how to get to it.
 
= Setting up MySQL =
Line 44 ⟶ 43:
 
== Marauroa and Stendhal: Moving time! ==
Check you have the following files in the server directory, either from your zip or your own build:
*stendhal-mapsserver-0X.64XX.jar
*marauroa.jar
*stendhal-xmlconf-0X.64XX.jar
*log4j.properties
*stendhal-servermaps-0X.64XX.jar
*stendhal-xmlconf-0.64.jar
*stendhal-maps-0.64.jar
*log4j.jar
*groovy.jar
*simple.jar
*marauroa.jar
*log4j.jar
*log4j.properties
*jython.jar
*mysql-connector.jar
*commons-lang.jar
<!-- there is no real order to this list, just how I remembered it -->
 
The first few will be included in your zip of the server. If any of the latter ones are missing you can fetch them here: http://arianne.cvs.sourceforge.net/arianne/stendhal/libs/
Done!
 
== MySQL & Marauroa: Let the 2 be one ==
Time to configure Marauroa to point to the database you made earlier. In the command-line (not in GUI!), run:
java -cp marauroa.jar:stendhal-server-0X.64XX.jar games.stendhal.server.GenerateINI
Make sure the names of any jars after the 'cp' are the same as the ones in the server directory.
 
When it asks you for...
*database name, use the default (marauroa)
Line 66 ⟶ 69:
*user, use the username you used in giving permissions (FOO)
*password, use the password you used giving permissions (BAR)
*port, anything above 1024. 32160 is the deafultdefault for stendhal, but it can be anything above 1024
*game, type "stendhal" (or a number for that, if a multiple-choice menu appears)
*turn time, or how long the server takes to process each event, choose anything above 200, but below 1000. This is in milliseconds. default is 300
*log and stats generation logs, use the default ("./") - it's in the same directory as everything else
*RSA key size, choose anything smaller than 1024 bits, but greater than 512 (or equal to). This is to make sure that the login information is valid and secure. Like the prompt says, anything greater than 1024 can take a LONG time. But, if you have ~30 minutes to spare (more or less, depending on your comp), you could use the extra security
Line 92 ⟶ 95:
== Server bonuses ==
=== You are the man! ===
Want to be an admin? Now you can! It's easy! First create a file called "admins.list" This is a plain text file, with each name on a seperateseparate line. The name must be EXACT, or it will not work. Then go to the directory where you extracted stendhal-server-X.XX.zip, and browse to /data/conf (create it if it isn't already there). Add admins.list there. You may need to adjust the classpath which your server loads from.
 
=== Be my wife? And other server extensions ===
Server extensions. They add much (or little) functionality to a server, that another may not have. If you want to add the Spouse extension, which adds marriage (uh-oh!) to your server, just add these to your marauroa.ini file we created earlier (note that marriage is not built in to the server and doesn't require an extension, but you can use this template for all extensions):