[REL]Mod Loader update to v1.2
Posted: August 26th, 2022, 4:09 pm
=======Brief Introduction=======
This is a simple command line tool(NO GUI) to help you apply mods configuration, without clicking mouse hundreds/thousands of times in "mods" menu.
I write this because I was bored to clicking mouse all the time once something has changed, especially a new game version has launched.
Adjusting sequence in a file is far easier then clicking mouse, my own opinion. Especially you have over 100 mods.
I didn't make a full test of this tool. There could be severe bugs existing which may corrupt your current file. Use with caution. I can't take any responsibility of your loss.
At least you need to know how to execute command in windows terminal app.
=======Change Logs=======
v1.2:
1. Add a new option "--export/-e", to export the current mods configuration of a profile to a file.
2. Fix some minor display errors.
v1.1:
1. Support a new option "--listwork/-lw", to list all downloaded workshop mods. (steam workshop)
2. Support adding workshop mods. (Please take a look at the "Typical Process Example" below)
3. "Verify" now supports both local mods and workshop mods.
v1.0:
1. Only support windows OS.
2. Only support ETS2/ATS of steam platform.
3. Only support local profiles.
4. Modification will overwrite all existing mods load sequence of the profile. Better backup current profile before modification.
5. If you have specify "-homedir <path>" in game booting options, this tool will recognize that location automatically. (E.g. -homedir e:\)
6. Default mod sequence configuration file is "mod_config", higher the position, higher the load priority. (Same behavior with "mods" menu in game)
7. Not support mods in workshop, you need to use "mod manager" in game to add/adjust them manually.
8. This tool will need to cooperate with another program "SII_Decrypt.exe" (https://github.com/TheLazyTomcat/SII_Decrypt). I have included a pre-compiled one in release.
=======Download Location=======
v1.2: https://sharemods.com/iyb3nmu0m2tg/mod_ ... 2.zip.html
++++++++++++++++++++++++++++++++
1. mod_loader.exe
Size: 6694759 bytes (6537 KiB)
SHA256: AFCE0799C48F4B7879F946988BA2B98AFC869325D792F99E45F7FF521FB40A46
++++++++++++++++++++++++++++++++
v1.1: https://sharemods.com/7o0pitvduld7/mod_ ... .1.7z.html
++++++++++++++++++++++++++++++++
1. mod_config
An example file, involving some workshop mods
MD5: 9856C608D8DFB3E6A63A26A71DBD7EDF
2. mod_loader.exe
Main program
MD5: E37D761F976969993B6DA473AA856AF4
3. SII_Decrypt.exe
sii file decrypting tool which is open source
MD5: 41DAE59D42780178A0E6538D37B4E0CF
++++++++++++++++++++++++++++++++
v1.0: https://sharemods.com/x10cyy7cywhb/mod_ ... .0.7z.html
++++++++++++++++++++++++++++++++
1. mod_config
An example file including all mods extracting from https://roextended.ro/forum/viewtopic.php?f=15&t=2328
MD5: 0C652D01158873C07FFDEB74A5BD4293
2. mod_loader.exe
Main program
MD5: 2F794AF0BAB768CCC7E5F1B0974EF7BB
3. SII_Decrypt.exe
sii file decrypting tool which is open source
MD5: 41DAE59D42780178A0E6538D37B4E0CF
++++++++++++++++++++++++++++++++
=======Command Help=======
=======Typical Process Example=======
1. List all local profiles
2. List all mods existing locally (the sequence here doesn't matter, only show by alphabet)
3. List all workshop mods you have subscribed
4. Adding workshop mods into "mod_config" file
If you plan to add a workshop mod into profile, all you need is adding the mod name before "|" shown above.
For example:
If you want to add "Sound Fixes Pack 22.64" and "Ford F-MAX" mod, you need to modify "mod_config" file like below:
5. List current mod loading sequence of one profile (e.g. test)
6. Verify if all mods in "mod_config" are all existing locally
If some mods are not existing locally, you will see:
7. After checking, if you're ready, move on to a real modification
Before modification, the tool will verify again.
If there are some mods not existing locally, it will inform you that.
If you need to forcely modify, add an option "--force/-f".
8. You can use step 5 to check again to see if you have done successfully
9. Then launch the game to check by "mod manager" in game, and add/adjust workshop mods as you need
10. Can't list all use cases, "--help" may give you more hints. Most of time, options and messages can be self-explained
Happy trucking.
Any bug feedback is welcomed.
This is a simple command line tool(NO GUI) to help you apply mods configuration, without clicking mouse hundreds/thousands of times in "mods" menu.
I write this because I was bored to clicking mouse all the time once something has changed, especially a new game version has launched.
Adjusting sequence in a file is far easier then clicking mouse, my own opinion. Especially you have over 100 mods.
I didn't make a full test of this tool. There could be severe bugs existing which may corrupt your current file. Use with caution. I can't take any responsibility of your loss.
At least you need to know how to execute command in windows terminal app.
=======Change Logs=======
v1.2:
1. Add a new option "--export/-e", to export the current mods configuration of a profile to a file.
2. Fix some minor display errors.
v1.1:
1. Support a new option "--listwork/-lw", to list all downloaded workshop mods. (steam workshop)
2. Support adding workshop mods. (Please take a look at the "Typical Process Example" below)
3. "Verify" now supports both local mods and workshop mods.
v1.0:
1. Only support windows OS.
2. Only support ETS2/ATS of steam platform.
3. Only support local profiles.
4. Modification will overwrite all existing mods load sequence of the profile. Better backup current profile before modification.
5. If you have specify "-homedir <path>" in game booting options, this tool will recognize that location automatically. (E.g. -homedir e:\)
6. Default mod sequence configuration file is "mod_config", higher the position, higher the load priority. (Same behavior with "mods" menu in game)
7. Not support mods in workshop, you need to use "mod manager" in game to add/adjust them manually.
8. This tool will need to cooperate with another program "SII_Decrypt.exe" (https://github.com/TheLazyTomcat/SII_Decrypt). I have included a pre-compiled one in release.
=======Download Location=======
v1.2: https://sharemods.com/iyb3nmu0m2tg/mod_ ... 2.zip.html
++++++++++++++++++++++++++++++++
1. mod_loader.exe
Size: 6694759 bytes (6537 KiB)
SHA256: AFCE0799C48F4B7879F946988BA2B98AFC869325D792F99E45F7FF521FB40A46
++++++++++++++++++++++++++++++++
v1.1: https://sharemods.com/7o0pitvduld7/mod_ ... .1.7z.html
++++++++++++++++++++++++++++++++
1. mod_config
An example file, involving some workshop mods
MD5: 9856C608D8DFB3E6A63A26A71DBD7EDF
2. mod_loader.exe
Main program
MD5: E37D761F976969993B6DA473AA856AF4
3. SII_Decrypt.exe
sii file decrypting tool which is open source
MD5: 41DAE59D42780178A0E6538D37B4E0CF
++++++++++++++++++++++++++++++++
v1.0: https://sharemods.com/x10cyy7cywhb/mod_ ... .0.7z.html
++++++++++++++++++++++++++++++++
1. mod_config
An example file including all mods extracting from https://roextended.ro/forum/viewtopic.php?f=15&t=2328
MD5: 0C652D01158873C07FFDEB74A5BD4293
2. mod_loader.exe
Main program
MD5: 2F794AF0BAB768CCC7E5F1B0974EF7BB
3. SII_Decrypt.exe
sii file decrypting tool which is open source
MD5: 41DAE59D42780178A0E6538D37B4E0CF
++++++++++++++++++++++++++++++++
=======Command Help=======
Code: Select all
usage: mod_loader.exe [-h] --game {ets2,ats} [--listprofile] [--listmod] [--listlocal] [--listwork] [--export]
[--profile PROFILE] [--config CONFIG] [--verify] [--modify] [--force] [--version]
This script can apply mods loader sequence to an account per a pre-configured file.
options:
-h, --help show this help message and exit
--game {ets2,ats}, -g {ets2,ats}
Specifiy the game you want to modify. Only ets2 or ats is supported.
--listprofile, -lp List all existing profiles.
--listmod, -lm List current mod load sequence of selected profile.
--listlocal, -ll List all external mods (under "mod" dir) locally.
--listwork, -lw List all workshop mods (subscribed in steam workshop).
--export, -e Export current mod configurations to a file.
--profile PROFILE, -p PROFILE
Specifiy a profile.
--config CONFIG, -c CONFIG
Specifiy a mod loader configuration file. "mod_config" will be used if not using this option.
--verify, -v Verify if all mods in config file exist locally.
--modify, -m Implement pre-configured mod sequence to the profile.
--force, -f Forcely modify when failing with --verify/-v.
--version, -V Show current version of this script.1. List all local profiles
Code: Select all
mod_loader.exe --game ets2 --listprofile
[Profile] <====> [Encrypted Directory]
test <====> 74657374
<snipped>Code: Select all
mod_loader.exe --game ets2 --listlocal
You got below mods locally:
<snipped>
RX35assets
RX35defmap
RX35Media
RX35model1
RX35model2
RX35prefab
<snipped>Code: Select all
mod_loader.ext --game ets2 --listwork
Dir name "Mod name|Mod description(for reference)"
=================================
<snipped>
1105656290 "mod_workshop_package.0000000041E6F9E2|Unlimited Money + XP"
1915802227 "mod_workshop_package.000000007230D273|Ford F-MAX (NOT COMPATIBLE)"
648591060 "mod_workshop_package.0000000026A8B6D4|Sound Fixes Pack 22.64"
965340469 "mod_workshop_package.000000003989ED35|minimal adviser interface for ATS & ETS2"
<snipped>If you plan to add a workshop mod into profile, all you need is adding the mod name before "|" shown above.
For example:
If you want to add "Sound Fixes Pack 22.64" and "Ford F-MAX" mod, you need to modify "mod_config" file like below:
Code: Select all
<snipped>
ETS_AllWorld_MAP_v25+EAA.scs
mod_workshop_package.0000000026A8B6D4 <===== Add this line
mod_workshop_package.000000007230D273 <===== Add this line
gmc.original_loading_screen.scs
GMC Logistics - Ultimate Traffic - No RO.scs
GMC Logistics - Truck and Trailers Paintjobs.scs
<snipped>Code: Select all
mod_loader.exe --game ets2 --profile test --listmod
<snipped>
"promods-me-defmap-v262"
"promods-me-assets-v262"
"gmc.mapa_eaa.promods.fix"
"promods-assets-v262"
"promods-def-st-v262"
"promods-map-v262"
"promods-media-v262"
"promods-model1-v262"
"promods-model2-v262"
"promods-model3-v262"
<snipped>Code: Select all
mod_loader.exe --game ets2 --profile test --verify
All mods to be loaded are all existing locally.Code: Select all
Below external or workshop mod(s) in mod config file not exist locally:
=================================
External mods:
ETS_AllWorld_MAP_v25+EAA1
=================================
Workshop mods:
Directory name: 648591061 ====> mod_workshop_package.000000000X26A8B6D5Code: Select all
mod_loader.exe --game ets2 --profile test --modify
Save mod configuration to the target profile: testIf there are some mods not existing locally, it will inform you that.
If you need to forcely modify, add an option "--force/-f".
8. You can use step 5 to check again to see if you have done successfully
9. Then launch the game to check by "mod manager" in game, and add/adjust workshop mods as you need
10. Can't list all use cases, "--help" may give you more hints. Most of time, options and messages can be self-explained
Happy trucking.
Any bug feedback is welcomed.
