Empires Wiki - User contributions [en]

Dedicated Server Setup

2025-09-01T21:32:04Z

Neoony: /* Dedicated Server - APT */ Fix the UDP 27005 port forwarding mention, 27005 is only outbound

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map con_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27015
* TCP 27015 (This is only for RCON, best to keep closed, or if you intend to use RCON then only allow specific IPs for security)
''UDP 27005 is only used outbound, no need to port forward''

Note:
For some reason, windows srcds.exe needs to have steam client installed to be able to generate .mdmp from crashes, along with running with -nobreakpad

=== Dedicated Server - APT ===
This method will install the server as a service, with tmux. (with tmux you run the server in a separate terminal window, so you can switch between the dedicated server and linux environment) 
 
Video tutorial: https://www.youtube.com/watch?v=RVvJTphiG24 
 
Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 32 bit Debian 10]. 
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:
mkdir -p /etc/apt/keyrings/
wget -qO- https://deb1.ws.maxmaton.nl/debian/signing.pub | gpg --dearmor | sudo tee /etc/apt/keyrings/maxmaton.gpg >/dev/null
echo 'deb [signed-by=/etc/apt/keyrings/maxmaton.gpg] http://deb.maxmaton.nl/debian buster main non-free' | sudo tee /etc/apt/sources.list.d/maxmaton.list

After that you can continue with:
apt update
apt install empires-server
''When it shows the license agreement, you have to press TAB to put your cursor to OK button.'' 
'''Your server is now up and running.''' 
 
You might also need to manually port forward the following ports:
* UDP 27015
* TCP 27015 (This is only for RCON, best to keep closed, or if you intend to use RCON then only allow specific IPs for security)
''UDP 27005 is only used outbound, no need to port forward''

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 pack is no longer maintained, and has outdated versions of maps.'' 
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) 

You can also start or stop the empires-server service
service empires-server stop
service empires-server start

Typing quit in server console will automatically restart the server. 
When server crashes it will restart automatically. (unless it freezes) 

Server folder is located in '''/var/lib/empires'''

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/bin/empires-server'''

== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Dedicated Server Setup

2025-09-01T21:31:33Z

Neoony: /* Dedicated Server - SteamCMD */ Fix the UDP 27005 port forwarding mention, its only outbound

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map con_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27015
* TCP 27015 (This is only for RCON, best to keep closed, or if you intend to use RCON then only allow specific IPs for security)
''UDP 27005 is only used outbound, no need to port forward''

Note:
For some reason, windows srcds.exe needs to have steam client installed to be able to generate .mdmp from crashes, along with running with -nobreakpad

=== Dedicated Server - APT ===
This method will install the server as a service, with tmux. (with tmux you run the server in a separate terminal window, so you can switch between the dedicated server and linux environment) 
 
Video tutorial: https://www.youtube.com/watch?v=RVvJTphiG24 
 
Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 32 bit Debian 10]. 
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:
mkdir -p /etc/apt/keyrings/
wget -qO- https://deb1.ws.maxmaton.nl/debian/signing.pub | gpg --dearmor | sudo tee /etc/apt/keyrings/maxmaton.gpg >/dev/null
echo 'deb [signed-by=/etc/apt/keyrings/maxmaton.gpg] http://deb.maxmaton.nl/debian buster main non-free' | sudo tee /etc/apt/sources.list.d/maxmaton.list

After that you can continue with:
apt update
apt install empires-server
''When it shows the license agreement, you have to press TAB to put your cursor to OK button.'' 
'''Your server is now up and running.''' 
 
You might also need to manually port forward the following 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.'' 
''This pack is no longer maintained, and has outdated versions of maps.'' 
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) 

You can also start or stop the empires-server service
service empires-server stop
service empires-server start

Typing quit in server console will automatically restart the server. 
When server crashes it will restart automatically. (unless it freezes) 

Server folder is located in '''/var/lib/empires'''

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/bin/empires-server'''

== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Research

2025-08-25T15:17:07Z

Neoony: Add the https://ekstergans.eu/empires/radar/ tool

{{Sitenav|Research}}

{{Note|Research requires that the team have a [[Radar]] facility operational.}}
[[Image:Comm_research1.jpg|right|thumb|Commander Research Menu]]

The [[Commander]] may research various technologies to make his team and their vehicles and players much more powerful. Following a traditional [[RTS]]-style tech tree, the progression through research is branched and varied. Two teams may take completely different paths for research depending on their play style.

The best place for information on each tech is the [http://empiresmod.com/docs/research_tree_appendix.htm Empires Mod Research Tree Appendix]. However, for the correct research paths, please check the Official Tech Tree image at the bottom of this page.

== Researching ==
Researching is handled by the [[Commander]] and requires the presence of a [[Radar]] facility. There is a ''Research'' button in the lower right corner of the commander interface, clicking this will bring up a dialogue showing current research progress and a link to the tech tree for further research. Clicking on the ''View Tree'' button will show the 5 base trees as seen above (Physics, Chemistry, Mechanical Engineering, Electrical Engineering, and Biology). After you have researched and entered one of the 6 base trees, you will see something like this:
[[Image:Comm_research.jpg|800px|center]]
* An icon with a red outline is something that is not researched yet.
* An icon with a green outline is something that has been researched.
* The tri icon represents that you must research the tree in order to get to the sub-items.
* A square icon represents a researchable item.
Research takes time, generally a minute or two for each item.
{{Note|Once a research entry is complete, a message is sent to all players on the commander's team informing them of the advancement.}}

== Tech Tree Tools ==
A tool showing the current research tree (by ekstergans). 
Updates automatically from the empires_scripts gitlab repository. 
https://ekstergans.eu/empires/radar/

== Tech Tree Images ==
A number of graphical representations of the tech tree are floating around out there, some widely used, others not. Below you will find some of these. Only the first one is the actual official version.

'''Tech Tree for Current Release:'''
{|
| [[Image:empires_techtree_2.14.x_coloured.png|1024px|Empires 2.13.x Tech Tree]]
|}

'''Older Tech Trees:'''
<center>
{|
| [[Image:Empires 241 TechTree.png|thumb|Empires 2.41 Tech Tree with production details (Printable Version)]]
| [[Image:Tech_tree.jpg|thumb|Official Tech Tree Image]]
| [[Image:EmpiresSteamR1TechTree.gif|thumb|Steam Release Tech Tree with production details (Printable Version)]]
| [[Image:Empires225bTechTree.gif|thumb|2.25b Tech Tree with production details (Printable Version)]]
| [[Image:Empires224TechTreeIcon.gif|thumb|2.24 Tech Tree (icons) with production details (Printable Version)]]
| [[Image:Empires224TechTree.gif|thumb|2.24 Tech Tree with production details (Printable Version)]]
|-
| [[Image:Empires223TechTree.gif|thumb|2.23 Tech Tree with production details (Printable Version)]]
| [[Image:Empires21TechTree.gif|thumb|2.1 Tech Tree with production details (Printable Version)]]
| [[Image:Physics_research_tree.png|thumb|Physics Tree (Printable Version)]]
| [[Image:Mech_research_tree.png|thumb|Mechanical Engineering Tree (Printable Version)]]
|-
| [[Image:Biologie_research_tree.png|thumb|Biology Tree (Printable Version)]]
| [[Image:Electrical_research_tree.png|thumb|Electrical Engineering Tree (Printable Version)]]
| [[Image:Chemistry_research_tree.png|thumb|Chemistry Tree (Printable Version)]]
|}
</center>

[[Category:Gameplay|Research]]

Dedicated Server Setup

2025-08-11T20:20:03Z

Neoony: /* Dedicated Server - SteamCMD */ Note about needing steam client for windows srcds.exe to generate .mdmp, along with -nobreakpad

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map con_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27005
* TCP and UDP 27015

Note:
For some reason, windows srcds.exe needs to have steam client installed to be able to generate .mdmp from crashes, along with running with -nobreakpad

=== Dedicated Server - APT ===
This method will install the server as a service, with tmux. (with tmux you run the server in a separate terminal window, so you can switch between the dedicated server and linux environment) 
 
Video tutorial: https://www.youtube.com/watch?v=RVvJTphiG24 
 
Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 32 bit Debian 10]. 
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:
mkdir -p /etc/apt/keyrings/
wget -qO- https://deb1.ws.maxmaton.nl/debian/signing.pub | gpg --dearmor | sudo tee /etc/apt/keyrings/maxmaton.gpg >/dev/null
echo 'deb [signed-by=/etc/apt/keyrings/maxmaton.gpg] http://deb.maxmaton.nl/debian buster main non-free' | sudo tee /etc/apt/sources.list.d/maxmaton.list

After that you can continue with:
apt update
apt install empires-server
''When it shows the license agreement, you have to press TAB to put your cursor to OK button.'' 
'''Your server is now up and running.''' 
 
You might also need to manually port forward the following 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.'' 
''This pack is no longer maintained, and has outdated versions of maps.'' 
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) 

You can also start or stop the empires-server service
service empires-server stop
service empires-server start

Typing quit in server console will automatically restart the server. 
When server crashes it will restart automatically. (unless it freezes) 

Server folder is located in '''/var/lib/empires'''

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/bin/empires-server'''

== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Version/2.38.x

2025-06-20T20:47:18Z

Neoony: /* Features */

{{SitenavNested|:Change_Log|Patch notes}}
== 2.38.0 ==
{{FuturePatch}}
'''Release: (2025-06-20)'''
=== Features ===
* Replaced vehicle shell particle effects with the new [https://developer.valvesoftware.com/wiki/Particle_System_Overview particle system]. Each cannon can (and now does) have a different trail of particles.
** This may make it easier to identify the locations of artillery tanks, and notice incoming artillery shells.
* Large rework of the vehicle heat mechanics
** Added a fourth "Overheat" heat region.
*** Now there is "Low" (Green), "Medium" (Yellow), "High" (Orange), and "Overheat" (Red)
** The portion of the heat bar that is not filled will still be displayed, but in a way more muted color.
** The positions of the various heat regions can be defined per-engine.
** When a weapon cannot fire due to overheating, the ammo indicator for that weapon will turn red.
*** This was already in the code, but the definition of overheating used was incorrect so this condition was never actually triggered.
** Engines will now begin stalling at the High region, and completely stall at the Overheat region.
** Weapons can have a "Critical Heat Zone". When a weapon is fired while the vehicle is in this zone or above, then it will fire a crit.
*** Crit shells can have a different firing sound, impact sound, and trail particles.
*** Crit shells do increased damage
*** Only the Plasma cannon currently uses this feature, and likely only the plasma weapons will use this mechanic.
*** Only shells have crits implemented. If this idea is kept, then we'd want to implement the same for MGs, missiles, and grenades.
** Due to simplifications of the engine stall code, the "Heat Stall Penalty" value on engines now indicates the maximum amount the throttle can be reduced to via engine overheating, instead of the square root of the maximum amount the throttle can be reduced to via engine overheating.
* Added an additional info panel to the vehicle HUD
** This panel is displayed to players currently inside a tank
** The panel shows the following information, from left to right:
*** The armor the vehicle has equipped
*** The engine the vehicle has equipped
*** The current number of passengers, out of the vehicle's total capacity
*** Whether the vehicle will not detonate mines (i.e., the driver or a passenger has the Defuse skill)
*** Whether the vehicle has a spawn point
* Added Pykrete Armor
** Pykrete armor is made of ice reinforced with complex hydrocarbon chains.
** It uses ambient humidity to slowly regenerate when vehicle heat is in the low region, but melts faster in higher heat regions. This introduces a new melting/regeneration mechanic to the game.
* Research now drains resources over time, instead of spending all of the resources up-front.
** Commanders can pause and resume research at any time.
** If there is insufficient resources for research to continue, then research is paused automatically.
*** The entire team will hear the "Insufficient Resources" sound clip.
** When research is complete, the entire team (and all spectators) will hear the "Research is now complete" sound effect, instead of just the commander.
** Added a new mapmaking entity <code>emp_logic_resource_drain</code> to allow mapmakers to specify their own similar resource drains.
* Improved the resources HUD display. The resource total and income are now displayed more accurately than before.
** Resource total updates more frequently, to better reflect the actual value. Previously it was tied to a timer.
**Resource income now displays all manual adjustments to income, not just income from refineries. This should cover all gains/losses but to list some examples it includes resource adjustments from vehicle purchases, vehicle carcass recycling and building purchases/refunds.
**Recurring resource income is now displayed alongside the dynamic income, this figure excludes manual adjustments and resource drains. Essentially, this displays income from recurring sources, for example refineries.
* Engineer and Commander radars now also spot fully-built enemy buildings, in addition to enemy vehicles.
* Added additional HUD icons for certain F-menu requests.
* Added additional cancellation and suppression criteria for certain F-menu requests.
** Notably, requests for ammo, health, and repairs are automatically cancelled as soon as any health or ammo is recieved, as appropriate.
* Added new listener mapmaking entities, <code>emp_logic_resource_listener</code>, <code>emp_logic_ticket_listener</code>, and <code>emp_logic_research_listener</code>.
* Added a sound effect that plays when a tank loads ammo.
* Pressing the suicide hotkey (delete by default) while already dead force-kills you, preventing engineers from reviving you.
* The debug console command <code>emp_debug_spawn_shell</code> now has three parameters:
** 1: The weapon index of the shell to spawn
** 2: The number of shells to spawn (between 1 and 128)
** 3: Whether or not the shell is a crit shell.
* Commanders can now see player request icons from further away, especially requests for commander attention.
** This distance is 12k units for commander attention requests and 6k units for other requests
** For comparison, requests are normally 3k units and revive icons 4k units

=== Bugfixes ===
* The C++ code for the mini-map has been extensively refactored. This update resolves several longstanding issues and improves maintainability, making it easier for developers to add new features and enhancements.
* Fixed a bug causing homing missiles to fire without any spread when fired without entering missile lock.
* Fixed a crash involving the vehicle info HUD element.
* Fixed a bug where reviving in water would cause the player to appear far beneath the surface.
* Fixed a bug where players changing teams to spectator while in a vehicle retain collision.
* Fixed some issues with the method in which tips were selected to be displayed on the loading screen.

=== Script/Game Balance ===

==== Buildings ====
* Armory
** Reduced Carcass Removal Time from 30 to 10
* Barracks
** Reduced Carcass Removal Time from 30 to 20
* Radar
** Reduced Carcass Removal Time from 30 to 15
* Repair Pad
** Reduced Carcass Removal Time from 30 to 15

==== Research ====
* All research costs have been divided by 60, to account for the change from up-front costs to res/second costs.
* Added a research item for APC spawn points.
** Costs 4 resources per second for 120 seconds. (480 resources in total.)
* Added a research item for Pykrete Armor in the Chemistry tree within Improved Heat Transfer Fluids, next to Advanced Coolant Engine.
* APC Chassis is researched by default
* The Homing Missiles research now unlocks the 2-slot homing missile instead of the 3-slot homing missile
* Re-enabled research for Salvo Homing Missiles and TOW Guided Missiles
* Nuclear Warhead
** Increased research cost from 4 to 5 (Total cost 1200)
** Increased research time from 180 to 240

==== Infantry Weapons ====
* NF Heavy Carbine (SMG3)
** Improved Overall Weapon Spread
**Increased damage per bullet from 27 to 37
** Increased Time between shoots from 0.12 to 0.20
** Increased minimal damage per bullet from 13 to 18
** Decreased clip size from 20 to 12
*** Also adjusted spawn/max ammo counts - engineer spawns with 4 clips and scout spawns with 5 clips. (Without ammo increase skill.)

=== Vehicle Chassis ===
* NF & BE APC
** Increased available weight from 235 to 265

==== Vehicle Armors ====
* Capacitive Armor
** Buff
*** Decreased Cost per plate from 20 to 18
*** Increased Health per plate from 80 to 110
*** Decreased Damage To Heat Absorbed from 0.1 to 0.05
** Nerf
*** Increased Weight per plate from 15 to 18
*** Added Speed To Damage Modifier 0.000035
*** Decreased Infantry Grenade Resist from 0.55 to 0.35
*** Decreased Infantry Mine Resist from 0.55 to 0.50
*** Decreased Infantry Missile Resist from 0.40 to 0.20
*** Decreased Infantry Mortar Resist from 0.40 to 0.20
*** Decreased Infantry Explosive Sticky Resist from 0.25 to 0.20
*** Decreased Infantry Sticky Stun Resist from 0.25 to 0.15
*** Decreased Squad Arty Resist from 0.55 to 0.40
* Composite
** Increase Sticky Bomb Resistance from -0.716 to -0.6

==== Vehicle Engines ====
* All Chassis
** Increased Heat Dissipation for Advanced Coolant Engine by 1

==== Vehicle Weapons ====
* Shells and missiles now use uniform circular distribution when applying spread instead of bounded uniform distribution.
** All this means is that spread is applied using a radius around the crosshair instead of using random min/max bounds. (Circular distribution instead of square.)
* Plasma Cannon
** Decreased damage from 84 to 60
** Now fires 2x damage crit shells when in the high (orange) heat region or above
* Salvo Homing Missiles
** Increased cost from 105 to 150
** Increased clip size from 4 to 10
** Increased reload time from 3.75 to 8
** Increased missile lock on range from 5000 to 8000
** Decreased lock on time from 0.6 to 0.5
** Decreased lock on radius from 0.35 to 0.2
** Decreased lock on range modifier from 0.00040 to 0.00025
** Decreased damage from 40 to 28
** Increased Heat from 3 to 5
** Decreased weight from 100 to 80
** Increased Explosion range from 80 to 150
* Homing Missiles (2-slot)
** Increased cost from 80 to 95
** Decreased missile Speed from 2500 to 2300
** Decreased weight from 70 to 60
* TOW Guided Missiles
** Increased cost from 135 to 150
** Increased Missile speed from 2100 to 2300
** Increased Missile Range from 6500 to 8000
** Increased clip size from 5 to 6
** Increased Explosion Radius from 115 to 150
** Decreased Cycle Time from 1.3 to 1.25
* Biological Cannon
** Increased Damage from 80 to 90
** Reduced Biological Damage from 10 to 5
* Biological Missile Launcher
** Increased Damage from 50 to 60
** Reduced Biological Damage from 10 to 5
* Homing Missile Launcher
** Increased Lock On Radius from 0.1 to 0.2
** Reduced Lock On Range Multiplier from 0.00025 to 0.0001875
*** Lock On time increased from between 0.5 to 2.5 seconds to between 0.5 to 2 (up to 40% faster)
* Biological Grenade Launcher
** Reduced Cycle Time from 2 to 1.6
** Increased Clip Size from 6 to 8
** Reduced Total Ammo Clips from 5 to 4
** Reduced Vehicle Biological Damage from 10 to 5
** Increased Vehicle Bio Time from 4 to 5
* Medium Artillery Cannon
** Increased Projectile Spread from 0.001 to 0.25
* High-Explosive Artillery Cannon
** Increased Projectile Spread from 0.001 to 0.30
* Ranged Artillery Cannon
** Increased Projectile Spread from 0.001 to 0.15

=== Other changes ===

* Several unused features have been removed:
** Research can no longer upgrade ammo damage.
** Vehicle weapons can no longer be "disabled", and research cannot disable vehicle weapons.
** Servers can no longer disable vehicle horns with the <code>emp_sv_vehicle_allow_horns</code> cvar
* Increased the default value of the <code>emp_sv_vehicle_fadeout_time</code> cvar from 30 seconds to 180 seconds.
* Increased the default value of the <code>emp_sv_vehicle_fadeout_time_partial</code> cvar from 30 seconds to 60 seconds.
* We did a large refactor to the minimap code. You shouldn't notice any huge changes, but the scaling might be slightly off from what it was before. This can be adjusted with the <code>emp_map_size</code> cvar.
* Removed some less useful statistics from the vehicle preview in the vehicle creation panel.

[[Category:Patch Notes]]

Change Log

2024-04-30T19:50:05Z

Neoony: /* Source Engine (2013 branch) */ fix wrong date on 2.36.3 release

This is an overview of the published versions of empires:

== Source Engine (2013 branch) ==
{{VersionTableHeader}}
{{VersionTableRow|patches=4|2.36|3|2024-04-20}}
{{VersionTableRow|2.36|2|2024-02-24}}
{{VersionTableRow|2.36|1|2024-02-18}}
{{VersionTableRow|2.36|0|2024-02-17}}
{{VersionTableRow|patches=3|2.35|2|2023-07-15}}
{{VersionTableRow|2.35|1|2023-07-08}}
{{VersionTableRow|2.35|0|2023-06-18}}
{{VersionTableRow|patches=9|2.34|9|2023-03-05}}
{{VersionTableRow|2.34|8}}
{{VersionTableRow|2.34|7}}
{{VersionTableRow|2.34|6}}
{{VersionTableRow|2.34|5}}
{{VersionTableRow|2.34|4}}
{{VersionTableRow|2.34|3}}
{{VersionTableRow|2.34|2}}
{{VersionTableRow|2.34|1|2022-01-16}}
{{VersionTableRow|patches=5|2.33|5|2022-01-01}}
{{VersionTableRow|2.33|4}}
{{VersionTableRow|2.33|3}}
{{VersionTableRow|2.33|2}}
{{VersionTableRow|2.33|1}}
{{VersionTableRow|patches=2|2.32|2}}
{{VersionTableRow|2.32|1}}
{{VersionTableRow|patches=2|2.31|2}}
{{VersionTableRow|2.31|1}}
{{VersionTableRow|patches=10|2.30|10}}
{{VersionTableRow|2.30|9}}
{{VersionTableRow|2.30|8}}
{{VersionTableRow|2.30|7}}
{{VersionTableRow|2.30|6}}
{{VersionTableRow|2.30|5}}
{{VersionTableRow|2.30|4|2021-01-22}}
{{VersionTableRow|2.30|3}}
{{VersionTableRow|2.30|2}}
{{VersionTableRow|2.30|1|2020-12-05}}
{{VersionTableRow|patches=6|2.29|6}}
{{VersionTableRow|2.29|5}}
{{VersionTableRow|2.29|4}}
{{VersionTableRow|2.29|3}}
{{VersionTableRow|2.29|2}}
{{VersionTableRow|2.29|1}}
{{VersionTableRow|patches=8|2.28|8}}
{{VersionTableRow|2.28|7}}
{{VersionTableRow|2.28|6}}
{{VersionTableRow|2.28|5}}
{{VersionTableRow|2.28|4}}
{{VersionTableRow|2.28|3}}
{{VersionTableRow|2.28|2}}
{{VersionTableRow|2.28|1}}
{{VersionTableRow|patches=1|2.27|1}}
{{VersionTableRow|patches=8|2.26|8}}
{{VersionTableRow|2.26|7}}
{{VersionTableRow|2.26|6}}
{{VersionTableRow|2.26|5}}
{{VersionTableRow|2.26|4}}
{{VersionTableRow|2.26|3}}
{{VersionTableRow|2.26|2}}
{{VersionTableRow|2.26|1}}
{{VersionTableRow|patches=9|2.25|9}}
{{VersionTableRow|2.25|8}}
{{VersionTableRow|2.25|7}}
{{VersionTableRow|2.25|6}}
{{VersionTableRow|2.25|5}}
{{VersionTableRow|2.25|4}}
{{VersionTableRow|2.25|3}}
{{VersionTableRow|2.25|2}}
{{VersionTableRow|2.25|1}}
{{VersionTableRow|patches=4|2.24|4}}
{{VersionTableRow|2.24|3}}
{{VersionTableRow|2.24|2}}
{{VersionTableRow|2.24|1}}
{{VersionTableRow|patches=3|2.23|3}}
{{VersionTableRow|2.23|2}}
{{VersionTableRow|2.23|1}}
{{VersionTableRow|patches=2|2.22|2}}
{{VersionTableRow|2.22|1}}
{{VersionTableRow|patches=6|2.21|6}}
{{VersionTableRow|2.21|5}}
{{VersionTableRow|2.21|4}}
{{VersionTableRow|2.21|3}}
{{VersionTableRow|2.21|2}}
{{VersionTableRow|2.21|1}}
{{VersionTableRow|patches=2|2.20|2}}
{{VersionTableRow|2.20|1}}
{{VersionTableRow|patches=1|2.19|1}}
{{VersionTableRow|patches=2|2.18|2}}
{{VersionTableRow|2.18|1}}
{{VersionTableRow|patches=4|2.17|4}}
{{VersionTableRow|2.17|3}}
{{VersionTableRow|2.17|2}}
{{VersionTableRow|2.17|1|2018-08-15}}
{{VersionTableRow|patches=4|2.16|4}}
{{VersionTableRow|2.16|3}}
{{VersionTableRow|2.16|2}}
{{VersionTableRow|2.16|1}}
{{VersionTableRow|patches=11|2.15|11}}
{{VersionTableRow|2.15|10}}
{{VersionTableRow|2.15|9}}
{{VersionTableRow|2.15|8}}
{{VersionTableRow|2.15|7}}
{{VersionTableRow|2.15|6}}
{{VersionTableRow|2.15|5}}
{{VersionTableRow|2.15|4}}
{{VersionTableRow|2.15|3}}
{{VersionTableRow|2.15|2}}
{{VersionTableRow|2.15|1}}
{{VersionTableRow|patches=7|2.14|7}}
{{VersionTableRow|2.14|6}}
{{VersionTableRow|2.14|5}}
{{VersionTableRow|2.14|4}}
{{VersionTableRow|2.14|3}}
{{VersionTableRow|2.14|2}}
{{VersionTableRow|2.14|1}}
{{VersionTableRow|patches=5|2.13|5}}
{{VersionTableRow|2.13|4}}
{{VersionTableRow|2.13|3}}
{{VersionTableRow|2.13|2}}
{{VersionTableRow|2.13|1}}
{{VersionTableRow|patches=1|2.12|1}}
{{VersionTableRow|patches=1|2.11|1}}
{{VersionTableRow|patches=1|2.10|0|2016-9-25}}
{{VersionTableRow|patches=4|2.9|3}}
{{VersionTableRow|2.9|2}}
{{VersionTableRow|2.9|1}}
{{VersionTableRow|2.9|0|2016-08-13}} 
{{VersionTableRow|patches=1|2.8|0|2016-05-08}}
{{VersionTableRow|patches=1|2.7|0|2016-02-17}}
{{VersionTableRow|patches=12|2.6|9|2015-06-27}}
{{VersionTableRow|2.6|8|2015-05-10}}
{{VersionTableRow|2.6|7a}}
{{VersionTableRow|2.6|7|2015-05-04}}
{{VersionTableRow|2.6|6|2015-04-25}}
{{VersionTableRow|2.6|5|2015-03-28}}
{{VersionTableRow|2.6|4a|2015-03-22}}
{{VersionTableRow|2.6|4|2015-03-21}}
{{VersionTableRow|2.6|3|2015-03-14}}
{{VersionTableRow|2.6|2|2015-02-12}}
{{VersionTableRow|2.6|1|2015-01-27}}
{{VersionTableRow|2.6|0|2015-01-14}}
{{VersionTableRowOld|patches=10|2.52|.9|2015-01-10}}
{{VersionTableRowOld|2.52|.8|2014-12-25}}
{{VersionTableRowOld|2.52|.7|2014-12-13}}
{{VersionTableRowOld|2.52|.6|2014-11-29}}
{{VersionTableRowOld|2.52|.5|2014-11-21}}
{{VersionTableRowOld|2.52|.4|2014-11-16}}
{{VersionTableRowOld|2.52|.3|2014-11-08}}
{{VersionTableRowOld|2.52|.2|2014-10-21}}
{{VersionTableRowOld|2.52|.1|2014-10-18}}
{{VersionTableRowOld|2.52||2014-09-28}}
{{VersionTableRowOld|patches=1|2.51||2014-09-28}}
{{VersionTableRowOld|patches=4|2.5| RC4}}
{{VersionTableRowOld|2.5| RC3}}
{{VersionTableRowOld|2.5| RC2}}
{{VersionTableRowOld|2.5| RC1|2014-03-26}}
|}

== Source Engine (orange box branch) ==

{{VersionTableHeader}}
{{VersionTableRowOld|patches=1|2.41||2013-03-23}}
{{VersionTableRowOld|patches=1|2.4||2012-12-27}}
{{VersionTableRowOld|patches=2|Steam Release| 2|2011-11-26}}
{{VersionTableRowOld|Steam Release| 1|2011-03-09}}
{{VersionTableRowOld|patches=1|2.31|a|2011-02-22}}
{{VersionTableRowOld|patches=1|2.30||2010-11-21}}
{{VersionTableRowOld|patches=1|2.29||2010-11-8}}
{{VersionTableRowOld|patches=2|2.28|b|2010-10-28}}
{{VersionTableRowOld|2.28||2010-10-11}}
{{VersionTableRowOld|patches=1|2.27||2010-09-30}}
{{VersionTableRowOld|patches=3|2.26||2010-09-25}}
{{VersionTableRowOld|2.26| Rc2|2010-09-23}}
{{VersionTableRowOld|2.26| Rc1|2010-09-23}}
{{VersionTableRowOld|patches=3|2.25|b|2010-04-29}}
{{VersionTableRowOld|2.25|a|2010-04-18}}
{{VersionTableRowOld|2.25||2010-04-14}}
{{VersionTableRowOld|patches=5|2.24|e|2009-07-24|type=Linux hotfix}}
{{VersionTableRowOld|2.24|d|2009-05-21}}
{{VersionTableRowOld|2.24|c|2009-05-08|type=Balancing hotfix}}
{{VersionTableRowOld|2.24|b|2009-05-08}}
{{VersionTableRowOld|2.24||2009-05-07|type=Prerelease}}
{{VersionTableRowOld|patches=4|2.2|3|2009-03-14}}
{{VersionTableRowOld|2.2|2|2009-01-19}}
{{VersionTableRowOld|2.2|1|2008-12-30}}
{{VersionTableRowOld|2.2||2008-12-13}}
|}

== Source Engine (hl2 branch) ==

{{VersionTableHeader}}
{{VersionTableRowOld|patches=2|2.1|1|2008-01-03}}
{{VersionTableRowOld|2.1||2008-01-02}}
{{VersionTableRowOld|patches=1|2.0||2007-11-30}}
{{VersionTableRowOld|patches=10|1.0|71|2006-07-31}}
{{VersionTableRowOld|1.0|7|2006-07-23}}
{{VersionTableRowOld|1.0|6|2006-07-2}}
{{VersionTableRowOld|1.0|5|2006-05-14}}
{{VersionTableRowOld|1.0|4}}
{{VersionTableRowOld|1.0|31}}
{{VersionTableRowOld|1.0|3}}
{{VersionTableRowOld|1.0|2}}
{{VersionTableRowOld|1.0|1|2006-03-17}}
{{VersionTableRowOld|1.0||2006-03-04}}
|}
== Refractor 2 Engine ==

{{VersionTableHeader}}
{{VersionTableRowOld|patches=1|0.2||2004-04-10}}
{{VersionTableRowOld|patches=2|0.1||2004-02-08}}
{{VersionTableRowOld|0.1||2004-01-10}}
|}

== Misc. Pages ==
{{fixme|These pages contain content that needs to be split up into the redlink pages above.}}
* [[Change_Log_(2.8-2.25)|2.8 - 2.25]]
* [[Change_Log_(pre_2.25)|2.25 and older]]

Dedicated Server Setup

2024-03-12T22:12:56Z

Neoony: /* Dedicated Server - SteamCMD */ fix outdated district map name in the start command :D

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map con_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27005
* TCP and UDP 27015

=== Dedicated Server - APT ===
This method will install the server as a service, with tmux. (with tmux you run the server in a separate terminal window, so you can switch between the dedicated server and linux environment) 
 
Video tutorial: https://www.youtube.com/watch?v=RVvJTphiG24 
 
Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 32 bit Debian 10]. 
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:
mkdir -p /etc/apt/keyrings/
wget -qO- https://deb1.ws.maxmaton.nl/debian/signing.pub | gpg --dearmor | sudo tee /etc/apt/keyrings/maxmaton.gpg >/dev/null
echo 'deb [signed-by=/etc/apt/keyrings/maxmaton.gpg] http://deb.maxmaton.nl/debian buster main non-free' | sudo tee /etc/apt/sources.list.d/maxmaton.list

After that you can continue with:
apt update
apt install empires-server
''When it shows the license agreement, you have to press TAB to put your cursor to OK button.'' 
'''Your server is now up and running.''' 
 
You might also need to manually port forward the following 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.'' 
''This pack is no longer maintained, and has outdated versions of maps.'' 
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) 

You can also start or stop the empires-server service
service empires-server stop
service empires-server start

Typing quit in server console will automatically restart the server. 
When server crashes it will restart automatically. (unless it freezes) 

Server folder is located in '''/var/lib/empires'''

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/bin/empires-server'''

== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Dedicated Server Setup

2024-02-21T20:40:01Z

Neoony: /* Dedicated Server - APT */ mention the TAB key on license during installation

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map emp_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27005
* TCP and UDP 27015

=== Dedicated Server - APT ===
This method will install the server as a service, with tmux. (with tmux you run the server in a separate terminal window, so you can switch between the dedicated server and linux environment) 
 
Video tutorial: https://www.youtube.com/watch?v=RVvJTphiG24 
 
Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 32 bit Debian 10]. 
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:
mkdir -p /etc/apt/keyrings/
wget -qO- https://deb1.ws.maxmaton.nl/debian/signing.pub | gpg --dearmor | sudo tee /etc/apt/keyrings/maxmaton.gpg >/dev/null
echo 'deb [signed-by=/etc/apt/keyrings/maxmaton.gpg] http://deb.maxmaton.nl/debian buster main non-free' | sudo tee /etc/apt/sources.list.d/maxmaton.list

