[REL]Mod Loader update to v1.2

Post Reply
shooter556
PPM
Posts: 12
Joined: December 10th, 2020, 3:48 pm

[REL]Mod Loader update to v1.2

Post by shooter556 » 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=======

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.
=======Typical Process Example=======
1. List all local profiles

Code: Select all

mod_loader.exe --game ets2 --listprofile
[Profile]  <====>  [Encrypted Directory]
test   <====>   74657374
<snipped>
2. List all mods existing locally (the sequence here doesn't matter, only show by alphabet)

Code: Select all

mod_loader.exe --game ets2 --listlocal
You got below mods locally:
<snipped>
RX35assets
RX35defmap
RX35Media
RX35model1
RX35model2
RX35prefab
<snipped>
3. List all workshop mods you have subscribed

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>
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:

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>
5. List current mod loading sequence of one profile (e.g. test)

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>
6. Verify if all mods in "mod_config" are all existing locally

Code: Select all

mod_loader.exe --game ets2 --profile test --verify
All mods to be loaded are all existing locally.
If some mods are not existing locally, you will see:

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.000000000X26A8B6D5
7. After checking, if you're ready, move on to a real modification

Code: Select all

mod_loader.exe --game ets2 --profile test --modify
Save mod configuration to the target profile: test
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.
Last edited by shooter556 on January 7th, 2023, 2:27 pm, edited 3 times in total.
User avatar
Tapir
VIP
Posts: 4216
Joined: December 15th, 2018, 3:07 pm
Location: Stratford, UK

Re: [REL]Mod Loader

Post by Tapir » August 27th, 2022, 10:18 am

Nice tool
Image

System: Windows 11 PRO
Processor: Intel i7-12700KF 5GHZ
Motherboard: Gigabyte B760 DS3H AX
Memory: Corsair DDR5-6000 32 GB
Storage: Samsung 990 M2 SSD + 2 Samsung 870 SSD
Graphics: Asus GeForce Dual RTX 3060 V2 12GB GDDR6
User avatar
punk
PPM
Posts: 462
Joined: May 10th, 2020, 9:39 am
Location: Baku
Contact:

Re: [REL]Mod Loader

Post by punk » August 27th, 2022, 10:21 am

Good job! GUI version will be highly appreciated:)
Image

My PC: MSI MAG Z590 Tomahawk, Core i7-10700K, G.Skill RipJaws 64GB, Samsung EVO 1TB SSD, GeForce GTX 1060 6 GB, Logitech G920

My Combo topic: https://roextended.ro/forum/viewtopic.php?f=15&t=1640
Innactually
Posts: 3
Joined: September 6th, 2022, 10:00 am

Re: [REL]Mod Loader

Post by Innactually » September 6th, 2022, 10:05 am

How do I do it? it gives me "mod_loader.exe: error: the following arguments are required: --game/-g" when I launch it
User avatar
Tapir
VIP
Posts: 4216
Joined: December 15th, 2018, 3:07 pm
Location: Stratford, UK

Re: [REL]Mod Loader

Post by Tapir » September 6th, 2022, 12:43 pm

mod_loader.exe --game ets2 --listprofile <---for example


And so it looks like :

Code: Select all

