Configuration file server.ini: Difference between revisions

{{Navigation for Marauroa Top|Using}}

{{Navigation for Marauroa Users}}

The server is configured using a configuration file called server.ini. It is possible to use a different file using the -c command line parameter. In most cases the game will provide a '''GenerateINI''' program that you should execute to generate the server.ini file. Nevertheless it may be interesting to know which parameter exist and how they can be set.

If you are writing your own game, you should have a look at the provided GenerateINI programs, too.

Marauroa needs access to a database. MySQL and H2 are actively supported and tested. Other database may work too, perhaps with a few tweaks.

H2 is cool because it works out of the box without having to setup a database server: You just need to specify a filename which will be created automatically. In this example it is called marauroa-h2db and the "~" means that it is created in your home folder.

'''jdbc_url'''=jdbc:h2:~/''marauroa-h2db'';AUTO_RECONNECT=TRUE;DB_CLOSE_ON_EXIT=FALSE;AUTO_SERVER=TRUE

MySQL is a classical database server. As such it has to be setup separately. After creating a database and a user you can configure it like this:

'''jdbc_url'''=jdbc:mysql://''localhost''/''marauroa''

The next section is game specific. You usually don't have to edit it. It allows the games to define classes that customize the the framework. This is explained in detail in the tutorial.

'''python_script'''=

In the server section you can configure the tcp port and turn time. Normally the games provide recommendations for both settings. You can enable logging of server statistics by providing a file name for the statistics_filename parameter. And in case you need to debug the server, you can provide your own log4j configuration file.

'''tcp_port'''=32160

'''turn_length'''=300

'''statistics_filename'''=server_stats.xml

'''log4j_url'''=marauroa/server/log4j.properties

Version and contact information:

'''server_service'''=stendhal

You can define some limits to prevent flooding by huge amounts of data, lots of message or lots of players. This is particularly useful if your server is behind a small Internet connection.

'''allowed_bytes_per_second'''=1024

'''allowed_messages_per_second'''=20

'''max_number_of_players'''=128

There is a second set of settings very similar to the above. But those ones are not about resource usage but more about preventing trouble:

'''account_creation_counting_time'''=3600

'''account_creation_limit'''=5

'''parallel_connection_limit'''=10

'''ip_whitelist'''=127.0.0.1

Other limits:

'''limit_characters_per_account'''=2147483647

== Account and character creation ==

Since Marauroa 3.8.4 it is possible to disable account and character creation using

'''allow_account_creation'''=false

'''allow_character_creation'''=false

This is useful if account creation is done using other means. For example filling the account, characters and rpobjects table from an other application. It is used on stendhalgame.org for the test server because the test database shares the accounts with the main database.

Since Marauroa 3.9.5 it is possible to define the initial status of new accounts.

'''account_creation_status'''=active

== RSA ==

RSA is the encryption algorithm used to protected the client server communication. Note: You need to generate your own pair of primes using GenerateINI. Do not use the following examples.

[[Category:Marauroa]]

{{#breadcrumbs: [[Marauroa]] | [[Navigation for Marauroa Users|Using]] | [[Configuration file server.ini|server.ini]] }}