[Guide] How to set up -homedir and other startup parameters

Forum rules
SCS as a company do not wish to have paid mods on this forum. While we understand that not all paid mods use the Intellectual Property of other companies/people, it is very hard to moderate what is and isn't acceptable when money is involved. There are also concerns that it could look unfavorable to potential work partners going forward if SCS allow mods that may potentially use unlicensed branding.
Posting in the Mods forum (ATS and ETS2) is restricted to sharing free-to-the-public mods and providing support for mods. For more details, please check the Forum Rules.
User avatar
Reef
Posts: 3903
Joined: 27 Dec 2012 23:16
Location: Everywhere and nowhere baby

[Guide] How to set up -homedir and other startup parameters

#1 Post by Reef » 26 Jun 2016 19:32

How to use the -homedir feature with ETS2 or ATS (exact same process)

Ok firstly you will need to create some desktop shortcuts, this is now made a little more complicated recently if you use Steam due to an annoying little "Custom parameters check" popup that has been introduced, but don't worry there is a way around this (thanks to Josh0).

We will first apply this tutorial as if you are a Steam game version owner and then afterwards I will explain the different parts for the non Steam Digital Download or Disc version owners.

Steam:

1) You will first need to create a desktop shortcut through the Steam client, this is to determine what the applaunch ID number is, for ETS2 it's 227300 and for ATS it's 270880 for me, and I'm reasonably sure it will be the same for everyone else but follow the images and instructions below to find out for sure.


1a) Open your Steam client and find the game in your library, then right click on the name and click on "Properties"

[ external image ]


1b) Click on "CREATE DESKTOP SHORTCUT"

[ external image ]


1c) Click OK to close dialogue box

[ external image ]


1d) Now go to your desktop and right click on the shortcut and select "Properties"

[ external image ]


1e) Here you will see the id number (in my case and possibly all other cases 270880 regarding ATS)

[ external image ]


Now we have gotten the applaunch ID number we can move on to the next stage.

2) Either return to the Steam client and in the properties window (where you created a desktop shortcut) select the "LOCAL FILES" tab and then press the "BROWSE LOCAL FILES" button, or navigate through explorer (usually C:\Program Files (x86)\Steam\steamapps\common\Euro Truck Simulator 2 or American Truck Simulator)

[ external image ]


2a) This will open the main folder in this case American Truck Simulator but it's exactly the same procedure for Euro Truck Simulator 2 too.

[ external image ]


3) You now need to open the "bin" folder and then the win_x86 (32bit) or the win_x64 (64bit) folder, (note: ATS only has the win_x64 folder as it is a 64bit only game)

4) Right click on the .exe (either eurotrucks2 or amtrucks depending on game of course) and select "Create Shortcut"

[ external image ]


4a) Now move that shortcut to the desktop.

[ external image ]


4b) right click on the shortcut and select "Properties"

[ external image ]


4c) now I recommend that you open notepad and copy the Target: text into notepad, it just makes it clearer to read and edit.

[ external image ]


5) Ok now we get down to editing and also adding our custom startup parameters..

firstly to combat that annoying Steam popup you need to change *steamapps\common\American Truck Simulator\bin\win_x64\amtrucks.exe"* to *Steam.exe" -applaunch 270880* (without the *'s and double check that you are using the correct ID number as per the start of this guide)

[ external image ]


Ok that's the popup taken care of (again thanks to Josh0 for that tidbit)

6) Now to add the startup parameters.

Here are some you can use:

-64bit (always launch the game in 64bit irrelevant for ATS of course)
-nointro (as it says on the tin, skips the intro)
-homedir (this is so that you can set a custom Euro Truck Simulator 2 or American Truck Simulator folder exactly like the one in your Documents folder but in a location of your choosing, it will contain its own profile folders, mod folder, music folder, config.cfg file, game.log.txt file and even screenshot folder just exactly like the original one in your Documents folder)

When you add a parameter it goes on the end of the text BUT MAKE SURE YOU ALWAYS HAVE A SPACE AT THE START OF EACH AND EVERY PARAMETER YOU ADD!!

example:
"C:\Program Files (x86)\Steam\Steam.exe" -applaunch 270880 -homedir

7) Now a little word about the homedir peramiter, you must ensure that you write an absolute path to the new directories folder location, in other words you will need to specify the drive letter (if you have more than one hard drive or SSD) and any other existing folder that you want the new directory to be created in.

for example:
My O.S. and programs and Steam and games are all on C drive as per most normal PC setups, but I would like my new home directory for ETS2 (or ATS) to be on my secondary drive which is called E drive, Also I want my ETS2 and or ATS home directory to be within a file I created called "Truck Sims", therefore my homedir path would have to be set out as follows..

-homedir "E:\Truck Sims" (you must have the quote marks)

[ external image ]


Copy the contents of your notepad back into the Target: field

Click "Apply" and close the Shortcuts properties window.

Now what will happen is that when you then launch the game for the first time using this shortcut it will then create the American Truck Simulator (or Euro Truck Simulator 2) folder and all it's containing files and folders as mentioned above being a complete replica of the one in your C:\**User**\Documents folder

So you will then have in your destination drive E:\Truck Sims\American Truck Simulator

Also take note that when you first run the game using this custom shortcut it will be like starting from a fresh install, you will be asked to create a profile and set up your controller options and will have the beginning tutorial and first job, don't worry because you can save and exit the game at this point and then copy your existing profiles and mods and even the config.cfg from your original directory into the new directory and carry on where you left off.

Ok that's explained the whole process for hopefully even the complete computer novice to follow I will now add the differences for the non Steam users, which isn't that much really.

