Revision as of 00:22, 23 September 2012

This page might not be up-to-date (build 514).

This page is for the set up of the default KAG Server. For minimum requirements, installation and managing stability this is the right page. Due to its size the configuration of KAG servers has its own page here.

Server Requirements

The King Arthur's Gold Server is a relatively lightweight, 32-bit command line application. Freely distributed, this program allows anybody with an internet connection and a computer to host their own King Arthur's Gold server.

Note: There is very little official documentation for the KAG server. As a result, the majority of this document was created from observation, trial and error. Use at your own risk.

Dedicated Servers

Software

The KAG server can run on almost all OS Linux, Windows, or Mac.
The recommended operating system is Linux, specifically Debian.

Lowest Hardware

RAM: At least 128MB
CPU: At least 1 core clocked @ 1Ghz

Recommended Hardware

RAM: 512MB
CPU: 2 cores clocked @ 2Ghz

Network

Internet Connection speed per player scales with the number of players:
Upload to each player: (number of players - 1) * 0.3 kb/s
Download from each player: 0.5kb/s

Ports

Firewall tolerant means that a typical connection-oriented (SPI) firewall will allow that port through. Depending on the firewall, all ports may need to be forwarded in UDP.

	Description	Modifiable?	Firewall Tolerant?
50301/udp	Used to listen for connections.	yes	no
50328/udp	Used to communicate with clients.	yes	yes
80/tcp	Used for autoupdates	no	yes
443/tcp	Used for API (server list, auth, minimaps, etc) server communication	no	yes

Residential Connections

For those hosting on residential internet connections:

Make sure that your computer has at least the above specifications.
Keep in mind that many ISPs forbid running any kind of server, including a KAG server, they may block certain ports and dynamically assign IP addresses.

Installation

Port Forwarding

Router

As said before KAG Servers require various ports to be open for it to run properly. If you are using a router, it most likely has its own firewall. Unfortunately since there are many router manufacturers, its almost impossible for a universal guide that would offer step-by-step instructions on how to set up these 'port forwards'. Please consult your router manufacturer's website for more precise information on how to accomplish this.

Windows Firewall

If you are running a Windows OS this is most likely active on your computer blocking certain ports . The following steps were done on a Windows 7 computer but other Windows OS should be nearly identical.

Go to Control Panel and open the Security and Security tab.
Click on "Windows Firewall".
Click on "Advanced settings" on the left hand side column.
Right click on the "Inbound Rules" button, in the left hand side column, and select "New Rule..."
Select "Port" and click "Next".
Type in the port you wish to allow (they are found above) and click "Next".
Select "Allow this connection and click "Next"
(Recommended) Select "Domain", "Private" and "Public"
Type in a Name and click "Finish.
Repeat steps 4-9 for all the ports

Mac Firewall

Download Portmap: http://www.macupdate.com/app/mac/27342/port-map/
Next, decompress the archive. This can be done with many different programs, including PeaZip.
Launch Portmap.
Open the required ports.

Antivirus Firewall

Like Windows Firewall, if you have an antivirus it most always has a firewall. Unfortunately since there are many antivirus products on the market, its almost impossible for a universal guide that would offer step-by-step instructions on how to set up these 'port forwards'. Please consult your antivirus brand's website for more precise information on how to accomplish this.

Linux Install

This guide is written for 32-bit Debian Linux. To run on 64-bit Debian Linux, the ia32-libs package must be installed.

Do this step if you have a 64-bit OS. Install ia32-libs:
```
apt-get install ia32-libs
```

Download the server:

wget http://dl.kag2d.com/kag-linux32-dedicated-latest.tar.gz

Next, decompress the archive.

tar -zxf kag-linux32-dedicated-latest.tar.gz

Change to the new directory:
```
cd kag-linux32-dedicated
```
Run your server:
```
./KAGdedi
```
Your default KAG Server is now running.

Windows Install

First, download the server: http://kag2d.com/en/download
Note: The downloads page only lists a linux server. Even though the server is intended to run on Linux, it will run on Windows.
Next, decompress the archive. This can be done with many different programs, including PeaZip.
Open the folder the archive was extracted into.
Run your server by running dedicatedserver.bat.
Your default KAG Server is now running.

Mac Install

Due to their similarities, the installation instructions for Linux should apply for Macs, though Mac does not currently have a dedicated server option. If that doesn't work try this:

Download Trelawney's Dedicated OSX Server: http://dl.dropbox.com/u/23114384/kag/osx_dedicated.zip
Make sure that KAG is in your applications folder.
Next, decompress osx_dedicated.zip. This can be done with many different programs, including PeaZip. Then lanch it.
It will says "Make sure to edit dedicated_autoconfig.gm" and a copy of KAG launches.
Your default KAG Server is now running.

Managing Instability

As Alpha software, the KAG server in certain builds is very unstable. Build are sometimes crash prone but it varies from release to release due to new features mixed with bug fixes. As such, it is recommended practice to run the server in a keepalive script, which will restart it whenever it crashes. In addition, many people restart their server once a day, during the hours of least usage, to help decrease the risk of a crash while the server is being played upon.

Keep-alive Scripts

Linux/Mac

Trelawney's Keepalive Script, dedi.sh, will restart the KAG server 5 seconds after it crashes. Download it here.
If retyping/using copy and paste, make sure word wrapping is turned off in you text editor. (In nano, use nano -w dedi.sh .)
Once created, be sure to make the script executable with chmod +x dedi.sh.

