Dedicated Server Setup: Difference between revisions

From Empires Wiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
(46 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{Sitenav|Dedicated Server Setup}}
{{Sitenav|Dedicated Server Setup}}


== Dedicated Server (Windows) ==
== Dedicated Server (Linux) ==
=== Downloading ===
Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 32 bit Debian 10]. <br>
First of all you need the [http://steampowered.com/download/hldsupdatetool.exe HLDS Update Tool]. This is what we use to update/download the server. You will also need Empires Dedicated Server from the [http://www.empiresmod.com/drupal/node/14 Download Page].
Debian 11 has some packages deprecated, this method will not work as described. However you can start with Debian 10 and then later upgrade to 11. <br>
If you have a 64 bit install you might need to execute the following as root: <br>


If you want to use [http://www.sourcemod.net/ SourceMod], make sure you download it before going any further.
dpkg --add-architecture i386
apt update
apt install lib32gcc1


=== Installing ===
Execute the following in a root shell to add the key and repository:
* First we need to download the SDS (Source Dedicated Server). To download we open up hldsupdatetool.exe and download the tool to an arbitrary location on your machine, for example:
C:\HL2DS
* When you have finished installing the update tool open the install folder in a command prompt and type:
hldsupdatetool.exe -command update -game "orangebox" -dir C:\HL2DS 


* If that doesnt work or your stuck or having trouble getting orangebox then you can go [http://www.srcds.com/db/engine.php?subaction=showfull&id=1097362093&archive= HERE] for a more indepth tutorial on how to get it.
apt install gnupg2
curl https://deb1.ws.maxmaton.nl/debian/signing.pub | apt-key add -
echo 'deb http://deb.maxmaton.nl/debian buster main non-free' > /etc/apt/sources.list.d/maxmaton.list
apt update


{{Tip|Make sure you replace C:\HL2DS with your install path if it's different.}}
On Debian 10 x64 (maybe even 9) you will also need to add non-free to each repository <br>
''(Error: empires-server:i386 : Depends: steamcmd:i386 but it is not installable)'' <br>
As mentioned here: https://unix.stackexchange.com/questions/390075/install-steamcmd-on-debian-9-stretch <br>
Do
apt edit-sources
And choose your favorite editor and add non-free to each repository <br>
{|
|-
|[[File:Dedicated_server_nonfree.png|600px|thumb|left|Example]]
|-
|}
After that you can continue with:
apt update
apt install empires-server
'''Your server is now up and running.''' <br>
<br>
You might also need to manually port forward <br>
Ports: <br>
UDP 27005 <br>
TCP and UDP 27015 <br>
<br>
If you also want the community provided maps, you can install the empires-server-maps-extra package (warning, takes a long time to install):


This will download all files necessary to host an orange box server (and Empires). And remember to "Go get yourself a cup of coffee." as valve said, this will take some time
apt install empires-server-maps-extra


* Install the Empires Dedicated Server files to "C:\HL2DS\orangebox\empires" (use your own install path).
=== Opening the server console ===
* Create a shortcut of '''srcds.exe''' and place it where you want then go to properties of the shortcut. Add the following to the end of the shortcut target:  
To open the server console, execute the following command:
-game empires +maxplayers 14 -port 27015 -console +map emp_canyon -autoupdate
It sould look like this;
srcds.exe -game empires +maxplayers 14 -port 27015 -console +map emp_canyon -autoupdate
{{Tip|You can adjust your port and maxplayers via the shortcut or the ''server.cfg'' file.}}


=== Configuration ===
  su - empires -c "tmux attach"
Next, edit your mapcycle.txt and server.cfg files to your liking.
{{Warning|When editing your server.cfg remember to change your '''rcon_password''' and '''hostname''' directives!}}
  rcon_password "pass" //Your rcon password
hostname "Servername" //The name of your server


These are the most important settings to change, there are more in the cfg so test around what is best for you.
To get out of the server console, dont do CTRL + C or you will kill the server <br>
You can do CTRL + B and then CTRL + D to detach and get out of server console <br>
You can do CTRL + B and then page up and page down to scroll higher in console, then ESC to get out of the CTRL + B mode (tmux basics, you can google them) <br>


=== Starting ===
Server folder is located in /var/lib/empires
You should now be able to double-click your server shortcut, which will start up your dedicated server.


== Dedicated Server (Linux) ==
You can also start or stop the empires-server service
=== Downloading ===
service empires-server stop
First of all you need the [http://storefront.steampowered.com/download/hldsupdatetool.bin HLDS Update Tool]. This is what we use to update/download the server. You will also need Empires Dedicated Server from the [http://empiresmod.com/download.php Empires Download Page].
service empires-server start


=== Installing SDS ===
== Dedicated Server (Windows) ==
Now we have to extract the HLDS-Update-Tool.
* Go to the homedir of the user who is designated to run the HL2-Server and create a subdir.
hl2usr@hl2srv ~ # mkdir hl2
* Copy the HLDS-Update-Tool into your new subdir and chmod it to make it executable:
hl2usr@hl2srv ~/hl2 # chmod +x hldsupdatetool.bin
* Run the binary:
hl2usr@hl2srv ~/hl2 # ./hldsupdatetool.bin
* If you get a warning about not finding "compress", go grab the "[http://ncompress.sourceforge.net/ ncompress]" package on Redhat/Fedora:
hl2usr@hl2srv ~/hl2 # yum install ncompress
* Now that you have finished extracting the Update-Tool you can use it to download all required files:
hl2usr@hl2srv ~/hl2 # ./steam -command update -game "orangebox" -dir .
Get yourself a cup of tea, coffee, soda, etc., and have a rest. Depending on your connection speed this can take some time


=== Installing Empires ===
*Download and install (follow the instructions on the page): [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD].
Next, we have to extract the previously downloaded Empires-Server.
*Open a command line window with elevated / local administrator privileges and browse to the location of the update tool.
* Copy the zip-file (something like empires_v1xxx_server.zip) to the folder where the HLDS-Update-Tool resides (''~/hl2'' in this example) and extract it:
*Update syntax example:
hl2usr@hl2srv ~/hl2 # unzip empires_v1xxx_server.zip -d orangebox
This command creates the directory ''~hl2/orangebox/empires'' and extracts all needed files into it.


=== Configuration ===
Before you can start your new Dedicated Server the servers config files have to be altered to satisfy your needs.
* cd to the ''"orangebox/empires"'' subdir
* Edit the file ''mapcycle.txt'' with your prefered text editor and add/remove the maps you like/don't like in your mapcycle
* cd to the config dir of your Empires installation (''~/hl2/orangebox/empires/cfg'' in this example)
* Edit the ''server.cfg'' to your liking
{{Warning|When editing your server.cfg remember to change your '''rcon_password''' and '''hostname''' directives!}}
rcon_password "pass"  //Your rcon password
hostname "Servername" //The name of your server
=== Starting ===
Now your server should be ready for startup
* cd to your Dedicated-Servers basedir (''~/hl2'' in this example)
* Start the Server:
hl2usr@hl2srv ~/hl2 # ./srcds_run -game empires +maxplayers 14 -port 27015 -console +map emp_canyon -autoupdate
{{Tip|Use a terminal multiplexer like [http://www.gnu.org/software/screen/ Screen] to be able to detach the HL2-Server Console and disconnect from your servers shell without terminating the HL2-Daemon}}
* You can create a Bash-File in your Dedicated-Servers basedir to easily start your Empires-Server in a virtual Screen-Terminal:
{{ Box File|empires.sh|
<pre>
<pre>
#! /bin/bash
steamcmd.exe +login anonymous +app_update 460040 validate +quit
screen -A -d -m -S empires -t empires ./srcds_run -game empires +maxplayers 14 -port 27015 -console +map emp_canyon -autoupdate
</pre>
</pre>
}}
Please note that if you wish to retain explicit control over when updates happen on your server you can omit the -autoupdate option.
* Now make the Bash-File executable and run it:
hl2usr@hl2srv ~/hl2 # chmod +x empires.sh
hl2usr@hl2srv ~/hl2 # ./empires.sh
The Dedicated-Server now runs in the background. You can attach to the Screen-Terminal by typing:
hl2usr@hl2srv ~/hl2 # screen -r empires


You can detach from the Screen-Terminal and leave the server running by typing a Control-a followed by "d".
*to update Empires Dedicated Server follow the same procedure.


To stop the server, reattach to the Screen-Terminal and type Control-c.


If you intend to run multiple servers then you will need to set a unique value for the port used & the the Screen-Terminal name used via the -port & -S options in the above command.
== Server Extensions ==
There are several plugins available for use in Empires. Two extension systems are available (and can run in parallel):
* [http://www.sourcemod.net/ SourceMod] is the most common system, and is used for the majority of plugins. Handy SourceMod plugins that have been confirmed to work on Empires servers are:
** [http://raegquit.com/beerdude26/empires-plugins/rg_ungrief.smx Ungrief Command Vehicle] - Teleports the specified command vehicle to where you are looking. Usage: !ungrief <nf | be | imp>
** [http://www.sourcebans.net/ SourceBans] - A free global administration and banning system for Source engine based servers.
** [http://kigenac.com/viewtopic.php?f=4&t=231 Kigen's Anti-Cheat] (Requires Sockets 3.0.1 plugin) - An extensive anti-cheating plugin.
** For more plugins, look at the [[Sourcemod Plugins]] page.
* [http://www.sourceop.com/wiki/Installing SourceOp] is less popular, but is required to run an anti-DoS plugin:
** [http://www.sourceop.com/modules.php?name=Downloads&d_op=viewdownload&cid=9 DoS Attack Fixer] - Protects against A2C_PRINT and other spam.


=== Monitoring server resources ===
Both systems themselves run on [http://www.sourcemm.net/ MetaMod], allowing them to run in parallel.
==== Bandwidth ====
For monitor server bandwidth you can use "iftop" which will display bandwidth consumption on a per port/connections basis. NB: This program needs to run as '''root'''.


Assuming your running empires on the default 27015 port the follow will filter to show only empires traffic:
== Tips and Tricks ==
<pre>
=== Customize server.cfg settings ===
root@hl2srv ~/hl2 # iftop -P -f "port 27015"
As the server.cfg (amongst others) can be overwritten during upgrade and you may wish to have your server run in different "modes" such as password protected clan match/practice, increased resource rates for "tank wars", etc, it is best to treat your server.cfg as "read-only".
</pre>


A lightly loaded server with 4 active players and 7 recently departed:
Any default settings you wish to use can be placed in a separate file such as "myserver.cfg". At the end of server.cfg, you can then add the line "exec myserver.cfg".
<pre>
                50.0Kb          100Kb          150Kb          200Kb      250Kb
└───────────────┴───────────────┴───────────────┴───────────────┴───────────────
oneltdhost.net:27015      <=> guru239.netsonic.fi:13765  43.1Kb  44.8Kb  44.5Kb
oneltdhost.net:27015      <=> 71-213-216-109.sxcy.:27005 41.1Kb  43.8Kb  41.2Kb
oneltdhost.net:27015      <=> cc300737-b.hnglo1.ov:27005 40.7Kb  42.2Kb  36.8Kb
oneltdhost.net:27015      <=> dynamic-acs-24-239-4:27011 27.7Kb  27.9Kb  33.7Kb
oneltdhost.net:27015      <=> host-091-097-139-118:49167    0b    175b    44b
oneltdhost.net:27015      <=> 120.139.76-8:netview-aix-8    0b      0b    44b
oneltdhost.net:27015      <=> ANice-754-1-3-:megaco-h248    0b      0b    44b
oneltdhost.net:27015      <=> host86-139-6-13.rang:64937    0b      0b    44b
oneltdhost.net:27015      <=> daruck-69-4.gimp.co:finger    0b      0b    44b
oneltdhost.net:27015      <=> c24-143-85-34.s:t1distproc    0b      0b    44b
oneltdhost.net:27015      <=> 213-67-55-231-no157.:57200    0b      0b    44b


This way, server.cfg will then run myserver.cfg and override any server.cfg settings.


Loading various server "modes" can then be done by calling them in the server console:


 
<pre>
 
rcon exec tankwars.cfg
 
 
────────────────────────────────────────────────────────────────────────────────
TX:            cumm:  824KB  peak:  88.7Kb  rates:  66.0Kb  69.9Kb  72.9Kb
RX:                    798KB          92.1Kb          86.6Kb  89.0Kb  83.5Kb
TOTAL:                1.58MB            174Kb            153Kb  159Kb  156Kb
</pre>
</pre>


Furthermore, you can hit the "t" key to display each connection on a single line rather than show receive and transmit on two lines.
If you want a mode to be automatically loaded after map change / server restart, you can add another line to server.cfg below the "exec myserver.cfg" entry.
 
==== CPU/Disk ====
For CPU usage you can use top (default installed all linux distros), htop (enhanced 'top') or atop.


[http://htop.sourceforge.net/ htop] gives a very good "at-a-glance" showing overall CPU core load, memory usage and the top dozen or so processes.
As an example of custom configuration you might want to use, the following line will disable the ability to join spectators at the start of the round:


<pre>
<pre>
 
emp_allowspectators 0; wait 30000; emp_allowspectators 1
  1  [||                        2.0%]    Tasks: 85 total, 2 running
  2  [||||||||                23.3%]    Load average: 0.36 0.23 0.14
  Mem[||||||||||||||||||||845/3934MB]    Uptime: 10 days, 02:41:32
  Swp[|                    30/1913MB]
 
  PID USER    PRI  NI  VIRT  RES  SHR S CPU% MEM%  TIME+  Command
27647 hl2      -3  0  161M 94724 12344 S 57.0  2.4 14:37.76 ./srcds_i486 -game
12337 daruck    20  0  468M  210M  3400 R  8.0  5.3 13h08:54 ./isagimp
27649 hl2      -3  0  161M 94724 12344 S  5.0  2.4  1:38.01 ./srcds_i486 -game
28030 hl2      20  0 14984  1160  912 R  1.0  0.0  0:04.71 htop
27997 hl2        0 -20 15464  3188  2424 S  0.0  0.1  0:02.20 atop
11298 named    20  0  177M 31556  2196 S  0.0  0.8 34:28.57 /usr/sbin/named -u
11296 named    20  0  177M 31556  2196 S  0.0  0.8 30:05.04 /usr/sbin/named -u
11295 named    20  0  177M 31556  2196 S  0.0  0.8 25:34.77 /usr/sbin/named -u
2149 mysql    20  0  324M 41132  5068 S  0.0  1.0  2h02:27 /usr/libexec/mysql
2163 mysql    20  0  324M 41132  5068 S  0.0  1.0 50:19.25 /usr/libexec/mysql
    1 root      20  0 10308  716  596 S  0.0  0.0  0:08.52 init [2]
  556 root      16  -4 12588  768  404 S  0.0  0.0  0:00.50 /sbin/udevd -d
1668 root      20  0  6684  916  432 S  0.0  0.0  2:50.50 /sbin/dhclient -1
1728 rpc      20  0 18660  624  424 S  0.0  0.0  0:00.63 rpcbind
1748 root      20  0 21044  1316  564 S  0.0  0.0  0:00.15 pcscd
1756 root      20  0 90636  1292  648 S  0.0  0.0  4:56.45 rsyslogd -m 0
F1Help  F2Setup F3SearchF4InvertF5Tree  F6SortByF7Nice -F8Nice +F9Kill  F10Quit
</pre>
</pre>


It should be put at the end of the .cfg file so as to not delay any subsequent commands. The wait command delays all further commands by the amount specified in 1/100ths of a second.


[http://www.atcomputing.nl/Tools/atop/download-atop.html atop] will give you the missing Hard disk activity monitor by way of the "DSK" line's "busy" percentage:
== Running a beta server ==
<pre>
Running a beta server is just like a normal server, with the desired steam branch mentioned when downloading the server package.
ATOP - oneltdhost        2008/12/31  12:38:24              10 seconds elapsed
PRC | sys  1.10s | user  5.76s | #proc    121 | #zombie    0 | #exit      0 |
CPU | sys      4% | user    21% | irq      0% | idle    174% | wait      0% |
cpu | sys      2% | user    19% | irq      0% | idle    78% | cpu001 w  0% |
cpu | sys      2% | user      1% | irq      0% | idle    97% | cpu000 w  0% |
CPL | avg1  0.19 | avg5    0.20 | avg15  0.12 | csw    18728 | intr    3847 |
MEM | tot    3.8G | free  93.8M | cache  2.9G | buff    4.4M | slab  306.0M |
SWP | tot    1.9G | free    1.8G |              | vmcom 972.8M | vmlim  3.8G |
DSK |        sda | busy      0% | read      12 | write      9 | avio    1 ms |
NET | transport  | tcpi    679 | tcpo    704 | udpi    805 | udpo    620 |
NET | network    | ipi    1498 | ipo    1332 | ipfrw      0 | deliv  1485 |
NET | eth0    0% | pcki    1498 | pcko    1332 | si  344 Kbps | so  279 Kbps |


  PID  SYSCPU  USRCPU  VGROW  RGROW  RDDSK  WRDSK  ST EXC S  CPU CMD    1/1
27647  0.73s  5.55s    0K    0K    0K    0K  --  - S  62% srcds_i486
2149  0.07s  0.11s    0K    0K    0K    0K  --  - S  2% mysqld
28030  0.10s  0.03s    0K    0K    0K    0K  --  - S  1% cheese
27997  0.03s  0.00s    0K    0K    0K    0K  --  - R  0% and
11294  0.00s  0.01s    0K    0K    0K    0K  --  - S  0% biscuits
12336  0.00s  0.00s    0K    0K    0K    0K  --  - S  0% screen
</pre>
== Tip and Tricks ==
=== Modularise server.cfg settings ===
As the server.cfg (amongst others) can be overwritten during upgrade and you may wish to have your server run in different "modes" such as password protected clan match/practice, increase resource rates for "tank wars", etc it's best to treat your server.cfg as "read-only" and any default settings you wish to have place them in a unique filename e.g. myserver.cfg then add a single line to the end of server.cfg "exec myserver.cfg"
This way server.cfg will then run myserver.cfg and override any server.cfg settings.
For example to set your server's hostname you'd add the following to myserver.cfg
<pre>
hostname "My Empires Server"
</pre>
In addition to myserver.cfg you can then create modified files to accommodate your various server "modes" which can either be called via
<pre>
<pre>
rcon exec tankwars.cfg
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>
</pre>
Or if you want this mode to automatically survive a map change/server restart, add another line to server.cfg below your "exec myserver.cfg" entry.


See this link for more info on automating server creation, and on switching to specific steam branches.
https://developer.valvesoftware.com/wiki/SteamCMD#Automating_SteamCMD


== Related Links ==
== Related Links ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [http://www.sourcemod.net/ SourceMod]
* https://pastebin.com/SXsp0r2F

Revision as of 23:46, 28 April 2022

Home > Dedicated Server Setup

Dedicated Server (Linux)

Installing a dedicated server is supported on 32 bit Debian 10.
Debian 11 has some packages deprecated, this method will not work as described. However you can start with Debian 10 and then later upgrade to 11.
If you have a 64 bit install you might need to execute the following as root:

dpkg --add-architecture i386
apt update
apt install lib32gcc1

Execute the following in a root shell to add the key and repository:

apt install gnupg2
curl https://deb1.ws.maxmaton.nl/debian/signing.pub | apt-key add -
echo 'deb http://deb.maxmaton.nl/debian buster main non-free' > /etc/apt/sources.list.d/maxmaton.list
apt update

On Debian 10 x64 (maybe even 9) you will also need to add non-free to each repository
(Error: empires-server:i386 : Depends: steamcmd:i386 but it is not installable)
As mentioned here: https://unix.stackexchange.com/questions/390075/install-steamcmd-on-debian-9-stretch
Do

apt edit-sources

And choose your favorite editor and add non-free to each repository

Example

After that you can continue with:

apt update
apt install empires-server

Your server is now up and running.

You might also need to manually port forward
Ports:
UDP 27005
TCP and UDP 27015

If you also want the community provided maps, you can install the empires-server-maps-extra package (warning, takes a long time to install):

apt install empires-server-maps-extra

Opening the server console

To open the server console, execute the following command:

su - empires -c "tmux attach"

To get out of the server console, dont do CTRL + C or you will kill the server
You can do CTRL + B and then CTRL + D to detach and get out of server console
You can do CTRL + B and then page up and page down to scroll higher in console, then ESC to get out of the CTRL + B mode (tmux basics, you can google them)

Server folder is located in /var/lib/empires

You can also start or stop the empires-server service

service empires-server stop
service empires-server start

Dedicated Server (Windows)

  • Download and install (follow the instructions on the page): SteamCMD.
  • Open a command line window with elevated / local administrator privileges and browse to the location of the update tool.
  • Update syntax example:
steamcmd.exe +login anonymous +app_update 460040 validate +quit
  • to update Empires Dedicated Server follow the same procedure.


Server Extensions

There are several plugins available for use in Empires. Two extension systems are available (and can run in parallel):

  • SourceMod is the most common system, and is used for the majority of plugins. Handy SourceMod plugins that have been confirmed to work on Empires servers are:
    • Ungrief Command Vehicle - Teleports the specified command vehicle to where you are looking. Usage: !ungrief <nf | be | imp>
    • SourceBans - A free global administration and banning system for Source engine based servers.
    • Kigen's Anti-Cheat (Requires Sockets 3.0.1 plugin) - An extensive anti-cheating plugin.
    • For more plugins, look at the Sourcemod Plugins page.
  • SourceOp is less popular, but is required to run an anti-DoS plugin:

Both systems themselves run on MetaMod, allowing them to run in parallel.

Tips and Tricks

Customize server.cfg settings

As the server.cfg (amongst others) can be overwritten during upgrade and you may wish to have your server run in different "modes" such as password protected clan match/practice, increased resource rates for "tank wars", etc, it is best to treat your server.cfg as "read-only".

Any default settings you wish to use can be placed in a separate file such as "myserver.cfg". At the end of server.cfg, you can then add the line "exec myserver.cfg".

This way, server.cfg will then run myserver.cfg and override any server.cfg settings.

Loading various server "modes" can then be done by calling them in the server console:

rcon exec tankwars.cfg

If you want a mode to be automatically loaded after map change / server restart, you can add another line to server.cfg below the "exec myserver.cfg" entry.

As an example of custom configuration you might want to use, the following line will disable the ability to join spectators at the start of the round:

emp_allowspectators 0; wait 30000; emp_allowspectators 1

It should be put at the end of the .cfg file so as to not delay any subsequent commands. The wait command delays all further commands by the amount specified in 1/100ths of a second.

Running a beta server

Running a beta server is just like a normal server, with the desired steam branch mentioned when downloading the server package.

steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit

See this link for more info on automating server creation, and on switching to specific steam branches. https://developer.valvesoftware.com/wiki/SteamCMD#Automating_SteamCMD

Related Links