[REL] [WIP] Easy SCSModManager (ESCSMM)

[BeckysFootSlave]

Easy SCSModManager

Manage your ETS2 & ATS mods faster and easier
Verwalte deine ETS2- & ATS-Mods schneller und einfacher

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

GitHub & Download:
Easy SCSModManager - Repository & Releases

[ external image ]

If you like ESCSMM, the easiest way to support it is a star on GitHub - it makes the project visible to other truckers and costs nothing: github.com/Switch-Bros/easy-scsmodmanager

Wenn dir ESCSMM gefaellt: Ein Stern auf GitHub ist die einfachste Unterstuetzung - er macht das Projekt fuer andere Trucker sichtbar und kostet nichts.

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


English Version

How it Works

1. Two games, one window
Switch between Euro Truck Simulator 2 and American Truck Simulator from a single window. Your install and profiles are detected automatically on Linux (native and Proton) and Windows.

2. Browse every mod
Your local mod folder and your Steam Workshop subscriptions, shown in a card grid with icon, name and description. Reads every container - plain .scs, ZIP-based .scs, HashFS v1/v2 and unpacked folders - so even a workshop mod named universal.scs shows its real name.

3. Real drag and drop load order
The in-game manager only moves a mod one row at a time - with 300 mods, getting one into the middle means clicking 150 times. Here you just scroll to the spot and drop it in. The active list is grouped by section (financial, sound, trucks, trailers, maps...) and the order is written straight back to profile.sii.

4. Map Combos
Export your map load order to a file and share it. Others import it and their maps get set in your exact order. Missing maps are listed by name, and an outdated map (you have 2.2, the combo used 2.4) is flagged as a hint.

5. Compatibility and conflict checks
Mods are checked against your game version exactly the way the game does it. And when two active mods overwrite the same def file, you get a hint - so you can order them on purpose.

6. Comfort
Favourites, profile backup and restore, full English and German interface.

Free and open source (GPL-3.0). Linux & Windows.
Available as AppImage, Windows .exe, .deb, .rpm, portable tar.gz and on the AUR.

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


Deutsche Version

Wie es funktioniert

1. Beide Spiele, ein Fenster
Wechsle zwischen Euro Truck Simulator 2 und American Truck Simulator aus einem Fenster. Installation und Profile werden automatisch erkannt - unter Linux (nativ und Proton) und Windows.

2. Jeder Mod im Blick
Dein lokaler mod-Ordner und deine Steam-Workshop-Abos im Karten-Raster mit Icon, Name und Beschreibung. Liest jedes Container-Format - einfache .scs, ZIP-basierte .scs, HashFS v1/v2 und entpackte Ordner - sodass auch ein Workshop-Mod namens universal.scs seinen echten Namen zeigt.

3. Echtes Drag and Drop fuer die Ladereihenfolge
Der Manager im Spiel schiebt einen Mod nur Zeile fuer Zeile - bei 300 Mods heisst das 150 Klicks, um einen in die Mitte zu bekommen. Hier scrollst du einfach zur Stelle und ziehst ihn rein. Die aktive Liste ist nach Abschnitt gruppiert (Finanzen, Sound, Trucks, Trailer, Maps...) und die Reihenfolge wird direkt in die profile.sii zurueckgeschrieben.

4. Map-Combos
Exportiere deine Map-Reihenfolge in eine Datei und teile sie. Andere importieren sie und ihre Maps werden in genau deine Reihenfolge gesetzt. Fehlende Maps werden mit Namen aufgelistet, und eine veraltete Map (du hast 2.2, die Combo nutzte 2.4) wird als Hinweis angezeigt.

5. Kompatibilitaets- und Konflikt-Pruefung
Mods werden gegen deine Spielversion geprueft, genau so wie es das Spiel macht. Und wenn zwei aktive Mods dieselbe def-Datei ueberschreiben, bekommst du einen Hinweis - damit du sie bewusst anordnest.

6. Komfort
Favoriten, Profil-Backup und Wiederherstellung, vollstaendige Oberflaeche auf Englisch und Deutsch.

