Server administration (Wurm Unlimited) - Revision history

Taufiq: /* User Interface */ Added screen shots of the graphical user interface

2016-10-02T11:32:56Z

User Interface: Added screen shots of the graphical user interface

Bigsteve: added Tree Spread odd

2016-09-30T13:30:06Z

added Tree Spread odd

Taufiq: Added link to multi-server setup

2015-12-21T00:37:40Z

Added link to multi-server setup

Taufiq: /* Running the Server */ Add command line arguments

2015-11-06T10:18:36Z

Running the Server: Add command line arguments

Taufiq: Added warning for RMI ports, since people insist on advising others that they need to open them up

2015-10-30T01:45:16Z

Added warning for RMI ports, since people insist on advising others that they need to open them up

Taufiq: /* Troubleshooting */ Added troubleshooting note for launcher crashing on windows 10 computers with touchscreen enabled.

2015-10-24T03:34:42Z

Troubleshooting: Added troubleshooting note for launcher crashing on windows 10 computers with touchscreen enabled.

Taufiq: /* Server Configuration file */ Added mention of config file syntax, added examples for PLAYERLOG configuration item.

2015-10-23T23:46:41Z

Server Configuration file: Added mention of config file syntax, added examples for PLAYERLOG configuration item.

Keenan: /* Linux Headless */ clarification

2015-10-22T18:57:36Z

Linux Headless: clarification

Keenan: /* Network Configuration */ Clarification for RMI

2015-10-21T22:59:35Z

Network Configuration: Clarification for RMI

Keenan at 17:45, 21 October 2015

2015-10-21T17:45:55Z

@@ Line 114: / Line 114: @@
 ===Select Game Database===
 ::;Select database to use: This selects the directory from which the world will be loaded. This list is populated from the game subdirectories of the server executable.
 ::;Start Server: Starts the server with the current configuration.
@@ Line 123: / Line 125: @@
 This controls aspects of the main server
 ====1. Server Settings====
 ::;Server Name: This names the server, and will be the name that appears in the server browser lists in the Wurm Unlimited client.
 ::;Server External IP Address:This is the IP address of the computer on which the server is run. For a new server, this is the external IP address detected by the configuration application for the computer on which it has been launched. When it is run, the server will attempt to bind to this IP address. Note that for computers on a LAN, this will be the IP address of the computer on that LAN. Linux users in particular should check this field, as it may default to 127.0.0.1 if the autodetection fails.
@@ Line 139: / Line 143: @@
 ::;Message of the day: A message to display upon login
 ====2. Advance Server Settings====
 ::;Server ID:This number is a unique identifier for the server in a server cluster. When the server gui is first launched with no preconfigured servers, this number is randomly generated so as to avoid clashing with any existing servers ids.
 ::;Server Internal IP Address: This is the IP address that is used to communicate with other servers. When it is run, the server will attempt to bind to this IP address for inter-server communication. This is also the IP that the RMI ports will bind to.
@@ Line 160: / Line 166: @@
 ====3. Gameplay Tweaks====
 ::;Skill gain rate multiplier: Multiplies the server skill gain rate. Higher means faster skill gain. It's not exact depending on a number of factors.
 ::;Characteristic start value: Start value of Characteristics such as body strength, stamina and soul depth
@@ Line 181: / Line 189: @@
 ::;Money pool: This is the amount of money that will be in the money pool after server restart.
 ====4. Twitter Settings====
 ::;Consumer key: Twitter consumer key
 ::;Consumer secret: Twitter consumer secret
@@ Line 186: / Line 198: @@
 ::;Application secret: Twitter application secret
 ====5. Maintenance====
 ::;Maintenance:Select to start the server in maintenance mode. A server in maintenance mode does not allow any players of power 0 to connect. Players set to 1 or higher will still be able to connect.
 ===Server Neighbors===
 ====1. Server Settings====
 ::;Server Name: Name of the neighboring server.
@@ Line 200: / Line 218: @@
 ::;Login server: The login server is the central cluster node responsible for bank accounts and cross communication
 ===Server Travel===
 ::;North: Drop-down box to select a server in the current cluster to transfer players to when they travel north.
 ::;South: Drop-down box to select a server in the current cluster to transfer players to when they travel south.
@@ Line 206: / Line 228: @@
 ===Players===
 This tab allows changes to specific players
 ::;Select Player: A drop-down box that will populate with players as they are created on the server. You may need to switch to another tab and back to see players created after you've viewed the tab.
 Once a player has been chosen from the drop-down, the following options are available:

@@ Line 178: / Line 178: @@
 ::;Breeding time modifier: A modifier which makes breeding faster the higher it is.
 ::;Field growth timer, hour: The number hours between field growth checks
 ::;Money pool: This is the amount of money that will be in the money pool after server restart.
 ====4. Twitter Settings====

← Older revision		Revision as of 00:37, 21 December 2015
Line 39:		Line 39:

	To install the server, run SteamCMD and log in with: <tt>login <account> <password></tt> or <tt>login anonymous</tt>. Next you set the install folder by typing <tt>force_install_dir <folder name></tt>, for example: <tt>force_install_dir wu</tt>. Finally, start the update with <tt>app_update 402370</tt>.		To install the server, run SteamCMD and log in with: <tt>login <account> <password></tt> or <tt>login anonymous</tt>. Next you set the install folder by typing <tt>force_install_dir <folder name></tt>, for example: <tt>force_install_dir wu</tt>. Finally, start the update with <tt>app_update 402370</tt>.
		+
		+	====Multi-Server====
		+	A [[Multi_Server_(Wurm_Unlimited)\|multi-server setup]] requires more detailed configuration.

	==Running the Server==		==Running the Server==