After that you can continue with:
apt update
apt install empires-server
''When it shows the license agreement, you have to press TAB to put your cursor to OK button.'' 
'''Your server is now up and running.''' 
 
You might also need to manually port forward the following 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.'' 
''This pack is no longer maintained, and has outdated versions of maps.'' 
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) 

You can also start or stop the empires-server service
service empires-server stop
service empires-server start

Typing quit in server console will automatically restart the server. 
When server crashes it will restart automatically. (unless it freezes) 

Server folder is located in '''/var/lib/empires'''

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/bin/empires-server'''

== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Dedicated Server Setup

2024-02-21T20:37:40Z

Neoony: /* Dedicated Server - APT */ remove the deprecated apt-key method and adjust the modern method, as also folder needs to be created on debian 10

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map emp_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27005
* TCP and UDP 27015

=== Dedicated Server - APT ===
This method will install the server as a service, with tmux. (with tmux you run the server in a separate terminal window, so you can switch between the dedicated server and linux environment) 
 
Video tutorial: https://www.youtube.com/watch?v=RVvJTphiG24 
 
Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 32 bit Debian 10]. 
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:
mkdir -p /etc/apt/keyrings/
wget -qO- https://deb1.ws.maxmaton.nl/debian/signing.pub | gpg --dearmor | sudo tee /etc/apt/keyrings/maxmaton.gpg >/dev/null
echo 'deb [signed-by=/etc/apt/keyrings/maxmaton.gpg] http://deb.maxmaton.nl/debian buster main non-free' | sudo tee /etc/apt/sources.list.d/maxmaton.list

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 the following 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.'' 
''This pack is no longer maintained, and has outdated versions of maps.'' 
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) 

You can also start or stop the empires-server service
service empires-server stop
service empires-server start

Typing quit in server console will automatically restart the server. 
When server crashes it will restart automatically. (unless it freezes) 

Server folder is located in '''/var/lib/empires'''

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/bin/empires-server'''

== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Dedicated Server Setup

2024-02-21T20:21:23Z

Neoony: /* Dedicated Server - APT */ Remove the debian 11 and 12 mentions, the GDB/lib32gcc1 actually does not work and produces errors when starting server, had no luck getting it to work with new lib32gcc-s1 in 11 and 12 - not sure what issues that causes

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map emp_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27005
* TCP and UDP 27015

=== Dedicated Server - APT ===
This method will install the server as a service, with tmux. (with tmux you run the server in a separate terminal window, so you can switch between the dedicated server and linux environment) 
 
Video tutorial: https://www.youtube.com/watch?v=RVvJTphiG24 
 
Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 32 bit Debian 10]. 
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

The above is deprecated way of adding the key and repo. This is the new way, but I have yet to test it on Debian 10 or 11 (only tried 12)
wget -qO- https://deb1.ws.maxmaton.nl/debian/signing.pub | gpg --dearmor | sudo tee /etc/apt/keyrings/maxmaton.gpg >/dev/null
echo 'deb [signed-by=/etc/apt/keyrings/maxmaton.gpg] http://deb.maxmaton.nl/debian buster main non-free' | sudo tee /etc/apt/sources.list.d/maxmaton.list

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 the following 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.'' 
''This pack is no longer maintained, and has outdated versions of maps.'' 
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) 

You can also start or stop the empires-server service
service empires-server stop
service empires-server start

Typing quit in server console will automatically restart the server. 
When server crashes it will restart automatically. (unless it freezes) 

Server folder is located in '''/var/lib/empires'''

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/bin/empires-server'''

== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Dedicated Server Setup

2024-02-21T18:14:52Z

Neoony: /* Dedicated Server - APT */ add debian 12 notes

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map emp_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27005
* TCP and UDP 27015

=== Dedicated Server - APT ===
This method will install the server as a service, with tmux. (with tmux you run the server in a separate terminal window, so you can switch between the dedicated server and linux environment) 

Video tutorial: https://www.youtube.com/watch?v=RVvJTphiG24 

Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 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

(Debian 12 would need "apt install lib32gcc-sl" ... Debian 12 guide to be updated)

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

The above is deprecated way of adding the key and repo. This is the new way, but I have yet to test it on Debian 10 or 11 (only tried 12)
wget -qO- https://deb1.ws.maxmaton.nl/debian/signing.pub | gpg --dearmor | sudo tee /etc/apt/keyrings/maxmaton.gpg >/dev/null
echo 'deb [signed-by=/etc/apt/keyrings/maxmaton.gpg] http://deb.maxmaton.nl/debian buster main non-free' | sudo tee /etc/apt/sources.list.d/maxmaton.list

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 the following 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.'' 
''This pack is no longer maintained, and has outdated versions of maps.'' 
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) 

You can also start or stop the empires-server service
service empires-server stop
service empires-server start

Typing quit in server console will automatically restart the server. 
When server crashes it will restart automatically. (unless it freezes) 

Server folder is located in '''/var/lib/empires'''

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/bin/empires-server'''

== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Dedicated Server Setup

2024-02-21T17:47:04Z

Neoony: /* Dedicated Server - APT */ add nondeprecated way of adding a key and repo

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map emp_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27005
* TCP and UDP 27015

=== Dedicated Server - APT ===
This method will install the server as a service, with tmux. (with tmux you run the server in a separate terminal window, so you can switch between the dedicated server and linux environment) 

Video tutorial: https://www.youtube.com/watch?v=RVvJTphiG24 

Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 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

The above is deprecated way of adding the key and repo. This is the new way, but I have yet to test it on Debian 10 or 11 (only 12)
wget -qO- https://deb1.ws.maxmaton.nl/debian/signing.pub | gpg --dearmor | sudo tee /etc/apt/keyrings/maxmaton.gpg >/dev/null
echo 'deb [signed-by=/etc/apt/keyrings/maxmaton.gpg] http://deb.maxmaton.nl/debian buster main non-free' | sudo tee /etc/apt/sources.list.d/maxmaton.list

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 the following 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.'' 
''This pack is no longer maintained, and has outdated versions of maps.'' 
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) 

You can also start or stop the empires-server service
service empires-server stop
service empires-server start

Typing quit in server console will automatically restart the server. 
When server crashes it will restart automatically. (unless it freezes) 

Server folder is located in '''/var/lib/empires'''

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/bin/empires-server'''

== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Dedicated Server Setup

2024-02-20T20:50:30Z

Neoony: /* Dedicated Server - APT */ mention that the map pack is not maintained

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map emp_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27005
* TCP and UDP 27015

=== Dedicated Server - APT ===
This method will install the server as a service, with tmux. (with tmux you run the server in a separate terminal window, so you can switch between the dedicated server and linux environment) 

Video tutorial: https://www.youtube.com/watch?v=RVvJTphiG24 

Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 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
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 the following 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.'' 
''This pack is no longer maintained, and has outdated versions of maps.'' 
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) 

You can also start or stop the empires-server service
service empires-server stop
service empires-server start

Typing quit in server console will automatically restart the server. 
When server crashes it will restart automatically. (unless it freezes) 

Server folder is located in '''/var/lib/empires'''

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/bin/empires-server'''

== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Sourcemod Plugins

2024-02-06T17:00:05Z

Neoony: EventTimeleftHostname is 100% my plugin -.-

