StendhalLocalhostServerOnLinux: Difference between revisions

Jump to navigation Jump to search
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: Line 1:
This guide applies to:
This guide applies to:
*Marauroa 2.1
*Marauroa 2.1
*Stendhal 0.64
*Stendhal 0.64 and above
*Stendhal server 0.64


= Setting up a localhost server =
= 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:
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
*Marauroa version 2.1, see below
*A compiled version of the Stendhal Server, version 0.64
*A compiled version of the Stendhal Server, version X.XX
*MySQL
*MySQL
*GNU/Linux (This may be others, the directions should apply almost exactly to any *nix system)
*GNU/Linux (This may be others, the directions should apply almost exactly to any *nix system)
Line 14: Line 13:
<!-- This is heavily based on the Visual Guide to Setting up a Localhost Server on Windows XP (c) -->
<!-- This is heavily based on the Visual Guide to Setting up a Localhost Server on Windows XP (c) -->
== Getting the materials ==
== Getting the materials ==
Download a current version of Stendhal. If you want to use the current release of the Stendhal server, go to http://arianne.sourceforge.net/?arianne_url=games/game_stendhal#downloadsection and download the stendhal-server-X.XX.zip from that page.
Download a current version of Stendhal. If you want to use the current release of the Stendhal server, go tohttp://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, ask your system administrator if you do and how to get to it.
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 how to get it.


= Setting up MySQL =
= Setting up MySQL =
Line 44: Line 43:


== Marauroa and Stendhal: Moving time! ==
== Marauroa and Stendhal: Moving time! ==
Check you have the following files in the server directory, either from your zip or your own build:
Check you have the following files in the server directory:
*stendhal-server-X.XX.jar
*marauroa.jar
*stendhal-xmlconf-X.XX.jar
*log4j.properties
*stendhal-server-0.64.jar
*stendhal-maps-X.XX.jar
*stendhal-xmlconf-0.64.jar
*stendhal-maps-0.64.jar
*log4j.jar
*groovy.jar
*groovy.jar
*simple.jar
*simple.jar
*marauroa.jar
*log4j.jar
*log4j.properties
*jython.jar
*jython.jar
*mysql-connector.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!
Done!


== MySQL & Marauroa: Let the 2 be one ==
== 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:
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-0.64.jar games.stendhal.server.GenerateINI
java -cp marauroa.jar:stendhal-server-X.XX.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...
When it asks you for...
*database name, use the default (marauroa)
*database name, use the default (marauroa)
Line 66: Line 69:
*user, use the username you used in giving permissions (FOO)
*user, use the username you used in giving permissions (FOO)
*password, use the password you used giving permissions (BAR)
*password, use the password you used giving permissions (BAR)
*port, anything above 1024. 32160 is the deafult for stendhal, but it can be anything above 1024
*port, anything above 1024. 32160 is the default for stendhal, but it can be anything above 1024
*game, type "stendhal" (or a number for that, if a multiple-choice menu appears)
*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
*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
*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
*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: Line 95:
== Server bonuses ==
== Server bonuses ==
=== You are the man! ===
=== 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 seperate 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.
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 separate 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 ===
=== 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):
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):