Skip to content

Commit

Permalink
readme cleanup and dockerfile param cleanup
Browse files Browse the repository at this point in the history
  • Loading branch information
Dzuelu committed Oct 31, 2023
1 parent 40d1afc commit a0c5971
Show file tree
Hide file tree
Showing 2 changed files with 17 additions and 18 deletions.
10 changes: 5 additions & 5 deletions Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -30,19 +30,19 @@ RUN apt-get update \
ENV LANG en_US.utf8
ENV PYTHONUNBUFFERED=1

ENV ARMA_BINARY=./arma3server
ENV ARMA_BINARY="./arma3server"
ENV ARMA_CDLC=
ENV ARMA_CONFIG=main.cfg
ENV ARMA_CONFIG="main.cfg"
ENV ARMA_LIMITFPS=1000
ENV ARMA_PARAMS=
ENV ARMA_PROFILE=main
ENV ARMA_WORLD=empty
ENV ARMA_PROFILE="main"
ENV ARMA_WORLD="empty"
ENV DEBUG=0
ENV FORCE_DOWNLOAD_WORKSHOP=0
ENV HEADLESS_CLIENTS=0
ENV PORT=2302
ENV STEAM_BRANCH_PASSWORD=
ENV STEAM_BRANCH=public
ENV STEAM_BRANCH="public"
ENV STEAM_PASSWORD=
ENV STEAM_USERNAME=
ENV STEAM_VALIDATE=1
Expand Down
25 changes: 12 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,34 +1,32 @@
# Docker Arma3 Server
An Arma3 Dedicated Server that can update Arma3 and mods on startup.
Allows for caching steam, Arma3, and mods install OR downloading any (or all) on startup.

A simple Arma3 Dedicated Server that can update Arma3 and workshop mods.
Allows for caching steam, Arma3, and workshop mods install OR downloading any (or all) on startup.


### Docker environment parameters
| Parameter | Required | Default | Description
| --- | --- | --- | ---
| ARMA_BINARY | N | ./arma3server | Arma 3 server binary to use, `./arma3server_x64` for x64
| ARMA_CDLC | N | | Creator DLC to load. [See](#creator-dlc)
| ARMA_CDLC | N | | Creator DLC to load. [See creator-dlc](#creator-dlc)
| ARMA_CONFIG | N | main.cfg | Config file to load from `/arma3/configs`
| ARMA_LIMITFPS | N | 1000 | Maximum server FPS
| ARMA_PARAMS | N | | Extra parameters given to server and any headless clients
| ARMA_PROFILE | N | main | Profile name, stored in `/arma3/configs/profiles`
| ARMA_WORLD | N | empty | World to load on startup
| DEBUG | N | 0 | Output debug messages including commands run
| FORCE_DOWNLOAD_WORKSHOP | N | 0 | Force re-download of workshop mods
| FORCE_DOWNLOAD_WORKSHOP | N | 0 | Force re-download of all workshop mods
| HEADLESS_CLIENTS | N | 0 | Launch n number of headless clients
| PORT | N | 2302 | Port used by the server, (uses PORT to PORT+3)
| STEAM_BRANCH | N | public | Steam branch code to download. [See](https://community.bistudio.com/wiki/Arma_3:_Steam_Branches)
| STEAM_BRANCH | N | public | Steam branch code to download. [See wiki](https://community.bistudio.com/wiki/Arma_3:_Steam_Branches)
| STEAM_BRANCH_PASSWORD | N | | Password for Steam branch code
| STEAM_PASSWORD | Y | | Steam user password
| STEAM_USERNAME | Y | | Steam user used to login to steamcmd
| STEAM_USERNAME | Y | | Steam user used to login to steamcmd, must own Arma3.
| STEAM_VALIDATE | N | 1 | Validates files after Steam download
| WORKSHOP_MODS | N | | URL or file path to load mods

The Steam account needs to own Arma3 to be able to download Steam workshop mods.
TODO: Look into and possibly use instead [steam managegameservers](https://steamcommunity.com/dev/managegameservers).


### Docker directory parameters
### Directories used
| Directory | Description
| --- | ---
| /steamcmd | Steam cmd executable (not steam install)
Expand All @@ -45,16 +43,17 @@ For a smaller storage space, add all the other volumes under `/arma3/` directory

### Creator DLC
To use a Creator DLC the `STEAM_BRANCH` must be set to `creatordlc` and
then set `ARMA_CDLC` environment variable to the CDLC class name(s) [found here](https://community.bistudio.com/wiki/Category:Arma_3:_CDLCs)
then set `ARMA_CDLC` environment variable to the CDLC class name(s) [found in wiki](https://community.bistudio.com/wiki/Category:Arma_3:_CDLCs)
separated by `;`.

Example: `-e ARMA_CDLC=csla;gm;vn;ws`


### Steam workshop mods
The script will check for any workshop mod updates on startup and only download what is out of date.
Place the mod list html exported by the launcher anywhere in the `/arma3/` directory and add the path to `WORKSHOP_MODS` environment variable to load.

Place the mod list html exported by the launcher anywhere in the `/arma3/` directory and add the path to
`WORKSHOP_MODS` environment variable to load.
The script will also to lowercase the workshop mod file paths as arma3 paths need to be case sensitive.

### Headless Clients
Launch n number of headless clients when `HEADLESS_CLIENTS` environment variable is set.
Expand Down

0 comments on commit a0c5971

Please sign in to comment.