{{ServerResources}}
=Sourcemod installation=
Check the following page for guide how to install Metamod and Sourcemod: [[Sourcemod]]
=Empires Specific Plugins=
Empires has a few specific plugins coded by members of its community, you can find them on [https://git.empiresmod.com/sourcemod Empires' Gitlab].
==Draftpick==
[[Draftpick]] is a [[Sourcemod]] plugin by [[Mikleo]], it is responsible for automatically balancing the players between teams using statistics gathered by [[Empstats]]. It includes four types of Draft.
==Empfun==
[[Empfun]] is a [[Sourcemod]] plugin by [[Mikleo]], it adds a way to manipulate entities within the game and create custom scenarios.
==Empstats==
[[Empstats]] is a [[Sourcemod]] plugin by [[Mikleo]], it tracks various statistics.
==Emputils==
[[Emputils]] is a [[Sourcemod]] plugin by [[Mikleo]], it contains various utilities to be used by other plugins.
==EventTimeleftHostname==
[[EventTimeleftHostname]] is a [[Sourcemod]] plugin by [[Neoony]], it allows server owners to display a countdown in their server's title.
==Lawlietstats==
[[Lawlietstats]] is a [[Sourcemod]] plugin by [[Lawliet]], it collects various informations.
==Lobby==
[[Lobby]] is a [[Sourcemod]] plugin by [[Neoony]], it controls the Lobby Server.
==NoCommExtendVote==
'''No Commander Extend Vote''' or [[NCEV]] for short is a [[Sourcemod]] plugin by [[Neoony]], it automatically detects commanders and only allows the game to start if both teams have a commander. 
==PugPlugin==
==ResearchInfo==
[[ResearchInfo]] is a [[Sourcemod]] plugin by [[Neoony]], gives a chat command to show what your team has researched in console. Unstable and unfinished. WIP
==sameIPBlock==
[[sameIPBlock]] is a [[Sourcemod]] plugin by [[Neoony]], only allows players to join from unique IP address.
==SourcemodOffsets==
[[SourcemodOffsets]] is a [[Sourcemod]] plugin by [[Neoony]], it automatically updates the sourcemod offsets required for Empires when they change.
==SquadControl==
[[Squadcontrol]] is a [[Sourcemod]] plugin by [[Mikleo]], it adds various utilities for Empires.
==Surrender==
[[Surrender]] is a [[SourceMod]] plugin by [[Neoony]], it allows players to trigger a vote to surrender which if successful destroys their [[Command Vehicle]]. 
==Updater==
[[Updater]] is a [[Sourcemod]] plugin by <> and updated for Empires by [[Neoony]], it allows servers to automatically update their plugins.
==Ungrief==
[[Ungrief]] is a [[Sourcemod]] plugin by [[Theowningone]] and updated by [[Neoony]], it allows admins to teleport the [[Command Vehicle]].
==Votetime==
[[Votetime]] is a [[Sourcemod]] plugin by [[Mikleo]], it adds commands to control the commander vote timer.
==vprofReport==
[[vprofReport]] is a [[Sourcemod]] plugin by [[Neoony]], automatically start "vprof" at certain number of clients on the server and then generates report when the round ends.
=Generic Plugins=
== End of Round AllTalk ==
Original Plugin: https://forums.alliedmods.net/showthread.php?p=1246351
== Chat Triggers ==
Plugin link: https://forums.alliedmods.net/showthread.php?p=585758 

== Advertisements 2.0 ==
Plugin link: https://forums.alliedmods.net/showthread.php?t=155705 
Simple advertisements plugin. It supports center, chat, hint, menu and top messages.
== SourceBans++ ==
Plugin link: https://sbpp.github.io/ 
Unofficial more updated version of SourceBans. 
-SourceBans++ is a majorly improved version of SourceBans 1.4.11 which was developed by GameConnect. 
Those major improvements include a new design, more stable web application, login via steam account and much more community made customizations. 
== SourceBot ==
''Original Plugin link:'' https://forums.alliedmods.net/showthread.php?p=883997 

== TeamSwitch ==
Plugin link: https://forums.alliedmods.net/showthread.php?p=587405 
This is a fully mod-independent team switching plugin, which gives an admin the ability to switch players to the opposite team either immediately, 
when they die, or at the end of the round (where appropriate). 
Players can also be switched to spectators. 
TeamSwitch detects which mod it is being run on at startup and configures itself accordingly. 

== Ultimate Mapchooser 3.4.5 ==
Plugin link: https://forums.alliedmods.net/showthread.php?t=134190 
Ultimate Mapchooser allows for increased control over map selection. This includes: 
* Random selection of the next map. 
* Which maps are added to votes 
* Which maps are available for nominations 
You can control how the randomization works by dividing your map rotation into groups, and controlling the weights of each group or each individual map, 
specify a minimum or maximum number of players allowed on the server for the map to be available, specify how many maps from a group are allowed in a vote, etc. 
EDIT: It seems the original version isnt working even with Creepers event fix for end of map votes. 
Here is cyberkillers version: https://github.com/CyberKiller/Ultimate-Mapchooser 
But it might be a little outdated... 

== Execute Configs ==
''Original Plugin link:'' https://forums.alliedmods.net/showthread.php?t=67620 
This plugin executes configs when there are either a certain amount of clients on, a certain event occurs, a certain round starts or when there are a certain amount of minutes left on the map. 
You can use this to disable alltalk above x clients, or to change the map when the timelimit hits, etc. 
'''More updated version (1.2.4) + added empires roundstart/gamestart events:''' https://git.empiresmod.com/sourcemod/executeconfigs 

[[Category:Sourcemod]]

Sourcemod

2024-02-06T16:51:05Z

Neoony: Add info

Sourcemod allows you to extend Empires without having access to the C++ code.

== Installation ==
* Install MetaMod:
** Download for [https://www.sourcemm.net/downloads.php?branch=stable Metamod]
** Copy the Addons folder into your empires folder
* Download sourcemod: http://www.sourcemod.net/downloads.php?branch=stable
* Copy the cfg and addons folders to your empires folder
* Install some [[Sourcemod Plugins]]

Make sure to edit following file: .../empires/empires/addons/metamod.vdf 
Put the following in (overwrite what is already there): 
<pre>"Plugin"
{
"file" "empires/addons/metamod/bin/server"
}</pre>

Also just in case, remove any x64 files in metamod 
Windows: 
addons\metamod_x64.vdf 
addons\metamod\bin\win64 (delete whole folder) 
addons\sourcemod\bin\x64 (delete whole folder) 
addons\sourcemod\bin\sourcemod_mm.x64.dll 

Linux: 
addons\metamod_x64.vdf 
addons\metamod\bin\linux64 (delete whole folder) 
addons\metamod\bin\linuxsteamrt64 (delete whole folder) 
addons\sourcemod\bin\x64 (delete whole folder) 
addons\sourcemod\bin\sourcemod_mm.x64.so 
 
It was once causing some issue for someone. Empires does not support x64, so just delete any such files to avoid any issues. 

== Developing Plugins ==
Empires has a lot of [[Game_events_added | game events]] you can make use of. For an example of plugins you can make see our [https://git.empiresmod.com/sourcemod/ sourcemod repository].

== Compiling from Source ==
Thanks to people smarter than me, compiling from source is pretty easy. 
Take your source-file or source-text and pop it in this: http://www.sourcemod.net/compiler.php 
Download your compiled plugin, and put it in your sourcemod/plugins folder. 

Or you can use spcomp.exe inside your sourcemod folders (\addons\sourcemod\scripting\spcomp.exe) (for windows) 
Just drag and drop your source-file onto the .exe. 

== Sourcemod offsets and signatures ==
'''Get latest offsets ready to use here''' https://git.empiresmod.com/sourcemod/sourcemodoffsets 
 
If you have issues with invalid signatures. 
Example: 
<pre>L 03/18/2017 - 00:02:51: [SDKTOOLS] Invalid detour address passed - Disabling detour to prevent crashes
L 03/18/2017 - 00:02:51: [SM] Exception reported: Entity Outputs are disabled - See error logs for details</pre>

'''Choice 1.''' '''Just download latest ready to use offsets here:''' https://git.empiresmod.com/sourcemod/sourcemodoffsets 
'''Choice 2.''' Replace the linux signatures in sdkhooks and sdktools files with the mac signatures. (this is already included in the above release) 
This is rather temporary fix and needs testing 
Example: 
<pre>/* CBaseEntityOutput::FireOutput */
"#default"
{
"Signatures"
{
"FireOutput"
{
"library" "server"
"windows" "\x55\x8B\xEC\x81\x2A\x2A\x2A\x2A\x2A\xA1\x2A\x2A\x2A\x2A\x33\xC5\x89\x45\x2A\x8B\x45\x2A\x53\x56\x8B\x2A\x2A\x57\x8B\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\xC7"
"linux" "@_ZN17CBaseEntityOutput10FireOutputE9variant_tP11CBaseEntityS2_f"
"mac" "@_ZN17CBaseEntityOutput10FireOutputE9variant_tP11CBaseEntityS2_f"
}
}
}</pre>

== Dumping updated Sourcemod offsets and signatures ==
Related thread: https://forums.empiresmod.com/index.php?threads/calculating-updated-sourcemod-vtable-offsets.20571/ 
Tool needed: https://delftelectronics.nl/empires/tools/vtablescanner3.zip 
The tool requires linux. If you are running 64bit linux, you will probably need to run the following to be able to run 32bit apps: 
<pre>dpkg --add-architecture i386
apt-get update
apt install libc6:i386 libelf1:i386</pre>
Unpack the vtablescanner3.zip anywhere in your linux. 
Next you need a server.so file from your dedicated server which is located in /empires_dedicated/empires/bin 
Copy server.so to the Release folder in the vtablescanner folder that you extracted. (vtablescanner/Release/server.so) 

Now open your terminal inside the Release folder. 
And enter the following command:
<pre>LD_LIBRARY_PATH="./" ./vtabledump ./server.so '_ZTV10CEmpPlayer' >dump.txt</pre>
The outputted RAW offsets are now located in vtablescanner/Release/dump.txt 
 
Now if you want to output a proper file for SourceMod. 
Open the terminal again inside Release folder. 
Type: 
<pre>./createoffsetscript >dumpsmoffsets.txt</pre>
This output file is the game.empires.txt which you can put into your: 
\addons\sourcemod\gamedata\sdkhooks.games\custom\game.empires.txt 
\addons\sourcemod\gamedata\sdktools.games\custom\game.empires.txt 
 
'''Also check this for offsets that need adjusting after a dump: https://git.empiresmod.com/sourcemod/sourcemodoffsets/issues/1''' 

== Plugin-Making tips ==
Dumping:
To get a dump of entity properties specific to empires and similar things, use following commands. 
'''"sm_dump_teprops"''' - Dumps tempentity props to a file 
'''"sm_dump_netprops_xml"''' - Dumps the networkable property table as an XML file 
'''"sm_dump_netprops"''' - Dumps the networkable property table as a text file 
'''"sm_dump_classes"''' - Dumps the class list as a text file 
'''"sm_dump_datamaps"''' - Dumps the data map list as a text file 
'''"sm_dump_admcache"''' - Dumps the admin cache for debugging 
'''"sm_dump_handles"''' - Dumps Handle usage to a file for finding Handle leaks 

Just add a filename after the command and you will find the dump files in empires folder. 
Just using some of those commands might make your client/server hang or even crash, but it will probably still make the dump, or just retry. 
------
'''Colors for messages:''' 
Custom colors usable by PrintToChat and similar. 
''Examples:'' 
<pre>\x079764FF BE
\x07FF2323 NF

PrintToChatAll("\x04[PLUGIN]\x079764FF BE\x01 not ready");
PrintToChatAll("\x04[PLUGIN]\x01 Commander left\x07FF2323 NF");</pre>

'''\x07''' - ''Type of coloring/message (custom colors seem to only work with \x07 and \x08)'' 
'''9764FF''' - ''HTML '''RRGGBB''' color without the '''#''' (You can pick your own color for example here: https://www.w3schools.com/colors/colors_picker.asp)'' 

'''Neoony's color standards:''' (Updated 18.4.2017 - Added player name color 
<pre>\x01 for standard text
\x04 for plugin things (example: "\x04[NCEV]\x01") [green]
\x079764FF for Brenodi Empire team [eyedropped from chat text]
\x07FF2323 for Northern Faction team [eyedropped from chat text]
\x07CB4491 for Both teams [mixed color of BE and NF, somewhat pink]
\x07CCCCCC for Spectators [gray]
\x07ff6600 for player name, if you cant use team colors for that [orange]
\x073399ff for displaying time, mainly seconds [light blue]
\x07008000 for enabled, unlocked or simply positive [green]
\x07b30000 for disabled, locked or simply negative, also for warnings [red]</pre>

[[Category:Sourcemod]]

Sourcemod

2024-02-06T16:40:52Z

Neoony: I hate this wiki formatting

Sourcemod allows you to extend Empires without having access to the C++ code.

== Installation ==
* Install MetaMod:
** Download for [https://www.sourcemm.net/downloads.php?branch=stable Metamod]
** Copy the Addons folder into your empires folder
* Download sourcemod: http://www.sourcemod.net/downloads.php?branch=stable
* Copy the cfg and addons folders to your empires folder
* Install some [[Sourcemod Plugins]]

Make sure to edit following file: .../empires/empires/addons/metamod.vdf 
Put the following in: 
<pre>"Plugin"
{
"file" "empires/addons/metamod/bin/server"
}</pre>

Also just in case, remove any x64 files in metamod 
Windows: 
addons\metamod_x64.vdf 
addons\metamod\bin\win64 (delete whole folder) 
addons\sourcemod\bin\x64 (delete whole folder) 
addons\sourcemod\bin\sourcemod_mm.x64.dll 

Linux: 
addons\metamod_x64.vdf 
addons\metamod\bin\linux64 (delete whole folder) 
addons\metamod\bin\linuxsteamrt64 (delete whole folder) 
addons\sourcemod\bin\x64 (delete whole folder) 
addons\sourcemod\bin\sourcemod_mm.x64.so 
 
It was once causing some issue for someone. Empires does not support x64, so just delete any such files to avoid any issues. 

== Developing Plugins ==
Empires has a lot of [[Game_events_added | game events]] you can make use of. For an example of plugins you can make see our [https://git.empiresmod.com/sourcemod/ sourcemod repository].

== Compiling from Source ==
Thanks to people smarter than me, compiling from source is pretty easy. 
Take your source-file or source-text and pop it in this: http://www.sourcemod.net/compiler.php 
Download your compiled plugin, and put it in your sourcemod/plugins folder. 

Or you can use spcomp.exe inside your sourcemod folders (\addons\sourcemod\scripting\spcomp.exe) (for windows) 
Just drag and drop your source-file onto the .exe. 

== Sourcemod offsets and signatures ==
'''Get latest offsets ready to use here''' https://git.empiresmod.com/sourcemod/sourcemodoffsets 
 
If you have issues with invalid signatures. 
Example: 
<pre>L 03/18/2017 - 00:02:51: [SDKTOOLS] Invalid detour address passed - Disabling detour to prevent crashes
L 03/18/2017 - 00:02:51: [SM] Exception reported: Entity Outputs are disabled - See error logs for details</pre>

'''Choice 1.''' '''Just download latest ready to use offsets here:''' https://git.empiresmod.com/sourcemod/sourcemodoffsets 
'''Choice 2.''' Replace the linux signatures in sdkhooks and sdktools files with the mac signatures. (this is already included in the above release) 
This is rather temporary fix and needs testing 
Example: 
<pre>/* CBaseEntityOutput::FireOutput */
"#default"
{
"Signatures"
{
"FireOutput"
{
"library" "server"
"windows" "\x55\x8B\xEC\x81\x2A\x2A\x2A\x2A\x2A\xA1\x2A\x2A\x2A\x2A\x33\xC5\x89\x45\x2A\x8B\x45\x2A\x53\x56\x8B\x2A\x2A\x57\x8B\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\xC7"
"linux" "@_ZN17CBaseEntityOutput10FireOutputE9variant_tP11CBaseEntityS2_f"
"mac" "@_ZN17CBaseEntityOutput10FireOutputE9variant_tP11CBaseEntityS2_f"
}
}
}</pre>

== Dumping updated Sourcemod offsets and signatures ==
Related thread: https://forums.empiresmod.com/index.php?threads/calculating-updated-sourcemod-vtable-offsets.20571/ 
Tool needed: https://delftelectronics.nl/empires/tools/vtablescanner3.zip 
The tool requires linux. If you are running 64bit linux, you will probably need to run the following to be able to run 32bit apps: 
<pre>dpkg --add-architecture i386
apt-get update
apt install libc6:i386 libelf1:i386</pre>
Unpack the vtablescanner3.zip anywhere in your linux. 
Next you need a server.so file from your dedicated server which is located in /empires_dedicated/empires/bin 
Copy server.so to the Release folder in the vtablescanner folder that you extracted. (vtablescanner/Release/server.so) 

Now open your terminal inside the Release folder. 
And enter the following command:
<pre>LD_LIBRARY_PATH="./" ./vtabledump ./server.so '_ZTV10CEmpPlayer' >dump.txt</pre>
The outputted RAW offsets are now located in vtablescanner/Release/dump.txt 
 
Now if you want to output a proper file for SourceMod. 
Open the terminal again inside Release folder. 
Type: 
<pre>./createoffsetscript >dumpsmoffsets.txt</pre>
This output file is the game.empires.txt which you can put into your: 
\addons\sourcemod\gamedata\sdkhooks.games\custom\game.empires.txt 
\addons\sourcemod\gamedata\sdktools.games\custom\game.empires.txt 
 
'''Also check this for offsets that need adjusting after a dump: https://git.empiresmod.com/sourcemod/sourcemodoffsets/issues/1''' 

== Plugin-Making tips ==
Dumping:
To get a dump of entity properties specific to empires and similar things, use following commands. 
'''"sm_dump_teprops"''' - Dumps tempentity props to a file 
'''"sm_dump_netprops_xml"''' - Dumps the networkable property table as an XML file 
'''"sm_dump_netprops"''' - Dumps the networkable property table as a text file 
'''"sm_dump_classes"''' - Dumps the class list as a text file 
'''"sm_dump_datamaps"''' - Dumps the data map list as a text file 
'''"sm_dump_admcache"''' - Dumps the admin cache for debugging 
'''"sm_dump_handles"''' - Dumps Handle usage to a file for finding Handle leaks 

Just add a filename after the command and you will find the dump files in empires folder. 
Just using some of those commands might make your client/server hang or even crash, but it will probably still make the dump, or just retry. 
------
'''Colors for messages:''' 
Custom colors usable by PrintToChat and similar. 
''Examples:'' 
<pre>\x079764FF BE
\x07FF2323 NF

PrintToChatAll("\x04[PLUGIN]\x079764FF BE\x01 not ready");
PrintToChatAll("\x04[PLUGIN]\x01 Commander left\x07FF2323 NF");</pre>

'''\x07''' - ''Type of coloring/message (custom colors seem to only work with \x07 and \x08)'' 
'''9764FF''' - ''HTML '''RRGGBB''' color without the '''#''' (You can pick your own color for example here: https://www.w3schools.com/colors/colors_picker.asp)'' 

'''Neoony's color standards:''' (Updated 18.4.2017 - Added player name color 
<pre>\x01 for standard text
\x04 for plugin things (example: "\x04[NCEV]\x01") [green]
\x079764FF for Brenodi Empire team [eyedropped from chat text]
\x07FF2323 for Northern Faction team [eyedropped from chat text]
\x07CB4491 for Both teams [mixed color of BE and NF, somewhat pink]
\x07CCCCCC for Spectators [gray]
\x07ff6600 for player name, if you cant use team colors for that [orange]
\x073399ff for displaying time, mainly seconds [light blue]
\x07008000 for enabled, unlocked or simply positive [green]
\x07b30000 for disabled, locked or simply negative, also for warnings [red]</pre>

[[Category:Sourcemod]]

Sourcemod

2024-02-06T16:40:19Z

Neoony: Fix

Sourcemod allows you to extend Empires without having access to the C++ code.

== Installation ==
* Install MetaMod:
** Download for [https://www.sourcemm.net/downloads.php?branch=stable Metamod]
** Copy the Addons folder into your empires folder
* Download sourcemod: http://www.sourcemod.net/downloads.php?branch=stable
* Copy the cfg and addons folders to your empires folder
* Install some [[Sourcemod Plugins]]

Make sure to edit following file: .../empires/empires/addons/metamod.vdf 
Put the following in: 
<pre>"Plugin"
{
"file" "empires/addons/metamod/bin/server"
}</pre>

Also just in case, remove any x64 files in metamod 
Windows:
addons\metamod_x64.vdf 
addons\metamod\bin\win64 (delete whole folder) 
addons\sourcemod\bin\x64 (delete whole folder) 
addons\sourcemod\bin\sourcemod_mm.x64.dll 

Linux:
addons\metamod_x64.vdf 
addons\metamod\bin\linux64 (delete whole folder) 
addons\metamod\bin\linuxsteamrt64 (delete whole folder) 
addons\sourcemod\bin\x64 (delete whole folder) 
addons\sourcemod\bin\sourcemod_mm.x64.so 
 
It was once causing some issue for someone. Empires does not support x64, so just delete any such files to avoid any issues. 

== Developing Plugins ==
Empires has a lot of [[Game_events_added | game events]] you can make use of. For an example of plugins you can make see our [https://git.empiresmod.com/sourcemod/ sourcemod repository].

== Compiling from Source ==
Thanks to people smarter than me, compiling from source is pretty easy. 
Take your source-file or source-text and pop it in this: http://www.sourcemod.net/compiler.php 
Download your compiled plugin, and put it in your sourcemod/plugins folder. 

Or you can use spcomp.exe inside your sourcemod folders (\addons\sourcemod\scripting\spcomp.exe) (for windows) 
Just drag and drop your source-file onto the .exe. 

== Sourcemod offsets and signatures ==
'''Get latest offsets ready to use here''' https://git.empiresmod.com/sourcemod/sourcemodoffsets 
 
If you have issues with invalid signatures. 
Example: 
<pre>L 03/18/2017 - 00:02:51: [SDKTOOLS] Invalid detour address passed - Disabling detour to prevent crashes
L 03/18/2017 - 00:02:51: [SM] Exception reported: Entity Outputs are disabled - See error logs for details</pre>

'''Choice 1.''' '''Just download latest ready to use offsets here:''' https://git.empiresmod.com/sourcemod/sourcemodoffsets 
'''Choice 2.''' Replace the linux signatures in sdkhooks and sdktools files with the mac signatures. (this is already included in the above release) 
This is rather temporary fix and needs testing 
Example: 
<pre>/* CBaseEntityOutput::FireOutput */
"#default"
{
"Signatures"
{
"FireOutput"
{
"library" "server"
"windows" "\x55\x8B\xEC\x81\x2A\x2A\x2A\x2A\x2A\xA1\x2A\x2A\x2A\x2A\x33\xC5\x89\x45\x2A\x8B\x45\x2A\x53\x56\x8B\x2A\x2A\x57\x8B\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\xC7"
"linux" "@_ZN17CBaseEntityOutput10FireOutputE9variant_tP11CBaseEntityS2_f"
"mac" "@_ZN17CBaseEntityOutput10FireOutputE9variant_tP11CBaseEntityS2_f"
}
}
}</pre>

== Dumping updated Sourcemod offsets and signatures ==
Related thread: https://forums.empiresmod.com/index.php?threads/calculating-updated-sourcemod-vtable-offsets.20571/ 
Tool needed: https://delftelectronics.nl/empires/tools/vtablescanner3.zip 
The tool requires linux. If you are running 64bit linux, you will probably need to run the following to be able to run 32bit apps: 
<pre>dpkg --add-architecture i386
apt-get update
apt install libc6:i386 libelf1:i386</pre>
Unpack the vtablescanner3.zip anywhere in your linux. 
Next you need a server.so file from your dedicated server which is located in /empires_dedicated/empires/bin 
Copy server.so to the Release folder in the vtablescanner folder that you extracted. (vtablescanner/Release/server.so) 

Now open your terminal inside the Release folder. 
And enter the following command:
<pre>LD_LIBRARY_PATH="./" ./vtabledump ./server.so '_ZTV10CEmpPlayer' >dump.txt</pre>
The outputted RAW offsets are now located in vtablescanner/Release/dump.txt 
 
Now if you want to output a proper file for SourceMod. 
Open the terminal again inside Release folder. 
Type: 
<pre>./createoffsetscript >dumpsmoffsets.txt</pre>
This output file is the game.empires.txt which you can put into your: 
\addons\sourcemod\gamedata\sdkhooks.games\custom\game.empires.txt 
\addons\sourcemod\gamedata\sdktools.games\custom\game.empires.txt 
 
'''Also check this for offsets that need adjusting after a dump: https://git.empiresmod.com/sourcemod/sourcemodoffsets/issues/1''' 

== Plugin-Making tips ==
Dumping:
To get a dump of entity properties specific to empires and similar things, use following commands. 
'''"sm_dump_teprops"''' - Dumps tempentity props to a file 
'''"sm_dump_netprops_xml"''' - Dumps the networkable property table as an XML file 
'''"sm_dump_netprops"''' - Dumps the networkable property table as a text file 
'''"sm_dump_classes"''' - Dumps the class list as a text file 
'''"sm_dump_datamaps"''' - Dumps the data map list as a text file 
'''"sm_dump_admcache"''' - Dumps the admin cache for debugging 
'''"sm_dump_handles"''' - Dumps Handle usage to a file for finding Handle leaks 

Just add a filename after the command and you will find the dump files in empires folder. 
Just using some of those commands might make your client/server hang or even crash, but it will probably still make the dump, or just retry. 
------
'''Colors for messages:''' 
Custom colors usable by PrintToChat and similar. 
''Examples:'' 
<pre>\x079764FF BE
\x07FF2323 NF

PrintToChatAll("\x04[PLUGIN]\x079764FF BE\x01 not ready");
PrintToChatAll("\x04[PLUGIN]\x01 Commander left\x07FF2323 NF");</pre>

'''\x07''' - ''Type of coloring/message (custom colors seem to only work with \x07 and \x08)'' 
'''9764FF''' - ''HTML '''RRGGBB''' color without the '''#''' (You can pick your own color for example here: https://www.w3schools.com/colors/colors_picker.asp)'' 

'''Neoony's color standards:''' (Updated 18.4.2017 - Added player name color 
<pre>\x01 for standard text
\x04 for plugin things (example: "\x04[NCEV]\x01") [green]
\x079764FF for Brenodi Empire team [eyedropped from chat text]
\x07FF2323 for Northern Faction team [eyedropped from chat text]
\x07CB4491 for Both teams [mixed color of BE and NF, somewhat pink]
\x07CCCCCC for Spectators [gray]
\x07ff6600 for player name, if you cant use team colors for that [orange]
\x073399ff for displaying time, mainly seconds [light blue]
\x07008000 for enabled, unlocked or simply positive [green]
\x07b30000 for disabled, locked or simply negative, also for warnings [red]</pre>

[[Category:Sourcemod]]

Sourcemod

2024-02-06T16:31:58Z

Neoony: Fix

Sourcemod allows you to extend Empires without having access to the C++ code.

== Installation ==
* Install MetaMod:
** Download for [https://www.sourcemm.net/downloads.php?branch=stable Metamod]
** Copy the Addons folder into your empires folder
* Download sourcemod: http://www.sourcemod.net/downloads.php?branch=stable
* Copy the cfg and addons folders to your empires folder
* Install some [[Sourcemod Plugins]]

Make sure to edit following file: .../empires/empires/addons/metamod.vdf 
Put the following in: 
<pre>"Plugin"
{
"file" "empires/addons/metamod/bin/server"
}</pre>

Also just in case, remove any x64 files in metamod 
addons\metamod_x64.vdf 
addons\metamod\bin\win64 (delete whole folder) 
addons\sourcemod\bin\x64
addons\sourcemod\bin\sourcemod_mm.x64.dll
 
It was once causing some issue for someone. Empires does not support x64, so just delete any such files to avoid any issues. 

== Developing Plugins ==
Empires has a lot of [[Game_events_added | game events]] you can make use of. For an example of plugins you can make see our [https://git.empiresmod.com/sourcemod/ sourcemod repository].

== Compiling from Source ==
Thanks to people smarter than me, compiling from source is pretty easy. 
Take your source-file or source-text and pop it in this: http://www.sourcemod.net/compiler.php 
Download your compiled plugin, and put it in your sourcemod/plugins folder. 

Or you can use spcomp.exe inside your sourcemod folders (\addons\sourcemod\scripting\spcomp.exe) (for windows) 
Just drag and drop your source-file onto the .exe. 

== Sourcemod offsets and signatures ==
'''Get latest offsets ready to use here''' https://git.empiresmod.com/sourcemod/sourcemodoffsets 
 
If you have issues with invalid signatures. 
Example: 
<pre>L 03/18/2017 - 00:02:51: [SDKTOOLS] Invalid detour address passed - Disabling detour to prevent crashes
L 03/18/2017 - 00:02:51: [SM] Exception reported: Entity Outputs are disabled - See error logs for details</pre>

'''Choice 1.''' '''Just download latest ready to use offsets here:''' https://git.empiresmod.com/sourcemod/sourcemodoffsets 
'''Choice 2.''' Replace the linux signatures in sdkhooks and sdktools files with the mac signatures. (this is already included in the above release) 
This is rather temporary fix and needs testing 
Example: 
<pre>/* CBaseEntityOutput::FireOutput */
"#default"
{
"Signatures"
{
"FireOutput"
{
"library" "server"
"windows" "\x55\x8B\xEC\x81\x2A\x2A\x2A\x2A\x2A\xA1\x2A\x2A\x2A\x2A\x33\xC5\x89\x45\x2A\x8B\x45\x2A\x53\x56\x8B\x2A\x2A\x57\x8B\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\xC7"
"linux" "@_ZN17CBaseEntityOutput10FireOutputE9variant_tP11CBaseEntityS2_f"
"mac" "@_ZN17CBaseEntityOutput10FireOutputE9variant_tP11CBaseEntityS2_f"
}
}
}</pre>

== Dumping updated Sourcemod offsets and signatures ==
Related thread: https://forums.empiresmod.com/index.php?threads/calculating-updated-sourcemod-vtable-offsets.20571/ 
Tool needed: https://delftelectronics.nl/empires/tools/vtablescanner3.zip 
The tool requires linux. If you are running 64bit linux, you will probably need to run the following to be able to run 32bit apps: 
<pre>dpkg --add-architecture i386
apt-get update
apt install libc6:i386 libelf1:i386</pre>
Unpack the vtablescanner3.zip anywhere in your linux. 
Next you need a server.so file from your dedicated server which is located in /empires_dedicated/empires/bin 
Copy server.so to the Release folder in the vtablescanner folder that you extracted. (vtablescanner/Release/server.so) 

Now open your terminal inside the Release folder. 
And enter the following command:
<pre>LD_LIBRARY_PATH="./" ./vtabledump ./server.so '_ZTV10CEmpPlayer' >dump.txt</pre>
The outputted RAW offsets are now located in vtablescanner/Release/dump.txt 
 
Now if you want to output a proper file for SourceMod. 
Open the terminal again inside Release folder. 
Type: 
<pre>./createoffsetscript >dumpsmoffsets.txt</pre>
This output file is the game.empires.txt which you can put into your: 
\addons\sourcemod\gamedata\sdkhooks.games\custom\game.empires.txt 
\addons\sourcemod\gamedata\sdktools.games\custom\game.empires.txt 
 
'''Also check this for offsets that need adjusting after a dump: https://git.empiresmod.com/sourcemod/sourcemodoffsets/issues/1''' 

== Plugin-Making tips ==
Dumping:
To get a dump of entity properties specific to empires and similar things, use following commands. 
'''"sm_dump_teprops"''' - Dumps tempentity props to a file 
'''"sm_dump_netprops_xml"''' - Dumps the networkable property table as an XML file 
'''"sm_dump_netprops"''' - Dumps the networkable property table as a text file 
'''"sm_dump_classes"''' - Dumps the class list as a text file 
'''"sm_dump_datamaps"''' - Dumps the data map list as a text file 
'''"sm_dump_admcache"''' - Dumps the admin cache for debugging 
'''"sm_dump_handles"''' - Dumps Handle usage to a file for finding Handle leaks 

Just add a filename after the command and you will find the dump files in empires folder. 
Just using some of those commands might make your client/server hang or even crash, but it will probably still make the dump, or just retry. 
------
'''Colors for messages:''' 
Custom colors usable by PrintToChat and similar. 
''Examples:'' 
<pre>\x079764FF BE
\x07FF2323 NF

PrintToChatAll("\x04[PLUGIN]\x079764FF BE\x01 not ready");
PrintToChatAll("\x04[PLUGIN]\x01 Commander left\x07FF2323 NF");</pre>

'''\x07''' - ''Type of coloring/message (custom colors seem to only work with \x07 and \x08)'' 
'''9764FF''' - ''HTML '''RRGGBB''' color without the '''#''' (You can pick your own color for example here: https://www.w3schools.com/colors/colors_picker.asp)'' 

'''Neoony's color standards:''' (Updated 18.4.2017 - Added player name color 
<pre>\x01 for standard text
\x04 for plugin things (example: "\x04[NCEV]\x01") [green]
\x079764FF for Brenodi Empire team [eyedropped from chat text]
\x07FF2323 for Northern Faction team [eyedropped from chat text]
\x07CB4491 for Both teams [mixed color of BE and NF, somewhat pink]
\x07CCCCCC for Spectators [gray]
\x07ff6600 for player name, if you cant use team colors for that [orange]
\x073399ff for displaying time, mainly seconds [light blue]
\x07008000 for enabled, unlocked or simply positive [green]
\x07b30000 for disabled, locked or simply negative, also for warnings [red]</pre>

[[Category:Sourcemod]]

Sourcemod

2024-02-06T16:28:01Z

Neoony: Edit the MM and SM installation steps

Sourcemod allows you to extend Empires without having access to the C++ code.

== Installation ==
* Install MetaMod:
** Download for [https://www.sourcemm.net/downloads.php?branch=stable Metamod]
** Copy the Addons folder into your empires folder
* Download sourcemod: http://www.sourcemod.net/downloads.php?branch=stable
* Copy the cfg and addons folders to your empires folder
* Install some [[Sourcemod Plugins]]

Make sure to edit following file: .../empires/empires/addons/metamod.vdf 
Put the following in: 
<pre>"Plugin"
{
"file" "empires/addons/metamod/bin/server"
}</pre>

Also just in case, remove any x64 files in metamod 
addons\metamod_x64.vdf 
addons\metamod\bin\win64 (delete whole folder) 
 
It was once causing some issue for someone 

== Developing Plugins ==
Empires has a lot of [[Game_events_added | game events]] you can make use of. For an example of plugins you can make see our [https://git.empiresmod.com/sourcemod/ sourcemod repository].

== Compiling from Source ==
Thanks to people smarter than me, compiling from source is pretty easy. 
Take your source-file or source-text and pop it in this: http://www.sourcemod.net/compiler.php 
Download your compiled plugin, and put it in your sourcemod/plugins folder. 

Or you can use spcomp.exe inside your sourcemod folders (\addons\sourcemod\scripting\spcomp.exe) (for windows) 
Just drag and drop your source-file onto the .exe. 

== Sourcemod offsets and signatures ==
'''Get latest offsets ready to use here''' https://git.empiresmod.com/sourcemod/sourcemodoffsets 
 
If you have issues with invalid signatures. 
Example: 
<pre>L 03/18/2017 - 00:02:51: [SDKTOOLS] Invalid detour address passed - Disabling detour to prevent crashes
L 03/18/2017 - 00:02:51: [SM] Exception reported: Entity Outputs are disabled - See error logs for details</pre>

'''Choice 1.''' '''Just download latest ready to use offsets here:''' https://git.empiresmod.com/sourcemod/sourcemodoffsets 
'''Choice 2.''' Replace the linux signatures in sdkhooks and sdktools files with the mac signatures. (this is already included in the above release) 
This is rather temporary fix and needs testing 
Example: 
<pre>/* CBaseEntityOutput::FireOutput */
"#default"
{
"Signatures"
{
"FireOutput"
{
"library" "server"
"windows" "\x55\x8B\xEC\x81\x2A\x2A\x2A\x2A\x2A\xA1\x2A\x2A\x2A\x2A\x33\xC5\x89\x45\x2A\x8B\x45\x2A\x53\x56\x8B\x2A\x2A\x57\x8B\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\xC7"
"linux" "@_ZN17CBaseEntityOutput10FireOutputE9variant_tP11CBaseEntityS2_f"
"mac" "@_ZN17CBaseEntityOutput10FireOutputE9variant_tP11CBaseEntityS2_f"
}
}
}</pre>

== Dumping updated Sourcemod offsets and signatures ==
Related thread: https://forums.empiresmod.com/index.php?threads/calculating-updated-sourcemod-vtable-offsets.20571/ 
Tool needed: https://delftelectronics.nl/empires/tools/vtablescanner3.zip 
The tool requires linux. If you are running 64bit linux, you will probably need to run the following to be able to run 32bit apps: 
<pre>dpkg --add-architecture i386
apt-get update
apt install libc6:i386 libelf1:i386</pre>
Unpack the vtablescanner3.zip anywhere in your linux. 
Next you need a server.so file from your dedicated server which is located in /empires_dedicated/empires/bin 
Copy server.so to the Release folder in the vtablescanner folder that you extracted. (vtablescanner/Release/server.so) 

Now open your terminal inside the Release folder. 
And enter the following command:
<pre>LD_LIBRARY_PATH="./" ./vtabledump ./server.so '_ZTV10CEmpPlayer' >dump.txt</pre>
The outputted RAW offsets are now located in vtablescanner/Release/dump.txt 
 
Now if you want to output a proper file for SourceMod. 
Open the terminal again inside Release folder. 
Type: 
<pre>./createoffsetscript >dumpsmoffsets.txt</pre>
This output file is the game.empires.txt which you can put into your: 
\addons\sourcemod\gamedata\sdkhooks.games\custom\game.empires.txt 
\addons\sourcemod\gamedata\sdktools.games\custom\game.empires.txt 
 
'''Also check this for offsets that need adjusting after a dump: https://git.empiresmod.com/sourcemod/sourcemodoffsets/issues/1''' 

== Plugin-Making tips ==
Dumping:
To get a dump of entity properties specific to empires and similar things, use following commands. 
'''"sm_dump_teprops"''' - Dumps tempentity props to a file 
'''"sm_dump_netprops_xml"''' - Dumps the networkable property table as an XML file 
'''"sm_dump_netprops"''' - Dumps the networkable property table as a text file 
'''"sm_dump_classes"''' - Dumps the class list as a text file 
'''"sm_dump_datamaps"''' - Dumps the data map list as a text file 
'''"sm_dump_admcache"''' - Dumps the admin cache for debugging 
'''"sm_dump_handles"''' - Dumps Handle usage to a file for finding Handle leaks 

Just add a filename after the command and you will find the dump files in empires folder. 
Just using some of those commands might make your client/server hang or even crash, but it will probably still make the dump, or just retry. 
------
'''Colors for messages:''' 
Custom colors usable by PrintToChat and similar. 
''Examples:'' 
<pre>\x079764FF BE
\x07FF2323 NF

PrintToChatAll("\x04[PLUGIN]\x079764FF BE\x01 not ready");
PrintToChatAll("\x04[PLUGIN]\x01 Commander left\x07FF2323 NF");</pre>

'''\x07''' - ''Type of coloring/message (custom colors seem to only work with \x07 and \x08)'' 
'''9764FF''' - ''HTML '''RRGGBB''' color without the '''#''' (You can pick your own color for example here: https://www.w3schools.com/colors/colors_picker.asp)'' 

'''Neoony's color standards:''' (Updated 18.4.2017 - Added player name color 
<pre>\x01 for standard text
\x04 for plugin things (example: "\x04[NCEV]\x01") [green]
\x079764FF for Brenodi Empire team [eyedropped from chat text]
\x07FF2323 for Northern Faction team [eyedropped from chat text]
\x07CB4491 for Both teams [mixed color of BE and NF, somewhat pink]
\x07CCCCCC for Spectators [gray]
\x07ff6600 for player name, if you cant use team colors for that [orange]
\x073399ff for displaying time, mainly seconds [light blue]
\x07008000 for enabled, unlocked or simply positive [green]
\x07b30000 for disabled, locked or simply negative, also for warnings [red]</pre>

[[Category:Sourcemod]]

Sourcemod Plugins

2024-02-06T16:20:37Z

Neoony: Add clearer link to installation guide for SM/MM

{{ServerResources}}
=Sourcemod installation=
Check the following page for guide how to install Metamod and Sourcemod: [[Sourcemod]]
=Empires Specific Plugins=
Empires has a few specific plugins coded by members of its community, you can find them on [https://git.empiresmod.com/sourcemod Empires' Gitlab].
==Draftpick==
[[Draftpick]] is a [[Sourcemod]] plugin by [[Mikleo]], it is responsible for automatically balancing the players between teams using statistics gathered by [[Empstats]]. It includes four types of Draft.
==Empfun==
[[Empfun]] is a [[Sourcemod]] plugin by [[Mikleo]], it adds a way to manipulate entities within the game and create custom scenarios.
==Empstats==
[[Empstats]] is a [[Sourcemod]] plugin by [[Mikleo]], it tracks various statistics.
==Emputils==
[[Emputils]] is a [[Sourcemod]] plugin by [[Mikleo]], it contains various utilities to be used by other plugins.
==EventTimeleftHostname==
[[EventTimeleftHostname]] is a [[Sourcemod]] plugin by <> and updated for Empires by [[Neoony]], it allows server owners to display a countdown in their server's title.
==Lawlietstats==
[[Lawlietstats]] is a [[Sourcemod]] plugin by [[Lawliet]], it collects various informations.
==Lobby==
[[Lobby]] is a [[Sourcemod]] plugin by [[Neoony]], it controls the Lobby Server.
==NoCommExtendVote==
'''No Commander Extend Vote''' or [[NCEV]] for short is a [[Sourcemod]] plugin by [[Neoony]], it automatically detects commanders and only allows the game to start if both teams have a commander. 
==PugPlugin==
==ResearchInfo==
[[ResearchInfo]] is a [[Sourcemod]] plugin by [[Neoony]], gives a chat command to show what your team has researched in console. Unstable and unfinished. WIP
==sameIPBlock==
[[sameIPBlock]] is a [[Sourcemod]] plugin by [[Neoony]], only allows players to join from unique IP address.
==SourcemodOffsets==
[[SourcemodOffsets]] is a [[Sourcemod]] plugin by [[Neoony]], it automatically updates the sourcemod offsets required for Empires when they change.
==SquadControl==
[[Squadcontrol]] is a [[Sourcemod]] plugin by [[Mikleo]], it adds various utilities for Empires.
==Surrender==
[[Surrender]] is a [[SourceMod]] plugin by [[Neoony]], it allows players to trigger a vote to surrender which if successful destroys their [[Command Vehicle]]. 
==Updater==
[[Updater]] is a [[Sourcemod]] plugin by <> and updated for Empires by [[Neoony]], it allows servers to automatically update their plugins.
==Ungrief==
[[Ungrief]] is a [[Sourcemod]] plugin by [[Theowningone]] and updated by [[Neoony]], it allows admins to teleport the [[Command Vehicle]].
==Votetime==
[[Votetime]] is a [[Sourcemod]] plugin by [[Mikleo]], it adds commands to control the commander vote timer.
==vprofReport==
[[vprofReport]] is a [[Sourcemod]] plugin by [[Neoony]], automatically start "vprof" at certain number of clients on the server and then generates report when the round ends.
=Generic Plugins=
== End of Round AllTalk ==
Original Plugin: https://forums.alliedmods.net/showthread.php?p=1246351
== Chat Triggers ==
Plugin link: https://forums.alliedmods.net/showthread.php?p=585758 

== Advertisements 2.0 ==
Plugin link: https://forums.alliedmods.net/showthread.php?t=155705 
Simple advertisements plugin. It supports center, chat, hint, menu and top messages.
== SourceBans++ ==
Plugin link: https://sbpp.github.io/ 
Unofficial more updated version of SourceBans. 
-SourceBans++ is a majorly improved version of SourceBans 1.4.11 which was developed by GameConnect. 
Those major improvements include a new design, more stable web application, login via steam account and much more community made customizations. 
== SourceBot ==
''Original Plugin link:'' https://forums.alliedmods.net/showthread.php?p=883997 

== TeamSwitch ==
Plugin link: https://forums.alliedmods.net/showthread.php?p=587405 
This is a fully mod-independent team switching plugin, which gives an admin the ability to switch players to the opposite team either immediately, 
when they die, or at the end of the round (where appropriate). 
Players can also be switched to spectators. 
TeamSwitch detects which mod it is being run on at startup and configures itself accordingly. 

== Ultimate Mapchooser 3.4.5 ==
Plugin link: https://forums.alliedmods.net/showthread.php?t=134190 
Ultimate Mapchooser allows for increased control over map selection. This includes: 
* Random selection of the next map. 
* Which maps are added to votes 
* Which maps are available for nominations 
You can control how the randomization works by dividing your map rotation into groups, and controlling the weights of each group or each individual map, 
specify a minimum or maximum number of players allowed on the server for the map to be available, specify how many maps from a group are allowed in a vote, etc. 
EDIT: It seems the original version isnt working even with Creepers event fix for end of map votes. 
Here is cyberkillers version: https://github.com/CyberKiller/Ultimate-Mapchooser 
But it might be a little outdated... 

== Execute Configs ==
''Original Plugin link:'' https://forums.alliedmods.net/showthread.php?t=67620 
This plugin executes configs when there are either a certain amount of clients on, a certain event occurs, a certain round starts or when there are a certain amount of minutes left on the map. 
You can use this to disable alltalk above x clients, or to change the map when the timelimit hits, etc. 
'''More updated version (1.2.4) + added empires roundstart/gamestart events:''' https://git.empiresmod.com/sourcemod/executeconfigs 

[[Category:Sourcemod]]

Dedicated Server Setup

2024-02-03T19:54:54Z

Neoony: additional info

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map emp_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27005
* TCP and UDP 27015

=== Dedicated Server - APT ===
This method will install the server as a service, with tmux. (with tmux you run the server in a separate terminal window, so you can switch between the dedicated server and linux environment) 

Video tutorial: https://www.youtube.com/watch?v=RVvJTphiG24 

Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 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
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 the following 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) 

You can also start or stop the empires-server service
service empires-server stop
service empires-server start

Typing quit in server console will automatically restart the server. 
When server crashes it will restart automatically. (unless it freezes) 

Server folder is located in '''/var/lib/empires'''

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/bin/empires-server'''
== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Dedicated Server Setup

2024-02-03T19:48:49Z

Neoony: fix formatting

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map emp_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27005
* TCP and UDP 27015

=== Dedicated Server - APT ===
This method will install the server as a service, with tmux. (with tmux you run the server in a separate terminal window, so you can switch between the dedicated server and linux environment) 

Video tutorial: https://www.youtube.com/watch?v=RVvJTphiG24 

Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 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
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 the following 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) 

You can also start or stop the empires-server service
service empires-server stop
service empires-server start

Server folder is located in '''/var/lib/empires'''

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/bin/empires-server'''
== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Dedicated Server Setup

2024-02-03T19:47:56Z

Neoony: fix path

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map emp_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27005
* TCP and UDP 27015

=== Dedicated Server - APT ===
This method will install the server as a service, with tmux. (with tmux you run the server in a separate terminal window, so you can switch between the dedicated server and linux environment) 

Video tutorial: https://www.youtube.com/watch?v=RVvJTphiG24 

Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 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
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 the following 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

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/bin/empires-server'''

You can also start or stop the empires-server service
service empires-server stop
service empires-server start
== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Dedicated Server Setup

2024-02-03T18:38:56Z

Neoony: remove fixme

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map emp_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27005
* TCP and UDP 27015

=== Dedicated Server - APT ===
This method will install the server as a service, with tmux. (with tmux you run the server in a separate terminal window, so you can switch between the dedicated server and linux environment) 

Video tutorial: https://www.youtube.com/watch?v=RVvJTphiG24 

Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 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
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 the following 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

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/lib/systemd/system/empires-server.service'''

You can also start or stop the empires-server service
service empires-server stop
service empires-server start
== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Dedicated Server Setup

2024-02-03T18:14:38Z

Neoony: Add video and APT explanation

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map emp_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27005
* TCP and UDP 27015

=== Dedicated Server - APT ===
{{Fixme|Now tested and working good}}

This method will install the server as a service, with tmux. (with tmux you run the server in a separate terminal window, so you can switch between the dedicated server and linux environment) 

Video tutorial: https://www.youtube.com/watch?v=RVvJTphiG24 

Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 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
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 the following 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

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/lib/systemd/system/empires-server.service'''

You can also start or stop the empires-server service
service empires-server stop
service empires-server start
== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Dedicated Server Setup

2024-02-03T17:47:25Z

Neoony: /* Dedicated Server - APT */ now tested

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map emp_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27005
* TCP and UDP 27015

=== Dedicated Server - APT ===
{{Fixme|Now tested and working good}}
Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 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
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 the following 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

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/lib/systemd/system/empires-server.service'''

You can also start or stop the empires-server service
service empires-server stop
service empires-server start
== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Dedicated Server Setup

2024-02-03T17:45:05Z

Neoony: APT explanation

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map emp_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27005
* TCP and UDP 27015

=== Dedicated Server - APT ===
{{Fixme}}
This method will install the server as a service, with tmux. (with tmux you run the server in a separate terminal window, so you can switch between the dedicated server and linux environment)

Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 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 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
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 the following 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

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/lib/systemd/system/empires-server.service'''

You can also start or stop the empires-server service
service empires-server stop
service empires-server start
== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Dedicated Server Setup

2024-02-03T17:43:16Z

Neoony: APT dedi set up changes

{{ServerResources}}

Dedicated servers are like the listen servers (which can be created by pressing the "create server" button on the main menu), but they don't require a copy of the game to be running. This is less resource intensive as the server doesn't need to spend any time rendering graphics.

== Installation ==
There are two supported ways of installing a dedicated server. On Windows and Linux, you can install the server using the SteamCMD utility. On Debian-based distributions of linux, you can also install the server through APT, this will set it up as a service and with tmux.

=== Dedicated Server - SteamCMD ===

The Empires Dedicated Server can be installed using the [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD] utility. The server has an appid of 460040, and must be downloaded while logged in as an anonymous user.

To install the server on Windows:
*[https://developer.valvesoftware.com/wiki/SteamCMD#Downloading_SteamCMD Install SteamCMD].
*Open a command line window with elevated / local administrator privileges
*Browse to the location where SteamCMD was installed, and enter this command:
<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>
*This same command can also be used to update Empires Dedicated Server.

Once the server has been downloaded, you can launch the server by navigating to the installed location of SRCDS.exe and running the following console command:
<pre>
srcds.exe -game "empires" -console -toconsole -secure +map emp_district402 +maxplayers 64
</pre>

To allow players to connect to your server from outside your local network, you may need to port-forward the following ports:
* UDP 27005
* TCP and UDP 27015

=== Dedicated Server - APT ===
{{Fixme}}
Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 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
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 the following 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

Start parameters can be edited in '''/etc/empires-server.conf'''

More detailed/full start parameters are inside the service '''/usr/lib/systemd/system/empires-server.service'''

You can also start or stop the empires-server service
service empires-server stop
service empires-server start
== Configuration ==

=== Cvars ===

Most configuration can be done through the use of [Server Cvars]. There are several ways commands can be set to run automatically:

* Include the command in the call to SRCDS. This is how the <code>maxplayers</code> cvar is set in the example above. This will run the command as soon as possible.
* Include the command in the <code>/cfg/autoexe.cfg</code> file. This will run the command once on server start-up, before any maps have loaded.
* Include the command in the <code>/cfg/server.cfg</code> file. This will run the command every time any map loads.
* Include the command in a <code>/cfg/maps/[mapname].cfg</code> file. If there is a <code>.cfg</code> file in this directory with the same name as a map, the commands in it will be run every time that map loads. Use this for map-specific configuration changes, such as adjusting the resource multiplier or ticket count.

The following configuration options are the ones you will most likely need to change:

{| class="wikitable"
|+ Common Configuration
! Command !! Description
|-
| hostname || The name of your server, as it appears in the server browser.
|-
| rcon_password || A password that can be used to send server commands remotely.
{{Warning|Set this to a secure password, and do not share it freely. Anyone with this password can execute admin commands on your server.}}
|-
| sv_password || If this is set, players will be required to enter this password before joining the server.
|-
| sv_downloadurl || The URL of a [[FastDL]] server.
|-
| sv_region || A number representing the region your server is located in. A list of valid regions [[https://developer.valvesoftware.com/wiki/Sv_region can be found here]].
|-
| sv_contact || An email address players can use to contact the server owner.
|-
| sv_setsteamaccount || Link the server to a Steam account using an authentication token.
{{Fixme|Why/under what circumstances should this be done?}}
|-
| maxplayers || The maximum number of players allowed to join the server. This can only be set as part of the command that launches SRCDS.
|}
=== FastDL Setup ===

The [https://developer.valvesoftware.com/wiki/FastDL FastDL system] allows server owners to specify a URL from which custom content will be downloaded. This speeds up the process of players downloading custom content when joining a server, so setting this system up is highly recommended.

{{Fixme|We need instructions here on how to set up a FastDL server.}}

== 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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* [https://pastebin.com/SXsp0r2F How to create an Empires Server on Windows from A to Z.]

Sourcemod

2023-12-02T16:47:52Z

Neoony: /* Developing Plugins */

Sourcemod allows you to extend Empires without having access to the C++ code.

== Installation ==
* Install MetaMod:
** Download for [http://www.metamodsource.net/downloads/mmsource-1.10.6-windows.zip Windows] or [http://www.metamodsource.net/downloads/mmsource-1.10.6-windows.tar.gz Linux ]
** Copy the Addons folder into your empires folder
** Start the game
** Enter meta version (if the installation was succesful you should see the metamod version)
* Download sourcemod: http://www.sourcemod.net/downloads.php?branch=stable
* Copy the cfg and addons folders to your empires folder
* Install some [[Sourcemod Plugins]]

== Developing Plugins ==
Empires has a lot of [[Game_events_added | game events]] you can make use of. For an example of plugins you can make see our [https://git.empiresmod.com/sourcemod/ sourcemod repository].

== Compiling from Source ==
Thanks to people smarter than me, compiling from source is pretty easy. 
Take your source-file or source-text and pop it in this: http://www.sourcemod.net/compiler.php 
Download your compiled plugin, and put it in your sourcemod/plugins folder. 

Or you can use spcomp.exe inside your sourcemod folders (\addons\sourcemod\scripting\spcomp.exe) (for windows) 
Just drag and drop your source-file onto the .exe. 

== Sourcemod offsets and signatures ==
'''Get latest offsets ready to use here''' https://git.empiresmod.com/sourcemod/sourcemodoffsets 
 
If you have issues with invalid signatures. 
Example: 
<pre>L 03/18/2017 - 00:02:51: [SDKTOOLS] Invalid detour address passed - Disabling detour to prevent crashes
L 03/18/2017 - 00:02:51: [SM] Exception reported: Entity Outputs are disabled - See error logs for details</pre>

'''Choice 1.''' '''Just download latest ready to use offsets here:''' https://git.empiresmod.com/sourcemod/sourcemodoffsets 
'''Choice 2.''' Replace the linux signatures in sdkhooks and sdktools files with the mac signatures. (this is already included in the above release) 
This is rather temporary fix and needs testing 
Example: 
<pre>/* CBaseEntityOutput::FireOutput */
"#default"
{
"Signatures"
{
"FireOutput"
{
"library" "server"
"windows" "\x55\x8B\xEC\x81\x2A\x2A\x2A\x2A\x2A\xA1\x2A\x2A\x2A\x2A\x33\xC5\x89\x45\x2A\x8B\x45\x2A\x53\x56\x8B\x2A\x2A\x57\x8B\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\x89\x2A\x2A\x2A\x2A\x2A\xC7"
"linux" "@_ZN17CBaseEntityOutput10FireOutputE9variant_tP11CBaseEntityS2_f"
"mac" "@_ZN17CBaseEntityOutput10FireOutputE9variant_tP11CBaseEntityS2_f"
}
}
}</pre>

== Dumping updated Sourcemod offsets and signatures ==
Related thread: https://forums.empiresmod.com/index.php?threads/calculating-updated-sourcemod-vtable-offsets.20571/ 
Tool needed: https://delftelectronics.nl/empires/tools/vtablescanner3.zip 
The tool requires linux. If you are running 64bit linux, you will probably need to run the following to be able to run 32bit apps: 
<pre>dpkg --add-architecture i386
apt-get update
apt install libc6:i386 libelf1:i386</pre>
Unpack the vtablescanner3.zip anywhere in your linux. 
Next you need a server.so file from your dedicated server which is located in /empires_dedicated/empires/bin 
Copy server.so to the Release folder in the vtablescanner folder that you extracted. (vtablescanner/Release/server.so) 

Now open your terminal inside the Release folder. 
And enter the following command:
<pre>LD_LIBRARY_PATH="./" ./vtabledump ./server.so '_ZTV10CEmpPlayer' >dump.txt</pre>
The outputted RAW offsets are now located in vtablescanner/Release/dump.txt 
 
Now if you want to output a proper file for SourceMod. 
Open the terminal again inside Release folder. 
Type: 
<pre>./createoffsetscript >dumpsmoffsets.txt</pre>
This output file is the game.empires.txt which you can put into your: 
\addons\sourcemod\gamedata\sdkhooks.games\custom\game.empires.txt 
\addons\sourcemod\gamedata\sdktools.games\custom\game.empires.txt 
 
'''Also check this for offsets that need adjusting after a dump: https://git.empiresmod.com/sourcemod/sourcemodoffsets/issues/1''' 

== Plugin-Making tips ==
Dumping:
To get a dump of entity properties specific to empires and similar things, use following commands. 
'''"sm_dump_teprops"''' - Dumps tempentity props to a file 
'''"sm_dump_netprops_xml"''' - Dumps the networkable property table as an XML file 
'''"sm_dump_netprops"''' - Dumps the networkable property table as a text file 
'''"sm_dump_classes"''' - Dumps the class list as a text file 
'''"sm_dump_datamaps"''' - Dumps the data map list as a text file 
'''"sm_dump_admcache"''' - Dumps the admin cache for debugging 
'''"sm_dump_handles"''' - Dumps Handle usage to a file for finding Handle leaks 

Just add a filename after the command and you will find the dump files in empires folder. 
Just using some of those commands might make your client/server hang or even crash, but it will probably still make the dump, or just retry. 
------
'''Colors for messages:''' 
Custom colors usable by PrintToChat and similar. 
''Examples:'' 
<pre>\x079764FF BE
\x07FF2323 NF

PrintToChatAll("\x04[PLUGIN]\x079764FF BE\x01 not ready");
PrintToChatAll("\x04[PLUGIN]\x01 Commander left\x07FF2323 NF");</pre>

'''\x07''' - ''Type of coloring/message (custom colors seem to only work with \x07 and \x08)'' 
'''9764FF''' - ''HTML '''RRGGBB''' color without the '''#''' (You can pick your own color for example here: https://www.w3schools.com/colors/colors_picker.asp)'' 

'''Neoony's color standards:''' (Updated 18.4.2017 - Added player name color 
<pre>\x01 for standard text
\x04 for plugin things (example: "\x04[NCEV]\x01") [green]
\x079764FF for Brenodi Empire team [eyedropped from chat text]
\x07FF2323 for Northern Faction team [eyedropped from chat text]
\x07CB4491 for Both teams [mixed color of BE and NF, somewhat pink]
\x07CCCCCC for Spectators [gray]
\x07ff6600 for player name, if you cant use team colors for that [orange]
\x073399ff for displaying time, mainly seconds [light blue]
\x07008000 for enabled, unlocked or simply positive [green]
\x07b30000 for disabled, locked or simply negative, also for warnings [red]</pre>

[[Category:Sourcemod]]

Version/2.34.x

2022-06-25T13:47:05Z

Neoony:

{{SitenavNested|:Change_Log|Patch notes}}
== 2.34.7 ==
'''Release: (TBC)'''
=== Bug fixes ===
* Fixed a bug causing the engineer tool to regain more ammo than expected when re-applying the player's class.
* Fixed an issue preventing map spawned ammo crates from re-supplying tanks in certain situations.
* Fixed an problem with the squad artillery ability being activated in areas that shouldn't be allowed. (Non sky-box.)

=== Script/Game Balance ===
==== Infantry Resists ====
* RPG Resistances and resulting Damage to Infantry is now same as Mortar
* Scout
** Increased RPG Resist from 0 to 0.19
*** Reduces RPG Damage from 117 to 105
* Rifleman
** Increased RPG Resist from 0 to 0.1
*** Reduces RPG Damage from 130 to 117
* Grenadier
** Increased RPG Resist from 0.2 to 0.28
*** Reduces RPG Damage from 104 to 93
* Engineer
** Increased RPG Resist from 0 to 0.1
*** Reduces RPG Damage from 130 to 117

==== Vehicle Weapons ====
* Plasma Cannon
** Increased Projectile Speed from 3100 to 3300
** Reduced Gravity from 0.35 to 0.30
** Reduced Projectile Spread from 1 to 0.4
* Railgun
** Increased Cost from 120 to 140
* Biological Cannon
** Increased Damage from 70 to 80
** Increased Recoil from 70 to 80
** Increased Speed from 3000 to 3100
** Reduced Gravity from 0.35 to 0.325
** Increased Explosion Radius from 150 to 200
** Increased Infantry Bio Damage from 4 to 6

== 2.34.6 ==
'''Release: (2022-05-01)'''
=== Bug fixes ===
* Fix order distances having incorrect unit conversion from inches to meters.
* Fix an exploit allowing players to refill their engineer tool to full when changing class.
* Disable mine detonation for players on ladders.
* Remove double averaging of scoreboard latency, engine code already handles it.

=== Script/Game Balance ===
==== Infantry Resists ====
* Engineer & Rifleman
** Increased Mortar Resist from 0 to 0.1
*** Reduces Mortar Damage from 130 to 117
* Scout
** Increased Mortar Resist from 0.1 to 0.19
*** Reduces Mortar Damage from 117 to 105
* Grenadier
** Increased Mortar Resist from 0.2 to 0.28
*** Reduces Mortar Damage from 104 to 93
==== Command Vehicle ====
* Reduced Engineer Hull Repair from 3 to 1
** It triples the time it takes to repair the Command Vehicle's Hull
* Reduced Engineer Armor Repair from 0.04 to 0.01
** It Quadruples the time it takes to repair the Command Vehicle's Armor
* Reduced Command Vehicle's Armor Health from 275 to 250
* Reduced Command Vehicle's Armor Regenaration from 0.004 to 0.002
* Increased Command Vehicle's Armor Damage to Heat Absorbed from 0.025 to 0.04

{{DevNote|The Command Vehicle needs to be strong enough to withstand enemy fire for a short period of time, however this strength and the ease of repair have made it possible to use the Command Vehicle to drive into enemy fire with little to no consequence.
With these changes taking too much damage will cost your team time. }}

==== Vehicle Armors ====
* All Armors
** Increased Squad Artillery Resistance from 0 to 0.25
==== Vehicle Weapons ====
* Extended Range Cannon
** Increased Gravity from 0.1 to 0.15
* Plasma Cannon
** Increased Explosion Force from 100 to 500
* Railgun
** Increased Gravity from 0.04 to 0.05
** Increased Explosion Force from 50 to 1000
* Biological Cannon
** Increased Explosion Force from 170 to 300
* Upgraded Missile Launcher
** Reduced Heat from 6.5 to 6
** Reduced Weight from 70 to 60
** Increased Explosion Force from 50 to 100
* Biological Missile Launcher
** Reduced Weight from 70 to 60
* Salvo Missile Launcher
** Reduced Weight from 60 to 55
** Increased Explosion Force from 20 to 50
* Guided Missile Launcher
** Reduced Heat from 9 to 8
** Reduced Weight from 70 to 60
** Increased Clip Size from 4 to 5
** Increased Explosion Force from 40 to 100
* Homing Missile Launcher
** Increased Explosion Force from 40 to 500
==== Infantry Weapons ====
* Mortar & RPG now share the same ammo
** It effectively reduces the amount of ammo Grenadiers carry by half
* Mortar
** Reduced Speed from 2000 to 1800
* Northern Faction .50cal Rifle
** Increased Minimal Damage from 20 to 30
*** It ensures that it takes 4 shots to kill an enemy on distances shorter than ~6000 units

== 2.34.5 ==
'''Release: (2022-04-02)'''
=== Bug fixes ===
* Fixed a bug/exploit that was allowing refineries to be placed at no resource cost.
* Fixed a bug where the engineer tool kit would not recharge the correct amount if you changed your skills while it was holstered.
* Fixed the "Just in time" achievement being awarded to the local player even if it was a different player that triggered the achievement.
* Fixed some issues where the squadleader.cfg file would not execute when expected, leaving you with the wrong key binds if you specified key binds inside the file.

=== Script/Game Balance ===
==== Infantry Weapons ====
* Heavy Machine Gun
** Increased firing rate from 660 RPM to 792 RPM.
* SMG1
** Reduced Max Falloff from 10k to 6k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
** Changed Kick to be more consistent
* SMG2
** Reduced Max Falloff from 10k to 4k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
** Changed Kick to be more consistent
* BEHR/NFAR
** Reduced Max Falloff from 10k to 8k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
* Shotgun
** Reduced Melee Cycle Time from 1 to 0.8
** Increased Melee Damage from 70 to 80
* NF Shot Pistol
** Reduced Damage from 20 to 14
** Reduced Cycle Time from 0.6 to 0.5
** Reduced Max Falloff from 10k to 2k
** Changed Accuracy
** Changed Kick
==== Vehicle Chassis ====
* Artillery Tank
** Removed Cannon's Yaw (movement left and right)
* Northern Faction Artillery Tank
** Increased minimum pitch (movement up and down) so the cannon does not go inside the vehicle
==== Vehicle Weapons ====
* Artillery Cannons
** Removed Recoil
==== Vehicle Armor ====
* Reflective angle modifier effective angle range has been reduced from 5 -> 50 degrees to 2.5 -> 47.5 degrees.
** This is a direct buff to all armors using the reflective angle modifier script attribute as it will reduce the size of the angle modifier "dead zone" (The zone in which there is no damage reduction).

== 2.34.4 ==
'''Release: (2022-02-26)'''
=== General changes ===
* Increased all voice line sound attenuation distance by about 1000 units.
* Removed unnecessary binary files from server packages. (Some client files were being shipped to server packages unnecessarily.)
* Added server commands to limit bunny hopping velocity gain and to enable auto bunny hopping, both are disabled by default. sv_enablebunnyhopping & sv_autobunnyhopping

=== Bug fixes ===
* Fixed a server crash relating to mines not being removed correctly.
* Fixed a few minor issues with the squad aura indicator sometimes showing incorrectly.
* Fixed an issue causing prop_physics_multiplayer entities being non-solid to players.
* Fixed player spawn points being able to be blocked by other players.

=== Script/Game Balance ===
* Scout hide is now removed from players who are reviving or being revived.
* Added functionality for explosions to be blocked by multiple entities.
** This allows damage to be applied with a system where multiple entities reduce the damage toward 0, instead of everything behind an explosion ray being blocked by the same thing. This should be more dynamic and it does fix some instances where people could potentially abuse flaws in the old system. (Like throwing concussion grenades at your feet, blocking the ray and causing the damage to pass through the walls and deal damage to turrets hidden behind them...)
* Large explosions no longer lose damage if player body parts are blocked, this feature was added in version 2.33.1
** This means that some weapons will always maintain their damage if the player is in radius and in line of sight to the explosion. (Currently this affects all artillery shells and nuclear missiles.)
==== Buildings ====
* Vehicle Factory
** Increased Health from 250 to 350
** Increased Cost from 400 to 500
* Radar
** Increased Health from 200 to 250
==== Infantry Weapons ====
* Concussion Grenades
** Increased Max Ammo from 3 to 6.
* Northern Faction Assault Rifle
** Reduced Rate of Fire from 660 RPM to 565 RPM
** Changes have been made to the Assault Rifle's accuracy
*** The NFAR is most effective while being still and firing short bursts
* Northern Faction SMG2
** Changes have been made to the SMG2's accuracy
*** SMG2 is most effective while being mobile and in close quarters "spraying and praying"
* Northern Faction SMG1
** Changes have been made to the SMG1
*** SMG1 is effective for short to medium range engagement in any situation
* Brenodi Empire Heavy Rifle
** Reduced Rate of Fire from 660 RPM to 565 RPM
** Changes have been made to the Assault Rifle's accuracy
*** The BEHR is most effective while being still and firing short bursts
* Brenodi Empire SMG2
** Changes have been made to the SMG2's accuracy
*** SMG2 is most effective while being mobile and in close quarters "spraying and praying"
* Brenodi Empire SMG1
** Changes have been made to the SMG1
*** SMG1 is effective for short to medium range engagement in any situation
* Brendo Empire Pistol 2
** The Brenodi Empire Pistol 2's accuracy has been improved
* A few of the weapons have been rebalanced, see the changes here https://git.empiresmod.com/empires_public/empires_scripts/-/merge_requests/231/diffs?commit_id=506bca8eac8be7900d5c799fce0e9c88e9ff66dd

== 2.34.3 ==
'''Release: (2022/01/28)'''
=== Features ===
* Added a squad member ID to both the mini-map and the Squad HUD. This can be used to locate specific players.
* Added player requests to the squad HUD. (Ammo/Health/Repairs)
* Added an indicator in the Squad HUD for players receiving the squad aura effect. (Green box next to player health when the player is receiving the benefit of the squad aura.)

{| style="margin-left:4em;text-align:center" class="wikitable"
|-
! Squad HUD changes !! Mini-map changes
|-
|[[File:SquadMenuChanges 2022-01-28.png|frame|center| Added player request icons (Ammo/Health/Repairs) and an indicator for players currently receiving the squad aura effect.]]
||
[[File:MinimapSquadIDExample.png|frame|center|The minimap now shows an ID for each player in your squad, this can be used to identify where each player in the squad is on the map.]]
|}

=== Bug fixes ===
* Fixed an issue causing explosion damage to break completely on vehicles. This was caused by a previous version, some of the explosion code was rewritten to fix a bug involving a tank's turret entity transferring damage to the tank entity. There was an oversight which was causing the damage to be prevented entirely; it should now be fixed.

=== Script/Game Balance ===
==== Infantry Resistances ====
* Reduced Explosive Missile Resistance (Nuclear Warhead) for all classes
** Grenadier with Health Upgrade can no longer survive a direct nuclear missile hit
* Reduced Artillery resistance for all classes
** Grenadier with Health Upgrade can no longer survive a direct high-explosive artillery shell hit.
==== Research ====
* Plasma Heavy Machine Gun
** Reduced Time from 90 to 60
** Reduced Cost from 360 to 240

== 2.34.2 ==
'''Release: (2022/01/23)'''
=== Bug fixes ===
* Fixed a code typo which was causing a bug with explosion damage, meaning double damage could occur to vehicles.
* Fixed a few issues relating to checking a player's team for displaying icons on the minimap. Sometimes player icons wouldn't display even though they should.
* Fixed building smoke not calling StopEmission if the particle system is in a sleep state. (IE not being rendered but inside the player's potential visible set)
** What this essentially means is that building smoke will continue to change state and even when you're not looking at the building. Previously you could look away from the building, turn around and notice smoke is still there for a few frames; despite the building being repaired while you weren't looking.
* Fixed a typo in vehicle_armor script for BulletExplosiveResist value.

=== Script/Game Balance ===
* Lowered Plasma Heavy Machine gun's minimum damage from 10 -> 8 (It previously had no damage falloff.)

== 2.34.1 ==
'''Release: (2022/01/16)'''
=== Features ===
* Added cvar "emp_sv_drop_cooked_grenades", this is disabled by default until some gameplay testing can be conducted and feedback gathered.
** Causes grenades to drop when players die if they had already pulled the pin out. (Excluding mines)

=== Bug fixes ===
* Fixed an issue with e-repair preventing mines from being defused inside a damaged friendly building.
* Fixed an issue that was preventing wall gibs from spawning when destroyed. This was caused by a bug fix last patch.
* Fixed an issue that prevented the commander wall limit from functioning correctly.
* Fixed an bug relating to removal of attack targets on a player entering command view or a player entering scout hide. Both actions now remove targets instantly.
* Fixed some issues with how mines are triggered/detonated. Previous to this change, mines would detonate if a vehicle's "absbox" overlapped the mine bounding box. The problem with this is that the "absbox" is calculated every frame and doesn't rotate, it grows in size to encapsulate it's target. This lead to situations where a vehicle that wasn't perfectly aligned to the world origin would have a greater chance of triggering surrounding mines. The new system should be a lot more accurate and result in less frustration/guess work when trying to avoid mines.
* Fixed some issues relating to tanks receiving damage:
** Physics impact damage on tanks no longer prevents repair stations from repairing your tank. It would often be the case that a small bump when trying to enter the repair station would trigger the repair delay, this damage type is now filtered out of this feature. (For reference the delay is 10 seconds, so this can be quite frustrating for the driver.)
** Tanks no longer trigger the repair delay if they didn't actually take any damage from the entity trying to damage it. Previous to this change you could use a weapon that doesn't deal damage to delay a tank from repairing. This has long been an issue and the feature should now work as intended. (As an example, bullets can no longer delay a tank trying to use a repair station.)
** Fixed some issues where damage was being mis-attributed to players with regards to calculating assists/critical assists.
** Fixed an issue with tank turrets not transferring damage to the hull appropriately.
*** Fixed an issue with tanks taking explosion damage from the turret first, despite the hull being closer; resulting in a damage reduction. This will mostly impact gameplay when explosions occur on the top surface of tanks, they will now deal the expected amount of damage without a drop in damage. Explosions now prioritise dealing maximum possible damage in this situation, in terms of possible falloff reductions etc. This is likely going to have a bigger impact on chassis where the turret is often in the line of sight of explosions; for example NF light tanks, where the turret is easier to hit because it's shorter.
** Removed some code which was trying to prevent two sets of the same damage applying to vehicles per frame, this was added to prevent a vehicle's turret from transferring duplicate damage. This was crudely implemented and was preventing damage from occurring in certain situations.

=== Script/Game Balance ===
==== Command Vehicle ====
* Reduced the Heat to Damage Absorbed on the Command Vehicle's armor by half.
* Increased Max Speed from 25 to 30 mph.
==== General Balance Changes ====
* Removed the hard-coded variable damage on mines.
** It was previously written in code that mines would deal double damage if triggered by a vehicle. This has been removed because the damage resistance system should have been utilized to ensure that everything in the explosion radius was receiving the expected amount of damage. With the old method, it meant that everything in the explosion radius would receive double damage if the mine had been detonated by a vehicle.
* Removed the hard-coded variable damage on explosive sticky grenades.
** It was previously written in code that sticky grenades would deal double damage to all vehicles except the command vehicle. Again, this has been removed because the damage resistance system should have been utilized to ensure that everything in the explosion radius was receiving the expected amount of damage. With the old method, it meant that everything in the explosion radius would receive double damage if the grenade had been attached to a vehicle (Excluding CV).
** Damage resistances have been adjusted to compensate in the scripts.
* Added a new script variable for use with vehicle armors "Flat Damage Reduction". This change is to give reactive more of a unique identity, being quite resistant early game but being less effective as the game progresses and the enemy unlocks stronger weapons.
** Reactive now has a flat damage reduction of 5. (Resistances have been adjusted to ensure all anti-vehicle machine guns deal damage.)
** Reactive now has 120 HP per plate instead of 135.
** Composite now has a flat damage reduction of 1.

[[Category:Patch_Notes]]

Version/2.34.x

2022-06-25T13:10:39Z

Neoony:

{{SitenavNested|:Change_Log|Patch notes}}
== 2.34.7 ==
'''Release: (TBC)'''
=== Bug fixes ===
* Fixed a bug causing the engineer tool to regain more ammo than expected when re-applying the player's class.
* Fixed an issue preventing map spawned ammo crates from re-supplying tanks in certain situations.
* Fixed an problem with the squad artillery ability being activated in areas that shouldn't be allowed. (Non sky-box.)
* Remove spotting of players that attack buildings with a vehicle and jump out before detonation

=== Script/Game Balance ===
==== Infantry Resists ====
* RPG Resistances and resulting Damage to Infantry is now same as Mortar
* Scout
** Increased RPG Resist from 0 to 0.19
*** Reduces RPG Damage from 117 to 105
* Rifleman
** Increased RPG Resist from 0 to 0.1
*** Reduces RPG Damage from 130 to 117
* Grenadier
** Increased RPG Resist from 0.2 to 0.28
*** Reduces RPG Damage from 104 to 93
* Engineer
** Increased RPG Resist from 0 to 0.1
*** Reduces RPG Damage from 130 to 117

==== Vehicle Weapons ====
* Plasma Cannon
** Increased Projectile Speed from 3100 to 3300
** Reduced Gravity from 0.35 to 0.30
** Reduced Projectile Spread from 1 to 0.4
* Railgun
** Increased Cost from 120 to 140
* Biological Cannon
** Increased Damage from 70 to 80
** Increased Recoil from 70 to 80
** Increased Speed from 3000 to 3100
** Reduced Gravity from 0.35 to 0.325
** Increased Explosion Radius from 150 to 200
** Increased Infantry Bio Damage from 4 to 6

== 2.34.6 ==
'''Release: (2022-05-01)'''
=== Bug fixes ===
* Fix order distances having incorrect unit conversion from inches to meters.
* Fix an exploit allowing players to refill their engineer tool to full when changing class.
* Disable mine detonation for players on ladders.
* Remove double averaging of scoreboard latency, engine code already handles it.

=== Script/Game Balance ===
==== Infantry Resists ====
* Engineer & Rifleman
** Increased Mortar Resist from 0 to 0.1
*** Reduces Mortar Damage from 130 to 117
* Scout
** Increased Mortar Resist from 0.1 to 0.19
*** Reduces Mortar Damage from 117 to 105
* Grenadier
** Increased Mortar Resist from 0.2 to 0.28
*** Reduces Mortar Damage from 104 to 93
==== Command Vehicle ====
* Reduced Engineer Hull Repair from 3 to 1
** It triples the time it takes to repair the Command Vehicle's Hull
* Reduced Engineer Armor Repair from 0.04 to 0.01
** It Quadruples the time it takes to repair the Command Vehicle's Armor
* Reduced Command Vehicle's Armor Health from 275 to 250
* Reduced Command Vehicle's Armor Regenaration from 0.004 to 0.002
* Increased Command Vehicle's Armor Damage to Heat Absorbed from 0.025 to 0.04

{{DevNote|The Command Vehicle needs to be strong enough to withstand enemy fire for a short period of time, however this strength and the ease of repair have made it possible to use the Command Vehicle to drive into enemy fire with little to no consequence.
With these changes taking too much damage will cost your team time. }}

==== Vehicle Armors ====
* All Armors
** Increased Squad Artillery Resistance from 0 to 0.25
==== Vehicle Weapons ====
* Extended Range Cannon
** Increased Gravity from 0.1 to 0.15
* Plasma Cannon
** Increased Explosion Force from 100 to 500
* Railgun
** Increased Gravity from 0.04 to 0.05
** Increased Explosion Force from 50 to 1000
* Biological Cannon
** Increased Explosion Force from 170 to 300
* Upgraded Missile Launcher
** Reduced Heat from 6.5 to 6
** Reduced Weight from 70 to 60
** Increased Explosion Force from 50 to 100
* Biological Missile Launcher
** Reduced Weight from 70 to 60
* Salvo Missile Launcher
** Reduced Weight from 60 to 55
** Increased Explosion Force from 20 to 50
* Guided Missile Launcher
** Reduced Heat from 9 to 8
** Reduced Weight from 70 to 60
** Increased Clip Size from 4 to 5
** Increased Explosion Force from 40 to 100
* Homing Missile Launcher
** Increased Explosion Force from 40 to 500
==== Infantry Weapons ====
* Mortar & RPG now share the same ammo
** It effectively reduces the amount of ammo Grenadiers carry by half
* Mortar
** Reduced Speed from 2000 to 1800
* Northern Faction .50cal Rifle
** Increased Minimal Damage from 20 to 30
*** It ensures that it takes 4 shots to kill an enemy on distances shorter than ~6000 units

== 2.34.5 ==
'''Release: (2022-04-02)'''
=== Bug fixes ===
* Fixed a bug/exploit that was allowing refineries to be placed at no resource cost.
* Fixed a bug where the engineer tool kit would not recharge the correct amount if you changed your skills while it was holstered.
* Fixed the "Just in time" achievement being awarded to the local player even if it was a different player that triggered the achievement.
* Fixed some issues where the squadleader.cfg file would not execute when expected, leaving you with the wrong key binds if you specified key binds inside the file.

=== Script/Game Balance ===
==== Infantry Weapons ====
* Heavy Machine Gun
** Increased firing rate from 660 RPM to 792 RPM.
* SMG1
** Reduced Max Falloff from 10k to 6k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
** Changed Kick to be more consistent
* SMG2
** Reduced Max Falloff from 10k to 4k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
** Changed Kick to be more consistent
* BEHR/NFAR
** Reduced Max Falloff from 10k to 8k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
* Shotgun
** Reduced Melee Cycle Time from 1 to 0.8
** Increased Melee Damage from 70 to 80
* NF Shot Pistol
** Reduced Damage from 20 to 14
** Reduced Cycle Time from 0.6 to 0.5
** Reduced Max Falloff from 10k to 2k
** Changed Accuracy
** Changed Kick
==== Vehicle Chassis ====
* Artillery Tank
** Removed Cannon's Yaw (movement left and right)
* Northern Faction Artillery Tank
** Increased minimum pitch (movement up and down) so the cannon does not go inside the vehicle
==== Vehicle Weapons ====
* Artillery Cannons
** Removed Recoil
==== Vehicle Armor ====
* Reflective angle modifier effective angle range has been reduced from 5 -> 50 degrees to 2.5 -> 47.5 degrees.
** This is a direct buff to all armors using the reflective angle modifier script attribute as it will reduce the size of the angle modifier "dead zone" (The zone in which there is no damage reduction).

== 2.34.4 ==
'''Release: (2022-02-26)'''
=== General changes ===
* Increased all voice line sound attenuation distance by about 1000 units.
* Removed unnecessary binary files from server packages. (Some client files were being shipped to server packages unnecessarily.)
* Added server commands to limit bunny hopping velocity gain and to enable auto bunny hopping, both are disabled by default. sv_enablebunnyhopping & sv_autobunnyhopping

=== Bug fixes ===
* Fixed a server crash relating to mines not being removed correctly.
* Fixed a few minor issues with the squad aura indicator sometimes showing incorrectly.
* Fixed an issue causing prop_physics_multiplayer entities being non-solid to players.
* Fixed player spawn points being able to be blocked by other players.

=== Script/Game Balance ===
* Scout hide is now removed from players who are reviving or being revived.
* Added functionality for explosions to be blocked by multiple entities.
** This allows damage to be applied with a system where multiple entities reduce the damage toward 0, instead of everything behind an explosion ray being blocked by the same thing. This should be more dynamic and it does fix some instances where people could potentially abuse flaws in the old system. (Like throwing concussion grenades at your feet, blocking the ray and causing the damage to pass through the walls and deal damage to turrets hidden behind them...)
* Large explosions no longer lose damage if player body parts are blocked, this feature was added in version 2.33.1
** This means that some weapons will always maintain their damage if the player is in radius and in line of sight to the explosion. (Currently this affects all artillery shells and nuclear missiles.)
==== Buildings ====
* Vehicle Factory
** Increased Health from 250 to 350
** Increased Cost from 400 to 500
* Radar
** Increased Health from 200 to 250
==== Infantry Weapons ====
* Concussion Grenades
** Increased Max Ammo from 3 to 6.
* Northern Faction Assault Rifle
** Reduced Rate of Fire from 660 RPM to 565 RPM
** Changes have been made to the Assault Rifle's accuracy
*** The NFAR is most effective while being still and firing short bursts
* Northern Faction SMG2
** Changes have been made to the SMG2's accuracy
*** SMG2 is most effective while being mobile and in close quarters "spraying and praying"
* Northern Faction SMG1
** Changes have been made to the SMG1
*** SMG1 is effective for short to medium range engagement in any situation
* Brenodi Empire Heavy Rifle
** Reduced Rate of Fire from 660 RPM to 565 RPM
** Changes have been made to the Assault Rifle's accuracy
*** The BEHR is most effective while being still and firing short bursts
* Brenodi Empire SMG2
** Changes have been made to the SMG2's accuracy
*** SMG2 is most effective while being mobile and in close quarters "spraying and praying"
* Brenodi Empire SMG1
** Changes have been made to the SMG1
*** SMG1 is effective for short to medium range engagement in any situation
* Brendo Empire Pistol 2
** The Brenodi Empire Pistol 2's accuracy has been improved
* A few of the weapons have been rebalanced, see the changes here https://git.empiresmod.com/empires_public/empires_scripts/-/merge_requests/231/diffs?commit_id=506bca8eac8be7900d5c799fce0e9c88e9ff66dd

== 2.34.3 ==
'''Release: (2022/01/28)'''
=== Features ===
* Added a squad member ID to both the mini-map and the Squad HUD. This can be used to locate specific players.
* Added player requests to the squad HUD. (Ammo/Health/Repairs)
* Added an indicator in the Squad HUD for players receiving the squad aura effect. (Green box next to player health when the player is receiving the benefit of the squad aura.)

{| style="margin-left:4em;text-align:center" class="wikitable"
|-
! Squad HUD changes !! Mini-map changes
|-
|[[File:SquadMenuChanges 2022-01-28.png|frame|center| Added player request icons (Ammo/Health/Repairs) and an indicator for players currently receiving the squad aura effect.]]
||
[[File:MinimapSquadIDExample.png|frame|center|The minimap now shows an ID for each player in your squad, this can be used to identify where each player in the squad is on the map.]]
|}

=== Bug fixes ===
* Fixed an issue causing explosion damage to break completely on vehicles. This was caused by a previous version, some of the explosion code was rewritten to fix a bug involving a tank's turret entity transferring damage to the tank entity. There was an oversight which was causing the damage to be prevented entirely; it should now be fixed.

=== Script/Game Balance ===
==== Infantry Resistances ====
* Reduced Explosive Missile Resistance (Nuclear Warhead) for all classes
** Grenadier with Health Upgrade can no longer survive a direct nuclear missile hit
* Reduced Artillery resistance for all classes
** Grenadier with Health Upgrade can no longer survive a direct high-explosive artillery shell hit.
==== Research ====
* Plasma Heavy Machine Gun
** Reduced Time from 90 to 60
** Reduced Cost from 360 to 240

== 2.34.2 ==
'''Release: (2022/01/23)'''
=== Bug fixes ===
* Fixed a code typo which was causing a bug with explosion damage, meaning double damage could occur to vehicles.
* Fixed a few issues relating to checking a player's team for displaying icons on the minimap. Sometimes player icons wouldn't display even though they should.
* Fixed building smoke not calling StopEmission if the particle system is in a sleep state. (IE not being rendered but inside the player's potential visible set)
** What this essentially means is that building smoke will continue to change state and even when you're not looking at the building. Previously you could look away from the building, turn around and notice smoke is still there for a few frames; despite the building being repaired while you weren't looking.
* Fixed a typo in vehicle_armor script for BulletExplosiveResist value.

=== Script/Game Balance ===
* Lowered Plasma Heavy Machine gun's minimum damage from 10 -> 8 (It previously had no damage falloff.)

== 2.34.1 ==
'''Release: (2022/01/16)'''
=== Features ===
* Added cvar "emp_sv_drop_cooked_grenades", this is disabled by default until some gameplay testing can be conducted and feedback gathered.
** Causes grenades to drop when players die if they had already pulled the pin out. (Excluding mines)

=== Bug fixes ===
* Fixed an issue with e-repair preventing mines from being defused inside a damaged friendly building.
* Fixed an issue that was preventing wall gibs from spawning when destroyed. This was caused by a bug fix last patch.
* Fixed an issue that prevented the commander wall limit from functioning correctly.
* Fixed an bug relating to removal of attack targets on a player entering command view or a player entering scout hide. Both actions now remove targets instantly.
* Fixed some issues with how mines are triggered/detonated. Previous to this change, mines would detonate if a vehicle's "absbox" overlapped the mine bounding box. The problem with this is that the "absbox" is calculated every frame and doesn't rotate, it grows in size to encapsulate it's target. This lead to situations where a vehicle that wasn't perfectly aligned to the world origin would have a greater chance of triggering surrounding mines. The new system should be a lot more accurate and result in less frustration/guess work when trying to avoid mines.
* Fixed some issues relating to tanks receiving damage:
** Physics impact damage on tanks no longer prevents repair stations from repairing your tank. It would often be the case that a small bump when trying to enter the repair station would trigger the repair delay, this damage type is now filtered out of this feature. (For reference the delay is 10 seconds, so this can be quite frustrating for the driver.)
** Tanks no longer trigger the repair delay if they didn't actually take any damage from the entity trying to damage it. Previous to this change you could use a weapon that doesn't deal damage to delay a tank from repairing. This has long been an issue and the feature should now work as intended. (As an example, bullets can no longer delay a tank trying to use a repair station.)
** Fixed some issues where damage was being mis-attributed to players with regards to calculating assists/critical assists.
** Fixed an issue with tank turrets not transferring damage to the hull appropriately.
*** Fixed an issue with tanks taking explosion damage from the turret first, despite the hull being closer; resulting in a damage reduction. This will mostly impact gameplay when explosions occur on the top surface of tanks, they will now deal the expected amount of damage without a drop in damage. Explosions now prioritise dealing maximum possible damage in this situation, in terms of possible falloff reductions etc. This is likely going to have a bigger impact on chassis where the turret is often in the line of sight of explosions; for example NF light tanks, where the turret is easier to hit because it's shorter.
** Removed some code which was trying to prevent two sets of the same damage applying to vehicles per frame, this was added to prevent a vehicle's turret from transferring duplicate damage. This was crudely implemented and was preventing damage from occurring in certain situations.

=== Script/Game Balance ===
==== Command Vehicle ====
* Reduced the Heat to Damage Absorbed on the Command Vehicle's armor by half.
* Increased Max Speed from 25 to 30 mph.
==== General Balance Changes ====
* Removed the hard-coded variable damage on mines.
** It was previously written in code that mines would deal double damage if triggered by a vehicle. This has been removed because the damage resistance system should have been utilized to ensure that everything in the explosion radius was receiving the expected amount of damage. With the old method, it meant that everything in the explosion radius would receive double damage if the mine had been detonated by a vehicle.
* Removed the hard-coded variable damage on explosive sticky grenades.
** It was previously written in code that sticky grenades would deal double damage to all vehicles except the command vehicle. Again, this has been removed because the damage resistance system should have been utilized to ensure that everything in the explosion radius was receiving the expected amount of damage. With the old method, it meant that everything in the explosion radius would receive double damage if the grenade had been attached to a vehicle (Excluding CV).
** Damage resistances have been adjusted to compensate in the scripts.
* Added a new script variable for use with vehicle armors "Flat Damage Reduction". This change is to give reactive more of a unique identity, being quite resistant early game but being less effective as the game progresses and the enemy unlocks stronger weapons.
** Reactive now has a flat damage reduction of 5. (Resistances have been adjusted to ensure all anti-vehicle machine guns deal damage.)
** Reactive now has 120 HP per plate instead of 135.
** Composite now has a flat damage reduction of 1.

[[Category:Patch_Notes]]

Version/2.34.x

2022-06-24T19:25:48Z

Neoony:

Version/2.34.x

2022-06-24T19:13:18Z

Neoony:

{{SitenavNested|:Change_Log|Patch notes}}
== 2.34.7 ==
'''Release: (TBC)'''
=== Bug fixes ===
* Fixed a bug causing the engineer tool to regain more ammo than expected when re-applying the player's class.
* Fixed an issue preventing map spawned ammo crates from re-supplying tanks in certain situations.
* Fixed an problem with the squad artillery ability being activated in areas that shouldn't be allowed. (Non sky-box.)

=== Script/Game Balance ===
==== Infantry Resists ====
* Scout
** Increased RPG Resist from 0 to 0.19
*** Reduces RPG Damage from 117 to 105
* Rifleman
** Increased RPG Resist from 0 to 0.1
*** Reduces RPG Damage from 130 to 117
* Grenadier
** Increased RPG Resist from 0.2 to 0.28
*** Reduces RPG Damage from 104 to 93
* Engineer
** Increased RPG Resist from 0 to 0.1
*** Reduces RPG Damage from 130 to 117

==== Vehicle Weapons ====
* Plasma Cannon
** Increased Projectile Speed from 3100 to 3300
** Reduced Gravity from 0.35 to 0.30
** Reduced Projectile Spread from 1 to 0.4
* Railgun
** Increased Cost from 120 to 140
* Biological Cannon
** Increased Damage from 70 to 80
** Increased Recoil from 70 to 80
** Increased Speed from 3000 to 3100
** Reduced Gravity from 0.35 to 0.325
** Increased Explosion Radius from 150 to 200
** Increased Infantry Bio Damage from 4 to 6

== 2.34.6 ==
'''Release: (2022-05-01)'''
=== Bug fixes ===
* Fix order distances having incorrect unit conversion from inches to meters.
* Fix an exploit allowing players to refill their engineer tool to full when changing class.
* Disable mine detonation for players on ladders.
* Remove double averaging of scoreboard latency, engine code already handles it.

=== Script/Game Balance ===
==== Infantry Resists ====
* Engineer & Rifleman
** Increased Mortar Resist from 0 to 0.1
*** Reduces Mortar Damage from 130 to 117
* Scout
** Increased Mortar Resist from 0.1 to 0.19
*** Reduces Mortar Damage from 117 to 105
* Grenadier
** Increased Mortar Resist from 0.2 to 0.28
*** Reduces Mortar Damage from 104 to 93
==== Command Vehicle ====
* Reduced Engineer Hull Repair from 3 to 1
** It triples the time it takes to repair the Command Vehicle's Hull
* Reduced Engineer Armor Repair from 0.04 to 0.01
** It Quadruples the time it takes to repair the Command Vehicle's Armor
* Reduced Command Vehicle's Armor Health from 275 to 250
* Reduced Command Vehicle's Armor Regenaration from 0.004 to 0.002
* Increased Command Vehicle's Armor Damage to Heat Absorbed from 0.025 to 0.04

{{DevNote|The Command Vehicle needs to be strong enough to withstand enemy fire for a short period of time, however this strength and the ease of repair have made it possible to use the Command Vehicle to drive into enemy fire with little to no consequence.
With these changes taking too much damage will cost your team time. }}

==== Vehicle Armors ====
* All Armors
** Increased Squad Artillery Resistance from 0 to 0.25
==== Vehicle Weapons ====
* Extended Range Cannon
** Increased Gravity from 0.1 to 0.15
* Plasma Cannon
** Increased Explosion Force from 100 to 500
* Railgun
** Increased Gravity from 0.04 to 0.05
** Increased Explosion Force from 50 to 1000
* Biological Cannon
** Increased Explosion Force from 170 to 300
* Upgraded Missile Launcher
** Reduced Heat from 6.5 to 6
** Reduced Weight from 70 to 60
** Increased Explosion Force from 50 to 100
* Biological Missile Launcher
** Reduced Weight from 70 to 60
* Salvo Missile Launcher
** Reduced Weight from 60 to 55
** Increased Explosion Force from 20 to 50
* Guided Missile Launcher
** Reduced Heat from 9 to 8
** Reduced Weight from 70 to 60
** Increased Clip Size from 4 to 5
** Increased Explosion Force from 40 to 100
* Homing Missile Launcher
** Increased Explosion Force from 40 to 500
==== Infantry Weapons ====
* Mortar & RPG now share the same ammo
** It effectively reduces the amount of ammo Grenadiers carry by half
* Mortar
** Reduced Speed from 2000 to 1800
* Northern Faction .50cal Rifle
** Increased Minimal Damage from 20 to 30
*** It ensures that it takes 4 shots to kill an enemy on distances shorter than ~6000 units

== 2.34.5 ==
'''Release: (2022-04-02)'''
=== Bug fixes ===
* Fixed a bug/exploit that was allowing refineries to be placed at no resource cost.
* Fixed a bug where the engineer tool kit would not recharge the correct amount if you changed your skills while it was holstered.
* Fixed the "Just in time" achievement being awarded to the local player even if it was a different player that triggered the achievement.
* Fixed some issues where the squadleader.cfg file would not execute when expected, leaving you with the wrong key binds if you specified key binds inside the file.

=== Script/Game Balance ===
==== Infantry Weapons ====
* Heavy Machine Gun
** Increased firing rate from 660 RPM to 792 RPM.
* SMG1
** Reduced Max Falloff from 10k to 6k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
** Changed Kick to be more consistent
* SMG2
** Reduced Max Falloff from 10k to 4k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
** Changed Kick to be more consistent
* BEHR/NFAR
** Reduced Max Falloff from 10k to 8k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
* Shotgun
** Reduced Melee Cycle Time from 1 to 0.8
** Increased Melee Damage from 70 to 80
* NF Shot Pistol
** Reduced Damage from 20 to 14
** Reduced Cycle Time from 0.6 to 0.5
** Reduced Max Falloff from 10k to 2k
** Changed Accuracy
** Changed Kick
==== Vehicle Chassis ====
* Artillery Tank
** Removed Cannon's Yaw (movement left and right)
* Northern Faction Artillery Tank
** Increased minimum pitch (movement up and down) so the cannon does not go inside the vehicle
==== Vehicle Weapons ====
* Artillery Cannons
** Removed Recoil
==== Vehicle Armor ====
* Reflective angle modifier effective angle range has been reduced from 5 -> 50 degrees to 2.5 -> 47.5 degrees.
** This is a direct buff to all armors using the reflective angle modifier script attribute as it will reduce the size of the angle modifier "dead zone" (The zone in which there is no damage reduction).

== 2.34.4 ==
'''Release: (2022-02-26)'''
=== General changes ===
* Increased all voice line sound attenuation distance by about 1000 units.
* Removed unnecessary binary files from server packages. (Some client files were being shipped to server packages unnecessarily.)
* Added server commands to limit bunny hopping velocity gain and to enable auto bunny hopping, both are disabled by default. sv_enablebunnyhopping & sv_autobunnyhopping

=== Bug fixes ===
* Fixed a server crash relating to mines not being removed correctly.
* Fixed a few minor issues with the squad aura indicator sometimes showing incorrectly.
* Fixed an issue causing prop_physics_multiplayer entities being non-solid to players.
* Fixed player spawn points being able to be blocked by other players.

=== Script/Game Balance ===
* Scout hide is now removed from players who are reviving or being revived.
* Added functionality for explosions to be blocked by multiple entities.
** This allows damage to be applied with a system where multiple entities reduce the damage toward 0, instead of everything behind an explosion ray being blocked by the same thing. This should be more dynamic and it does fix some instances where people could potentially abuse flaws in the old system. (Like throwing concussion grenades at your feet, blocking the ray and causing the damage to pass through the walls and deal damage to turrets hidden behind them...)
* Large explosions no longer lose damage if player body parts are blocked, this feature was added in version 2.33.1
** This means that some weapons will always maintain their damage if the player is in radius and in line of sight to the explosion. (Currently this affects all artillery shells and nuclear missiles.)
==== Buildings ====
* Vehicle Factory
** Increased Health from 250 to 350
** Increased Cost from 400 to 500
* Radar
** Increased Health from 200 to 250
==== Infantry Weapons ====
* Concussion Grenades
** Increased Max Ammo from 3 to 6.
* Northern Faction Assault Rifle
** Reduced Rate of Fire from 660 RPM to 565 RPM
** Changes have been made to the Assault Rifle's accuracy
*** The NFAR is most effective while being still and firing short bursts
* Northern Faction SMG2
** Changes have been made to the SMG2's accuracy
*** SMG2 is most effective while being mobile and in close quarters "spraying and praying"
* Northern Faction SMG1
** Changes have been made to the SMG1
*** SMG1 is effective for short to medium range engagement in any situation
* Brenodi Empire Heavy Rifle
** Reduced Rate of Fire from 660 RPM to 565 RPM
** Changes have been made to the Assault Rifle's accuracy
*** The BEHR is most effective while being still and firing short bursts
* Brenodi Empire SMG2
** Changes have been made to the SMG2's accuracy
*** SMG2 is most effective while being mobile and in close quarters "spraying and praying"
* Brenodi Empire SMG1
** Changes have been made to the SMG1
*** SMG1 is effective for short to medium range engagement in any situation
* Brendo Empire Pistol 2
** The Brenodi Empire Pistol 2's accuracy has been improved
* A few of the weapons have been rebalanced, see the changes here https://git.empiresmod.com/empires_public/empires_scripts/-/merge_requests/231/diffs?commit_id=506bca8eac8be7900d5c799fce0e9c88e9ff66dd

== 2.34.3 ==
'''Release: (2022/01/28)'''
=== Features ===
* Added a squad member ID to both the mini-map and the Squad HUD. This can be used to locate specific players.
* Added player requests to the squad HUD. (Ammo/Health/Repairs)
* Added an indicator in the Squad HUD for players receiving the squad aura effect. (Green box next to player health when the player is receiving the benefit of the squad aura.)

{| style="margin-left:4em;text-align:center" class="wikitable"
|-
! Squad HUD changes !! Mini-map changes
|-
|[[File:SquadMenuChanges 2022-01-28.png|frame|center| Added player request icons (Ammo/Health/Repairs) and an indicator for players currently receiving the squad aura effect.]]
||
[[File:MinimapSquadIDExample.png|frame|center|The minimap now shows an ID for each player in your squad, this can be used to identify where each player in the squad is on the map.]]
|}

=== Bug fixes ===
* Fixed an issue causing explosion damage to break completely on vehicles. This was caused by a previous version, some of the explosion code was rewritten to fix a bug involving a tank's turret entity transferring damage to the tank entity. There was an oversight which was causing the damage to be prevented entirely; it should now be fixed.

=== Script/Game Balance ===
==== Infantry Resistances ====
* Reduced Explosive Missile Resistance (Nuclear Warhead) for all classes
** Grenadier with Health Upgrade can no longer survive a direct nuclear missile hit
* Reduced Artillery resistance for all classes
** Grenadier with Health Upgrade can no longer survive a direct high-explosive artillery shell hit.
==== Research ====
* Plasma Heavy Machine Gun
** Reduced Time from 90 to 60
** Reduced Cost from 360 to 240

== 2.34.2 ==
'''Release: (2022/01/23)'''
=== Bug fixes ===
* Fixed a code typo which was causing a bug with explosion damage, meaning double damage could occur to vehicles.
* Fixed a few issues relating to checking a player's team for displaying icons on the minimap. Sometimes player icons wouldn't display even though they should.
* Fixed building smoke not calling StopEmission if the particle system is in a sleep state. (IE not being rendered but inside the player's potential visible set)
** What this essentially means is that building smoke will continue to change state and even when you're not looking at the building. Previously you could look away from the building, turn around and notice smoke is still there for a few frames; despite the building being repaired while you weren't looking.
* Fixed a typo in vehicle_armor script for BulletExplosiveResist value.

=== Script/Game Balance ===
* Lowered Plasma Heavy Machine gun's minimum damage from 10 -> 8 (It previously had no damage falloff.)

== 2.34.1 ==
'''Release: (2022/01/16)'''
=== Features ===
* Added cvar "emp_sv_drop_cooked_grenades", this is disabled by default until some gameplay testing can be conducted and feedback gathered.
** Causes grenades to drop when players die if they had already pulled the pin out. (Excluding mines)

=== Bug fixes ===
* Fixed an issue with e-repair preventing mines from being defused inside a damaged friendly building.
* Fixed an issue that was preventing wall gibs from spawning when destroyed. This was caused by a bug fix last patch.
* Fixed an issue that prevented the commander wall limit from functioning correctly.
* Fixed an bug relating to removal of attack targets on a player entering command view or a player entering scout hide. Both actions now remove targets instantly.
* Fixed some issues with how mines are triggered/detonated. Previous to this change, mines would detonate if a vehicle's "absbox" overlapped the mine bounding box. The problem with this is that the "absbox" is calculated every frame and doesn't rotate, it grows in size to encapsulate it's target. This lead to situations where a vehicle that wasn't perfectly aligned to the world origin would have a greater chance of triggering surrounding mines. The new system should be a lot more accurate and result in less frustration/guess work when trying to avoid mines.
* Fixed some issues relating to tanks receiving damage:
** Physics impact damage on tanks no longer prevents repair stations from repairing your tank. It would often be the case that a small bump when trying to enter the repair station would trigger the repair delay, this damage type is now filtered out of this feature. (For reference the delay is 10 seconds, so this can be quite frustrating for the driver.)
** Tanks no longer trigger the repair delay if they didn't actually take any damage from the entity trying to damage it. Previous to this change you could use a weapon that doesn't deal damage to delay a tank from repairing. This has long been an issue and the feature should now work as intended. (As an example, bullets can no longer delay a tank trying to use a repair station.)
** Fixed some issues where damage was being mis-attributed to players with regards to calculating assists/critical assists.
** Fixed an issue with tank turrets not transferring damage to the hull appropriately.
*** Fixed an issue with tanks taking explosion damage from the turret first, despite the hull being closer; resulting in a damage reduction. This will mostly impact gameplay when explosions occur on the top surface of tanks, they will now deal the expected amount of damage without a drop in damage. Explosions now prioritise dealing maximum possible damage in this situation, in terms of possible falloff reductions etc. This is likely going to have a bigger impact on chassis where the turret is often in the line of sight of explosions; for example NF light tanks, where the turret is easier to hit because it's shorter.
** Removed some code which was trying to prevent two sets of the same damage applying to vehicles per frame, this was added to prevent a vehicle's turret from transferring duplicate damage. This was crudely implemented and was preventing damage from occurring in certain situations.

=== Script/Game Balance ===
==== Command Vehicle ====
* Reduced the Heat to Damage Absorbed on the Command Vehicle's armor by half.
* Increased Max Speed from 25 to 30 mph.
==== General Balance Changes ====
* Removed the hard-coded variable damage on mines.
** It was previously written in code that mines would deal double damage if triggered by a vehicle. This has been removed because the damage resistance system should have been utilized to ensure that everything in the explosion radius was receiving the expected amount of damage. With the old method, it meant that everything in the explosion radius would receive double damage if the mine had been detonated by a vehicle.
* Removed the hard-coded variable damage on explosive sticky grenades.
** It was previously written in code that sticky grenades would deal double damage to all vehicles except the command vehicle. Again, this has been removed because the damage resistance system should have been utilized to ensure that everything in the explosion radius was receiving the expected amount of damage. With the old method, it meant that everything in the explosion radius would receive double damage if the grenade had been attached to a vehicle (Excluding CV).
** Damage resistances have been adjusted to compensate in the scripts.
* Added a new script variable for use with vehicle armors "Flat Damage Reduction". This change is to give reactive more of a unique identity, being quite resistant early game but being less effective as the game progresses and the enemy unlocks stronger weapons.
** Reactive now has a flat damage reduction of 5. (Resistances have been adjusted to ensure all anti-vehicle machine guns deal damage.)
** Reactive now has 120 HP per plate instead of 135.
** Composite now has a flat damage reduction of 1.

[[Category:Patch_Notes]]

Version/2.34.x

2022-06-24T19:06:58Z

Neoony:

{{SitenavNested|:Change_Log|Patch notes}}
== 2.34.7 ==
'''Release: (TBC)'''
=== Bug fixes ===
* Fixed a bug causing the engineer tool to regain more ammo than expected when re-applying the player's class.
* Fixed an issue preventing map spawned ammo crates from re-supplying tanks in certain situations.
* Fixed an problem with the squad artillery ability being activated in areas that shouldn't be allowed. (Non sky-box.)

=== Script/Game Balance ===
==== Infantry Resists ====
* Scout
** Increased RPG Resist from 0 to 0.19
*** Reduces Mortar Damage from 117 to 105
* Rifleman
** Increased RPG Resist from 0 to 0.1
*** Reduces Mortar Damage from 130 to 117
* Grenadier
** Increased RPG Resist from 0.2 to 0.28
*** Reduces Mortar Damage from 104 to 93
* Engineer
** Increased RPG Resist from 0 to 0.1
*** Reduces Mortar Damage from 130 to 117

==== Vehicle Weapons ====
* Plasma Cannon
** Increased Projectile Speed from 3100 to 3300
** Reduced Gravity from 0.35 to 0.30
** Reduced Projectile Spread from 1 to 0.4
* Railgun
** Increased Cost from 120 to 140
* Biological Cannon
** Increased Damage from 70 to 80
** Increased Recoil from 70 to 80
** Increased Speed from 3000 to 3100
** Reduced Gravity from 0.35 to 0.325
** Increased Explosion Radius from 150 to 200
** Increased Infantry Bio Damage from 4 to 6

== 2.34.6 ==
'''Release: (2022-05-01)'''
=== Bug fixes ===
* Fix order distances having incorrect unit conversion from inches to meters.
* Fix an exploit allowing players to refill their engineer tool to full when changing class.
* Disable mine detonation for players on ladders.
* Remove double averaging of scoreboard latency, engine code already handles it.

=== Script/Game Balance ===
==== Infantry Resists ====
* Engineer & Rifleman
** Increased Mortar Resist from 0 to 0.1
*** Reduces Mortar Damage from 130 to 117
* Scout
** Increased Mortar Resist from 0.1 to 0.19
*** Reduces Mortar Damage from 117 to 105
* Grenadier
** Increased Mortar Resist from 0.2 to 0.28
*** Reduces Mortar Damage from 104 to 93
==== Command Vehicle ====
* Reduced Engineer Hull Repair from 3 to 1
** It triples the time it takes to repair the Command Vehicle's Hull
* Reduced Engineer Armor Repair from 0.04 to 0.01
** It Quadruples the time it takes to repair the Command Vehicle's Armor
* Reduced Command Vehicle's Armor Health from 275 to 250
* Reduced Command Vehicle's Armor Regenaration from 0.004 to 0.002
* Increased Command Vehicle's Armor Damage to Heat Absorbed from 0.025 to 0.04

{{DevNote|The Command Vehicle needs to be strong enough to withstand enemy fire for a short period of time, however this strength and the ease of repair have made it possible to use the Command Vehicle to drive into enemy fire with little to no consequence.
With these changes taking too much damage will cost your team time. }}

==== Vehicle Armors ====
* All Armors
** Increased Squad Artillery Resistance from 0 to 0.25
==== Vehicle Weapons ====
* Extended Range Cannon
** Increased Gravity from 0.1 to 0.15
* Plasma Cannon
** Increased Explosion Force from 100 to 500
* Railgun
** Increased Gravity from 0.04 to 0.05
** Increased Explosion Force from 50 to 1000
* Biological Cannon
** Increased Explosion Force from 170 to 300
* Upgraded Missile Launcher
** Reduced Heat from 6.5 to 6
** Reduced Weight from 70 to 60
** Increased Explosion Force from 50 to 100
* Biological Missile Launcher
** Reduced Weight from 70 to 60
* Salvo Missile Launcher
** Reduced Weight from 60 to 55
** Increased Explosion Force from 20 to 50
* Guided Missile Launcher
** Reduced Heat from 9 to 8
** Reduced Weight from 70 to 60
** Increased Clip Size from 4 to 5
** Increased Explosion Force from 40 to 100
* Homing Missile Launcher
** Increased Explosion Force from 40 to 500
==== Infantry Weapons ====
* Mortar & RPG now share the same ammo
** It effectively reduces the amount of ammo Grenadiers carry by half
* Mortar
** Reduced Speed from 2000 to 1800
* Northern Faction .50cal Rifle
** Increased Minimal Damage from 20 to 30
*** It ensures that it takes 4 shots to kill an enemy on distances shorter than ~6000 units

== 2.34.5 ==
'''Release: (2022-04-02)'''
=== Bug fixes ===
* Fixed a bug/exploit that was allowing refineries to be placed at no resource cost.
* Fixed a bug where the engineer tool kit would not recharge the correct amount if you changed your skills while it was holstered.
* Fixed the "Just in time" achievement being awarded to the local player even if it was a different player that triggered the achievement.
* Fixed some issues where the squadleader.cfg file would not execute when expected, leaving you with the wrong key binds if you specified key binds inside the file.

=== Script/Game Balance ===
==== Infantry Weapons ====
* Heavy Machine Gun
** Increased firing rate from 660 RPM to 792 RPM.
* SMG1
** Reduced Max Falloff from 10k to 6k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
** Changed Kick to be more consistent
* SMG2
** Reduced Max Falloff from 10k to 4k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
** Changed Kick to be more consistent
* BEHR/NFAR
** Reduced Max Falloff from 10k to 8k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
* Shotgun
** Reduced Melee Cycle Time from 1 to 0.8
** Increased Melee Damage from 70 to 80
* NF Shot Pistol
** Reduced Damage from 20 to 14
** Reduced Cycle Time from 0.6 to 0.5
** Reduced Max Falloff from 10k to 2k
** Changed Accuracy
** Changed Kick
==== Vehicle Chassis ====
* Artillery Tank
** Removed Cannon's Yaw (movement left and right)
* Northern Faction Artillery Tank
** Increased minimum pitch (movement up and down) so the cannon does not go inside the vehicle
==== Vehicle Weapons ====
* Artillery Cannons
** Removed Recoil
==== Vehicle Armor ====
* Reflective angle modifier effective angle range has been reduced from 5 -> 50 degrees to 2.5 -> 47.5 degrees.
** This is a direct buff to all armors using the reflective angle modifier script attribute as it will reduce the size of the angle modifier "dead zone" (The zone in which there is no damage reduction).

== 2.34.4 ==
'''Release: (2022-02-26)'''
=== General changes ===
* Increased all voice line sound attenuation distance by about 1000 units.
* Removed unnecessary binary files from server packages. (Some client files were being shipped to server packages unnecessarily.)
* Added server commands to limit bunny hopping velocity gain and to enable auto bunny hopping, both are disabled by default. sv_enablebunnyhopping & sv_autobunnyhopping

=== Bug fixes ===
* Fixed a server crash relating to mines not being removed correctly.
* Fixed a few minor issues with the squad aura indicator sometimes showing incorrectly.
* Fixed an issue causing prop_physics_multiplayer entities being non-solid to players.
* Fixed player spawn points being able to be blocked by other players.

=== Script/Game Balance ===
* Scout hide is now removed from players who are reviving or being revived.
* Added functionality for explosions to be blocked by multiple entities.
** This allows damage to be applied with a system where multiple entities reduce the damage toward 0, instead of everything behind an explosion ray being blocked by the same thing. This should be more dynamic and it does fix some instances where people could potentially abuse flaws in the old system. (Like throwing concussion grenades at your feet, blocking the ray and causing the damage to pass through the walls and deal damage to turrets hidden behind them...)
* Large explosions no longer lose damage if player body parts are blocked, this feature was added in version 2.33.1
** This means that some weapons will always maintain their damage if the player is in radius and in line of sight to the explosion. (Currently this affects all artillery shells and nuclear missiles.)
==== Buildings ====
* Vehicle Factory
** Increased Health from 250 to 350
** Increased Cost from 400 to 500
* Radar
** Increased Health from 200 to 250
==== Infantry Weapons ====
* Concussion Grenades
** Increased Max Ammo from 3 to 6.
* Northern Faction Assault Rifle
** Reduced Rate of Fire from 660 RPM to 565 RPM
** Changes have been made to the Assault Rifle's accuracy
*** The NFAR is most effective while being still and firing short bursts
* Northern Faction SMG2
** Changes have been made to the SMG2's accuracy
*** SMG2 is most effective while being mobile and in close quarters "spraying and praying"
* Northern Faction SMG1
** Changes have been made to the SMG1
*** SMG1 is effective for short to medium range engagement in any situation
* Brenodi Empire Heavy Rifle
** Reduced Rate of Fire from 660 RPM to 565 RPM
** Changes have been made to the Assault Rifle's accuracy
*** The BEHR is most effective while being still and firing short bursts
* Brenodi Empire SMG2
** Changes have been made to the SMG2's accuracy
*** SMG2 is most effective while being mobile and in close quarters "spraying and praying"
* Brenodi Empire SMG1
** Changes have been made to the SMG1
*** SMG1 is effective for short to medium range engagement in any situation
* Brendo Empire Pistol 2
** The Brenodi Empire Pistol 2's accuracy has been improved
* A few of the weapons have been rebalanced, see the changes here https://git.empiresmod.com/empires_public/empires_scripts/-/merge_requests/231/diffs?commit_id=506bca8eac8be7900d5c799fce0e9c88e9ff66dd

== 2.34.3 ==
'''Release: (2022/01/28)'''
=== Features ===
* Added a squad member ID to both the mini-map and the Squad HUD. This can be used to locate specific players.
* Added player requests to the squad HUD. (Ammo/Health/Repairs)
* Added an indicator in the Squad HUD for players receiving the squad aura effect. (Green box next to player health when the player is receiving the benefit of the squad aura.)

{| style="margin-left:4em;text-align:center" class="wikitable"
|-
! Squad HUD changes !! Mini-map changes
|-
|[[File:SquadMenuChanges 2022-01-28.png|frame|center| Added player request icons (Ammo/Health/Repairs) and an indicator for players currently receiving the squad aura effect.]]
||
[[File:MinimapSquadIDExample.png|frame|center|The minimap now shows an ID for each player in your squad, this can be used to identify where each player in the squad is on the map.]]
|}

=== Bug fixes ===
* Fixed an issue causing explosion damage to break completely on vehicles. This was caused by a previous version, some of the explosion code was rewritten to fix a bug involving a tank's turret entity transferring damage to the tank entity. There was an oversight which was causing the damage to be prevented entirely; it should now be fixed.

=== Script/Game Balance ===
==== Infantry Resistances ====
* Reduced Explosive Missile Resistance (Nuclear Warhead) for all classes
** Grenadier with Health Upgrade can no longer survive a direct nuclear missile hit
* Reduced Artillery resistance for all classes
** Grenadier with Health Upgrade can no longer survive a direct high-explosive artillery shell hit.
==== Research ====
* Plasma Heavy Machine Gun
** Reduced Time from 90 to 60
** Reduced Cost from 360 to 240

== 2.34.2 ==
'''Release: (2022/01/23)'''
=== Bug fixes ===
* Fixed a code typo which was causing a bug with explosion damage, meaning double damage could occur to vehicles.
* Fixed a few issues relating to checking a player's team for displaying icons on the minimap. Sometimes player icons wouldn't display even though they should.
* Fixed building smoke not calling StopEmission if the particle system is in a sleep state. (IE not being rendered but inside the player's potential visible set)
** What this essentially means is that building smoke will continue to change state and even when you're not looking at the building. Previously you could look away from the building, turn around and notice smoke is still there for a few frames; despite the building being repaired while you weren't looking.
* Fixed a typo in vehicle_armor script for BulletExplosiveResist value.

=== Script/Game Balance ===
* Lowered Plasma Heavy Machine gun's minimum damage from 10 -> 8 (It previously had no damage falloff.)

== 2.34.1 ==
'''Release: (2022/01/16)'''
=== Features ===
* Added cvar "emp_sv_drop_cooked_grenades", this is disabled by default until some gameplay testing can be conducted and feedback gathered.
** Causes grenades to drop when players die if they had already pulled the pin out. (Excluding mines)

=== Bug fixes ===
* Fixed an issue with e-repair preventing mines from being defused inside a damaged friendly building.
* Fixed an issue that was preventing wall gibs from spawning when destroyed. This was caused by a bug fix last patch.
* Fixed an issue that prevented the commander wall limit from functioning correctly.
* Fixed an bug relating to removal of attack targets on a player entering command view or a player entering scout hide. Both actions now remove targets instantly.
* Fixed some issues with how mines are triggered/detonated. Previous to this change, mines would detonate if a vehicle's "absbox" overlapped the mine bounding box. The problem with this is that the "absbox" is calculated every frame and doesn't rotate, it grows in size to encapsulate it's target. This lead to situations where a vehicle that wasn't perfectly aligned to the world origin would have a greater chance of triggering surrounding mines. The new system should be a lot more accurate and result in less frustration/guess work when trying to avoid mines.
* Fixed some issues relating to tanks receiving damage:
** Physics impact damage on tanks no longer prevents repair stations from repairing your tank. It would often be the case that a small bump when trying to enter the repair station would trigger the repair delay, this damage type is now filtered out of this feature. (For reference the delay is 10 seconds, so this can be quite frustrating for the driver.)
** Tanks no longer trigger the repair delay if they didn't actually take any damage from the entity trying to damage it. Previous to this change you could use a weapon that doesn't deal damage to delay a tank from repairing. This has long been an issue and the feature should now work as intended. (As an example, bullets can no longer delay a tank trying to use a repair station.)
** Fixed some issues where damage was being mis-attributed to players with regards to calculating assists/critical assists.
** Fixed an issue with tank turrets not transferring damage to the hull appropriately.
*** Fixed an issue with tanks taking explosion damage from the turret first, despite the hull being closer; resulting in a damage reduction. This will mostly impact gameplay when explosions occur on the top surface of tanks, they will now deal the expected amount of damage without a drop in damage. Explosions now prioritise dealing maximum possible damage in this situation, in terms of possible falloff reductions etc. This is likely going to have a bigger impact on chassis where the turret is often in the line of sight of explosions; for example NF light tanks, where the turret is easier to hit because it's shorter.
** Removed some code which was trying to prevent two sets of the same damage applying to vehicles per frame, this was added to prevent a vehicle's turret from transferring duplicate damage. This was crudely implemented and was preventing damage from occurring in certain situations.

=== Script/Game Balance ===
==== Command Vehicle ====
* Reduced the Heat to Damage Absorbed on the Command Vehicle's armor by half.
* Increased Max Speed from 25 to 30 mph.
==== General Balance Changes ====
* Removed the hard-coded variable damage on mines.
** It was previously written in code that mines would deal double damage if triggered by a vehicle. This has been removed because the damage resistance system should have been utilized to ensure that everything in the explosion radius was receiving the expected amount of damage. With the old method, it meant that everything in the explosion radius would receive double damage if the mine had been detonated by a vehicle.
* Removed the hard-coded variable damage on explosive sticky grenades.
** It was previously written in code that sticky grenades would deal double damage to all vehicles except the command vehicle. Again, this has been removed because the damage resistance system should have been utilized to ensure that everything in the explosion radius was receiving the expected amount of damage. With the old method, it meant that everything in the explosion radius would receive double damage if the grenade had been attached to a vehicle (Excluding CV).
** Damage resistances have been adjusted to compensate in the scripts.
* Added a new script variable for use with vehicle armors "Flat Damage Reduction". This change is to give reactive more of a unique identity, being quite resistant early game but being less effective as the game progresses and the enemy unlocks stronger weapons.
** Reactive now has a flat damage reduction of 5. (Resistances have been adjusted to ensure all anti-vehicle machine guns deal damage.)
** Reactive now has 120 HP per plate instead of 135.
** Composite now has a flat damage reduction of 1.

[[Category:Patch_Notes]]

Version/2.34.x

2022-06-24T17:17:50Z

Neoony:

{{SitenavNested|:Change_Log|Patch notes}}
== 2.34.7 ==
'''Release: (TBC)'''
=== Bug fixes ===
* Fixed a bug causing the engineer tool to regain more ammo than expected when re-applying the player's class.
* Fixed an issue preventing map spawned ammo crates from re-supplying tanks in certain situations.
* Fixed an problem with the squad artillery ability being activated in areas that shouldn't be allowed. (Non sky-box.)

=== Script/Game Balance ===
==== Infantry Resists ====
* Scout
** Increased RPG Resist from 0 to 0.19
* Rifleman
** Increased RPG Resist from 0 to 0.1
* Grenadier
** Increased RPG Resist from 0.2 to 0.28
* Engineer
** Increased RPG Resist from 0 to 0.1

==== Vehicle Weapons ====
* Plasma Cannon
** Increased Projectile Speed from 3100 to 3300
** Reduced Gravity from 0.35 to 0.30
** Reduced Projectile Spread from 1 to 0.4
* Railgun
** Increased Cost from 120 to 140
* Biological Cannon
** Increased Damage from 70 to 80
** Increased Recoil from 70 to 80
** Increased Speed from 3000 to 3100
** Reduced Gravity from 0.35 to 0.325
** Increased Explosion Radius from 150 to 200
** Increased Infantry Bio Damage from 4 to 6

== 2.34.6 ==
'''Release: (2022-05-01)'''
=== Bug fixes ===
* Fix order distances having incorrect unit conversion from inches to meters.
* Fix an exploit allowing players to refill their engineer tool to full when changing class.
* Disable mine detonation for players on ladders.
* Remove double averaging of scoreboard latency, engine code already handles it.

=== Script/Game Balance ===
==== Infantry Resists ====
* Engineer & Rifleman
** Increased Mortar Resist from 0 to 0.1
*** Reduces Mortar Damage from 130 to 117
* Scout
** Increased Mortar Resist from 0.1 to 0.19
*** Reduces Mortar Damage from 117 to 105
* Grenadier
** Increased Mortar Resist from 0.2 to 0.28
*** Reduces Mortar Damage from 104 to 93
==== Command Vehicle ====
* Reduced Engineer Hull Repair from 3 to 1
** It triples the time it takes to repair the Command Vehicle's Hull
* Reduced Engineer Armor Repair from 0.04 to 0.01
** It Quadruples the time it takes to repair the Command Vehicle's Armor
* Reduced Command Vehicle's Armor Health from 275 to 250
* Reduced Command Vehicle's Armor Regenaration from 0.004 to 0.002
* Increased Command Vehicle's Armor Damage to Heat Absorbed from 0.025 to 0.04

{{DevNote|The Command Vehicle needs to be strong enough to withstand enemy fire for a short period of time, however this strength and the ease of repair have made it possible to use the Command Vehicle to drive into enemy fire with little to no consequence.
With these changes taking too much damage will cost your team time. }}

==== Vehicle Armors ====
* All Armors
** Increased Squad Artillery Resistance from 0 to 0.25
==== Vehicle Weapons ====
* Extended Range Cannon
** Increased Gravity from 0.1 to 0.15
* Plasma Cannon
** Increased Explosion Force from 100 to 500
* Railgun
** Increased Gravity from 0.04 to 0.05
** Increased Explosion Force from 50 to 1000
* Biological Cannon
** Increased Explosion Force from 170 to 300
* Upgraded Missile Launcher
** Reduced Heat from 6.5 to 6
** Reduced Weight from 70 to 60
** Increased Explosion Force from 50 to 100
* Biological Missile Launcher
** Reduced Weight from 70 to 60
* Salvo Missile Launcher
** Reduced Weight from 60 to 55
** Increased Explosion Force from 20 to 50
* Guided Missile Launcher
** Reduced Heat from 9 to 8
** Reduced Weight from 70 to 60
** Increased Clip Size from 4 to 5
** Increased Explosion Force from 40 to 100
* Homing Missile Launcher
** Increased Explosion Force from 40 to 500
==== Infantry Weapons ====
* Mortar & RPG now share the same ammo
** It effectively reduces the amount of ammo Grenadiers carry by half
* Mortar
** Reduced Speed from 2000 to 1800
* Northern Faction .50cal Rifle
** Increased Minimal Damage from 20 to 30
*** It ensures that it takes 4 shots to kill an enemy on distances shorter than ~6000 units

== 2.34.5 ==
'''Release: (2022-04-02)'''
=== Bug fixes ===
* Fixed a bug/exploit that was allowing refineries to be placed at no resource cost.
* Fixed a bug where the engineer tool kit would not recharge the correct amount if you changed your skills while it was holstered.
* Fixed the "Just in time" achievement being awarded to the local player even if it was a different player that triggered the achievement.
* Fixed some issues where the squadleader.cfg file would not execute when expected, leaving you with the wrong key binds if you specified key binds inside the file.

=== Script/Game Balance ===
==== Infantry Weapons ====
* Heavy Machine Gun
** Increased firing rate from 660 RPM to 792 RPM.
* SMG1
** Reduced Max Falloff from 10k to 6k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
** Changed Kick to be more consistent
* SMG2
** Reduced Max Falloff from 10k to 4k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
** Changed Kick to be more consistent
* BEHR/NFAR
** Reduced Max Falloff from 10k to 8k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
* Shotgun
** Reduced Melee Cycle Time from 1 to 0.8
** Increased Melee Damage from 70 to 80
* NF Shot Pistol
** Reduced Damage from 20 to 14
** Reduced Cycle Time from 0.6 to 0.5
** Reduced Max Falloff from 10k to 2k
** Changed Accuracy
** Changed Kick
==== Vehicle Chassis ====
* Artillery Tank
** Removed Cannon's Yaw (movement left and right)
* Northern Faction Artillery Tank
** Increased minimum pitch (movement up and down) so the cannon does not go inside the vehicle
==== Vehicle Weapons ====
* Artillery Cannons
** Removed Recoil
==== Vehicle Armor ====
* Reflective angle modifier effective angle range has been reduced from 5 -> 50 degrees to 2.5 -> 47.5 degrees.
** This is a direct buff to all armors using the reflective angle modifier script attribute as it will reduce the size of the angle modifier "dead zone" (The zone in which there is no damage reduction).

== 2.34.4 ==
'''Release: (2022-02-26)'''
=== General changes ===
* Increased all voice line sound attenuation distance by about 1000 units.
* Removed unnecessary binary files from server packages. (Some client files were being shipped to server packages unnecessarily.)
* Added server commands to limit bunny hopping velocity gain and to enable auto bunny hopping, both are disabled by default. sv_enablebunnyhopping & sv_autobunnyhopping

=== Bug fixes ===
* Fixed a server crash relating to mines not being removed correctly.
* Fixed a few minor issues with the squad aura indicator sometimes showing incorrectly.
* Fixed an issue causing prop_physics_multiplayer entities being non-solid to players.
* Fixed player spawn points being able to be blocked by other players.

=== Script/Game Balance ===
* Scout hide is now removed from players who are reviving or being revived.
* Added functionality for explosions to be blocked by multiple entities.
** This allows damage to be applied with a system where multiple entities reduce the damage toward 0, instead of everything behind an explosion ray being blocked by the same thing. This should be more dynamic and it does fix some instances where people could potentially abuse flaws in the old system. (Like throwing concussion grenades at your feet, blocking the ray and causing the damage to pass through the walls and deal damage to turrets hidden behind them...)
* Large explosions no longer lose damage if player body parts are blocked, this feature was added in version 2.33.1
** This means that some weapons will always maintain their damage if the player is in radius and in line of sight to the explosion. (Currently this affects all artillery shells and nuclear missiles.)
==== Buildings ====
* Vehicle Factory
** Increased Health from 250 to 350
** Increased Cost from 400 to 500
* Radar
** Increased Health from 200 to 250
==== Infantry Weapons ====
* Concussion Grenades
** Increased Max Ammo from 3 to 6.
* Northern Faction Assault Rifle
** Reduced Rate of Fire from 660 RPM to 565 RPM
** Changes have been made to the Assault Rifle's accuracy
*** The NFAR is most effective while being still and firing short bursts
* Northern Faction SMG2
** Changes have been made to the SMG2's accuracy
*** SMG2 is most effective while being mobile and in close quarters "spraying and praying"
* Northern Faction SMG1
** Changes have been made to the SMG1
*** SMG1 is effective for short to medium range engagement in any situation
* Brenodi Empire Heavy Rifle
** Reduced Rate of Fire from 660 RPM to 565 RPM
** Changes have been made to the Assault Rifle's accuracy
*** The BEHR is most effective while being still and firing short bursts
* Brenodi Empire SMG2
** Changes have been made to the SMG2's accuracy
*** SMG2 is most effective while being mobile and in close quarters "spraying and praying"
* Brenodi Empire SMG1
** Changes have been made to the SMG1
*** SMG1 is effective for short to medium range engagement in any situation
* Brendo Empire Pistol 2
** The Brenodi Empire Pistol 2's accuracy has been improved
* A few of the weapons have been rebalanced, see the changes here https://git.empiresmod.com/empires_public/empires_scripts/-/merge_requests/231/diffs?commit_id=506bca8eac8be7900d5c799fce0e9c88e9ff66dd

== 2.34.3 ==
'''Release: (2022/01/28)'''
=== Features ===
* Added a squad member ID to both the mini-map and the Squad HUD. This can be used to locate specific players.
* Added player requests to the squad HUD. (Ammo/Health/Repairs)
* Added an indicator in the Squad HUD for players receiving the squad aura effect. (Green box next to player health when the player is receiving the benefit of the squad aura.)

{| style="margin-left:4em;text-align:center" class="wikitable"
|-
! Squad HUD changes !! Mini-map changes
|-
|[[File:SquadMenuChanges 2022-01-28.png|frame|center| Added player request icons (Ammo/Health/Repairs) and an indicator for players currently receiving the squad aura effect.]]
||
[[File:MinimapSquadIDExample.png|frame|center|The minimap now shows an ID for each player in your squad, this can be used to identify where each player in the squad is on the map.]]
|}

=== Bug fixes ===
* Fixed an issue causing explosion damage to break completely on vehicles. This was caused by a previous version, some of the explosion code was rewritten to fix a bug involving a tank's turret entity transferring damage to the tank entity. There was an oversight which was causing the damage to be prevented entirely; it should now be fixed.

=== Script/Game Balance ===
==== Infantry Resistances ====
* Reduced Explosive Missile Resistance (Nuclear Warhead) for all classes
** Grenadier with Health Upgrade can no longer survive a direct nuclear missile hit
* Reduced Artillery resistance for all classes
** Grenadier with Health Upgrade can no longer survive a direct high-explosive artillery shell hit.
==== Research ====
* Plasma Heavy Machine Gun
** Reduced Time from 90 to 60
** Reduced Cost from 360 to 240

== 2.34.2 ==
'''Release: (2022/01/23)'''
=== Bug fixes ===
* Fixed a code typo which was causing a bug with explosion damage, meaning double damage could occur to vehicles.
* Fixed a few issues relating to checking a player's team for displaying icons on the minimap. Sometimes player icons wouldn't display even though they should.
* Fixed building smoke not calling StopEmission if the particle system is in a sleep state. (IE not being rendered but inside the player's potential visible set)
** What this essentially means is that building smoke will continue to change state and even when you're not looking at the building. Previously you could look away from the building, turn around and notice smoke is still there for a few frames; despite the building being repaired while you weren't looking.
* Fixed a typo in vehicle_armor script for BulletExplosiveResist value.

=== Script/Game Balance ===
* Lowered Plasma Heavy Machine gun's minimum damage from 10 -> 8 (It previously had no damage falloff.)

== 2.34.1 ==
'''Release: (2022/01/16)'''
=== Features ===
* Added cvar "emp_sv_drop_cooked_grenades", this is disabled by default until some gameplay testing can be conducted and feedback gathered.
** Causes grenades to drop when players die if they had already pulled the pin out. (Excluding mines)

=== Bug fixes ===
* Fixed an issue with e-repair preventing mines from being defused inside a damaged friendly building.
* Fixed an issue that was preventing wall gibs from spawning when destroyed. This was caused by a bug fix last patch.
* Fixed an issue that prevented the commander wall limit from functioning correctly.
* Fixed an bug relating to removal of attack targets on a player entering command view or a player entering scout hide. Both actions now remove targets instantly.
* Fixed some issues with how mines are triggered/detonated. Previous to this change, mines would detonate if a vehicle's "absbox" overlapped the mine bounding box. The problem with this is that the "absbox" is calculated every frame and doesn't rotate, it grows in size to encapsulate it's target. This lead to situations where a vehicle that wasn't perfectly aligned to the world origin would have a greater chance of triggering surrounding mines. The new system should be a lot more accurate and result in less frustration/guess work when trying to avoid mines.
* Fixed some issues relating to tanks receiving damage:
** Physics impact damage on tanks no longer prevents repair stations from repairing your tank. It would often be the case that a small bump when trying to enter the repair station would trigger the repair delay, this damage type is now filtered out of this feature. (For reference the delay is 10 seconds, so this can be quite frustrating for the driver.)
** Tanks no longer trigger the repair delay if they didn't actually take any damage from the entity trying to damage it. Previous to this change you could use a weapon that doesn't deal damage to delay a tank from repairing. This has long been an issue and the feature should now work as intended. (As an example, bullets can no longer delay a tank trying to use a repair station.)
** Fixed some issues where damage was being mis-attributed to players with regards to calculating assists/critical assists.
** Fixed an issue with tank turrets not transferring damage to the hull appropriately.
*** Fixed an issue with tanks taking explosion damage from the turret first, despite the hull being closer; resulting in a damage reduction. This will mostly impact gameplay when explosions occur on the top surface of tanks, they will now deal the expected amount of damage without a drop in damage. Explosions now prioritise dealing maximum possible damage in this situation, in terms of possible falloff reductions etc. This is likely going to have a bigger impact on chassis where the turret is often in the line of sight of explosions; for example NF light tanks, where the turret is easier to hit because it's shorter.
** Removed some code which was trying to prevent two sets of the same damage applying to vehicles per frame, this was added to prevent a vehicle's turret from transferring duplicate damage. This was crudely implemented and was preventing damage from occurring in certain situations.

=== Script/Game Balance ===
==== Command Vehicle ====
* Reduced the Heat to Damage Absorbed on the Command Vehicle's armor by half.
* Increased Max Speed from 25 to 30 mph.
==== General Balance Changes ====
* Removed the hard-coded variable damage on mines.
** It was previously written in code that mines would deal double damage if triggered by a vehicle. This has been removed because the damage resistance system should have been utilized to ensure that everything in the explosion radius was receiving the expected amount of damage. With the old method, it meant that everything in the explosion radius would receive double damage if the mine had been detonated by a vehicle.
* Removed the hard-coded variable damage on explosive sticky grenades.
** It was previously written in code that sticky grenades would deal double damage to all vehicles except the command vehicle. Again, this has been removed because the damage resistance system should have been utilized to ensure that everything in the explosion radius was receiving the expected amount of damage. With the old method, it meant that everything in the explosion radius would receive double damage if the grenade had been attached to a vehicle (Excluding CV).
** Damage resistances have been adjusted to compensate in the scripts.
* Added a new script variable for use with vehicle armors "Flat Damage Reduction". This change is to give reactive more of a unique identity, being quite resistant early game but being less effective as the game progresses and the enemy unlocks stronger weapons.
** Reactive now has a flat damage reduction of 5. (Resistances have been adjusted to ensure all anti-vehicle machine guns deal damage.)
** Reactive now has 120 HP per plate instead of 135.
** Composite now has a flat damage reduction of 1.

[[Category:Patch_Notes]]

Version/2.34.x

2022-05-01T13:12:15Z

Neoony:

{{SitenavNested|:Change_Log|Patch notes}}
== 2.34.6 ==
'''Release: (TBD - not released yet)'''
=== Bug fixes ===
* Fix order distances having incorrect unit conversion from inches to meters.
* Fix an issue allowing an exploit to refill calc charge.
* Disable mine detonation for players on ladders.
* Remove double averaging of scoreboard latency, engine code already handles it.

==== Infantry Resists ====
* Engineer & Rifleman
** Increased Mortar Resist from 0 to 0.1
*** Reduces Mortar Damage from 130 to 117
* Scout
** Increased Mortar Resist from 0.1 to 0.19
*** Reduces Mortar Damage from 117 to 105
* Grenadier
** Increased Mortar Resist from 0.2 to 0.28
*** Reduces Mortar Damage from 104 to 93
==== Command Vehicle ====
* Reduced Engineer Hull Repair from 3 to 1
** It triples the time it takes to repair the Command Vehicle's Hull
* Reduced Engineer Armor Repair from 0.04 to 0.01
** It Quadruples the time it takes to repair the Command Vehicle's Armor
* Reduced Command Vehicle's Armor Health from 275 to 250
* Reduced Command Vehicle's Armor Regenaration from 0.004 to 0.002
* Increased Command Vehicle's Armor Damage to Heat Absorbed from 0.025 to 0.04
==== Vehicle Armors ====
* All Armors
** Increased Squad Artillery Resistance from 0 to 0.25
==== Vehicle Weapons ====
* Extended Range Cannon
** Increased Gravity from 0.1 to 0.15
* Plasma Cannon
** Increased Explosion Force from 100 to 500
* Railgun
** Increased Gravity from 0.04 to 0.05
** Increased Explosion Force from 50 to 1000
* Biological Cannon
** Increased Explosion Force from 170 to 300
* Upgraded Missile Launcher
** Reduced Heat from 6.5 to 6
** Reduced Weight from 70 to 60
** Increased Explosion Force from 50 to 100
* Biological Missile Launcher
** Reduced Weight from 70 to 60
* Salvo Missile Launcher
** Reduced Weight from 60 to 55
** Increased Explosion Force from 20 to 50
* Guided Missile Launcher
** Reduced Heat from 9 to 8
** Reduced Weight from 70 to 60
** Increased Clip Size from 4 to 5
** Increased Explosion Force from 40 to 100
* Homing Missile Launcher
** Increased Explosion Force from 40 to 500
==== Infantry Weapons ====
* Mortar & RPG now share the same ammo
** It effectively reduces the amount of ammo Grenadiers carry by half
* Mortar
** Reduced Speed from 2000 to 1800
* Northern Faction .50cal Rifle
** Increased Minimal Damage from 20 to 30
*** It ensures that it takes 4 shots to kill an enemy on distances shorter than ~6000 units

== 2.34.5 ==
'''Release: (2022-04-02)'''
=== Bug fixes ===
* Fixed a bug/exploit that was allowing refineries to be placed at no resource cost.
* Fixed a bug where the engineer tool kit would not recharge the correct amount if you changed your skills while it was holstered.
* Fixed the "Just in time" achievement being awarded to the local player even if it was a different player that triggered the achievement.
* Fixed some issues where the squadleader.cfg file would not execute when expected, leaving you with the wrong key binds if you specified key binds inside the file.

=== Script/Game Balance ===
==== Infantry Weapons ====
* Heavy Machine Gun
** Increased firing rate from 660 RPM to 792 RPM.
* SMG1
** Reduced Max Falloff from 10k to 6k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
** Changed Kick to be more consistent
* SMG2
** Reduced Max Falloff from 10k to 4k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
** Changed Kick to be more consistent
* BEHR/NFAR
** Reduced Max Falloff from 10k to 8k
** Changed Moving Accuracy so it accounts for the moving speed
*** This results in lower accuracy while moving
* Shotgun
** Reduced Melee Cycle Time from 1 to 0.8
** Increased Melee Damage from 70 to 80
* NF Shot Pistol
** Reduced Damage from 20 to 14
** Reduced Cycle Time from 0.6 to 0.5
** Reduced Max Falloff from 10k to 2k
** Changed Accuracy
** Changed Kick
==== Vehicle Chassis ====
* Artillery Tank
** Removed Cannon's Yaw (movement left and right)
* Northern Faction Artillery Tank
** Increased minimum pitch (movement up and down) so the cannon does not go inside the vehicle
==== Vehicle Weapons ====
* Artillery Cannons
** Removed Recoil
==== Vehicle Armor ====
* Reflective angle modifier effective angle range has been reduced from 5 -> 50 degrees to 2.5 -> 47.5 degrees.
** This is a direct buff to all armors using the reflective angle modifier script attribute as it will reduce the size of the angle modifier "dead zone" (The zone in which there is no damage reduction).

== 2.34.4 ==
'''Release: (2022-02-26)'''
=== General changes ===
* Increased all voice line sound attenuation distance by about 1000 units.
* Removed unnecessary binary files from server packages. (Some client files were being shipped to server packages unnecessarily.)
* Added server commands to limit bunny hopping velocity gain and to enable auto bunny hopping, both are disabled by default. sv_enablebunnyhopping & sv_autobunnyhopping

=== Bug fixes ===
* Fixed a server crash relating to mines not being removed correctly.
* Fixed a few minor issues with the squad aura indicator sometimes showing incorrectly.
* Fixed an issue causing prop_physics_multiplayer entities being non-solid to players.
* Fixed player spawn points being able to be blocked by other players.

=== Script/Game Balance ===
* Scout hide is now removed from players who are reviving or being revived.
* Added functionality for explosions to be blocked by multiple entities.
** This allows damage to be applied with a system where multiple entities reduce the damage toward 0, instead of everything behind an explosion ray being blocked by the same thing. This should be more dynamic and it does fix some instances where people could potentially abuse flaws in the old system. (Like throwing concussion grenades at your feet, blocking the ray and causing the damage to pass through the walls and deal damage to turrets hidden behind them...)
* Large explosions no longer lose damage if player body parts are blocked, this feature was added in version 2.33.1
** This means that some weapons will always maintain their damage if the player is in radius and in line of sight to the explosion. (Currently this affects all artillery shells and nuclear missiles.)
==== Buildings ====
* Vehicle Factory
** Increased Health from 250 to 350
** Increased Cost from 400 to 500
* Radar
** Increased Health from 200 to 250
==== Infantry Weapons ====
* Concussion Grenades
** Increased Max Ammo from 3 to 6.
* Northern Faction Assault Rifle
** Reduced Rate of Fire from 660 RPM to 565 RPM
** Changes have been made to the Assault Rifle's accuracy
*** The NFAR is most effective while being still and firing short bursts
* Northern Faction SMG2
** Changes have been made to the SMG2's accuracy
*** SMG2 is most effective while being mobile and in close quarters "spraying and praying"
* Northern Faction SMG1
** Changes have been made to the SMG1
*** SMG1 is effective for short to medium range engagement in any situation
* Brenodi Empire Heavy Rifle
** Reduced Rate of Fire from 660 RPM to 565 RPM
** Changes have been made to the Assault Rifle's accuracy
*** The BEHR is most effective while being still and firing short bursts
* Brenodi Empire SMG2
** Changes have been made to the SMG2's accuracy
*** SMG2 is most effective while being mobile and in close quarters "spraying and praying"
* Brenodi Empire SMG1
** Changes have been made to the SMG1
*** SMG1 is effective for short to medium range engagement in any situation
* Brendo Empire Pistol 2
** The Brenodi Empire Pistol 2's accuracy has been improved
* A few of the weapons have been rebalanced, see the changes here https://git.empiresmod.com/empires_public/empires_scripts/-/merge_requests/231/diffs?commit_id=506bca8eac8be7900d5c799fce0e9c88e9ff66dd

== 2.34.3 ==
'''Release: (2022/01/28)'''
=== Features ===
* Added a squad member ID to both the mini-map and the Squad HUD. This can be used to locate specific players.
* Added player requests to the squad HUD. (Ammo/Health/Repairs)
* Added an indicator in the Squad HUD for players receiving the squad aura effect. (Green box next to player health when the player is receiving the benefit of the squad aura.)

{| style="margin-left:4em;text-align:center" class="wikitable"
|-
! Squad HUD changes !! Mini-map changes
|-
|[[File:SquadMenuChanges 2022-01-28.png|frame|center| Added player request icons (Ammo/Health/Repairs) and an indicator for players currently receiving the squad aura effect.]]
||
[[File:MinimapSquadIDExample.png|frame|center|The minimap now shows an ID for each player in your squad, this can be used to identify where each player in the squad is on the map.]]
|}

=== Bug fixes ===
* Fixed an issue causing explosion damage to break completely on vehicles. This was caused by a previous version, some of the explosion code was rewritten to fix a bug involving a tank's turret entity transferring damage to the tank entity. There was an oversight which was causing the damage to be prevented entirely; it should now be fixed.

=== Script/Game Balance ===
==== Infantry Resistances ====
* Reduced Explosive Missile Resistance (Nuclear Warhead) for all classes
** Grenadier with Health Upgrade can no longer survive a direct nuclear missile hit
* Reduced Artillery resistance for all classes
** Grenadier with Health Upgrade can no longer survive a direct high-explosive artillery shell hit.
==== Research ====
* Plasma Heavy Machine Gun
** Reduced Time from 90 to 60
** Reduced Cost from 360 to 240

== 2.34.2 ==
'''Release: (2022/01/23)'''
=== Bug fixes ===
* Fixed a code typo which was causing a bug with explosion damage, meaning double damage could occur to vehicles.
* Fixed a few issues relating to checking a player's team for displaying icons on the minimap. Sometimes player icons wouldn't display even though they should.
* Fixed building smoke not calling StopEmission if the particle system is in a sleep state. (IE not being rendered but inside the player's potential visible set)
** What this essentially means is that building smoke will continue to change state and even when you're not looking at the building. Previously you could look away from the building, turn around and notice smoke is still there for a few frames; despite the building being repaired while you weren't looking.
* Fixed a typo in vehicle_armor script for BulletExplosiveResist value.

=== Script/Game Balance ===
* Lowered Plasma Heavy Machine gun's minimum damage from 10 -> 8 (It previously had no damage falloff.)

== 2.34.1 ==
'''Release: (2022/01/16)'''
=== Features ===
* Added cvar "emp_sv_drop_cooked_grenades", this is disabled by default until some gameplay testing can be conducted and feedback gathered.
** Causes grenades to drop when players die if they had already pulled the pin out. (Excluding mines)

=== Bug fixes ===
* Fixed an issue with e-repair preventing mines from being defused inside a damaged friendly building.
* Fixed an issue that was preventing wall gibs from spawning when destroyed. This was caused by a bug fix last patch.
* Fixed an issue that prevented the commander wall limit from functioning correctly.
* Fixed an bug relating to removal of attack targets on a player entering command view or a player entering scout hide. Both actions now remove targets instantly.
* Fixed some issues with how mines are triggered/detonated. Previous to this change, mines would detonate if a vehicle's "absbox" overlapped the mine bounding box. The problem with this is that the "absbox" is calculated every frame and doesn't rotate, it grows in size to encapsulate it's target. This lead to situations where a vehicle that wasn't perfectly aligned to the world origin would have a greater chance of triggering surrounding mines. The new system should be a lot more accurate and result in less frustration/guess work when trying to avoid mines.
* Fixed some issues relating to tanks receiving damage:
** Physics impact damage on tanks no longer prevents repair stations from repairing your tank. It would often be the case that a small bump when trying to enter the repair station would trigger the repair delay, this damage type is now filtered out of this feature. (For reference the delay is 10 seconds, so this can be quite frustrating for the driver.)
** Tanks no longer trigger the repair delay if they didn't actually take any damage from the entity trying to damage it. Previous to this change you could use a weapon that doesn't deal damage to delay a tank from repairing. This has long been an issue and the feature should now work as intended. (As an example, bullets can no longer delay a tank trying to use a repair station.)
** Fixed some issues where damage was being mis-attributed to players with regards to calculating assists/critical assists.
** Fixed an issue with tank turrets not transferring damage to the hull appropriately.
*** Fixed an issue with tanks taking explosion damage from the turret first, despite the hull being closer; resulting in a damage reduction. This will mostly impact gameplay when explosions occur on the top surface of tanks, they will now deal the expected amount of damage without a drop in damage. Explosions now prioritise dealing maximum possible damage in this situation, in terms of possible falloff reductions etc. This is likely going to have a bigger impact on chassis where the turret is often in the line of sight of explosions; for example NF light tanks, where the turret is easier to hit because it's shorter.
** Removed some code which was trying to prevent two sets of the same damage applying to vehicles per frame, this was added to prevent a vehicle's turret from transferring duplicate damage. This was crudely implemented and was preventing damage from occurring in certain situations.

=== Script/Game Balance ===
==== Command Vehicle ====
* Reduced the Heat to Damage Absorbed on the Command Vehicle's armor by half.
* Increased Max Speed from 25 to 30 mph.
==== General Balance Changes ====
* Removed the hard-coded variable damage on mines.
** It was previously written in code that mines would deal double damage if triggered by a vehicle. This has been removed because the damage resistance system should have been utilized to ensure that everything in the explosion radius was receiving the expected amount of damage. With the old method, it meant that everything in the explosion radius would receive double damage if the mine had been detonated by a vehicle.
* Removed the hard-coded variable damage on explosive sticky grenades.
** It was previously written in code that sticky grenades would deal double damage to all vehicles except the command vehicle. Again, this has been removed because the damage resistance system should have been utilized to ensure that everything in the explosion radius was receiving the expected amount of damage. With the old method, it meant that everything in the explosion radius would receive double damage if the grenade had been attached to a vehicle (Excluding CV).
** Damage resistances have been adjusted to compensate in the scripts.
* Added a new script variable for use with vehicle armors "Flat Damage Reduction". This change is to give reactive more of a unique identity, being quite resistant early game but being less effective as the game progresses and the enemy unlocks stronger weapons.
** Reactive now has a flat damage reduction of 5. (Resistances have been adjusted to ensure all anti-vehicle machine guns deal damage.)
** Reactive now has 120 HP per plate instead of 135.
** Composite now has a flat damage reduction of 1.

[[Category:Patch_Notes]]

Dedicated Server Setup

2022-04-28T16:46:24Z

Neoony:

{{Sitenav|Dedicated Server Setup}}

== Dedicated Server (Linux) ==
Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 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 
{|
|-
|[[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.''' 
 
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): [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD].
*Open a command line window with elevated / local administrator privileges and browse to the location of the update tool.
*Update syntax example:

<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>

*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):
* [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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* https://pastebin.com/SXsp0r2F

File:Dedicated server nonfree.png

2022-04-28T16:13:03Z

Neoony:

Dedicated Server Setup

2022-04-22T16:39:58Z

Neoony:

{{Sitenav|Dedicated Server Setup}}

== Dedicated Server (Linux) ==
Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 32 bit Debian 10]. If you have a 64 bit install you might need to execute the following as root:

29-01-2022 update: Ideally start with Debian 10 x64 (11 will be a trouble as some stuff is deprecated)

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

To install the server, execute the following in a root shell:

apt-key add - <<-KEY
-----BEGIN PGP PUBLIC KEY BLOCK-----

mQGNBFw/ZjgBDAC78OjFtCcWQuh0d6YpVu/kfr/qibzAwP13bl3o1FTGha2i/dOo
XdWvnbDDcRmZ7aJjr4aUIbjLbpEGYVrcX8+0kBYbcbmwJWPjfWg0/RyS0Jk+yXD+
DcUrWQC1Ib31zTW8QeoEmuD48H2QBuX3jMCAT+8ThsdkAbzkyEbc7AHDsRsZLDQ9
uKrZGvMpi2Q9T3kKLNAOlYux92sgdP+kvBJ2/lFUm+yZzNwWfdmLiMSseALUtkeh
ERkRwS0a4bEcL1+Yd32RNa5WxoIVXimAxzTAQ+aIIrpOzkQwzxwA7HKyYhd6jj1p
VfVa2Q8PrinJN+a10uFK1m/c5IUOwEsTbM+45hkZTxN1+ZO51OU+JvjYmcCJzKC0
wlKBeG0t9SHZZ/3v5bJHinbvXu4j2oSgr2kuBNvqBT3AxZk/MVojxAhnu+X23/TT
7rEDaCzVz8s16pYRJZjBvVk7INq5b2WCRFlhwEDekf3ThhNhwTbbatrKBpXbVb+R
11Z1KexuW7F6jOkAEQEAAbQnTWF4IE1hdG9uIChwYWNrYWdlcykgPGluZm9AbWF4
bWF0b24ubmw+iQHUBBMBCgA+FiEEpOkWittoxBWISDs56eNqER324vYFAlw/ZjgC
GwMFCQPCZwAFCwkIBwIGFQoJCAsCBBYCAwECHgECF4AACgkQ6eNqER324vZphwv+
NYtOnJBoas1xGxAMQqeAMPPFuXbgXRcoXB/mZZWWw3o4VIjzz9/WietFDEHasyuW
2F2S/m611UM4uVH2cir3Rya/Wdwj0qBaoRxWdNskBhBqHIhJYNFp2VJu4HJ5iCft
PjJEuHklittEyoBjz6T5p/kcsd9ado9uZ9HBU6479R+Kwe68Srud5xqruhDUAP67
9UYQI94prvia40YTC2wCO4OXgNL9E2klGi2/kb1oVgIuDSBrgWwwf0E1oEorsCgI
iN46WLrXJhlKZS4WbrBMNgzYyWGlXi1ZTIRIbuaG0wI9ZuzN4lyeGJUIr8l+2uv8
F2OWsAojvGu47OOlIPhRLO/jWNkP8fuTQlXdn1FpFWZ8LNMPCCzPWZABJo2JTCrd
2mQMWomqXdWwdG4BZJMOymnANXQoVEon5G5IN3c1RLj5m6CvLAExEBQjlJAH3KLz
s420vrM0ri9n3GSapbEsxVdh06fN9XW1axcvK5hg7XaS5aVikVVUF5HO0rgzrMcQ
uQGNBFw/ZjgBDADpn57P38WtDkj7ZM7jTV0ROOjvOioLryT7haJsJ4TKaLfa8Oet
y2bbf8x9CfQqVyNK3OyxYRxpYVkvhnNin+Bu5EkfMMcmOvU2ltkYaRI/yY/MlzJp
Nt5uVrBmw1ledrRFAuwaLmSKD3qPf3PqE/pm0ElWT2VO/ALAdqwg70voiEb5PnWL
bqbpVzc7M0GoLXQcC1vvT6adbtMAJeUsN2GAy599uhF8gFMHSHX6KHASQ9m9wIAe
zawSZcf/8bTGBeNYnuditVoPZMVyfEkjgc+grkQaQPJZn1Vxs7abE2HDnPuElzRH
ZTdmnnxqBCP3M7lU3yuxKl7uGfxs4P/8XnJxplsBC98iIrKf71zOshZb5/9KxOTa
1xwGU2B7L2UU3pxO1YHYISD1QmIziQ8LE2n/vv0Drw9aoSHaIQIMowXeuZWSwahE
mCuYoCWzBiVVN3tQzkW2BhZLVFb7UhhxWlZgQa3wscZkZtqwEi40yGq7a+JUWu5Q
H+AygLFlgrXU0LkAEQEAAYkBvAQYAQoAJhYhBKTpForbaMQViEg7OenjahEd9uL2
BQJcP2Y4AhsMBQkDwmcAAAoJEOnjahEd9uL2vCIL/A5lhwHGevts6rWGDrGO0fOG
noRVED9aU+hS2VaWr6x2mC/PuNiw1rz9UDRml6um8KVU7fh8+Z/lTJwnBo3dHwIz
UWIwnQ1zaFsjzlxK7FK2bATJlM+g1TYhmyB3GAd7seLLxa5IB7k8bfYNYXYeZvJw
i0/sG9uTwilbVzl2n+BFrliXOGw9fJKzP48LfLUuBEn6usRxjIMdXzEH7WhOsZFZ
AMmQOn6sfOieyoYjY1XVSXG01Y8UEm0wTHDG9ulotTn+BuVF8x4Ofb2WKOn/baP3
R5BOd68Mea6pxHmwxd2BkHZvTyTTQndXOFqF7N0w1J+avxfXZnzlCtduCWg3k7mz
TenRhxINtvVt6XIIP4M5SytU/R0TcI0PQCbkFXEMOPC6ov/ASCMFc9YUYz3LujqS
uuxOfdtSD/BkggL5dB+vNN4hWXZ4klPvSUWj1+qsgD5lWse3rODxuU6sTF1e3jzG
GKcQ8Ze2ZfnnVeyoSma/Y0ygxUAkamS7I8pLJvdIrg==
=g0Xa
-----END PGP PUBLIC KEY BLOCK-----
KEY
echo 'deb http://deb.maxmaton.nl/debian buster main non-free' > /etc/apt/sources.list.d/maxmaton.list
apt update --allow-insecure-repositories
apt install empires-server

Note:
--allow-insecure-repositories is a temporary measure (Need to update this)

On Debian 10 x64 (maybe even 9) you will also need to add non-free to each repository
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
After that you can continue with:
apt update --allow-insecure-repositories
apt install empires-server
You might also need to manually port forward (it should be automatic with UFW, but on last try 29-01-2022 it was not for some reason)
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)

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): [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD].
*Open a command line window with elevated / local administrator privileges and browse to the location of the update tool.
*Update syntax example:

<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>

*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):
* [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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* https://pastebin.com/SXsp0r2F

Dedicated Server Setup

2022-04-22T16:36:10Z

Neoony:

{{Sitenav|Dedicated Server Setup}}

== Dedicated Server (Linux) ==
Installing a dedicated server is supported on [https://www.debian.org/CD/netinst/ 32 bit Debian 10]. If you have a 64 bit install you might need to execute the following as root:
29-01-2022 update: Ideally start with Debian 10 x64 (11 will be a trouble as some stuff is deprecated)

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

To install the server, execute the following in a root shell:

apt-key add - <<-KEY
-----BEGIN PGP PUBLIC KEY BLOCK-----

mQGNBFw/ZjgBDAC78OjFtCcWQuh0d6YpVu/kfr/qibzAwP13bl3o1FTGha2i/dOo
XdWvnbDDcRmZ7aJjr4aUIbjLbpEGYVrcX8+0kBYbcbmwJWPjfWg0/RyS0Jk+yXD+
DcUrWQC1Ib31zTW8QeoEmuD48H2QBuX3jMCAT+8ThsdkAbzkyEbc7AHDsRsZLDQ9
uKrZGvMpi2Q9T3kKLNAOlYux92sgdP+kvBJ2/lFUm+yZzNwWfdmLiMSseALUtkeh
ERkRwS0a4bEcL1+Yd32RNa5WxoIVXimAxzTAQ+aIIrpOzkQwzxwA7HKyYhd6jj1p
VfVa2Q8PrinJN+a10uFK1m/c5IUOwEsTbM+45hkZTxN1+ZO51OU+JvjYmcCJzKC0
wlKBeG0t9SHZZ/3v5bJHinbvXu4j2oSgr2kuBNvqBT3AxZk/MVojxAhnu+X23/TT
7rEDaCzVz8s16pYRJZjBvVk7INq5b2WCRFlhwEDekf3ThhNhwTbbatrKBpXbVb+R
11Z1KexuW7F6jOkAEQEAAbQnTWF4IE1hdG9uIChwYWNrYWdlcykgPGluZm9AbWF4
bWF0b24ubmw+iQHUBBMBCgA+FiEEpOkWittoxBWISDs56eNqER324vYFAlw/ZjgC
GwMFCQPCZwAFCwkIBwIGFQoJCAsCBBYCAwECHgECF4AACgkQ6eNqER324vZphwv+
NYtOnJBoas1xGxAMQqeAMPPFuXbgXRcoXB/mZZWWw3o4VIjzz9/WietFDEHasyuW
2F2S/m611UM4uVH2cir3Rya/Wdwj0qBaoRxWdNskBhBqHIhJYNFp2VJu4HJ5iCft
PjJEuHklittEyoBjz6T5p/kcsd9ado9uZ9HBU6479R+Kwe68Srud5xqruhDUAP67
9UYQI94prvia40YTC2wCO4OXgNL9E2klGi2/kb1oVgIuDSBrgWwwf0E1oEorsCgI
iN46WLrXJhlKZS4WbrBMNgzYyWGlXi1ZTIRIbuaG0wI9ZuzN4lyeGJUIr8l+2uv8
F2OWsAojvGu47OOlIPhRLO/jWNkP8fuTQlXdn1FpFWZ8LNMPCCzPWZABJo2JTCrd
2mQMWomqXdWwdG4BZJMOymnANXQoVEon5G5IN3c1RLj5m6CvLAExEBQjlJAH3KLz
s420vrM0ri9n3GSapbEsxVdh06fN9XW1axcvK5hg7XaS5aVikVVUF5HO0rgzrMcQ
uQGNBFw/ZjgBDADpn57P38WtDkj7ZM7jTV0ROOjvOioLryT7haJsJ4TKaLfa8Oet
y2bbf8x9CfQqVyNK3OyxYRxpYVkvhnNin+Bu5EkfMMcmOvU2ltkYaRI/yY/MlzJp
Nt5uVrBmw1ledrRFAuwaLmSKD3qPf3PqE/pm0ElWT2VO/ALAdqwg70voiEb5PnWL
bqbpVzc7M0GoLXQcC1vvT6adbtMAJeUsN2GAy599uhF8gFMHSHX6KHASQ9m9wIAe
zawSZcf/8bTGBeNYnuditVoPZMVyfEkjgc+grkQaQPJZn1Vxs7abE2HDnPuElzRH
ZTdmnnxqBCP3M7lU3yuxKl7uGfxs4P/8XnJxplsBC98iIrKf71zOshZb5/9KxOTa
1xwGU2B7L2UU3pxO1YHYISD1QmIziQ8LE2n/vv0Drw9aoSHaIQIMowXeuZWSwahE
mCuYoCWzBiVVN3tQzkW2BhZLVFb7UhhxWlZgQa3wscZkZtqwEi40yGq7a+JUWu5Q
H+AygLFlgrXU0LkAEQEAAYkBvAQYAQoAJhYhBKTpForbaMQViEg7OenjahEd9uL2
BQJcP2Y4AhsMBQkDwmcAAAoJEOnjahEd9uL2vCIL/A5lhwHGevts6rWGDrGO0fOG
noRVED9aU+hS2VaWr6x2mC/PuNiw1rz9UDRml6um8KVU7fh8+Z/lTJwnBo3dHwIz
UWIwnQ1zaFsjzlxK7FK2bATJlM+g1TYhmyB3GAd7seLLxa5IB7k8bfYNYXYeZvJw
i0/sG9uTwilbVzl2n+BFrliXOGw9fJKzP48LfLUuBEn6usRxjIMdXzEH7WhOsZFZ
AMmQOn6sfOieyoYjY1XVSXG01Y8UEm0wTHDG9ulotTn+BuVF8x4Ofb2WKOn/baP3
R5BOd68Mea6pxHmwxd2BkHZvTyTTQndXOFqF7N0w1J+avxfXZnzlCtduCWg3k7mz
TenRhxINtvVt6XIIP4M5SytU/R0TcI0PQCbkFXEMOPC6ov/ASCMFc9YUYz3LujqS
uuxOfdtSD/BkggL5dB+vNN4hWXZ4klPvSUWj1+qsgD5lWse3rODxuU6sTF1e3jzG
GKcQ8Ze2ZfnnVeyoSma/Y0ygxUAkamS7I8pLJvdIrg==
=g0Xa
-----END PGP PUBLIC KEY BLOCK-----
KEY
echo 'deb http://deb.maxmaton.nl/debian buster main non-free' > /etc/apt/sources.list.d/maxmaton.list
apt update --allow-insecure-repositories
apt install empires-server

Note:
--allow-insecure-repositories is a temporary measure (Need to update this)
On Debian 10 x64 (maybe even 9) you will also need to add non-free to each repository
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
After that you can continue with:
apt update --allow-insecure-repositories
apt install empires-server
You might also need to manually port forward (it should be automatic with UFW, but on last try 29-01-2022 it was not for some reason)
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)

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): [https://developer.valvesoftware.com/wiki/SteamCMD SteamCMD].
*Open a command line window with elevated / local administrator privileges and browse to the location of the update tool.
*Update syntax example:

<pre>
steamcmd.exe +login anonymous +app_update 460040 validate +quit
</pre>

*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):
* [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.

Both systems themselves run on [http://www.sourcemm.net/ 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:

<pre>
rcon exec tankwars.cfg
</pre>

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:

<pre>
emp_allowspectators 0; wait 30000; emp_allowspectators 1
</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.

== 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.

<pre>
steamcmd.exe +login anonymous +app_update 460040 -beta beta validate +quit
</pre>

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 ==
* [http://server.counter-strike.net/server.php?cmd=cmdall General HL2 Directives/Commands]
* [http://www.sourcemod.net/ SourceMod]
* https://pastebin.com/SXsp0r2F

Map:emp oktay

2022-04-22T16:32:21Z

Neoony: Created page with "{{Sitenav|Maps > emp_oktay }} Minimap of emp_oktay ==Overview== emp_oktay '''Starting Refineries:''' TBD '''Star..."

{{Sitenav|[[Maps]] > emp_oktay }}
[[Image:emp_oktay_beta3 minimap.png|thumb|right|250px|Minimap of emp_oktay]]

==Overview==
emp_oktay

'''Starting Refineries:''' TBD

'''Starting Resources:''' TBD

'''Refineries:''' TBD

'''Total Amount of Resources:''' TBD

'''Tickets:''' TBD

== Commander Strategies ==
== Points of Interest ==

[[Category:Maps|oktay]]
[[Category:Commander_maps|oktay]]

File:Emp oktay beta3 minimap.png

2022-04-22T16:32:04Z

Neoony:

Map:emp fury

2022-04-22T16:25:22Z

Neoony: Created page with "{{Sitenav|Maps > emp_fury }} Minimap of emp_fury ==Overview== emp_fury '''Starting Refineries:''' TBD '''Starting R..."

{{Sitenav|[[Maps]] > emp_fury }}
[[Image:emp_fury_rc2 minimap.png|thumb|right|250px|Minimap of emp_fury]]

==Overview==
emp_fury

'''Starting Refineries:''' TBD

'''Starting Resources:''' TBD

'''Refineries:''' TBD

'''Total Amount of Resources:''' TBD

'''Tickets:''' TBD

== Commander Strategies ==
== Points of Interest ==

[[Category:Maps|fury]]
[[Category:Commander_maps|fury]]

File:Emp fury rc2 minimap.png

2022-04-22T16:23:46Z

Neoony:

Editing entities without recompiling whole map

2021-04-14T18:35:20Z

Neoony: Created page with "===Editing entities without recompiling whole map=== e.g. to fix vehicle ids or loadouts https://imgur.com/a/RJcHCma"

===Editing entities without recompiling whole map===
e.g. to fix vehicle ids or loadouts
https://imgur.com/a/RJcHCma

Mapping Tutorials

2021-04-14T18:29:10Z

Neoony:

{{MappingDocumentation}}

==Beginner==
*[[Basic Classic Map]]
*[[Basic Conquest Map]]
*[[Resource nodes|Resource Nodes]]
*[[Flag Maps]]
*[[Engineer-Buildable Objects]]
*[[Releasing a Map]]

==Intermediate==
* [[Multi-Part Buildables]]
* [[Adding A Timelimit]]
* [[Custom map particles]]
* [[Editing entities without recompiling whole map]]

[[Category: Mapping]]

Mapping

2021-04-14T18:20:55Z

Neoony:

{{MappingDocumentation}}
__NOTOC__
==Overview==
From a technical standpoint, mapping for Empires is very much the same as mapping for any other Source game or mod, but with a collection of additional, necessary entities. The mapping section of the Empires Wiki will explain how to configure the Source SDK for Empires, and offer additional learning resources with which to get started.

From a gameplay standpoint, mapping for Empires is very different from mapping for other Source games or mods. Empires maps are predominantly larger than those of other games and mods. Most often, Empires maps are nearly as large as the Source engine will allow. Optimization is more stringent in both limitations on mappers and requirements of maps.

There are two types of maps common to Empires: ''classic maps'' and ''conquest maps'', each entailing a unique style of gameplay.

===Classic Maps===
Classic maps are the flagship maps which champion the core gameplay that Empires was built to provide. Each team has a commander, and some sort of starting base (be it a barracks or an arbitrary spawn point). The teams must venture out, take control of territories for resources or strategic vantage. A commander views the battlefield from above and leads the team in the completion of its objectives. Some classic maps include capture point objectives (flags, most often) to create a hybrid style of play, where building refineries is mixed with capturing points that offer resources or some other territorial benefit, such as a spawnpoint, ammo/health crate, or layout-changing event.

===Conquest Maps===
Conquest maps segment Empires gameplay by removing the command vehicles from each team. Each team must venture forward to capture objectives and control territories. Conquest maps can involve standalone infantry or a combination of infantry and vehicles.

===Editing entities without recompiling whole map===
e.g. to fix vehicle ids or loadouts
https://imgur.com/a/RJcHCma

==Other Resources==
*[http://developer.valvesoftware.com/ Valve Developer Wiki]
**[http://developer.valvesoftware.com/wiki/Category:Level_Design Level Design]
**[http://developer.valvesoftware.com/wiki/Category:Entities Entities]
**[http://developer.valvesoftware.com/wiki/Category:Hammer Hammer Editor Documentation]
*[http://interlopers.net/index.php?page=tutorials Interlopers Tutorials]
*[http://halfwit-2.com/?page=tutorials Halfwit-2 Tutorials]

[[Category: Mapping]]

Mapping

2021-04-14T18:08:23Z

Neoony: /* Fixing vehicle loadouts */

Mapping

2021-04-14T16:45:38Z

Neoony:

{{MappingDocumentation}}
__NOTOC__
==Overview==
From a technical standpoint, mapping for Empires is very much the same as mapping for any other Source game or mod, but with a collection of additional, necessary entities. The mapping section of the Empires Wiki will explain how to configure the Source SDK for Empires, and offer additional learning resources with which to get started.

From a gameplay standpoint, mapping for Empires is very different from mapping for other Source games or mods. Empires maps are predominantly larger than those of other games and mods. Most often, Empires maps are nearly as large as the Source engine will allow. Optimization is more stringent in both limitations on mappers and requirements of maps.

There are two types of maps common to Empires: ''classic maps'' and ''conquest maps'', each entailing a unique style of gameplay.

===Classic Maps===
Classic maps are the flagship maps which champion the core gameplay that Empires was built to provide. Each team has a commander, and some sort of starting base (be it a barracks or an arbitrary spawn point). The teams must venture out, take control of territories for resources or strategic vantage. A commander views the battlefield from above and leads the team in the completion of its objectives. Some classic maps include capture point objectives (flags, most often) to create a hybrid style of play, where building refineries is mixed with capturing points that offer resources or some other territorial benefit, such as a spawnpoint, ammo/health crate, or layout-changing event.

===Conquest Maps===
Conquest maps segment Empires gameplay by removing the command vehicles from each team. Each team must venture forward to capture objectives and control territories. Conquest maps can involve standalone infantry or a combination of infantry and vehicles.

===Fixing vehicle loadouts===
https://imgur.com/a/RJcHCma

==Other Resources==
*[http://developer.valvesoftware.com/ Valve Developer Wiki]
**[http://developer.valvesoftware.com/wiki/Category:Level_Design Level Design]
**[http://developer.valvesoftware.com/wiki/Category:Entities Entities]
**[http://developer.valvesoftware.com/wiki/Category:Hammer Hammer Editor Documentation]
*[http://interlopers.net/index.php?page=tutorials Interlopers Tutorials]
*[http://halfwit-2.com/?page=tutorials Halfwit-2 Tutorials]

[[Category: Mapping]]

Sourcemod Plugins

2021-04-01T19:53:09Z

Neoony:

{{Sitenav|Sourcemod Plugins}}

=Empires Specific Plugins=
Empires has a few specific plugins coded by members of its community, you can find them on [https://git.empiresmod.com/sourcemod Empires' Gitlab].
==Draftpick==
[[Draftpick]] is a [[Sourcemod]] plugin by [[Mikleo]], it is responsible for automatically balancing the players between teams using statistics gathered by [[Empstats]]. It includes four types of Draft.
==Empfun==
[[Empfun]] is a [[Sourcemod]] plugin by [[Mikleo]], it adds a way to manipulate entities within the game and create custom scenarios.
==Empstats==
[[Empstats]] is a [[Sourcemod]] plugin by [[Mikleo]], it tracks various statistics.
==Emputils==
[[Emputils]] is a [[Sourcemod]] plugin by [[Mikleo]], it contains various utilities to be used by other plugins.
==EventTimeleftHostname==
[[EventTimeleftHostname]] is a [[Sourcemod]] plugin by <> and updated for Empires by [[Neoony]], it allows server owners to display a countdown in their server's title.
==Lawlietstats==
[[Lawlietstats]] is a [[Sourcemod]] plugin by [[Lawliet]], it collects various informations.
==Lobby==
[[Lobby]] is a [[Sourcemod]] plugin by [[Neoony]], it controls the Lobby Server.
==NoCommExtendVote==
'''No Commander Extend Vote''' or [[NCEV]] for short is a [[Sourcemod]] plugin by [[Neoony]], it automatically detects commanders and only allows the game to start if both teams have a commander. 
==PugPlugin==
==ResearchInfo==
[[ResearchInfo]] is a [[Sourcemod]] plugin by [[Neoony]], gives a chat command to show what your team has researched in console. Unstable and unfinished. WIP
==sameIPBlock==
[[sameIPBlock]] is a [[Sourcemod]] plugin by [[Neoony]], only allows players to join from unique IP address.
==SourcemodOffsets==
[[SourcemodOffsets]] is a [[Sourcemod]] plugin by [[Neoony]], it automatically updates the sourcemod offsets required for Empires when they change.
==SquadControl==
[[Squadcontrol]] is a [[Sourcemod]] plugin by [[Mikleo]], it adds various utilities for Empires.
==Surrender==
[[Surrender]] is a [[SourceMod]] plugin by [[Neoony]], it allows players to trigger a vote to surrender which if successful destroys their [[Command Vehicle]]. 
==Updater==
[[Updater]] is a [[Sourcemod]] plugin by <> and updated for Empires by [[Neoony]], it allows servers to automatically update their plugins.
==Ungrief==
[[Ungrief]] is a [[Sourcemod]] plugin by [[Theowningone]] and updated by [[Neoony]], it allows admins to teleport the [[Command Vehicle]].
==Votetime==
[[Votetime]] is a [[Sourcemod]] plugin by [[Mikleo]], it adds commands to control the commander vote timer.
==vprofReport==
[[vprofReport]] is a [[Sourcemod]] plugin by [[Neoony]], automatically start "vprof" at certain number of clients on the server and then generates report when the round ends.
=Generic Plugins=
== End of Round AllTalk ==
Original Plugin: https://forums.alliedmods.net/showthread.php?p=1246351
== Chat Triggers ==
Plugin link: https://forums.alliedmods.net/showthread.php?p=585758 

== Advertisements 2.0 ==
Plugin link: https://forums.alliedmods.net/showthread.php?t=155705 
Simple advertisements plugin. It supports center, chat, hint, menu and top messages.
== SourceBans++ ==
Plugin link: https://sbpp.github.io/ 
Unofficial more updated version of SourceBans. 
-SourceBans++ is a majorly improved version of SourceBans 1.4.11 which was developed by GameConnect. 
Those major improvements include a new design, more stable web application, login via steam account and much more community made customizations. 
== SourceBot ==
''Original Plugin link:'' https://forums.alliedmods.net/showthread.php?p=883997 

== TeamSwitch ==
Plugin link: https://forums.alliedmods.net/showthread.php?p=587405 
This is a fully mod-independent team switching plugin, which gives an admin the ability to switch players to the opposite team either immediately, 
when they die, or at the end of the round (where appropriate). 
Players can also be switched to spectators. 
TeamSwitch detects which mod it is being run on at startup and configures itself accordingly. 

== Ultimate Mapchooser 3.4.5 ==
Plugin link: https://forums.alliedmods.net/showthread.php?t=134190 
Ultimate Mapchooser allows for increased control over map selection. This includes: 
* Random selection of the next map. 
* Which maps are added to votes 
* Which maps are available for nominations 
You can control how the randomization works by dividing your map rotation into groups, and controlling the weights of each group or each individual map, 
specify a minimum or maximum number of players allowed on the server for the map to be available, specify how many maps from a group are allowed in a vote, etc. 
EDIT: It seems the original version isnt working even with Creepers event fix for end of map votes. 
Here is cyberkillers version: https://github.com/CyberKiller/Ultimate-Mapchooser 
But it might be a little outdated... 

== Execute Configs ==
''Original Plugin link:'' https://forums.alliedmods.net/showthread.php?t=67620 
This plugin executes configs when there are either a certain amount of clients on, a certain event occurs, a certain round starts or when there are a certain amount of minutes left on the map. 
You can use this to disable alltalk above x clients, or to change the map when the timelimit hits, etc. 
'''More updated version (1.2.4) + added empires roundstart/gamestart events:''' https://git.empiresmod.com/sourcemod/executeconfigs