Skip to content

LsHallo/ets2-dedicated-convoy-server

Repository files navigation

ETS2/ATS Convoy Multiplayer Dedicated Server

This docker container provides the new (as of Dec 2022) dedicated server for ETS2/ATS in a simple and complete package.
Easy to configure and use!

Contents

Running

Minimal example:

ETS2

docker run -d \
--name "ets2-server" \
--network host \
--restart unless-stopped \
-e "ETS_SERVER_NAME=My Server" \
lshallo/ets2-convoy-server

This minimal example will start the server with default settings and a custom name defined.

To use your own config see Mods


ATS

docker run -d \
--name "ats-server" \
--network host \
--restart unless-stopped \
-e "ETS_SERVER_NAME=My Server" \
lshallo/ats-convoy-server

This minimal example will start the server with default settings and a custom name defined.

To use your own config see Mods

Docker Compose

See docker-compose.yml.

Then use docker compose up -d to start the server.
You can check the logs with docker compose logs -f.

Update the server with docker compose pull && docker compose up -d. Stop the server with docker compose stop and remove it with docker compose down.

Server Configuration

Environment Variables


Variable Name Example Description Default
ETS_SERVER_WRITE_CONFIG true Enable/disable automatic config generation from env variables. true
ETS_SERVER_UPDATE_ON_START true Enable/disable update on server start. Will always update on first start to get server files. true
ETS_SERVER_NAME My Server The name of the server. Shown ingame. Euro Truck Simulator 2 Docker Server
ETS_SERVER_DESCRIPTION Join me! The description of the server. Shown ingame. ""
ETS_SERVER_WELCOME_MESSAGE Welcome to my server! The welcome message. Shown ingame. ""
ETS_SERVER_PASSWORD password The password required to join your server ""
ETS_SERVER_MAX_PLAYERS 8 Max number of players. Probably limited to 8 max. 8
ETS_SERVER_MAX_VEHICLES_TOTAL 100 Maximum number of vehicles on server??? 100
ETS_SERVER_MAX_AI_VEHICLES_PLAYER 50 Maximum number of AI vehicles around a player??? 50
ETS_SERVER_MAX_AI_VEHICLES_PLAYER_SPAWN 50 ??? 50
ETS_SERVER_CONNECTION_VIRTUAL_PORT 100 Virtual connection port. Only used internally. Do not forward. 100
ETS_SERVER_QUERY_VIRTUAL_PORT 101 Virtual query port. Only used internally. Do not forward. 101
ETS_SERVER_PORT 27015 The external port of the server. You need to forward UDP + TCP. 27015
ETS_SERVER_QUERY_PORT 27016 The external query port of the server. You need to forward UDP + TCP. Must be in the range 27015 - 2720 for LAN games. 27016
ETS_SERVER_LOGON_TOKEN 79gzbtepa2f0q72grfvazhhpsdasd The logon token to have a persistent search token. See Server README ""
ETS_SERVER_PLAYER_DAMAGE true Enable/disable player collisions true
ETS_SERVER_TRAFFIC true Enable/disable traffic true
ETS_SERVER_HIDE_IN_COMPANY false Enable/disable collisions of players in menu false
ETS_SERVER_HIDE_COLLIDING true Enable/disable hiding of players in no collisions zone true
ETS_SERVER_FORCE_SPEEDLIMITER false Enable/disable speed limit false
ETS_SERVER_MODS_OPTIONING false Enable optional mods false
ETS_SERVER_TIMEZONES false Enable time zones false
ETS_SERVER_SERVICE_NO_COLLISION false Enable/disable collision in service areas (true = collisions enable, false = collisions disabled) false
ETS_SERVER_NAME_TAGS true Enable/disable display of name tags above trucks true
ETS_SERVER_FRIENDS_ONLY false Limit server to steam friends??? false
ETS_SERVER_SHOW_SERVER true Show server in public server list? true
ETS_SERVER_MODERATORS 208370238402, 2384723894723, 283947923 List of steam IDs to turn moderatos on join. Moderators can alter the server time. See Server README ""
ETS_SERVER_CONFIG_FILE_PATH /home/user/ets/server_config.sii Path to server config file. /home/steam/.local/share/Euro Truck Simulator 2/server_config.sii
ETS_SERVER_BRANCH temporary_1_47 Server branch. Allows downgrading to an older version. At SteamDB you'll find available branches for both ETS2 and ATS. To return back to the latest public release, use "public" ""

