SXC PATH FINDER
A Companion Tool for SXC Extractor
 

Prologue

Some users may having trouble when trying to extract certain HashFS formatted mod file by using SXC Extractor, especially with tons of reported missing items has been found. Came from that reason, the SXC Path Finder was written in the hope those missing items can be significantly reduced.

SXC Path Finder (can be pronounced as Sexy Path Finder) intended 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.



Visit SXC discussion thread at SCS Forum and drop a comment there
if you have problem, find bug, or just want to say hi.
Basic Usage
About the Program
Working with Parameters

Basic Usage

 

About the Program

SXC Path Finder is a console program runs under Microsoft Windows. It is a simple text based application. No fancy GUI and no bullsh*t. It comes without installer. SXC Path Finder is shipped together as addons with SXC Extractor. Extract the SXC Extractor package using any ZIP Archiver program onto a destination folder of your choice. SXC Packer is stored under addonspathfinder sub-folder. From Windows Explorer, press Shift + Right Click on the SXC Path Finder folder then choose a menu item labeled as "Open Command Prompt from here" or "Open Power Shell from here" depending on your Windows version. Running SXC Path Finder can be done by typing:
sxclist
Or with Power Shell console:
.\sxclist.exe
After typing, press the Enter key on the keyboard to actually execute the application. Running SXC Path Finder without any parameter will just display a usage tips of parameter description, which will described more details below.
 

Working with Parameters

SXC Path Finder requires at least a single parameter in order to function. The parameter in an input file, must pointing to an existing file location of HashFS mod file (.scs).

Let say we have an HashFS mod file located on C:\temp\modfile.scs and we want to search all valid file name entries on it. Run SXC Path Finder as follows:
sxclist C:\temp\modfile.scs
Or with Power Shell console:
.\sxclist.exe C:\temp\modfile.scs
Any valid entry that found will be displayed into the standard output, which is the screen by default. If you want to save these entries to a file, you need to supply the second parameter that define an output text file name to store the entries. Please remember this output file will be overwriten if exists.

From the previous example, let say we want to store all these valid entries had been found to be stored in C:\temp\missing_items.txt. Run SXC Path Finder as follows:
sxclist C:\temp\modfile.scs C:\temp\missing_items.txt
Or with Power Shell console:
.\sxclist.exe C:\temp\modfile.scs C:\temp\missing_items.txt
Only mod files are supported by SXC Path Filder. If you specify an input file that belongs to game data (i.e. base.scs or def.scs), SXC Path Finder will simply reject it.
Please note, between parameter must be separated with (at least) a space character. If a parameter contains spaces, you should enclose it with double-quotes. Take a look at this example:
sxclist C:\temp\modfile.scs "C:\my temp\missing items.txt"
If no entry is found, SXC Path Finder will not create the output file.
The process may took times, especially with large mod file. When complete, all file names that can properly used as Name Resolver List will be stored in output file. Later, you can use this output file to resolve missing items when using SXC Extractor through -bl switch. For example:
sxc C:\temp\modfile.scs -bl C:\temp\missing_items.txt
 

Epilogue

The author of SXC Path Finder has no relation and is not affiliated with SCS Software. SXC Packer is made by user for users, in the hope it comes useful and handy for modders. Have fun, keep trucking, and happy modding!

---ooOoo---