mirror of
https://github.com/GameServerManagers/LinuxGSM-Docs.git
synced 2025-01-09 04:17:28 +08:00
GitBook: [master] 2 pages modified
This commit is contained in:
Daniel Gibbs
gitbook-bot
parent
30d7af943f
commit
ef49199284
@ -10,60 +10,112 @@
|
||||
|
||||
[https://community.bistudio.com/wiki/Arma\_3\_Headless\_Client](https://community.bistudio.com/wiki/Arma_3_Headless_Client)
|
||||
|
||||
* Headless Client is used to offload AI calculations from the server.
|
||||
* Headless Client is used to off load AI calculations from the server.
|
||||
* Headless Client is integrated into game client and dedicated server executable \(Windows and Linux, use -client parameter\).
|
||||
* The server doesn't allow arbitrary connections from headless clients if you do not define the headless clients IPs in the server.cfg.
|
||||
* The server does not allow arbitrary connections from headless clients if you do not define the headless clients IPs in the server.cfg.
|
||||
|
||||
### Headless Client Setup and Usage
|
||||
|
||||
Starting up a headless client and having it connect to your server is easy, Creating a mission that uses the Headless Client is not.
|
||||
|
||||
> note: This guide handles the setup and connection ONLY.
|
||||
>
|
||||
{% hint style="info" %}
|
||||
This guide only handles the setup and connecting a headless client.
|
||||
{% endhint %}
|
||||
|
||||
> note: All references to `arma3server` are referring the script you use to start your server, not the server executable itself unless noted.
|
||||
|
||||
1. Create a [new server instance](../features/multiple-game-servers.md) using LinuxGSM `./linuxgsm.sh arma3server`. This will become the headless client instance. Rename the new instance to `arma3server-hc`.
|
||||
Create a [new server instance](../features/multiple-game-servers.md) using LinuxGSM `./linuxgsm.sh arma3server`. This will become the headless client instance and rename the new instance to `arma3server-hc`.
|
||||
|
||||
Edit the config file `lgsm/config-lgsm/arma3server-hc.cfg`.
|
||||
|
||||
Edit the `port=` increasing the number by a factor of 12 e.g 2303 becomes 2314.
|
||||
Change the `port=` increasing the number by a factor of 12 e.g 2303 becomes 2314.
|
||||
|
||||
Edit `parms=` changing it to the following.
|
||||
Update `startparameters=` changing it to the following.
|
||||
|
||||
```text
|
||||
parms="-client -connect=${ip}:${port} -password=CHANGEME"`
|
||||
startparmaters="-client -connect=${ip}:${port} -password=CHANGEME"
|
||||
```
|
||||
|
||||
Edit the game server config for the ARMA 3 server \(not the headless client\) `arma3server.server.cfg`. Add the headless client IP address to `headlessClients[]=`. If the headless client is on the same physical server as the ARMA 3 server then also add the IP it to `localClient[]=`.
|
||||
Edit the game server config of `arma3server` \(not the headless client\) `arma3server.server.cfg` and add the headless client IP address to `headlessClients[]=`. If the headless client is on the same physical server as the ARMA 3 server then also add the IP to `localClient[]=`.
|
||||
|
||||
> note: Do not use 127.0.0.1 as the IP address.
|
||||
|
||||
`headlessClients[]={"xxx.xxx.xxx.xxx"};
|
||||
localClient[]={xxx.xxx.xxx.xxx};` Navigate to your profile directory. By default `cd ~/.local/share/Arma\ 3\ -\ Other\ Profiles` and edit `Player.Arma3Profile` adding the line `battleyeLicense=1;`.
|
||||
|
||||
Start your server with `./arma3server start` Start your headless client with `./arma3server-hc start`.
|
||||
|
||||
Only a logged in admin can see the headless clients in the player menu on the server. The headless client will connect and automatically assume the first available headless client slot.
|
||||
|
||||
## Adding Mods
|
||||
|
||||
The following guide is a general process for getting mods to load with your server.
|
||||
|
||||
### Mods Directory
|
||||
|
||||
It is recommended you store all your mods in the `serverfiles/mods` directory
|
||||
|
||||
Any mod directories you download normally start with an `@` for example.
|
||||
{% hint style="warning" %}
|
||||
Do not use 127.0.0.1 as the IP address.
|
||||
{% endhint %}
|
||||
|
||||
```text
|
||||
@CBA_A3
|
||||
headlessClients[]={"1.2.3.4"};
|
||||
localClient[]={"1.2.3.4"};
|
||||
```
|
||||
|
||||
Navigate to your profile directory.
|
||||
|
||||
```text
|
||||
~cd ~/.local/share/Arma\ 3\ -\ Other\ Profiles
|
||||
```
|
||||
|
||||
edit `Player.Arma3Profile` and add the line `battleyeLicense=1;`.
|
||||
|
||||
Start your server with `./arma3server start`
|
||||
|
||||
Start your headless client with `./arma3server-hc start`.
|
||||
|
||||
Only an admin can see the headless clients in the player menu on the server. The headless client will connect and automatically assume the first available headless client slot.
|
||||
|
||||
## Mod Support
|
||||
|
||||
Arma 3 mods are managed using the [Steam Workshop](https://steamcommunity.com/app/346110/workshop/) or manual downloads.
|
||||
|
||||
### Adding Mods
|
||||
|
||||
Firstly, you need to select the mods you want to use from the [steam workshop](https://steamcommunity.com/app/346110/workshop/).
|
||||
|
||||
{% hint style="warning" %}
|
||||
Mods can cause your server to become unstable or may not be compatible with each other. It is a good idea to read the mods docs and/or speak with other experienced Arma3 admins.
|
||||
{% endhint %}
|
||||
|
||||
Here is a popular mod to get started:
|
||||
|
||||
* [CBA: Community Based Addons for Arma 3](https://steamcommunity.com/workshop/filedetails/?id=450814997)
|
||||
|
||||
Download the Mod using [https://steamworkshopdownloader.io/](https://steamworkshopdownloader.io/) the workshop id is `450814997`
|
||||
|
||||
Create a directory called `@cba_a3` in `serverfiles/mods`
|
||||
|
||||
```text
|
||||
serverfiles/mods/@cba_a3
|
||||
```
|
||||
|
||||
Copy the contents of the mod archive to the `@cba_a3` directory.
|
||||
|
||||
{% hint style="warning" %}
|
||||
Remember to check you have the correct user permissions once uploaded
|
||||
{% endhint %}
|
||||
|
||||
Copy the contents of the `@cba_a3/keys` directory to the server keys directory.
|
||||
|
||||
```text
|
||||
cp serverfiles/mods/@cba_a3/keys/* serverfiles/keys
|
||||
```
|
||||
|
||||
Add @cba\_a3 to the `mods=""` setting in the [LinuxGSM config](../configuration/linuxgsm-config.md).
|
||||
|
||||
```text
|
||||
mods="mods/@cba_a3"
|
||||
```
|
||||
|
||||
If you are adding multiple mods make sure you put a semicolon in between each mod.
|
||||
|
||||
```text
|
||||
mods="mods/@mod1;mods/@mod2"
|
||||
```
|
||||
|
||||
### Lower Case file names
|
||||
|
||||
ArmA 3 server requires that the mods possess all lowercase names. Since not all mods do this all files with uppercase letters will need or be converted. This can be done by using the following script.
|
||||
Arma 3 server requires that mods have lowercase names. Some mods do not do this and will need to have there file names converted to lowercase.
|
||||
|
||||
Run the script from the `mods` directory.
|
||||
This can be done by using the following script.
|
||||
|
||||
Run the script from the `serverfiles/mods` directory.
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
@ -85,46 +137,32 @@ do
|
||||
done
|
||||
```
|
||||
|
||||
Next, ensure that all the mods are listed in the LinuxGSM config. Ensuring that semicolons are escaped `\`.
|
||||
|
||||
```text
|
||||
mods="mods/@ace\;mods/@advancedrappelling\;mods/@advancedslingloading\;mods/@advancedtowing\;mods/@advancedurbanrappelling\;mods/@ares\;mods/@cba_a3\;mods/@rhsafrf\;mods/@rhsusaf"
|
||||
```
|
||||
|
||||
Start the server and check that your mods all have valid hashes.
|
||||
You should see something similar to the following in your `console` [log](../features/logging.md)file.
|
||||
You should see the "Community Base Addons" mod appear in your `console` [log](../features/logging.md)file.
|
||||
|
||||
```text
|
||||
1:21:05 ============================================================================================= List of mods ===============================================================================================
|
||||
1:21:05 modsReadOnly = true
|
||||
1:21:05 safeModsActivated = false
|
||||
1:21:05 customMods = true
|
||||
1:21:05 hash = '24A14A6F1715B508E4C140459CBB736444CA099C'
|
||||
1:21:05 hashShort = 'f9bc2cc3'
|
||||
1:21:05 name | modDir | default | origin | hash | hashShort | fullPath
|
||||
1:21:05 ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
|
||||
1:21:05 RHS: United States Forces | @rhsusaf | false | GAME DIR | 2f346300316ae1bee109888385a77be1921fc48b | 4c30ccd | /home/arma3server/serverfiles/mods/@rhsusaf
|
||||
1:21:05 RHS: Armed Forces of the Russian Federation | @rhsafrf | false | GAME DIR | a9f61612ce09e3eb050dddb477390bbdca8f6f96 | 86f4f4ea | /home/arma3server/serverfiles/mods/@rhsafrf
|
||||
1:21:05 Community Base Addons v3.0.0 | @cba_a3 | false | GAME DIR | 5e4d58da7d3525e9089577880a322b2e9ccf1767 | dc1227b1 | /home/arma3server/serverfiles/mods/@cba_a3
|
||||
1:21:05 Ares | @ares | false | GAME DIR | d69f08e52d5102394e3fb5ae0e62fd2cd8409b0c | e1c60454 | /home/arma3server/serverfiles/mods/@ares
|
||||
1:21:05 Advanced Urban Rappelling | @advancedurbanrappelling | false | GAME DIR | f89771ffb164eb32069350428c73bf5ace17fb12 | 7c4278a8 | /home/arma3server/serverfiles/mods/@advancedurbanrappelling
|
||||
1:21:05 Advanced Towing | @advancedtowing | false | GAME DIR | 3bbdd3d06fbdf74ef0197e92409a34c81edb10d5 | eb7c2b5d | /home/arma3server/serverfiles/mods/@advancedtowing
|
||||
1:21:05 Advanced Sling Loading | @advancedslingloading | false | GAME DIR | 1af4c6ff7f351b09ad5ef4513f3038d44a375117 | 9f2e7c81 | /home/arma3server/serverfiles/mods/@advancedslingloading
|
||||
1:21:05 Advanced Rappelling | @advancedrappelling | false | GAME DIR | 35c56daaba7164fbaadb24b5715caf9216189348 | 7029c1d8 | /home/arma3server/serverfiles/mods/@advancedrappelling
|
||||
1:21:05 Advanced Combat Environment 3.7.0 | @ace | false | GAME DIR | 1251197941f4565b6fddb807ccc6c88bfbb61113 | a66ef771 | /home/arma3server/serverfiles/mods/@ace
|
||||
1:21:05 Arma 3 DLC Bundle | dlcbundle | true | NOT FOUND | | |
|
||||
1:21:05 Arma 3 Apex | expansion | true | GAME DIR | ec40f8295ae63a8b823ae3fb2700b9118ff69072 | 231d7bbe | /home/arma3server/serverfiles/expansion
|
||||
1:21:05 Arma 3 Marksmen | mark | true | GAME DIR | a6ae777fb084f739dbdc84cb8a58c864e8fd5ad0 | f71c9869 | /home/arma3server/serverfiles/mark
|
||||
1:21:05 Arma 3 Helicopters | heli | true | GAME DIR | 5b05f65505b7a14ab34754fd014590de8a287023 | e55c01d5 | /home/arma3server/serverfiles/heli
|
||||
1:21:05 Arma 3 Karts | kart | true | GAME DIR | 18cd569ec6fa46f3db80faf3aa51a852874b2028 | 4a0232e1 | /home/arma3server/serverfiles/kart
|
||||
1:21:05 Arma 3 Zeus | curator | true | GAME DIR | 20a9850c01e340b360399c169fc3bb1cb8bf4dc7 | ee9ab146 | /home/arma3server/serverfiles/curator
|
||||
1:21:05 Arma 3 | A3 | true | NOT FOUND | | |
|
||||
1:21:05 ==========================================================================================================================================================================================================
|
||||
15:27:37 ============================================================================================= List of mods ===============================================================================================
|
||||
15:27:37 modsReadOnly = true
|
||||
15:27:37 safeModsActivated = false
|
||||
15:27:37 customMods = true
|
||||
15:27:37 hash = 'B44C8332DD951EC30619282DAC7A59519AA0BCB6'
|
||||
15:27:37 hashShort = '185e1b29'
|
||||
15:27:37 name | modDir | default | official | origin | hash | hashShort | fullPath
|
||||
15:27:37 ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
|
||||
15:27:37 Community Base Addons v3.15.3 | @cba_a3 | false | false | GAME DIR | fa100065ad10a6ab7a5e16d53efc2b26f3df3b58 | 7f1d8e45 | /home/lgsm/arma3server/serverfiles/@cba_a3
|
||||
15:27:37 Arma 3 Art of War | aow | true | true | GAME DIR | 93cf5270ce855921dcfd261c583983d4e0bb6899 | 2930da71 | /home/lgsm/arma3server/serverfiles/aow
|
||||
15:27:37 Arma 3 Contact (Platform) | enoch | true | true | GAME DIR | 61e8060b8dce2727f235695e59de01089546d9ad | 2dd9b92b | /home/lgsm/arma3server/serverfiles/enoch
|
||||
15:27:37 Arma 3 Tanks | tank | true | true | GAME DIR | 37296b3dd900117d055e6c13e1ce21e54cd8067b | dfc0778f | /home/lgsm/arma3server/serverfiles/tank
|
||||
15:27:37 Arma 3 Tac-Ops | tacops | true | true | GAME DIR | dec763aedfdc28eab838361370a48f2411535e5a | 70a109b7 | /home/lgsm/arma3server/serverfiles/tacops
|
||||
15:27:37 Arma 3 Laws of War | orange | true | true | GAME DIR | a786e1c2e7b3aec524cc1ce932039dc18da0351d | 128b066b | /home/lgsm/arma3server/serverfiles/orange
|
||||
15:27:37 Arma 3 Malden | argo | true | true | GAME DIR | b9edefa0cd211d0961282ce9b69eabeb59bda780 | 1954e272 | /home/lgsm/arma3server/serverfiles/argo
|
||||
15:27:37 Arma 3 Jets | jets | true | true | GAME DIR | cd6561bc9148fec23b136de7fa02bfbd71e12221 | 1f2e3b6f | /home/lgsm/arma3server/serverfiles/jets
|
||||
15:27:37 Arma 3 Apex | expansion | true | true | GAME DIR | 2d573cab31befb9729503ed00c211628c73622cc | e5ad6f6c | /home/lgsm/arma3server/serverfiles/expansion
|
||||
15:27:37 Arma 3 Marksmen | mark | true | true | GAME DIR | f0784723164eb212a22fa2d49e589bead97a9735 | 2d4eada7 | /home/lgsm/arma3server/serverfiles/mark
|
||||
15:27:37 Arma 3 Helicopters | heli | true | true | GAME DIR | 1af5847f6b557b98763dfdad7be3c32491cee65e | 873ada67 | /home/lgsm/arma3server/serverfiles/heli
|
||||
15:27:37 Arma 3 Karts | kart | true | true | GAME DIR | 5ebe4af2ae6777d560a14cf9e39d4ee3f852a75c | 3a3f5ff9 | /home/lgsm/arma3server/serverfiles/kart
|
||||
15:27:37 Arma 3 Zeus | curator | true | true | GAME DIR | 351bd6e8b13a4e8f514a173bf78dd949c899e107 | b6d4451 | /home/lgsm/arma3server/serverfiles/curator
|
||||
15:27:37 Arma 3 | A3 | true | true | NOT FOUND | | |
|
||||
15:27:37 ==========================================================================================================================================================================================================
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### "BattlEye initialization failed"
|
||||
|
||||
If you see this message while connecting to your server, try to open the port 2306 \(UDP\) in your firewall.
|
||||
|
||||
|
||||
@ -21,6 +21,7 @@ List of distros and there glibc version.
|
||||
| Debian 10 | 2.28 |
|
||||
| Ubuntu 16.04 LTS | 2.23 |
|
||||
| Ubuntu 18.04 LTS | 2.27 |
|
||||
| Ubuntu 20.04 LTS | 2.31 |
|
||||
|
||||
[distrowatch.com](http://distrowatch.com) is also a great source to find this information.
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user