[TOOL] SXC Extractor - Flexible Game Data/Mod File Extraction Tool (UPDATE December 24, 2023)

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.
Post Reply
madman271
Posts: 36
Joined: 18 May 2019 11:25

[TOOL] SXC Extractor - Flexible Game Data/Mod File Extraction Tool (UPDATE December 24, 2023)

#1 Post by madman271 » 21 Sep 2019 06:55

SXC Extractor is a tool to extract ETS2/ATS game data files. This tool has similar main functionality as the official SCS Extractor, with additional improvements and features:
  • List items (path and filename) through List Mode.
  • Selective file extraction and listing based on path and wildcard filtering.
  • Support "encrypted" mod zipped file extraction.
  • Can handle particular game data/DLC file where SCS Extractor fails.
Like the official SCS Extractor, this tool is also a console (text-based) program running under Windows Command Prompt or Power Shell console window. Require minimal Windows 2000 to run, support both x86 (32-bit) and x64 (64-bit) Windows architecture. SXC Extractor is stand-alone Windows application without needs any run-time or redistributeble library packages. It does not require platform foundation like .NET Framework, Java, etc. Just a Windows OS and SXC Extractor, you good to go.


SPECIAL CASE
Certain SCS game data file (e.g. core.scs and locale.scs) has directory structures stripped for some reason. To work with such kind of file which is returning "no root path" error message, put additional "-137243" switch when working with the file for the first time. Next time accessing the same file there is no need to use the switch as long as the game data file isn't updated and the associated index file (*.idx) intact (this is no longer necessary with game files such as core.scs, base_cfg.scs, and locale.scs).


SUPPORTED FILE TYPE
SXC Extractor can handle both native game data/DLC file (*.scs) usually stored on Steam folder, as well as mod zipped file (*.scs, *.zip) especially the ones that "encrypted" to prevent users looking at the contents.


LIMITATIONS
This tool does not fully tested especially with various "encrypted" mod zipped files. If you find problems or bugs, please let me know by posting comments in this thread.


SUPPORTS
Supports (questions, problems, bugs) are given through this thread only. Contacting me by PM, email or any others regarding this tool will be ignored. If you asking for permission, the answer is YES. If you asking for source codes, the answer is NO. This tool comes without any warranty. You are free to re-upload or redistribute this tool. Read "license.txt" included in the tool's package.


INCLUDED IN ZIP
  1. Text2Hash
    A small tool to calculate 64-bit hash from the given text (normally a file path). These 64-bit hashes can be used to compare file identity that stored in SCS HashFS formatted file (*.scs). This tool may be fully useful for advanced modder who want to crack down a complex HashFS mod file. (No longer shipped starting with SXC Extractor 1.22.9.10)
  2. SXC Path Finder
    A tool to search any occurences of defined file names on whole files stored in an HashFS formatted mod file. Any proper file names found then can be used in the purpose as Name Resolver List in SXC Extractor through the -bl switch. This tool intended to cut working time and hassles when extracting complex HashFS mod file. This tool is far from perfect. It is possible not all occurence of file names will be found.
  3. SXC Packer
    A handy tool to compress and pack mod file in a new way, packing it into SCS proprietary HashFS format. Besides of compressing whole entries within a folder, SXC Packer comes with additional feature like: exclude certain folders and files, hide/strip folders and files from HashFS directory structures, and encrypt certain unit files (*.sii).

32-BIT VS. 64-BIT VERSION
Downloaded Package distribution below includes 32-bit and 64-bit version of SXC Extractor, SXC Packer, and SXC Path Finder. The executable filename of 64-bit version are sxc64.exe, sxcpack64.exe, and sxclist64.exe respectively. There are no differences between 32-bit and 64-bit version in the context of features and functionalities. The 64-bit version, however, must be running under Windows x64 platform and runs faster compared with the 32-bit version.


CHANGELOG
  1. SXC Extractor 1.23.12.24
    (Release date December 24, 2023)
    • Error handling reworked.
    • Warning will be given when filtering with "!" symbol without supplying base path (the -d switch).
    • Warning will be given if no entries match any specific pattern filter.
    • Minor fixes and improvements.
  2. SXC Packer 1.0.23.1224
    (Release date December 24, 2023)
    • Introduce -a switch: always pack empty folders and files.
    • Introduce -ad switch: always pack empty folders.
    • Introduce -af switch: always pack empty files (zero sized).
    • Error handling reworked.
    • Minor fixes and improvements.
  3. SXC Path Finder 1.0.23.1224
    (Release date December 24, 2023)
    • Minor fixes and improvements.

CONTRIBUTORS (in alphabetical orders)
Happy modding!


DOWNLOAD LINKS
Version 1.23.12.24 (latest version)

sxc-01231224.zip 1.3 MB Integrity & Authenticity Validation: (For those who concern with secure environments)
  • ZIP File SHA-256 Digest:

    Code: Select all

    f16aa1e82554e02d9852613fb883f5375621a1a3f187250da50a1669e85bb256
    Do not open and extract the downloaded ZIP archive file if does not match the hash digest above, which mean your downloaded ZIP file may corrupt during transfer, has been altered in purpose, or maliciously infected by something. ALWAYS USE DIGEST PROVIDED ONLY BY ORIGINAL AUTHOR!
  • For SHA-256 digest of all executable (.exe) files in the package, download the digest file here, and put the digest file into the main SXC installation folder prior checking the executable file integrity. You need a 3rd party tool that support SHA-256 checksum verification through a digest file (*.sha256).

OLDER VERSION (some links may already dead)

Code: Select all

Version 1.23.2.14 - sxc-01230214.zip 1.3 MB
(ZIP File SHA-256 Digest: f5e3b1b4ade60cb5099e3067e0f3679f3a1e655f6002c6c2b932c116f835bc34)
- GDrive    : https://drive.google.com/file/d/1PpJ3x3VaB54oA4xc-MkzILqiFbhOkXwf/view
- ShareMods : https://sharemods.com/nqrbe22zp3b5/sxc-01230214.zip.html
- ModsBase  : https://modsbase.com/b0y713m0lqte/sxc-01230214.zip.html

Version 1.22.12.10 - sxc-01221210.zip 1.2 MB
(ZIP File SHA-256 Digest: 5325c8282495c2a609ce9bf6284c85a112e2fd0cd745bd7f0b184046bcee23e9)
- GDrive    : https://drive.google.com/file/d/11iWckrUSWvhMvyxxQyfdI-0qH0EcOsWs/view
- ShareMods : https://sharemods.com/di6mysbb36p2/sxc-01221210.zip.html
- ModsBase  : https://modsbase.com/56y8zfje56jh/sxc-01221210.zip.html

Version 1.22.12.2 - sxc-01221210.zip 1.2 MB
(ZIP File SHA-256 Digest: d853d8414036f8c0ff3623fbdc3738a75d1ca47ce4204e256410cbee7dba3c8d)
- GDrive    : https://drive.google.com/file/d/1ieFQNUGFuigiRhLo1MnIgW1bzu-ytabw/view
- ShareMods : https://sharemods.com/tw0917xhmdps/sxc-01221202.zip.html
- ModsBase  : https://modsbase.com/jg1xdjxmypks/sxc-01221202.zip.html

Version 1.22.9.10 - sxc-01220910.zip (1.2 MB)
(ZIP File SHA-256 Digest: f68629473d9544e11d53c87dfe0a9ed94fc737fd798e075994e7ca19615a4c05)
- GDrive    : https://drive.google.com/file/d/1BFrjaQe6w5ZAn31UAJKVz1DIkm6SELW2/view
- ShareMods : https://sharemods.com/amv9gdgj914h/sxc-01220910.zip.html
- ModsBase  : https://modsbase.com/d1yohq6nwrpq/sxc-01220910.zip.html

Version 1.20.5.8 - sxc-01200508.zip (1.1 MB)
(ZIP File SHA-256 Digest: f4f4a0727ac03467df35ac3e9fec469344b5dda08e93760c2cfc7d368827fe91)
- GDrive    : https://drive.google.com/file/d/1KwHWpho6oIT151symXl4iUhSG9VGiFcL/view
- ShareMods : https://sharemods.com/hejb21mn3ja3/sxc-01200508.zip.html
- ModsBase  : https://modsbase.com/9nwjscr1jps0/sxc-01200508.zip.html

Version 1.19.12.30 - sxc-01191230.zip (1.1 MB)
(ZIP File SHA-256 Digest: ac05b3c8e204a6f246d54e6417332a8b541f833c75b51df0b18fde68b6f65124)
- GDrive    : https://drive.google.com/file/d/188tj1BHnKoKKwCFdeqKFq4VljBeKzA9i/view
- ShareMods : https://sharemods.com/m429svjlmx6z/sxc-01191230.zip.html
- ModsBase  : https://modsbase.com/e96y97puv9vv/sxc-01191230.zip.html

