Spoiler tag

Thursday, May 19, 2016

JSRF Tool 2.0b : model viewer + texture modding made easy!

Hey! Long time no see!

I am not doing much JSRF stuff anymore but since someone asked about modifying textures I am releasing a new tool that I worked on and off here and there.

It has the model viewer I have shown before (still buggy on some models) and more importantly a texture viewer that also allows you to easily edit textures, save changes and upload the modded files to the Xbox in a few clicks.

Also keep in mind this tool does not extract models just preview them, for texture it extracts and converts them to BMP but only in a temporary folder to be automatically opened in the image editor, if you want to extract models or textures in mass use the older tool, top right of the blog for the download link to the old tool.

JSRF Tool 2.0b features:
-Folder/File browser
-Model Viewer (unfinished: some models dont display the proper texture) 
-Texture viewer
-Texture automatic conversion and transfer to image editor
-Texture import from image editor
-One click file upload to the Xbox and automatically clears cache for uploaded file so changes refresh.

If you are just going to use the tool to view models, you'll need to have the JSRF game files somewhere on your PC, you can extract the files from an xbox ISO, won't got into details you can google on how to get the files ;)

Using the tool

When you start the tool, first thing you'll want to do is go to the Settings tab:

JSRF Media Folder (modding): click Select folder and select the "Media" folder of the JSRF files, once you do that the contents of the media folder should appear in the tool:

This is going to be the files the tool will load and if you modify the textures the files in that folder will be saved/modded.

Browsing & previewing models/textures 

Now that the JSRF Media folder is setup, browse in the JSRF tool to Media\Players\ and double click on Beat.dat for instance:

A series of nodes appear on the right when a file is opened, red(pink?) contain models, orange nodes contain textures, beige are materials, uncolored nodes are empty or unknown data.

Double click on the red node it should open up with a few items, select the first one, a wild headless beat has appeared!

 You can rotate the camera around the model with the mouse, hold right click to rotate, hold middle mouse button to move, scroll wheel to zoom in-out.

Try loading other models, player models in JSRF are in most cases split in several models, for different head expressions or animated cloth etc

 Now try the texture nodes

Generally .dat files contain models and textures, .bin are usually for animation data, gameplay or other data.

That's pretty much it to browse stuff :)

Modding texture files

If you want to mod the game textures, you'll need a modded xbox with the game installed in the xbox hard drive and a modded dashboard that has FTP, so you can connect your xbox to your pc to send the modded files to the xbox.

Assuming you have all that setup and working lets go back to the JSRF tool settings tab and configure a few more things.

JSRF Media Folder original files:  is used in case you want to restore the original files, if you want to be able to do this in case you modify files, first make a copy of the JSRF Media folder and name it something different like Media_original and select that folder for "JSRF Media Folder original files".

This is just optional, in case you want to easily restore a file to its original state.

JSRF Files (Xbox)
The tool uses this to connect to the xbox and send the modded files through FTP.
Set the xbox IP address the login and password, lastly the path where the JSRF game files are installed in the xbox HDD.

Prefered Texture Editor
Select the path to your image editor tool of your choice.

  Once you have a file opened and a texture loaded click "Edit texture", this will extract and convert the texture to a temporary folder (in JSRF_Tool_2.0b\resources\tmp\), it will then open up the file in the image editor of your choice.

Edit the image there and once you are done save the file, go back into the JSRF tool and click "Save Changes".
This will re-import the image that was opened in the image editor, convert it back to DDS and re-write the JSRF file, in this case 'beat.dat'.

FTP file to Xbox: this will upload the file that's currently open in the JSRF tool, to the xbox.

Your xbox should be running on the dashboard with FTP and connected to your PC through ethernet and of course with the proper IP network settings so the PC and xbox can communicate but I am assuming hopefully you already know about this if you have a modded xbox.

It should take one second at most to upload, the tool also automatically clears the cache so its reloaded when you load the game.

Unfortunately I didn't yet code a way to inform if the FTP connection fails or the upload progress, so even if it fails or succeeds it wont show anything, the app locks up for a second while it uploads though so you'll know when its done.

Start the game after uploading the modded file(s) and if the FTP worked you should see the changes, if not make sure your FTP and IP settings are correct, try to ping the xbox, try using an FTP client to make sure your xbox FTP setup works.

Revert to original file:
this button will copy the file from the original JSRF folder to the JSRF modding files folder, for the filename that's currently open.

For instance lets say I have my modded beat.dat opened in the tool, if I click revert to original file, it will copy the file


Anyways, I think that covers pretty much everything you need to know about the tool, if you have any questions feel free to ask in the comments.