#!/bin/bash
echo "Running KAG dedicated server"
echo "TO SET IP/PORT/SLOTS/PASSWORD ADD THESE COMMAND PARAMS: ip 127.0.0.1 port 50213 slots 32 password pass123"
mv KAGdedi.tmp KAGdedi
chmod +x KAGdedi
until ./KAGdedi nolauncher autostart Scripts/dedicated_autostart.gm autoconfig Scripts/dedicated_autoconfig.gm; do
        echo "KAG server running"
        sleep 5
done

To use, run the script: ./dedi.sh instead of the usual ./KAGdedi

Adapting for Maqq's Configuration Tool

To use a configuration generated by Maqq's Configuration Tool, replace line 6 in the above script with:

./KAGdedi autostart Scripts/custom_autostart.gm autoconfig Scripts/custom_autoconfig.gm

Windows

The Beaz's Keepalive Script, dedi.bat, will restart the KAG server 5 seconds after it crashes. To use, create a text file, paste/type in the script below, and save it as dedi.bat.

@ECHO off
 
:restart
echo (%time%) Server Started - close this window to prevent restart.
 
start /wait KAG.exe nolauncher autostart Scripts/dedicated_autostart.gm autoconfig Scripts/dedicated_autoconfig.gm
 
echo (%time%) WARNING: Server closed or crashed, restarting.
 
goto restart

To make it work on Windows Vista or 7 you need to disable Windows Error Reporting. To do so:

Run regedit.exe
Modify HKCU\Software\Microsoft\Windows\Windows Error Reporting\DontShowUI entry with value 1

Adapting for Maqq's Configuration Tool

To use a configuration generated by Maqq's Configuration Tool, replace line 6 in the above script with:

start /wait KAG.exe nolauncher autostart Scripts/custom_autostart.gm autoconfig Scripts/custom_autoconfig.gm

Daily Server Restarts

If a KAG server is running in a keepalive script, a scheduled task that kills the server once a day is, effectively, a daily restart because the keepalive script will automatically restart the server.

Linux/Mac - Cronjob

This script will kill all instances of KAGdedi at 3 AM.

Use crontab -e to create a new cronjob. This will open your default text editor.
In the text editor, type:
```
0 3 * * * pkill -1 KAGdedi
```
Close editor. Cronjob installed!

Windows - Task Scheduler

Checking for Updates

So far there is not a public script to restart a server when an update is available, but the following logic should be able to be combined with a restart script above to restart a server once an update is available.

curl -s http://update.kag2d.com/linux32-dedicated-release/App/version.txt | head -n1 | cut -d ' ' -f2
1337154874-636-6e12e0f833b0

When that string (the 2nd whitespace-delimited element of the first line of that URL) changes, an update is available. The first number is the unix timestamp of the build, the 2nd is the code revision, the 3rd is a hex identifier used internally by the developers. You should be able to just monitor for a change. You could also use logic involving watching the first two parts of the string to see if they increment, but the format of this string may change in the future.

Configuration

The KAG server is configured using text files. Customizing a KAG server installation involves modifying the variables in these files. There are two ways to do this: Manually or by using a Configuration Tool. Of the two, a tool is far the fastest and easiest method, yet manual returns greater results.

JackD's/Maqq's Tool

Windows GUI

Requirements:

NET Framework 2.0 or higher

Installation:

Download the tool: http://dl.dropbox.com/u/65858755/KAGServerConfigTool/KAG_Server_Config_Tool.zip
Extract it and copy the contents into your KAG Servers root folder (e.g. C:\KAG).
Run KAGServer.exe
On first start you should go to the "Help" tab and select "Check for updates" to make sure you are using the newest version of the tool.
Once the update has finished, follow the GUI's instructions and run the server.

Linux/Mac GUI

Requirements:

Mono 2.10.8

Installation:

Download the tool: http://dl.dropbox.com/u/65858755/KAGServerConfigTool/KAG_Server_Config_Tool.zip
Extract it and copy the contents into your KAG Servers root folder
Change to the directory in the console, e.g.:
```
cd kag_linux
```
Make it executable:
```
chmod +x ./RunKAGServerCT.sh
```
Start the app executing the RunKAGServerCT.sh script on a terminal window:
```
 ./RunKAGServerCT.sh
```
On first start you should go to the "Help" tab and select "Check for updates" to make sure you are using the newest version of the tool.
Once the update has finished, follow the GUI's instructions and run the server.

Manual

One of the most important decisions a server administrator must make is whether or not to allow the Royal Guard to police their server. Please read the opening posts in these threads (In-game moderators (AKA Royal Guard) & The Royal Guard - FAQ & Public Policy) so you can make an informed decision.

If you decide you don't want guards to moderate on your server, please ensure they are turned off in your dedicated_autoconfig.gm file like this:

dedicated_autoconfig.gm

Of the many modifiable variables, these are some of the most important:

global m_width = 600; // Map generator width. Affects RAM usage.
global m_height = 250; // Map generator height. Affects RAM usage.
global m_seed = 0; // Map generator seed. Pick a random number.
global g_kickvote_percent = 33; // Percentage of players needed for a kick vote to pass.
global g_mapvote_percent = 51; // Percentage of team players needed for a map vote to pass.
global g_vote_time = 60; // How long (in seconds) does the voting take place.
global g_kickvote_bantime = 30; // How long (in minutes) is the player banned after a kick vote.
global sv_maxplayers = 16; // Maximum number of players allowed ingame.
global sv_port = 50301; // Server communication port, this is where it listens for incoming clients. Remember to open this port in your firewall.
global sv_password = ``; // Sets the server password.
global sv_rconpassword = ``; // Sets the server remote console password. This is important if you want to have control over your server.
global sv_require_auth = 1; // If set to 1 server checks client authentication via master server.
global sv_gold_only = 0; // If set to 1 only premium account players can join (aka Gold Server).
global sv_allow_globals_mods = 1; // If set to 1 global KAG moderators and admins can kick/ban players on server.
global sv_deltapos_modifier = 1; // Controls the threshold for delta packet updating. Value higher than 1 will reduce bandwidth, lower increase.
global sv_maxping = 450; // Max ping allowed on server after which player is kicked. Large ping players will slow down server.
global sv_maxping_warnings = 200; // Because of ping spikes, warnings are issued if a player has ping over max number.
global sv_maxhack_warnings = 25; // Maximum amount of warnings where server thinks player is hacking.
global sv_alloweditor = 1; // If set to 1 players that have RCON can start map editor on server
global sv_name = `KAG game`; // Sets the server name displayed in server browser.
global sv_info = ``; // Sets the server info displayed in server browser. If you want it multi-line simply move text to new line with enter.

dedicated_autostart.gm

// autostart on dedicated server launch


//set autostartswitch to:
//	0 for CTF 
//	1 for TDM
//	2 for Sandbox
//	3 for Zombies
//	4 for RTDM
//  10 for TEST

global autostartswitch = 0;

newWorld( "" );
switchGameState(0);

startServer();	

if (autostartswitch == 0) //ctf
{
	LoadRules("Rules/CTF/gamemode.cfg");
	LoadMapCycle( "Scripts/mapcycle.cfg" );
	LoadMap( "" );
	print(`Loaded CTF default config`);
}
else if (autostartswitch == 1) //tdm
{
	LoadRules("Rules/TDM/gamemode.cfg");
	LoadMapCycle( "Scripts/mapcycle.cfg" );
	LoadMap( "" );
	print(`Loaded TDM default config`);
}
else if (autostartswitch == 2) //sandbox
{
	LoadRules("Rules/Sandbox/gamemode.cfg");
	LoadMapCycle( "Scripts/mapcycle.cfg" );
	LoadMap( "" );
	print(`Loaded TDM default config`);
}
else if (autostartswitch == 3) //zombies (GOLD ONLY)
{
	LoadRules("Rules/Zombie_Survival/gamemode.cfg");
	LoadMapCycle( "Rules/Zombie_Survival/ZombieMapCycle.cfg" );
	LoadMap( "" );
	
	print(`Loaded zombies default config : server now in GOLD MODE`);
} else if (autostartswitch == 4) //rtdm
{
	LoadRules("Rules/RTDM/gamemode.cfg");
	LoadMapCycle( "Rules/RTDM/RTDMMapCycle.cfg" );
	LoadMap( "" );
	print(`Loaded RTDM default config`);
}else
if (autostartswitch == 10) //test
{
	LoadRules("Rules/TEST/gamemode.cfg");
	LoadMapCycle( "Scripts/mapcycle.cfg" );
	LoadMap( "" );
	print(`Loaded TEST default config`);
}

print(`Config finished loading from Scripts/Server/dedicated_autostart.gm`);

This file is very important. If you want to change rules for your server then you have to edit the global autostartswitch variable.

For an individual Rule there is the the number 10. If you want to make a Zombie Survival Server or any modded Server you need to make your server for Gold users only ( see dedicated_autoconfig.gm)

mapcycle.cfg

#KAG mapcycle;
# put map generator files, png files here, or script files
# eg. mapcycle = Maps/example1.png; Maps/example2.png; Maps/generator_flat.cfg; Maps/swordfight.gm;

mapcycle = Maps/generator_ctf_mountain.cfg;

You must separate paths to files with semicolons. Allowed files are generators, script files and maps in png format.

Remote Control

A server can be controlled in-game. While connected to the server, press the HOME key to open the console. A full list of available rcon commands can be found here. In order to remote control a server however you must be set as an administrator in the servers configuration files. The system KAG uses for this is found bellow.

Security Levels

King Arthur's Gold uses a system called 'Security Levels' (or 'seclevs' for short) to manage player access to various features on its servers. There are default, hardcoded levels setup but it is strongly advised that server owners take the time to setup their own specific seclev definitions.

Read more...

Blacklisting & Whitelisting

A player blacklists is the list of players who are not allowed to play on a given server. A whitelist is the inverse of a blacklist; if enabled, only those on the whitelist will be allowed to play.