----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Additional info for non-Steam users (Direct Digital Downloads from the official website or for those that bought a physical disc in a bricks and mortar store)

The main differences are,
Obviously no Steam client so those instructions are invalid, no need to worry about the popup fix as there are no popups to fix, folder locations are slightly different.

If you are on a 32bit only system (applies to ETS2 only) then navigate through Explorer to C:\Program Files\Euro Truck Simulator 2\bin\win_x86\eurotrucks2.exe

if you are on a 64bit system then navigate to C:\Program Files (x86)\Euro Truck Simulator 2\bin\win_x64\eurotrucks2.exe for ETS2 or C:\Program Files (x86)\American Truck Simulator\bin\win_x64\amtrucks.exe for ATS

Now right click on the .exe as explained for the Steam users from image 4) and create the shortcut and follow the tutorial through to 4c) and then follow 6) and 7)

All you need to do with the non Steam shortcuts is just add the parameters (not forgetting the space at the start of each one though!)

Example:
"C:\Program Files (x86)\Euro Truck Simulator 2\bin\win_x86\eurotrucks2.exe" -homedir -nointro

and that's it, any questions just ask.
User avatar
Dogface
Posts: 252
Joined: 14 May 2015 01:07
Location: I-80 USA

Re: [Guide] How to set up -homedir and other startup paramet

#2 Post by Dogface » 26 Jun 2016 21:39

Cool, thanks. :)
User avatar
Cadde
Posts: 6800
Joined: 24 Apr 2013 18:08
Location: Have no fear, i am from the internets!

Re: [Guide] How to set up -homedir and other startup paramet

#3 Post by Cadde » 27 Jun 2016 18:38

Well done!
On extended hiatus.
User avatar
DaStig
Posts: 3426
Joined: 26 Jan 2015 17:35
Location: Stigmania
Contact:

Re: [Guide] How to set up -homedir and other startup paramet

#4 Post by DaStig » 27 Jun 2016 18:57

Very, very useful my friend ... I'm also using this method to keep my different profiles nicely separated ... each profile with its own mod-map and game directory ... very convenient and useful.

DaStig

* thread got bookmarked here :mrgreen:
Member of GTM Team | ETS2 Screenshots | ATS Screenshots | Flickr | Facebook
AMD Ryzen 7 2700 | MSI B450M Mortar | GTX 1070Ti 8GB | Corsair Vengeance 16GB RAM | 3x SSD Samsung 850 Pro 250GB | Dell UtraSharp 27" U2719D

[ external image ]
User avatar
ohaha
Posts: 11345
Joined: 07 Dec 2012 06:31
Location: Watchin' y'all
Contact:

Re: [Guide] How to set up -homedir and other startup paramet

#5 Post by ohaha » 27 Jun 2016 18:58

Handy little tip there. Nicely put together, too. :)
Retired, but still loving it.
igor90
Posts: 36
Joined: 17 Nov 2014 14:46

Re: [Guide] How to set up -homedir and other startup paramet

#6 Post by igor90 » 11 Jan 2017 00:01

-64bit (always launch the game in 64bit irrelevant for ATS of course)
-nointro (as it says on the tin, skips the intro)
-homedir (this is so that you can set a custom Euro Truck Simulator 2 or American Truck Simulator folder exactly like the one in your Documents folder but in a location of your choosing, it will contain its own profile folders, mod folder, music folder, config.cfg file, game.log.txt file and even screenshot folder just exactly like the original one in your Documents folder)
Can You ditinguish that parameters (bold text or smthn). There is a lot of text int the first post and I missed it first time I was looking for it. :lol:

It would be nice if we have all the startup parameters we can set in one place. There are other parameters people would like to know f.ex. -edit europe (to open map editor), some resolution parameters, but sadly I don't remember how exactly it was going... :)
taffypride1983
Posts: 36
Joined: 09 Oct 2013 21:39

Re: [Guide] How to set up -homedir and other startup parameters

#7 Post by taffypride1983 » 26 Jul 2017 11:13

Hi, can we use the same trick to move the Screenshots and Music folder, or does this work automatically when we swap homedir?
User avatar
Reef
Posts: 3903
Joined: 27 Dec 2012 23:16
Location: Everywhere and nowhere baby

Re: [Guide] How to set up -homedir and other startup parameters

#8 Post by Reef » 26 Jul 2017 12:08

@taffypride1983

Everything, the Euro Truck Simulator 2 folder and all of its contents including profile, music & screenshot folders, config.cfg, game.log.txt files the whole lot is re-created in the new directory, the Euro Truck Simulator 2 (or American Truck Simulator as it works for that too) folder that is in your Documents folder will be replicated at the new directory path, you can still use the original by clicking the original shortcut too.
User avatar
Cadde
Posts: 6800
Joined: 24 Apr 2013 18:08
Location: Have no fear, i am from the internets!

Re: [Guide] How to set up -homedir and other startup parameters

#9 Post by Cadde » 26 Jul 2017 15:12

And if you really want to customize on what drives/paths your various folders are stored you could always use symlinks.
On extended hiatus.
User avatar
Reef
Posts: 3903
Joined: 27 Dec 2012 23:16
Location: Everywhere and nowhere baby

Re: [Guide] How to set up -homedir and other startup parameters

#10 Post by Reef » 26 Jul 2017 18:38

Thanks Cadde, you'd just reminded me of something I'd been meaning to do for a while, I've just symlinked my workshop mods folder off of my SSD that Steam is on to my 2Tb HDD using the Command prompt method.
Post Reply

Return to “Modding Guides”

Who is online

Users browsing this forum: Fynn1510, xpbaxxter and 2 guests