As you can probably tell, there are some question marks in the descriptions. I'm not sure what the parameters are doing. If you have any clue, please open an issue or pull request.

Custom Mods


To enable your installed mods you need to generate custom server_packages.dat and server_packages.sii files.

  1. Locate your ETS2 savegames folder

    • Windows: %USERPROFILE%\Documents\Euro Truck Simulator 2
    • Mac:
      • No Steam Cloud: ~/Library/Application Support/Euro Truck Simulator 2/profiles/<Your Profile>/save
      • Steam Cloud: ~/Library/Application Support/Steam/userdata/<Your ID>/304730/remote/profiles/<Your Profile>/save
    • Linux: You know best ;)
  2. Open config.cfg in your favourite editor (Notepad++, Emacs, Vim, ...)

    • Search for uset g_console "0" and replace it with uset g_console "1"
    • Search for uset g_developer "0" and replace it with uset g_developer "1"
    • Save the file
  3. Start the game and load your desired save. The state (where your truck is) of the save is not important. We will only export mods.

    • Open the console by pressing the ~ key (left of 1 in the number row). It will vary depending on your keyboard layout.
    • Type export_server_packages in the console at the bottom of the screen and press enter.
  4. Go to your savegames folder again.

    • You should see 2 new files: server_packages.dat and server_packages.sii
    • Copy the files to your ets2 server data directory (replacing the existing ones)
      • You need to mount /home/steam/.local/share/Euro Truck Simulator 2 to a local directory using your docker run config.
      • Place the files in the mounted directory. E.g.: /opt/ets2
    • Restart your server

Increase Max Player Limit above 8 Players

  1. Set the desired player count using ETS_SERVER_MAX_PLAYERS
  2. Start the container
  3. Wait for the game to download and the server to start
  4. Restart the container
  5. You should see the server reporting:
*** WARNING *** : [cvar] Can not create file '</home/steam/.local/share/Euro Truck Simulator 2 | /home>/config_ds.cfg'.
*** ERROR *** : [fs] Failed to open file '/home/config_ds.cfg' in the create_truncate mode.
[...]
*** WARNING *** : [MP] Warning: Proper player limit exceeded.
[...]
[MP] Maximum number of players: 32

Then the workaround is working.

Joining the Modified Server

To join your modified server you'll need to set the same property also in your game. First you need to enable developer mode: https://forum.scssoft.com/viewtopic.php?t=61852

Then in game press this key on your keyboard to open the console:
Keyboard

Enter g_max_convoy_size 128 and press enter. This setting is saved across reboots. However it might not survive updates and you might have to issue the command again.

Due to the hacky nature of the workaround I cannot provide any support. Please don't create issues about it unless it prevents the server from starting at all.

Troubleshooting

Login Error 15

Login error 15 indicates that the token is for the wrong game. Please check that you have not used your ETS token for ATS or similar.

See ETS_SERVER_README.md to genrate a new token.

Login Error 106

Login error 106 indicates that your logon token is invalid.
The token will lose validity after some time and you will need to generate a new one.
To check if the token is still valid log into steam in a browser and go to https://steamcommunity.com/dev/managegameservers.
If the token has strike through it is no longer valid.

See ETS_SERVER_README.md to genrate a new token.

Can't write config file server_config.sii

Make sure the mounted folder owner is user id 1000. chown -R 1000:1000 /opt/ets2 (or whereever you have mounted it)

About

Provides a docker container for ETS2/ATS multiplayer dedicated server.

Resources

License

Stars

Watchers

Forks

Packages