The contents of the file securitysetup.cfg in kagServer/Base/Security (where kagServer is the path to the kagServer's directory) should look something like this:

# Security setup

# Set to 1 to allow only the names in the whitelist or 0 to disallow the names in the blacklist
whitelist_active = 0
whitelist_file = Security/whitelist.cfg
blacklist_file = Security/blacklist.cfg

# Path to file where security levels are defined
seclevs_file = Security/seclevs.cfg

Note: The whitelist overrides the blacklist if enabled.

Whitelist

If you are using the whitelist, then at the path specified in whitelist_file you can create a file that looks something like this:

# Whitelist format: name; anothername; yetanothername;
whitelist =
name;
anothername;
yetanothername;

Simply add usernames in this way to allow only those players access to the server.

Blacklist

If you are using the blacklist, then at the path specified in blacklist_file you can create a file that looks something like this:

# Blacklist format: name; IP; expiration time and date h:m:s:d:M:y; reason;
# IP of 0.0.0.0 means no IP is banned, and the user is just banned by username.
# Blank username means no user is banned for that entry and it's just by IP.
# The time is in C++ struct tm format except for the year, which is human readable. Get relative times from /listbans on the console. 
# 	eg: 10:30:0:31:11:2050 is 10:30 AM on the 31st of December 2050AD

blacklist =
name1; 0.0.0.0; 10:30:0:31:11:2050; Banned;
name2; 12.34.45.78; 10:30:0:31:11:2050; Banned;

Simply add player details in the format described to ban them from the server. Alternatively, just use the ban menus or rcon commands in game to ban users. Note that January is the 0th month

@@ Line 1: / Line 1: @@
 {{Build
-|Version = 458
+|Version = 514
 }}
+<p>This page is for the set up of the default KAG Server. For minimum requirements, installation and managing stability this is the right page. Due to its size the configuration of KAG servers has its own page here.</p>
+=Server Requirements=
 The King Arthur's Gold Server is a relatively lightweight, 32-bit command line application. Freely distributed, this program allows anybody with an internet connection and a computer to host their own King Arthur's Gold server.
 '''Note: There is very little official documentation for the KAG server. As a result, the majority of this document was created from observation, trial and error. Use at your own risk.'''
-=Features=
+==Dedicated Servers==
-*All servers are added to the official server list to be seen by anybody who chooses the "Pick a Server" option in-game.
+===Software===
-*Servers can be remotely controlled in game by anybody with the server's Remote Control (RCON) password.
+*The KAG server can run on almost all OS Linux, Windows, or Mac.
-*Servers can be password protected. (This is separate from the RCON password.)
+*The recommended operating system is Linux, specifically Debian.
-=Requirements=
+===Lowest Hardware===
-==Hardware==
+*RAM: At least 128MB
-The hardware requirements for a KAG server are minimal. If a computer can run the full KAG game, it can run the KAG server.
+*CPU: At least 1 core clocked @ 1Ghz
-==Software==
+===Recommended Hardware===
-The KAG server can run on Linux, Windows, or Mac. The recommended operating system is Linux, specifically Debian.
+*RAM: 512MB
-==Network==
+*CPU: 2 cores clocked @ 2Ghz
-<p>The KAG server isn't designed to work on computers without an Internet connection. It is, however, [https://forum.kag2d.com/index.php?threads/lan-no-internet-server.4135/ still possible] to run it without one.</p>
+===Network===
-<p>The KAG server uses four ports:
+*Internet Connection speed per player scales with the number of players:
+*Upload to each player: (number of players - 1) * 0.3 kb/s
+*Download from each player: 0.5kb/s
+===Ports===
+*Firewall tolerant means that a typical connection-oriented ([http://en.wikipedia.org/wiki/Stateful_firewall SPI]) firewall will allow that port through. Depending on the firewall, all ports may need to be forwarded in UDP.
 {|border="1" cellpadding="5" cellspacing="0"
 |-
@@ Line 43: / Line 49: @@
 !scope="row" style="background:#E83131;"|no
 !scope="row" style="background:#31E831;"|yes
 |}
-Firewall tolerant means that a typical connection-oriented ([http://en.wikipedia.org/wiki/Stateful_firewall SPI]) firewall will allow that port through. Depending on the firewall, all ports may need to be forwarded in UDP.</p><p>
+==Residential Connections==
-The internet connection is typically the bottleneck that determines the number of users a server can support. Hosting more users than a connection can support will cause a high ping time and significant lag.</p>
+<p>For those hosting on residential internet connections:</p>
-===Hosting on Residential Connections===
+* Make sure that your computer has at least the above specifications.
-<p>For those hosting on residential internet connections, keep in mind that many ISPs forbid running any kind of server, including a KAG server. To complicate hosting a server, they may block certain ports and dynamically assign IP addresses.
+*Keep in mind that many ISPs forbid running any kind of server, including a KAG server, they may block certain ports and dynamically assign IP addresses.
-*It is highly unlikely that they would block the ports used by the KAG server. (A local router's firewall is most likely the culprit for connectivity issues when hosting on a residential connection.)
-*[http://ip4.me This] site displays the IP address of the current visitor. It can be used to determine the currently assigned public IP address.</p>
 =Installation=
-==Linux==
+==Port Forwarding==
+===Router===
+<p>As said before KAG Servers require various ports to be open for it to run properly. If you are using a router, it most likely has its own firewall. Unfortunately since there are many router manufacturers, its almost impossible for a universal guide that would offer step-by-step instructions on how to set up these 'port forwards'. Please consult your router manufacturer's website for more precise information on how to accomplish this.</p>
+===Windows Firewall===
+<p>If you are running a Windows OS this is most likely active on your computer blocking certain ports . The following steps were done on a Windows 7 computer but other Windows OS should be nearly identical.
+#Go to Control Panel and open the Security and Security tab.
+#Click on "Windows Firewall".
+#Click on "Advanced settings" on the left hand side column.
+#Right click on the "Inbound Rules" button, in the left hand side column, and select "New Rule..."
+#Select "Port" and click "Next".
+#Type in the port you wish to allow (they are found above) and click "Next".
+#Select "Allow this connection and click "Next"
+#(Recommended) Select "Domain", "Private" and "Public"
+#Type in a Name and click "Finish.
+#Repeat steps 4-9 for all the ports
+===Mac Firewall===
+#Download Portmap: http://www.macupdate.com/app/mac/27342/port-map/
+#Next, decompress the archive. This can be done with many different programs, including [http://peazip.sourceforge.net/ PeaZip].
+#Launch Portmap.
+#Open the required ports.
+===Antivirus Firewall===
+Like Windows Firewall, if you have an antivirus it most always has a firewall. Unfortunately since there are many antivirus products on the market, its almost impossible for a universal guide that would offer step-by-step instructions on how to set up these 'port forwards'. Please consult your antivirus brand's website for more precise information on how to accomplish this.</p>
+==Linux Install==
 <p>This guide is written for 32-bit Debian Linux. To run on 64-bit Debian Linux, the <code>ia32-libs</code> package must be installed.</p>
 <p>
-# First, download the server: <br /> <pre>wget http://dl.kag2d.com/kag-linux32-dedicated-latest.tar.gz</pre>
+# '''Do this step if you have a 64-bit OS.''' Install <code>ia32-libs</code>: <br /> <pre>apt-get install ia32-libs</pre>
+# Download the server: <br /> <pre>wget http://dl.kag2d.com/kag-linux32-dedicated-latest.tar.gz</pre>
 # Next, decompress the archive. <br /> <pre>tar -zxf kag-linux32-dedicated-latest.tar.gz</pre>
 # Change to the new directory: <br /> <pre>cd kag-linux32-dedicated</pre>
-# [[Server#Configuration|Configure]] your server.
+# Run your server: <br /> <pre>./KAGdedi</pre><br />
-# Run your server: <br /> <pre>./KAGdedi</pre><br />To connect, either find it in the server list or connect directly using the IPaddress:PortNumber format. (The default port is 50301.) Note that domain names will not work in place of the IP address.
+#Your default KAG Server is now running.
 </p>
+==Windows Install==
-==Windows==
 <p>
 # First, download the server: http://kag2d.com/en/download <br /> Note: The downloads page only lists a linux server. Even though the server is intended to run on Linux, it will run on Windows.
 # Next, decompress the archive. This can be done with many different programs, including [http://peazip.sourceforge.net/ PeaZip].
 # Open the folder the archive was extracted into.
-# [[Server#Configuration|Configure]] your server.
+# Run your server by running <code>dedicatedserver.bat</code>.<br />
-# Run your server by clicking <code>dedicatedserver.bat</code>.<br />To connect, either find it in the server list or connect directly using the IPaddress:PortNumber format. (The default port is 50301.) Domain names will not work in place of the IP address.
+#Your default KAG Server is now running.
+</p>
+==Mac Install==
+<P>Due to their similarities, the installation instructions for Linux should apply for Macs, though Mac does not currently have a dedicated server option.
+If that doesn't work try this:</P>
+#Download Trelawney's Dedicated OSX Server: http://dl.dropbox.com/u/23114384/kag/osx_dedicated.zip
+#Make sure that KAG is in your applications folder.
+#Next, decompress osx_dedicated.zip. This can be done with many different programs, including [http://peazip.sourceforge.net/ PeaZip]. Then lanch it.
+#It will says "Make sure to edit dedicated_autoconfig.gm" and a copy of KAG launches.
+#Your default KAG Server is now running.
+=Managing Instability=
+<p>As Alpha software, the KAG server in certain builds is very unstable. Build are sometimes crash prone but it varies from release to release due to new features mixed with bug fixes. As such, it is recommended practice to run the server in a keepalive script, which will restart it whenever it crashes. In addition, many people restart their server once a day, during the hours of least usage, to help decrease the risk of a crash while the server is being played upon.</p>
+==Keep-alive Scripts==
+===Linux/Mac===
+<p>Trelawney's Keepalive Script, <code>dedi.sh</code>, will restart the KAG server 5 seconds after it crashes. Download it [http://dl.dropbox.com/u/23114384/files/dedi.sh here].<br />
+If retyping/using copy and paste, make sure word wrapping is turned off in you text editor. (In nano, use <code> nano -w dedi.sh </code>.)<br />
+Once created, be sure to make the script executable with <code>chmod +x dedi.sh</code>.</p>
+<pre>
+#!/bin/bash
+echo "Running KAG dedicated server"
+echo "TO SET IP/PORT/SLOTS/PASSWORD ADD THESE COMMAND PARAMS: ip 127.0.0.1 port 50213 slots 32 password pass123"
+mv KAGdedi.tmp KAGdedi
+chmod +x KAGdedi
+until ./KAGdedi nolauncher autostart Scripts/dedicated_autostart.gm autoconfig Scripts/dedicated_autoconfig.gm; do
+        echo "KAG server running"
+        sleep 5
+done
+</pre>
+<p>To use, run the script: <code>./dedi.sh</code> instead of the usual <code>./KAGdedi</code></p>
+===Adapting for Maqq's Configuration Tool===
+<p>To use a configuration generated by Maqq's Configuration Tool, replace line 6 in the above script with:
+<pre>
+./KAGdedi autostart Scripts/custom_autostart.gm autoconfig Scripts/custom_autoconfig.gm
+</pre>
 </p>
-==Mac==
+===Windows===
-Due to their similarities, the installation instructions for Linux should apply for Macs, though Mac does not currently have a dedicated server option.
+<p>The Beaz's Keepalive Script, <code>dedi.bat</code>, will restart the KAG server 5 seconds after it crashes. To use, create a text file, paste/type in the script below, and save it as <code>dedi.bat</code>.</p>
+<pre>
+@ECHO off
+:restart
+echo (%time%) Server Started - close this window to prevent restart.
+start /wait KAG.exe nolauncher autostart Scripts/dedicated_autostart.gm autoconfig Scripts/dedicated_autoconfig.gm
+echo (%time%) WARNING: Server closed or crashed, restarting.
+goto restart
+</pre>
+<p>To make it work on Windows Vista or 7 you need to disable Windows Error Reporting. To do so:
+*Run regedit.exe
+*Modify HKCU\Software\Microsoft\Windows\Windows Error Reporting\DontShowUI entry with value 1</p>
+===Adapting for Maqq's Configuration Tool===
+<p>To use a configuration generated by Maqq's Configuration Tool, replace line 6 in the above script with:
+<pre>
+start /wait KAG.exe nolauncher autostart Scripts/custom_autostart.gm autoconfig Scripts/custom_autoconfig.gm
+</pre>
+</p>
+==Daily Server Restarts==
+<p>If a KAG server is running in a keepalive script, a scheduled task that kills the server once a day is, effectively, a daily restart because the keepalive script will automatically restart the server.</p>
+===Linux/Mac - Cronjob===
+<p>This script will kill all instances of KAGdedi at 3 AM.</p>
+<p>
+# Use <code>crontab -e</code> to create a new cronjob. This will open your default text editor.
+# In the text editor, type:<pre>0 3 * * * pkill -1 KAGdedi</pre>
+# Close editor. Cronjob installed!</p>
+===Windows - Task Scheduler===
-If that doesn't work try this:
+==Checking for Updates==
+So far there is not a public script to restart a server when an update is available, but the following logic should be able to be combined with a restart script above to restart a server once an update is available.
-What you will need:
+<pre>curl -s http://update.kag2d.com/linux32-dedicated-release/App/version.txt | head -n1 | cut -d ' ' -f2
+1337154874-636-6e12e0f833b0</pre>
-. Portmap: http://www.macupdate.com/app/mac/27342/port-map/
+When that string (the 2nd whitespace-delimited element of the first line of that URL) changes, an update is available.  The first number is the unix timestamp of the build, the 2nd is the code revision, the 3rd is a hex identifier used internally by the developers.  You should be able to just monitor for a change.  You could also use logic involving watching the first two parts of the string to see if they increment, but the format of this string may change in the future.
-. Trelawney's Dedicated OSX Server: http://dl.dropbox.com/u/23114384/kag/osx_dedicated.zip
-. You will not need the Linux dedicated server
-Part 1:
-. Make sure that KAG is in your applications folder. This should be default for most users
-. Make a copy of KAG by right clicking it and selecting "Duplicate"
-. Right click on the original KAG and select "Show Package Contents"
-. Follow the folders to the "Scripts" folder via Contents>MacOS>Base>Scripts
-. Open the "Scripts" folder and right click on the "dedicated_autoconfig.gm" file and open with textedit
-. Configure your server be sure not to miss the "sv_name" and "sv_info". Make sure the "sv_ip" is set to 0
-. Make sure the "sv_port" is equal to 50302. The default 50301 did not work for me
-. Save this file
-Part 2:
-. Unzip Portmap and launch it
-. Open the following ports on both UDP and TCP:
-i. 443
-ii. 80
-iii. 50301
-iv. 50302
-v. 50328
-vi. 25565
-All of these ports probably aren't necessary but it worked for me so that's what I'm suggesting. All the ports should have a green light. If they are yellow or red PM me or post in this thread and I might be able to help.
-Part 3:
-. Unzip osx_dedicated and launch it
-. You should come to a point where it says "Make sure to edit dedicated_autoconfig.gm" and a copy of KAG launches. This is not an error or a freeze! This confused me a lot but this is what is supposed to happen.
-. Go back to your Applications folder and launch the Kag Copy not the original. You should see your server in the browser.
 =Configuration=
-<p>The KAG server is configured using text files.  Customizing a KAG server installation involves modifying the variables in these files. There are two ways to do this: manually and using Maqq's Configuration Tool. Of the two, Maqq's Tool is by far the fastest and easiest method.</p>
+<p>The KAG server is configured using text files.  Customizing a KAG server installation involves modifying the variables in these files. There are two ways to do this: Manually or by using a Configuration Tool. Of the two, a tool is far the fastest and easiest method, yet manual returns greater results.</p>
+==JackD's/Maqq's Tool==
+===Windows GUI===
+Requirements:
+*NET Framework 2.0 or higher
+Installation:
+#Download the tool: http://dl.dropbox.com/u/65858755/KAGServerConfigTool/KAG_Server_Config_Tool.zip
+#Extract it and copy the contents into your KAG Servers root folder (e.g. C:\KAG).
+#Run KAGServer.exe
+#On first start you should go to the "Help" tab and select "Check for updates" to make sure you are using the newest version of the tool.
+#Once the update has finished, follow the GUI's instructions and run the server.
+===Linux/Mac GUI===
+Requirements:
+*Mono 2.10.8
+Installation:
+#Download the tool: http://dl.dropbox.com/u/65858755/KAGServerConfigTool/KAG_Server_Config_Tool.zip
+#Extract it and copy the contents into your KAG Servers root folder
+#Change to the directory in the console, e.g.:<pre>cd kag_linux</pre>
+#Make it executable: <pre>chmod +x ./RunKAGServerCT.sh</pre>
+#Start the app executing the RunKAGServerCT.sh script on a terminal window:<pre> ./RunKAGServerCT.sh</pre>
+#On first start you should go to the "Help" tab and select "Check for updates" to make sure you are using the newest version of the tool.
+#Once the update has finished, follow the GUI's instructions and run the server.
+==Manual==
 <p>'''One of the most important decisions a server administrator must make is whether or not to allow the [[Royal Guard]] to police their server. Please read the opening posts in these threads ([https://forum.kag2d.com/index.php?threads/in-game-moderators-aka-royal-guard-updated-25-12-2011.1128/ In-game moderators (AKA Royal Guard)] & [https://forum.kag2d.com/index.php?threads/the-royal-guard-frequently-asked-questions-public-policy.1714/ The Royal Guard - FAQ & Public Policy]) so you can make an informed decision.'''</p>
-<p>If you decide you don't want guards to moderate on your server, ''please ensure they are turned off'' in your dedicated_autoconfig.gm file like this:
+<p>If you decide you don't want guards to moderate on your server, ''please ensure they are turned off'' in your dedicated_autoconfig.gm file like this:</p>
-<font size=2><pre>
-global sv_allow_globals_mods = 0;
-</pre></font></p>
-==Manual Configuration==
-Of the many editable configuration files that the KAG server depends upon, most customization is done in the <code>dedicated_autoconfig.gm</code>, <code>dedicated_autostart.gm</code>, <code>mapcycle.cfg</code>, and <code>*-generator.cfg</code> files. These are all in the kagServer/Base/Scripts directory, where kagServer is the directory the server was extracted into.
 ===dedicated_autoconfig.gm===
@@ Line 253: / Line 307: @@
 You must separate paths to files with semicolons. Allowed files are generators, script files and maps in png format.</p>
+===Remote Control===
+<p>A server can be controlled in-game. While connected to the server, press the HOME key to open the console. A full list of available rcon commands can be found [[Commands|here]]. In order to remote control a server however you must be set as an administrator in the servers configuration files. The system KAG uses for this is found bellow.</p>
-===*-generator.cfg===
+===[[Security Levels]]===
-<p>Generators use [http://libnoise.sourceforge.net/tutorials/tutorial4.html  "libnoise"-library].</p>
-==Maqq's Server Configuration Tool==
-<p>Maqq's command-line interface server configuration tool provides an interactive way of setting up a server:</p>
-<p>
-Download in the root KAG directory (C:\KAG or /kag_linux , in windows and linux respectively).
-*In Windows, run KAGServer.exe and follow the onscreen instructions.
-*In linux, make it executable via <code>chmod +x sconfig.py</code> and run with  <code>./sconfig.py</code> . Daemonisation tools applicable to dedicatedserver.sh (''screen, tmux, nohup'' etc) still useable with this program</p>
-===Reusing Generated Configs===
-<p>These commands reuse the generated configuration files:[https://forum.kag2d.com/index.php?threads/maqqs-cli-server-configuration-tool.3121/#post-67046 ]</p>
-<p>
-*If you're using linux, type this in the console:
-<pre>./KAGdedi autostart Scripts/custom_autostart.gm autoconfig Scripts/custom_autoconfig.gm</pre>
-*If you're using windows, you should consider using the [GUI version], it lets you save the configuration into a file, but if you want to use the CLI version, type this in the command prompt:
-<pre>KAG autostart Scripts/custom_autostart.gm autoconfig Scripts/custom_autoconfig.gm</pre>
-</p>
-===Download Maqq's Server Config Tool===
-<p>
-*Windows (GUI): http://dl.dropbox.com/u/51067730/kag/KAGServer.exe
-*Windows (CLI): http://dl.dropbox.com/u/51067730/KAGServer.exe (has python included)
-*Linux/OSX (CLI-only): http://213.152.176.254/mirror/sconfig.py</p>
-=Remote Control=
-<p>A server can be controlled in-game. While connected to the server, press the HOME key to open the console. Typing "/rcon /login password", where password is the RCON password set by sv_rconpassword, will allow the current user to send commands to the server. These commands must be prefixed by "/rcon". For example, to use the /list command, type. "/rcon /list".</p>
-<p>A full list of available rcon commands can be found [[Commands|here]].</p>
-=[[Security Levels]]=
 {{:Security_Levels}}
 [[Security_Levels|''Read more...'']]
-=Blacklisting & Whitelisting=
+==Blacklisting & Whitelisting==
 <p>A player blacklists is the list of players who are not allowed to play on a given server. A whitelist is the inverse of a blacklist; if enabled, only those on the whitelist will be allowed to play.</p>
-==How to Create a Blacklist or Whitelist==
 <p>The contents of the file <code>securitysetup.cfg</code> in <code>kagServer/Base/Security</code> (where kagServer is the path to the kagServer's directory) should look something like this:</p>
 <pre>
@@ Line 333: / Line 359: @@
 Note that January is the 0th month</p>
-=Managing Instability=
-<p>As Alpha software frequently is, the KAG server is very unstable. Recent builds have been especially prone to crashing whenever left running for more than 24 hours (build 360+ has been much more stable, but it varies from release to release due to new features mixed with bug fixes). As such, it is recommended practice run the server in a keepalive script, which will restart it whenever it crashes. (In addition, many people restart their server once a day, during the hours of least usage, to help decrease the risk of a crash while the server is being played upon.)</p>
-==Trelawney's Keepalive Script for Linux==
-<p>This script, <code>dedi.sh</code>, will restart the KAG server 5 seconds after it crashes. Download it [http://dl.dropbox.com/u/23114384/files/dedi.sh here].<br />
-If retyping/using copy and paste, make sure word wrapping is turned off in you text editor. (In nano, use <code> nano -w dedi.sh </code>.)<br />
-Once created, be sure to make the script executable with <code>chmod +x dedi.sh</code>.</p>
-<pre>
-#!/bin/bash
-echo "Running KAG dedicated server"
-echo "TO SET IP/PORT/SLOTS/PASSWORD ADD THESE COMMAND PARAMS: ip 127.0.0.1 port 50213 slots 32 password pass123"
-mv KAGdedi.tmp KAGdedi
-chmod +x KAGdedi
-until ./KAGdedi nolauncher autostart Scripts/dedicated_autostart.gm autoconfig Scripts/dedicated_autoconfig.gm; do
-        echo "KAG server running"
-        sleep 5
-done
-</pre>
-<p>To use, run the script: <code>./dedi.sh</code></p>
-===Adapting for Maqq's Configuration Tool===
-<p>To use a configuration generated by Maqq's Configuration Tool, replace line 6 in the above script with:
-<pre>
-./KAGdedi autostart Scripts/custom_autostart.gm autoconfig Scripts/custom_autoconfig.gm
-</pre>
-</p>
-==The Beaz's Keepalive Script for Windows==
-<p>This script, <code>dedi.bat</code>, will restart the KAG server 5 seconds after it crashes. To use, create a text file, paste/type in the script below, and save it as <code>dedi.bat</code>.
-</p><p>To make it work on Windows Vista or 7 you need to disable Windows Error Reporting. To do so open regedit.exe and and (or modify) DWORD HKLM or HKCU\Software\Microsoft\Windows\Windows Error Reporting\DontShowUI entry with value 1</p>
-<pre>
-@ECHO off
-:restart
-echo (%time%) Server Started - close this window to prevent restart.
-start /wait KAG.exe nolauncher autostart Scripts/dedicated_autostart.gm autoconfig Scripts/dedicated_autoconfig.gm
-echo (%time%) WARNING: Server closed or crashed, restarting.
-goto restart
-</pre>
-===Adapting for Maqq's Configuration Tool===
-<p>To use a configuration generated by Maqq's Configuration Tool, replace line 6 in the above script with:
-<pre>
-start /wait KAG.exe nolauncher autostart Scripts/custom_autostart.gm autoconfig Scripts/custom_autoconfig.gm
-</pre>
-</p>
-==Daily Server Restarts==
-<p>If a KAG server is running in a keepalive script, a scheduled task/cronjob that kills the server once a day is, effectively, a daily restart because the keepalive script will automatically restart the server.</p>
-===For Linux - Cronjob===
-<p>This script will kill all instances of KAGdedi at 3 AM.</p>
-<p>
-# Use <code>crontab -e</code> to create a new cronjob. This will open your default text editor.
-# In the text editor, type:<pre>0 3 * * * pkill -1 KAGdedi</pre>
-# Close editor. Cronjob installed!
-</p>
-=Checking for Updates=
-So far there is not a public script to restart a server when an update is available, but the following logic should be able to be combined with a restart script above to restart a server once an update is available.
-<pre>nova-dhcp-host111:~ ryan$ curl -s http://update.kag2d.com/linux32-dedicated-release/App/version.txt | head -n1 | cut -d ' ' -f2
-1337154874-636-6e12e0f833b0
-nova-dhcp-host111:~ ryan$</pre>
-When that string (the 2nd whitespace-delimited element of the first line of that URL) changes, an update is available.  The first number is the unix timestamp of the build, the 2nd is the code revision, the 3rd is a hex identifier used internally by the developers.  You should be able to just monitor for a change.  You could also use logic involving watching the first two parts of the string to see if they increment, but the format of this string may change in the future -- tl;dr: it is best to just watch if the string changes, don't try to parse it.
 [[Category:Server]]

Difference between revisions of "Server"

Revision as of 00:22, 23 September 2012

Contents

Server Requirements

Dedicated Servers

Software

Lowest Hardware

Recommended Hardware

Network

Ports

Residential Connections

Installation

Port Forwarding

Router

Windows Firewall

Mac Firewall

Antivirus Firewall

Linux Install

Windows Install

Mac Install

Managing Instability

Keep-alive Scripts

Linux/Mac

Adapting for Maqq's Configuration Tool

Windows

Adapting for Maqq's Configuration Tool

Daily Server Restarts

Linux/Mac - Cronjob

Windows - Task Scheduler

Checking for Updates

Configuration

JackD's/Maqq's Tool

Windows GUI

Linux/Mac GUI

Manual

dedicated_autoconfig.gm

dedicated_autostart.gm

mapcycle.cfg

Remote Control

Security Levels

Blacklisting & Whitelisting

Whitelist

Blacklist

Navigation menu

Search