SCS Hub - Modding tools in one place

[AmirMahdavi]

[ external image ]

SCS games modding tools in one place

[ external image ][ external image ][ external image ]

[ external image ]


Link

[ external image ]


Install

• Windows
  • Download SCSHub_x.x.exe from releases and run file
  • Or you can procced with below instruction
• Linux, Mac
  • Required Python 3.10+ (maybe lower, not tested)
  • Clone repo or download repo zip

    Code: Select all

    git clone https://github.com/AmirMahdaviAM/SCSHub

  • Install requirements

    Code: Select all

    pip install -r requirements.txt

  • Run app

    Code: Select all

    python SCSHub.py

Feature

• SCS Tools
  • Official extractor and packer
  • Implemented feature
• Converter PIX
  • Multi base input
  • Single Model and Single TOBJ mode with conversion
  • Extract specific File or Folder without conversion
  • Animation export
  • Use old dds format
  • Past 1.47 material attributes
  • Animation finder
  • File and string hasher
• SXC Extractor
  • Single click finder & extractor (SXCFinder + My new path finder)
  • SXC Packer
  • SXC finder
• TOBJ Editor
  • Full attributes tobj editor and creator
  • Binary formant (import and export)
  • Text formant (only export)
  • 2D tobj support
• Def creator
  • Create simple def from pmd/pim accessory folder
  • Custom directory names
  • Custom name and filenames

Known issue

• App
  • Not tested in Linux and Mac
  • Open log and Open Folder buttons in InfoBar only work in windows
• SCS Tools & SXC Extractor
  • Only work in windows

Localization

If you want to help translate app to your language, Please check SCS Hub project in Crowdin


Thanks to

• zhiyiYo - PyQt Fluent Widgets and it's gallery app code
• mwl4 - Converter PIX project
• simon50keda - Converter PIX Wrapper for inspiration and code help

[Xuannghia1027]

thank you for your contribution

[AmirMahdavi]

Version 1.3 released

[ external image ]

Changelog:

Code: Select all

App:
UI Redesign
Banner change with colorize option
Added reset button in settings
Added credit section
Under-hood improvment
Single exe file for windows

SCS:
Added new scs extractor
Added scs packer

PIX:
Multi base input
Checkable animation .pma files
Add animation finder tab
Add hasher tab

SXC:
Added sxc finder
Added sxc packer
Custom path finder (implemented with sxc finder)

TOBJ:
Added full tobj editor and creator

DEF
Added accessory def creator

[JolanXBL]

Could you please update the software to include explanations as to what each of the files are for, how to get PIM files so Blender can read them, and when opening a TOBJ file, the software crashes.

[AmirMahdavi]

@JolanXBL if you want to import directly to blender you can use Covnerter PIX Wrapper

but if you want to use this tools:
1. go to PIX section in left panel
2. in Converter tab, click on Input button and choose archive(s) you want
suggested to select all base archives in game root folder and after loading, click on input again and select any other mod archive you want.
if will keep archive addresses in the input list (hold mouse on input button) until you click on recycle bin button and it will be reset.
3. now you choose (Model) mode and navigate to your model path
4. select and click on extract
5. it will be extracted to folder with first archive name and _exp in end of it(if you not changed the output manually)

i checked some tobj from game and it worked fine, could you please provide that tobj file to test it myself

[JolanXBL]

This is the confusing part of ATS editing. The button is called PIX extractor, it opens an SCS file, and displays a PMD model. That's 3 different extensions! But there is already an SCS button, and when that is used, it doesn't show any progress bar or what it's doing, just that it is doing something. So then why does the PIX extractor section show files while the SCS extractor section doesn't, yet they seem to do the exact same thing?

As for TOBJ, any file will crash the software. Here's the log:

INFO SCSHub (2024/09/04|22:21:54): App Started
INFO SCSHub (2024/09/04|22:21:54): Current working directory: "H:\Game stuff H\American Truck Simulator"
INFO SCSExtractor (2024/09/04|22:21:55): SCSExtractor exist
INFO PIXConverter (2024/09/04|22:21:55): PIXConverter exist
INFO SXCFinder (2024/09/04|22:21:55): SXCFinder exist
INFO TOBJEditor (2024/09/04|22:22:32): Set input file to "H:\Game stuff H\American Truck Simulator\Modding Files\_Base_vehicle\model\barrier\concrete\or_gray_wall.tobj"

Video:
https://jolanxbl.ca/games/ats/scshub-crash.mp4

[AmirMahdavi]

i think you should read modding wiki and tools documentation, scshub is just an gui over those tools

but for clarification
- scs extractor (packer) is official scs tools to extract whole archive (without conversion) and pack a mod folder
- pix converter is tool to view archive tree before any extraction and capable of extract whole archive or just only selected file
but main differences with scs tools is that it can convert model or tobj files from binary to readable format

- .scs files are game or mod archives
- .pmd are model files
- .tobj texture-object files
...


tobj are checked on two system and release and opened without error or crash
maybe problem in tobj extraction, extract them again with pix in FILE mode (NOT tobj)

tobj_test.jpg

[may]

Hello, I am using sxc to encrypt my work, but if I unlock it, I cannot. Removed - Rule 2.3 My Discord name is may0378_ck and I added you. You did not pass my friend request

[Dragolago]

This is a very good tool. I was wondering if you could add a map def creator automating the things in this video. Right now it's probably the most complicated part of making a map mod and it would be great if it could be semi-automated.

[tobrago]

@AmirMahdavi I sent you a request on Crowdin for the translation of your project into Serbian Cyrillic and Latin. I wish you success in your future work, but I noticed that you haven't updated in almost a year. Does that mean you have given up on the project or something else. I remind you that SCS has updated the packaging and the extractor.