gmc.original_loading_screen.scs
GMC Logistics - Ultimate Traffic - No RO.scs
GMC Logistics - Truck and Trailers Paintjobs.scs
gmc.ferry_killer.scs
SwedishIslandsMap_v1.10-Wombat.scs
paris_rebuild_v3_2.scs
blazingcreeperx.caucasus_caps_fix.scs
Project_Caucasus.scs
ENROEX.scs
ROEXallPMpack262RM244RC.scs
ROEXallSR109RC.scs
ROEXallRhodesFIX.scs
AZGESR109RC.scs
AZGE145.zip
RX35defmap.scs
RX35prefab.scs
RX35model1.scs
RX35model2.scs
RX35assets.scs
RX35Media.scs
Rhodes_1.0.scs
Jan-Mayen-Beta-0.4.1.zip
Med_Expansion_1.3.scs
Project Greenland - Promods Ferry.scs
Project Greenland.scs
bg_plus_v0.9.1.scs
gmc.kirov.caps_fix.scs
kirov_map_1-2_free.scs
PM261_RM2.44_connect_RusMap_v1.1.scs
RusMap1_44_fix.scs
RusMap-def_v2.44.scs
RusMap-map_v2.44.scs
RusMap-model_v2.44.scs
RusMap-model2_v2.44.scs
finnmark_v1659627688.scs
itarevamp_0.5.zip
blazingcreeperx.pm_emden_v7.scs
Bourges Updated v1.0.1.scs
Sud_de_France_by_Charly.scs
gmc.santiago.caps_fix.scs
santiago3.zip
Trigger_Fixer_1.2.scs
Larne_Road.scs
Macedonia_rework_def_st.scs
Macedonia_rework_map.scs
Macedonia_rework_mat&asset.scs
Redsea1-4-2.scs
Redsea_Assets.zip
gmc.israel-lebanon_open_border.scs
promods-me-defmap-v262.scs
promods-me-assets-v262.scs
gmc.mapa_eaa.promods.fix.scs
promods-assets-v262.scs
promods-def-st-v262.scs
promods-map-v262.scs
promods-media-v262.scs
promods-model1-v262.scs
promods-model2-v262.scs
promods-model3-v262.scs
gmc.corfu.promods.fix.scs
Corfu_and_The_Greek_Islands_Map.scs
Corfu_Models.scs
gmc.mapa_eaa.ferry_clean-up.scs
gmc.mapa_eaa.caps_fix.scs
gmc.mapa_eaa.rusmap.fix.scs
gmc.mapa_eaa.map_combo_fix.scs
MAPA_EAA_1-45.scs
MAPA_EAA_1-45_BASE1.scs
MAPA_EAA_1-45_BASE2.scs
gmc.rtasia.semaphore_fix.scs
Road_to_Asia1-3-2.scs
Road_to_Asia_Assets.scs
Road_to_Asia_Models.scs
gmc.southern_region.english_city_names.scs
SRmap_Def_and_Map_FIX144.scs
SRmap_[Model1].scs
SRmap_[Model2].scs
gmc.sibirmap.train_conn_removed.scs
gmc.sibirmap_2.caps_fix.scs
sibirmap232mapdef.scs
sibirmap232model.scs
gmc.the_great_steppe.english_city_names.scs
CrachFix-Actode_TGS_v1.1.scs
The Great Steppe-def-v2.0.scs
The Great Steppe-map-v2.0.scs
The Great Steppe-model-v2.0.scs
JRR_Def&Map[1.44-1.45].scs
JRR_Assets&Models1.scs
JRR_Assets&Models2.scs
Southeast Asia map ver0.1 def.zip
Southeastasia map ver0.1.zip
model2.scs
Indonesia_Map_Overlay_v1.zip
Indonesia_New_Prefabs_Part-4_1.38-Newest.zip
Indonesia_New_Road_Buildings_v2_1.35-Newest.zip
Indonesia_New_Signs_and_Navigation_v1_1.38-Newest.zip
Indonesia_New_Tollgate_Prefabs_Part-4_1.38-Newest.zip
Indonesia_New_Roads_Pt-3_1.35-1.38.zip

System: Windows 11 PRO
Processor: Intel i7-12700KF 5GHZ
Motherboard: Gigabyte B760 DS3H AX
Memory: Corsair DDR5-6000 32 GB
Storage: Samsung 990 M2 SSD + 2 Samsung 870 SSD
Graphics: Asus GeForce Dual RTX 3060 V2 12GB GDDR6
shooter556
PPM
Posts: 12
Joined: December 10th, 2020, 3:48 pm

Re: [REL]Mod Loader update to v1.1

Post by shooter556 » September 6th, 2022, 3:58 pm

I have updated this tool to v1.1

Change Logs:
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.
User avatar
Tapir
VIP
Posts: 4216
Joined: December 15th, 2018, 3:07 pm
Location: Stratford, UK

Re: [REL]Mod Loader update to v1.1

Post by Tapir » September 6th, 2022, 4:21 pm

Code: Select all