Kostenlos und Open Source (GPL-3.0). Linux & Windows.
Verfuegbar als AppImage, Windows-.exe, .deb, .rpm, portable tar.gz und im AUR.

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

Developed from SwitchBros with for Linux & the ETS2 & ATS community

[abasstreppas]

Hmm, interesting. I'll may give it a shot as this is just what the game is missing. Even though I only have 80+ mods it's chore to move them around

[rs_varel]

If only it actually worked... for over an hour, all you see is a blue circle (the program is supposedly searching for mods), and then crash. After that, it crashes immediately every single time. Pure junk!

[BeckysFootSlave]

If only it actually worked... for over an hour, all you see is a blue circle (the program is supposedly searching for mods), and then crash. After that, it crashes immediately every single time. Pure junk!

Sorry to hear it crashed for you - that's exactly the kind of thing I want to fix, so thanks for reporting it even if it was frustrating.

The "blue circle for a long time, then a crash" almost always means the mod scan got stuck on one specific archive (a very large or unusual container). To find out which one, could you help me with a few things?

1. Your OS and version (Windows 10/11? which build?)
2. Roughly how many mods are in your mod folder / Workshop?
3. I implement a logging system now into the app then you can provide me something I can work with.

With the log I can almost certainly see which mod it chokes on and fix the reader for that case.

For the record: I develop and test on Linux, where it runs fine for me. The Windows build is newer and hasn't had as much testing yet - so reports like yours genuinely help me make it solid on Windows too.

[rs_varel]

Windos 11 26200.8524
ca. 7000 mods (its difficult to sort out)

[16tonn]

It runs from the .exe file, and after registering, it can see the game, but it can't see the Workshop mods. How can I add Russian? I created the JSON file myself.

[BeckysFootSlave]

Windos 11 26200.8524
ca. 7000 mods (its difficult to sort out)

v1.1.2 writes a log file now. After it crashes, please open the menu Tools → Open log folder (or %LOCALAPPDATA%\easy-scsmodmanager\logs) and post the last ~30 lines here. With 7000 mods the scan alone takes a long while - the log will show us whether it dies during scanning or after, when building the UI.

[BeckysFootSlave]

It runs from the .exe file, and after registering, it can see the game, but it can't see the Workshop mods. How can I add Russian? I created the JSON file myself.

@16tonn Update on the Workshop issue: I checked the code - this one is on us. The Windows build currently never looks for the Steam Workshop folder at all, so no Settings change on your side can fix it. A fix is coming in the next update, I will post here when it is live. Sorry for the earlier detour, and thanks for the report - you found a real bug.

The Russian translation instructions from my post above still fully apply. Looking forward to the PR!

[16tonn]

Sorry for the earlier detour, and thanks for the report - you found a real bug.

"He who does nothing makes no mistakes." I already took a screenshot... The only thing I don't know is how to run the distribution instead of the executable.
https://iimg.su/i/N4mSmE

[BeckysFootSlave]

@16tonn @rs_varel
The app is now out as 1.1.3 (should work with workshop on windows)

Please get new one from github!

@16tonn Good question - the .exe bundles all resources, so to test your translation you run the app from source. On Windows:

1. Install Python 3.13+ from python.org (tick "Add python.exe to PATH" in the installer)

2. Get the source: green Code button on GitHub -> Download ZIP -> unpack it (main is currently v1.1.3)

3. Open a terminal (cmd) in the unpacked folder and run these three commands, one after the other:

Code: Select all

python -m venv .venv
.venv\Scripts\activate
pip install -e .

4. Put your translation at:

Code: Select all

easy_scsmodmanager\resources\i18n\ru\main.json

5. Start the app with:

Code: Select all

python -m easy_scsmodmanager

6. Settings -> Language -> Русский, then restart the app

That is all - the app picks up any language that ships a main.json, and the Russian entry is already prepared, so your folder shows up in the dropdown on its own. If a text shows as a raw key like "menu.file.refresh", that key is still missing in your file - easy to spot.

For the PR: only the new folder easy_scsmodmanager/resources/i18n/ru/ is needed, nothing else. Looking forward to it!