@@ Line 50: / Line 50: @@
   export DISPLAY=:99
 Once installed, you can launch the server and automatically start it by going into the install folder and typing either <tt>./WurmServerLauncher start=<ServerFolder></tt>. Example: <tt>./WurmServerLauncher start=Creative</tt>
 ===Launcher Configuration===

@@ Line 12: / Line 12: @@
 :;3724 TCP: The Wurm Unlimited server communicates with clients on this port. (This port may be modified, see [[Server_administration_(Wurm_Unlimited)#Local_Server|Local Server Configuration]])
 The following ports should be allowed by your firewall only if you are using multiple servers. Even then, you should ensure that your network security only allows traffic from known sources to these ports:
-:;7220, 7221 TCP: These are ports used for RMI and intra-server communication. These must be open on the local machine but should NOT be publicly available. They bind to the Local IP address. (These ports may be modified, see [[Server_administration_(Wurm_Unlimited)#Local_Server|Local Server Configuration]])
+:;7220, 7221 TCP: '''Warning: Do not under any circumstances open these ports to external access.''' These are ports used for RMI and intra-server communication. These must be open on the local machine but should NOT be publicly available. They bind to the Local IP address. (These ports may be modified, see [[Server_administration_(Wurm_Unlimited)#Local_Server|Local Server Configuration]])
 '''Note''': Your server will start without the Steam ports opened, but it will only be visible on the ''LAN'' tab of the server browser, and only to local clients.

@@ Line 261: / Line 261: @@
 ===Troubleshooting===
-:;Server is not visible in the server browser: his usually indicates that the Steam query ports 27016-27030 are not open, or have not been forwarded to the server host.
+:;Server is not visible in the server browser: This usually indicates that the Steam query ports 27016-27030 are not open, or have not been forwarded to the server host.
-:;On login, players get this message: <You can not log on to this type of server. Contact a GM or Dev>: This message indicates that the server is not configured to allow logins, using the IS_GAME_SERVER flag. Set IS_GAME_SERVER=true to allow logins on this server.
+:;On login, players get this message<nowiki>:</nowiki> <You can not log on to this type of server. Contact a GM or Dev>: This message indicates that the server is not configured to allow logins, using the IS_GAME_SERVER flag. Set IS_GAME_SERVER=true to allow logins on this server.
-:;Twitter is not working: You may need to download the commons-codec.jar and place it in the ''lib'' folder of your server. The library is available here: [http://commons.apache.org/proper/commons-codec/download_codec.cgi Apache Commons]
+:;Twitter is not working: You may need to download the commons-codec.jar and place it in the ''lib'' folder of your server. The library is available here: [http://commons.apache.org/proper/commons-codec/download_codec.cgi Apache Commons]. Note that this issue should be fixed in current versions.

@@ Line 171: / Line 171: @@
 ==Server Configuration file==
-On startup, the server reads from the '''wurm.ini''' file in the folder of the server that is loaded from the interface or with the <tt>start=</tt> argument. This configuration file sets a number of parameters:
+On startup, the server reads from the '''wurm.ini''' file in the folder of the server that is loaded from the interface or with the <tt>start=</tt> argument. This configuration file (details of the syntax are specified by Java's [https://docs.oracle.com/javase/8/docs/api/java/util/Properties.html#load-java.io.Reader- Properties.load method]) sets a number of parameters:
 ===Terrain and Resources===
 ::;CAVEIMG:When true, the ores on the map will be saved to a file named Ore.png in the server directory on startup. If not specified, defaults to false.
@@ Line 191: / Line 191: @@
 ::;DEVMODE: Turns on additional logging and disables email sending. If not specified, defaults to false.
 ::;LAG_THRESHOLD: Certain long-running operations are logged if they are over a certain threshold, as specified in milliseconds by LAG_THRESHOLD. If not specified, defaults to 1000.
-::;PLAYERLOG: Indicates the log file to which player statistics will be written at regular intervals. Must have a .log extension and write access or the default will be used. If not specified, defaults to numplayers.log in the server directory.
+::;PLAYERLOG: Indicates the log file to which player statistics will be written at regular intervals. Must have a .log extension and write access or the default will be used. The syntax of the file path may be in standard Java path format, eg.
 ::;USE_DATABASE_FOR_SERVER_STATISTICS_LOG: When true, server statistics will be logged to the wurmlogs database. This is in addition to MRTG logging. If not specified, defaults to false.
 ::;USE_ITEM_TRANSFER_LOG: When true, item transfers are logged to the database.

@@ Line 2: / Line 2: @@
 [[Image:Wurm_unlimited_25pc.png|center|link=http://store.steampowered.com/app/366220]]<br>
-This article is intended for advanced users that wish to run a dedicated Wurm Unlimited server. This is not a requirement for playing Wurm Unlimited. Please see the [[WU_Getting_Started|Getting Started]] guide for running Wurm Unlimited with the bundled server.
+This article is intended for advanced users that wish to run a dedicated Wurm Unlimited server. This is not a requirement for playing Wurm Unlimited. Please see the [[Wurm_Unlimited|Getting Started]] guide for running Wurm Unlimited with the bundled server.
 ==Installation==