Version 1.19.12.20 - sxc-01191220.zip (1.1 MB)
- ShareMods : https://sharemods.com/1gkwtf09kr5j/sxc-01191220.zip.html
- ModsBase  : https://modsbase.com/7scncmpgy5dt/sxc-01191220.zip.html

Version 1.19.12.10 - sxc-01191210.zip (425 KB)
- ShareMods : https://sharemods.com/poodlvvyjd3e/sxc-01191210.zip.html
- ModsBase  : https://modsbase.com/shg4l9lbfft4/sxc-01191210.zip.html

Version 1.19.11.30 - sxc-01191130.zip (422 KB)
ShareMods : https://sharemods.com/ncx3iwnhzvyg/sxc-01191130.zip.html
ModsBase  : https://modsbase.com/sacawx6dkael/sxc-01191130.zip.html

Version 1.19.11.23 - sxc-01191123.zip (214 KB)
ShareMods : https://sharemods.com/9dwmjaq5ue4h/sxc-01191123.zip.html
ModsBase  : https://modsbase.com/cpu5k8tfc04i/sxc-01191123.zip.html

Version 1.19.11.16 - sxc-01191116.zip (214 KB)
ShareMods : https://sharemods.com/b7wt4qzmdhw4/sxc-01191116.zip.html
ModsBase  : https://modsbase.com/er3jpu5r5pou/sxc-01191116.zip.html

Version 1.19.10.27 - sxc-01191027.zip (202 KB)
ShareMods : https://sharemods.com/sat2iw1jkkn5/sxc-01191027.zip.html
ModsBase  : https://modsbase.com/le5lhw02i5gh/sxc-01191027.zip.html

Version 1.19.10.19 - sxc-01191019.zip (199 KB)
ShareMods : https://sharemods.com/l30a1kjsejn9/sxc-01191019.zip.html
ModsBase  : https://modsbase.com/g2n7otf1z0wm/sxc-01191019.zip.html

!BUGGY! Version 1.19.10.15 - sxc-01191015.zip (200 KB)
ShareMods : https://sharemods.com/pgzdsdk3d6yx/sxc-01191015.zip.html
ModsBase  : https://modsbase.com/sgr76y0uks0w/sxc-01191015.zip.html

!BUGGY! Version 1.19.10.12 - sxc-01191012.zip (198 KB)
ShareMods : https://sharemods.com/7pseqp79bq94/sxc-01191012.zip.html
ModsBase  : https://modsbase.com/9zko1d68cmsk/sxc-01191012.zip.html

Version 1.19.10.4 - sxc-01191004.zip (176 KB)
ShareMods : https://sharemods.com/q1yearfbix7u/sxc-01191004.zip.html
ModsBase  : https://modsbase.com/f21j47tf97xh/sxc-01191004.zip.html

Version 1.19.9.7 - sxc-01190907.zip (162 KB)
ShareMods : https://sharemods.com/id06lehi69cr/sxc-01190907.zip.html
ModsBase  : https://modsbase.com/m5yr3ei2z43b/sxc-01190907.zip.html



SXC INSTALLER
When you're using SXC for the first time, you may need to create a hash database from the game. You can either manually do this, or you can use this handy little tool, which does just that! Just download the installer from this website:

https://projects.openthe.site/sxc-installer/ (no longer exists)
Google Drive (view)

Place the contents of the zip file inside the root of SXC (where the sxc.exe file is located). Then double-click on install.bat, and the installation will start.

Note: SXC Installer is created by @luukf8. Any questions, suggestions, bug reports or anything else regarding to SXC Installer can directly send to him by mention or PM.


*SXC may short of SCS eXtractor Clone but may also pronounced as 'Sexy'.
Last edited by madman271 on 24 Dec 2023 14:50, edited 21 times in total.
User avatar
knox_xss
Posts: 1274
Joined: 20 Dec 2012 14:38

Re: [TOOL] SXC Extractor - Flexible Game Data/Mod File Extraction Tool

#2 Post by knox_xss » 21 Sep 2019 08:20

Thanks, man! ;)
Long way to Fuji starts with the first step!
User avatar
xXCARL1992Xx
Posts: 16524
Joined: 17 Aug 2016 12:18
Contact:

Re: [TOOL] SXC Extractor - Flexible Game Data/Mod File Extraction Tool

#3 Post by xXCARL1992Xx » 21 Sep 2019 08:32

great tool, only thing is that the extracted data from locale.scs for example is pretty much useless for now, same goes for EVRs soundmods, i am able to extract all data and can filter out the defs, dds, .tobj files etc. but the soundfiles cant be used because they dont retain their original names, so hours of trial and error wich file is wich sound ingame, but still better then nothing
| !!!NO SUPPORT OR REQUESTS OF ANY SORT VIA PM!!! | Screenshot Thread | Steam Workshop | World of Trucks Profil |
[ external image ]
madman271
Posts: 36
Joined: 18 May 2019 11:25

Re: [TOOL] SXC Extractor - Flexible Game Data/Mod File Extraction Tool

#4 Post by madman271 » 21 Sep 2019 13:21

@xXCARL1992Xx Files on locale.scs are all encrypted. You can decrypt them by supplying -271309 param argument when extracting them. I make such param undocumented because I realize SCS encrypt certain files for some reason.
User avatar
xXCARL1992Xx
Posts: 16524
Joined: 17 Aug 2016 12:18
Contact:

Re: [TOOL] SXC Extractor - Flexible Game Data/Mod File Extraction Tool

#5 Post by xXCARL1992Xx » 21 Sep 2019 13:30

ah ok, now it worked

do you have planes to include a function where the modder has "destroyed" the base root of the mod so no archive program can red it ?

if you need example mods for it i can send you some
| !!!NO SUPPORT OR REQUESTS OF ANY SORT VIA PM!!! | Screenshot Thread | Steam Workshop | World of Trucks Profil |
[ external image ]
madman271
Posts: 36
Joined: 18 May 2019 11:25

Re: [TOOL] SXC Extractor - Flexible Game Data/Mod File Extraction Tool

#6 Post by madman271 » 21 Sep 2019 15:02

Would be grateful if you could tell me which mods that has "unusual" ZIP entries that causing any extractor refuse to extract. If you can't provide them here, send me a PM with the mod name (and download link if possible). Thank you.
User avatar
xXCARL1992Xx
Posts: 16524
Joined: 17 Aug 2016 12:18
Contact:

Re: [TOOL] SXC Extractor - Flexible Game Data/Mod File Extraction Tool

#7 Post by xXCARL1992Xx » 21 Sep 2019 15:05

i would sent it via PM but you need to allow PMs first :lol:
| !!!NO SUPPORT OR REQUESTS OF ANY SORT VIA PM!!! | Screenshot Thread | Steam Workshop | World of Trucks Profil |
[ external image ]
User avatar
knox_xss
Posts: 1274
Joined: 20 Dec 2012 14:38

Re: [TOOL] SXC Extractor - Flexible Game Data/Mod File Extraction Tool

#8 Post by knox_xss » 21 Sep 2019 16:57

@madman271
  1. Agree with Carl - I also have "unusual" (not zip - "city") mod for you but I can't send you PM. :)
    Do you have an alternative contact - working e-mail, for example?
  2. About hidden params.
    You mentioned two: "-271309" and "-137243". Okay. Thanks.
    Are there others? Is it possible to get a description of them?
Long way to Fuji starts with the first step!
madman271
Posts: 36
Joined: 18 May 2019 11:25

Re: [TOOL] SXC Extractor - Flexible Game Data/Mod File Extraction Tool

#9 Post by madman271 » 22 Sep 2019 03:13

So sorry guys, now PM is active. :-)

@knox_xss That's mean the mod uses SCS (not ZIP) file format. The "-137243" param used to read SCS files with directory info stripped off (e.g. core.scs, locale.scs, etc). The "-271309" param behaves like the previous one with additional ability to decrypt files (e.g. locale.csc, base_cfg.scs). No need to use both, put "-271309" and you still able to open SCS files with stripped directory info. There's more but those two params are enough for now. :D
User avatar
Cadde
Posts: 6806
Joined: 24 Apr 2013 18:08
Location: Have no fear, i am from the internets!

Re: [TOOL] SXC Extractor - Flexible Game Data/Mod File Extraction Tool

#10 Post by Cadde » 22 Sep 2019 15:05

Yeah the problem with locale.scs is the paths are implied and hardcoded and not actually listed in the SCS# file. Some paths are listed though.

Same with mods that have "broken" central directories. I.E, no /base directory etc. These only list the files that are necessary for the game to know what to load. From there, all paths are generated from the definition files, data files and TOBJ files etc.
To extract those with preserved paths and filenames one would have to parse all those data files to determine which file paths are used in the mod and then match them with their respective city hashes.
On extended hiatus.
Post Reply

Return to “Others”

Who is online

Users browsing this forum: boarfrom, FreedomFries, LIPtoH and 14 guests