ETS_AllWorld_MAP_v25+EAA.scs
mod_workshop_package.0000000026A8B6D4
mod_workshop_package.000000007230D273
gmc.original_loading_screen.scs
GMC Logistics - Ultimate Traffic - No RO.scs
GMC Logistics - Truck and Trailers Paintjobs.scs
gmc.ferry_killer.scs
SwedishIslandsMap_v1.10-Wombat.scs
paris_rebuild_v3_2.scs
blazingcreeperx.caucasus_caps_fix.scs
Project_Caucasus.scs
ENROEX.scs
ROEXallPMpack262RM244RC.scs
ROEXallSR109RC.scs
ROEXallRhodesFIX.scs
AZGESR109RC.scs
AZGE145.zip
RX35defmap.scs
RX35prefab.scs
RX35model1.scs
RX35model2.scs
RX35assets.scs
RX35Media.scs
Rhodes_1.0.scs
Jan-Mayen-Beta-0.4.1.zip
Med_Expansion_1.3.scs
Project Greenland - Promods Ferry.scs
Project Greenland.scs
bg_plus_v0.9.1.scs
gmc.kirov.caps_fix.scs
kirov_map_1-2_free.scs
PM261_RM2.44_connect_RusMap_v1.1.scs
RusMap1_44_fix.scs
RusMap-def_v2.44.scs
RusMap-map_v2.44.scs
RusMap-model_v2.44.scs
RusMap-model2_v2.44.scs
finnmark_v1659627688.scs
itarevamp_0.5.zip
blazingcreeperx.pm_emden_v7.scs
Bourges Updated v1.0.1.scs
Sud_de_France_by_Charly.scs
gmc.santiago.caps_fix.scs
santiago3.zip
Trigger_Fixer_1.2.scs
Larne_Road.scs
Macedonia_rework_def_st.scs
Macedonia_rework_map.scs
Macedonia_rework_mat&asset.scs
Redsea1-4-2.scs
Redsea_Assets.zip
gmc.israel-lebanon_open_border.scs
promods-me-defmap-v262.scs
promods-me-assets-v262.scs
gmc.mapa_eaa.promods.fix.scs
promods-assets-v262.scs
promods-def-st-v262.scs
promods-map-v262.scs
promods-media-v262.scs
promods-model1-v262.scs
promods-model2-v262.scs
promods-model3-v262.scs
gmc.corfu.promods.fix.scs
Corfu_and_The_Greek_Islands_Map.scs
Corfu_Models.scs
gmc.mapa_eaa.ferry_clean-up.scs
gmc.mapa_eaa.caps_fix.scs
gmc.mapa_eaa.rusmap.fix.scs
gmc.mapa_eaa.map_combo_fix.scs
MAPA_EAA_1-45.scs
MAPA_EAA_1-45_BASE1.scs
MAPA_EAA_1-45_BASE2.scs
gmc.rtasia.semaphore_fix.scs
Road_to_Asia1-3-2.scs
Road_to_Asia_Assets.scs
Road_to_Asia_Models.scs
gmc.southern_region.english_city_names.scs
SRmap_Def_and_Map_FIX144.scs
SRmap_[Model1].scs
SRmap_[Model2].scs
gmc.sibirmap.train_conn_removed.scs
gmc.sibirmap_2.caps_fix.scs
sibirmap232mapdef.scs
sibirmap232model.scs
gmc.the_great_steppe.english_city_names.scs
CrachFix-Actode_TGS_v1.1.scs
The Great Steppe-def-v2.0.scs
The Great Steppe-map-v2.0.scs
The Great Steppe-model-v2.0.scs
JRR_Def&Map[1.44-1.45].scs
JRR_Assets&Models1.scs
JRR_Assets&Models2.scs
Southeast Asia map ver0.1 def.zip
Southeastasia map ver0.1.zip
model2.scs
Indonesia_Map_Overlay_v1.zip
Indonesia_New_Prefabs_Part-4_1.38-Newest.zip
Indonesia_New_Road_Buildings_v2_1.35-Newest.zip
Indonesia_New_Signs_and_Navigation_v1_1.38-Newest.zip
Indonesia_New_Tollgate_Prefabs_Part-4_1.38-Newest.zip
Indonesia_New_Roads_Pt-3_1.35-1.38.zip

System: Windows 11 PRO
Processor: Intel i7-12700KF 5GHZ
Motherboard: Gigabyte B760 DS3H AX
Memory: Corsair DDR5-6000 32 GB
Storage: Samsung 990 M2 SSD + 2 Samsung 870 SSD
Graphics: Asus GeForce Dual RTX 3060 V2 12GB GDDR6
Innactually
Posts: 3
Joined: September 6th, 2022, 10:00 am

Re: [REL]Mod Loader update to v1.1

Post by Innactually » September 8th, 2022, 4:33 pm

Now it gives me
"Traceback (most recent call last):
File "mod_loader.py", line 209, in <module> ValueError: non-hexadecimal number found in fromhex() arg at position 25
[9032] Failed to execute script 'mod_loader' due to unhandled exception!" any help?
shooter556
PPM
Posts: 12
Joined: December 10th, 2020, 3:48 pm

Re: [REL]Mod Loader update to v1.1

Post by shooter556 » September 9th, 2022, 6:12 am

Innactually wrote:
September 8th, 2022, 4:33 pm
Now it gives me
"Traceback (most recent call last):
File "mod_loader.py", line 209, in <module> ValueError: non-hexadecimal number found in fromhex() arg at position 25
[9032] Failed to execute script 'mod_loader' due to unhandled exception!" any help?
I think that's due to some weird name directories under your profile directory.

Commonly it's "c:\users\<your_name>\Documents\Euro Truck Simulator 2\profiles" if you use the default setting.

Please check.
shooter556
PPM
Posts: 12
Joined: December 10th, 2020, 3:48 pm

Re: [REL]Mod Loader update to v1.1

Post by shooter556 » September 27th, 2022, 5:16 pm

Due to the outage of sharemods.com, I have updated the link of download.
Post Reply