Server Hosting – Arma Reforger
Pr9inichek (talk | contribs) m (→Linux Server: add info about LinuxGSM) |
Pr9inichek (talk | contribs) (→Linux Server: implemented this tutorial - https://discord.com/channels/105462288051380224/976119935875026964/1281596036565172306) |
||
Line 119: | Line 119: | ||
# Install SteamCMD - for the latest documentation, see {{Link|https://developer.valvesoftware.com/wiki/SteamCMD}} | # Install SteamCMD - for the latest documentation, see {{Link|https://developer.valvesoftware.com/wiki/SteamCMD}} | ||
## Download and install it (link on the {{Link|https://developer.valvesoftware.com/wiki/SteamCMD|SteamCMD}} page) - it will auto-update to the latest version | ## Download and install it (link on the {{Link|https://developer.valvesoftware.com/wiki/SteamCMD|SteamCMD}} page) - it will auto-update to the latest version | ||
## Set the install path with the {{hl|force_install_dir}} command (otherwise the default location will be used, {{hl| | ## Set the install path with the {{hl|force_install_dir}} command (otherwise the default location will be used, {{hl|home/<username>/.steam/steam/steamcmd}}) | ||
### You can name the folder ''arma-reforger, armaR, armarserver, armarexpserver'' and etc | |||
## Login as anonymous - type in {{hl|login anonymous}} | ## Login as anonymous - type in {{hl|login anonymous}} | ||
# Download and install the server {{hl|app_update 1874900}} | # Download and install the server {{hl|app_update 1874900}} | ||
## ''1890870'' for experimental version | |||
# Quit SteamCMD {{hl|quit}} | # Quit SteamCMD {{hl|quit}} | ||
Line 142: | Line 144: | ||
; Execution | ; Execution | ||
<syntaxhighlight lang="bash">steamcmd +runscript update_armar_ds.txt</syntaxhighlight> | <syntaxhighlight lang="bash">steamcmd +runscript update_armar_ds.txt</syntaxhighlight> | ||
==== With bash scripts ==== | |||
{{Feature|informative|Thanks to Marko for this tutorial}}1. Install SteamCMD<syntaxhighlight lang="bash">sudo apt install steamcmd</syntaxhighlight>2. create a directory lets say<code>armaR</code> somewhere, lets say<code>/home/<username>/armaR</code> | |||
3. in there create steam shell script that will install reforger server<code>steamShell.txt</code> with smthing like<syntaxhighlight lang="bash"> | |||
@ShutdownOnFailedCommand 1 | |||
login anonymous | |||
// Stable ID: 1874900 EXP: 1890870 | |||
app_update 1874900 validate | |||
quit | |||
</syntaxhighlight>4. then create bash script that will install/update game<code>steamInstall.sh</code> with:<syntaxhighlight lang="bash"> | |||
/usr/games/steamcmd +force_install_dir /home/<username>/armaR +runscript /home/<username>/armaR/steamShell.txt | |||
</syntaxhighlight>5. after that, server startup script<code>start.sh</code> with:<syntaxhighlight lang="bash"> | |||
// Install or Update game | |||
./steamInstall.sh | |||
//Start server | |||
./ArmaReforgerServer -config /home/<username>/.config/ArmaReforgerServer/config.json -profile /home/<username>/.config/ArmaReforgerServer -maxFPS 60 | |||
</syntaxhighlight>6. So the actual file tree will look something like this:<syntaxhighlight lang="bash"> | |||
/home/<username>/armaR | |||
steamShell.txt | |||
steamInstall.sh | |||
start.sh | |||
</syntaxhighlight>7. Then create actual<code>config.json</code> at<code>/home/<username>/.config/ArmaReforgerServer/config.json</code>, create folders if they don't exist | |||
8. Run<code>start.sh</code> this will install server, and start it. | |||
Console logs etc can be found in above mentioned profile folder, addons will also install there by default, you can again change that. | |||
You can also change profile/config directories as desired.{{Feature|informative|You can then create new service for systemctl to run start.sh and the thing will run in the background and auto restart after crashes etc}} | |||
=== LinuxGSM === | === LinuxGSM === |
Revision as of 06:02, 9 September 2024
Server Hosting is the fact of hosting a game instance accessible over the network to other players. There are two possible modes in Arma Reforger: player-hosted and dedicated.
Dedicated Server
A Dedicated Server is a server without any game instance launched; it purely processes game information and network synchronisation.
BattlEye
It is possible to modify BattlEye's RCon port and password by adding the following settings to Arma Reforger
RConPort 5678 RConPassword myNewBEPassword
Startup Parameters
See Startup Parameters - Hosting and the Server Config page for more information.
config
The Server exe uses the -config startup parameter to target the configuration file.
ArmaReforgerServer.exe -config ".\Configs\Campaign_SWCoast.json"
In above example, Campaign_SWCoast.json is expected to be locted in Configs folder next to the exe.
maxFPS
ArmaReforgerServer.exe -maxFPS 60
server
This parameter instructs the executable to launch local server and load selected world. When this parameter is used, config is ignored. Server parameter can be combined with addons and addonsDir parameters to start a server with local mods, which can be useful when testing addon before uploading it Workshop.
ArmaReforgerServer.exe -server "worlds/MP/MPTest.ent" -addonsDir "C:\MyModsDir" -addons MyCustomMod
Others
The below Startup Parameters are optional but may prove useful upon some cases:
- logStats - allows to log server's FPS every x milliseconds
- logLevel - sets the log detail level
- listScenarios - logs available scenario .conf file paths on startup
Configuration File
See Server Config.
Player-Hosted Server
Also known as Listen Server, a Player-Hosted Server is a server also hosting a local player. Such server is started from within the game, in Multiplayer > Host tab > Host new server.
Settings
The settings are all self-explanatory and Dedicated Server can be used.
Scenario Selection
Scenario and Source are two related fields:
- Scenario is the list of all available scenarios
- Source is a read-only field telling from which mod (or Arma Reforger) the selected Scenario is.
Crossplay
This option allows console players to join - see supportedGameClientTypes.
Mods
This tab allows to enable or disable local mods to make them available to the hosted game (or not). The Workshop is accessible from here.
Linux Server
The game server will by default use Docker container's IP for server browser registration and client connection which will cause failure during client connection attempt.
To avoid it use:
- Run the "ipconfig" command in cmd to list the local IPs
- "IP Connect" option in the server browser and insert one of the server's local IPs
- Custom server config (.json file) with "gameHostRegisterBindAddress" and "gameHostRegisterPort" parameters set to one of the local IP:Port combinations
Example:
-config "./My_Config.json" ClientConnectAddress 192.168.39.98
SteamCMD Setup
- Install SteamCMD - for the latest documentation, see https://developer.valvesoftware.com/wiki/SteamCMD
- Download and install it (link on the SteamCMD page) - it will auto-update to the latest version
- Set the install path with the force_install_dir command (otherwise the default location will be used, home
/<username> /.steam /steam /steamcmd) - You can name the folder arma-reforger, armaR, armarserver, armarexpserver and etc
- Login as anonymous - type in login anonymous
- Download and install the server app_update 1874900
- 1890870 for experimental version
- Quit SteamCMD quit
Example Script
- update_armar_ds.txt
Based on the SteamCMD page's example
// update_armar_ds.txt
//
@ShutdownOnFailedCommand 1
@NoPromptForPassword 1
force_install_dir ../armar_ds
login anonymous
app_update 1874900 validate
quit
- Execution
steamcmd +runscript update_armar_ds.txt
With bash scripts
1. Install SteamCMD
sudo apt install steamcmd
2. create a directory lets sayarmaR
somewhere, lets say/home/<username>/armaR
3. in there create steam shell script that will install reforger serversteamShell.txt
with smthing like
@ShutdownOnFailedCommand 1
login anonymous
// Stable ID: 1874900 EXP: 1890870
app_update 1874900 validate
quit
4. then create bash script that will install/update gamesteamInstall.sh
with:
/usr/games/steamcmd +force_install_dir /home/<username>/armaR +runscript /home/<username>/armaR/steamShell.txt
5. after that, server startup scriptstart.sh
with:
// Install or Update game
./steamInstall.sh
//Start server
./ArmaReforgerServer -config /home/<username>/.config/ArmaReforgerServer/config.json -profile /home/<username>/.config/ArmaReforgerServer -maxFPS 60
6. So the actual file tree will look something like this:
/home/<username>/armaR
steamShell.txt
steamInstall.sh
start.sh
7. Then create actualconfig.json
at/home/<username>/.config/ArmaReforgerServer/config.json
, create folders if they don't exist
8. Runstart.sh
this will install server, and start it.
Console logs etc can be found in above mentioned profile folder, addons will also install there by default, you can again change that.
You can also change profile/config directories as desired.
LinuxGSM
Alternatively, you can use this tool:
https://linuxgsm.com/servers/armarserver/
- It can monitor the game server by checking that the proccess is running and querying it. Should the server go offline LinuxGSM can restart the server and send you an alert. You can use cronjobs to setup monitoring.
- Update checks for any server updates and applies them. The server will update and restart only if required. This also needs to be set up on a schedule.
Docker Setup
- Install the latest Docker:
- Download and install Docker
- Enable Hyper-V in Windows if it is not already
- Assign HW resources in Docker
/Settings /Resources /Advanced: - CPU: 4 cores
- Memory: 6 GB
- Download Ubuntu 18.04 image via batch or powershell cmd: docker pull ubuntu:18.04
- Run Ubuntu image:
- mount volume with server data
- expose client connection UDP port
- Example: docker container run -t -d -p 2001:2001
/udp -v D:\server_data\linux_packed: /home /packed --name ubuntu_test ubuntu:18.04
- Connect to bash console: docker exec -it ubuntu_test
/bin /bash - Install necessary software:
- libcurl4 - required by server app
- net-tools - for debug purposes (enables ifconfig etc)
- Installation:
- apt-get update
- apt-get install libcurl4
- apt-get install net-tools
- apt-get install libssl1.1
- Create logs directory, e.g: mkdir
/home /profile - Run server:
- server executable needs proper execution/access rights:
- cd server_root_folder
- chmod +x ArmaReforgerServer
- Example: .
/ArmaReforgerServer -gproj . /addons /data /ArmaReforger.gproj -config Configs /ServerConfig /Campaign.json -backendlog -nothrow -profile /home /profile
- server executable needs proper execution/access rights: