NoMansSky:Tutorials/PSArcTool Guide: Difference between revisions

From Step Mods | Change The Game
 
(42 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTITLE__
{{#set:
{{NMSPage|contentTitle=How to use PSARCTool}}
NMSIndex=PSArcTool
{{TOC_right}}
}}{{PageTitle|logo=nomanssky|title=PSArcTool Guide|author=Lo2k|forumtid=15901}}
{{NMSPage}}
{{TOC}}[[Category:NoMansSky General Guides]]
== Introduction ==
== Introduction ==
PSARCTool is a tool created by Periander to uncompress .pak files to and from usual files and folder.<br>
All No Man's Sky game assets are stored in compressed files, the .pak files.<br>
To simplify, .pak files are just another .zip format. It stores in one file several files and folders in a compressed form.
To compress and uncompress .pak files, a little program called PSARCTool was created by Periander at the early days of No Man's Sky, but as the format never evolved, you can still use PSARCtool to unpak mods created for the very first game version !
This format as never changed since the initial release of No Man's Sky.<br>
This means you can still unpak mods created for the very first version of the game !


== Using PSARCTool ==
== Using PSARCTool ==
PSARTool is very easy to use :  
PSARTool is very easy to use :  
* just drag and drop any .pak file over it and it will decompress it into the contained files and folders.
* drag and drop any .pak file over it and it will decompress the files and folders contained in the .pak file.
* just drag and drop any group of files and folders over it and it will compress them into a psarc.pak file.
* drag and drop any group of files and folders over it and it will compress them into a "psarc.pak" file.


== Extracting all the game assets ==
== Extracting all the game assets ==
If you want to start modding, the first thing to do is to extract all the .pak files.
If you want to start modding, the first thing to do is to extract all the .pak files.<br>
The same way is used here : select all the .pak files from the game PCBANKS folder and drag them over the tool icon.
To do so, select all the .pak files from the game PCBANKS folder and drag them over the tool icon.<br>
Be aware though that this will open as many instance of PSARCTool than there are .pak files !
 
This means you won't really be able to use your computer for a few minutes, the time all the game assets will be extracted.
Be aware though that this will open as many instances of PSARCTool than there are .pak files !<br>
Be also aware that you will need some free space on your hard drive as latest 2.61.1 assets occupy 24.1GB !
This means you won't really be able to use your computer for a few minutes, the time all the game assets will be extracted.<br>
Be also aware that you will need some free space on your hard drive as the 4.08 game version assets occupy 32.4GB !
 
{{AlertSmall‏‎|type=warning|text=Extracting all the .pak at once will occupy your CPU at 100% for some minutes and will fill about 33GB of your hard drive !}}


== repacking a simple mod ==
== repacking a simple mod ==
For a mod, you often only edit a single file, or just a few of them.<br>
For a mod, you often only edit a single file, or just a few of them.<br>
If the file is a global, no problem as it is at the root of the extracted files.<br>
If the file is a global, no problem as it is at the root of the extracted files.<br>
But if it is nested inside some folders, it is important that the exact same folder structure will be kept and dragged over PSARCTool exe.
But if it is nested inside some folders, it is important that the exact same folder structure will be kept and dragged over PSARCTool exe.<br>
Moreover, you don't need all the other files around in each folder or subfolder, only the one(s) you edited for your mod.
Moreover, you don't need all the other files around in each folder or subfolder, only the one(s) you edited for your mod.<br>
So to prepare your mod, it's better to recreate the same folder structure before dragging it over PSARCTool.
So to prepare your mod, it's better to recreate the same folder structure before dragging it over PSARCTool.


For example :<br>  
For example :<br>  
You edited the '''REWARDTABLE.MBIN''' that was previously inside '''METADATA\REALITY\TABLES''' (You didn't edit it directly in the original folder, didn't you ?).
You edited the '''REWARDTABLE.MBIN''' that was previously inside '''METADATA/REALITY/TABLES''' (You didn't edit it directly in the original folder, didn't you ?).
Then to prepare your mod :
Then to prepare your mod :
* create a METADATA folder, enter it
* create a METADATA folder, enter it
* (inside the MEDATATA folder) create a REALITY folder, enter it
* (inside the MEDATATA folder) create a REALITY folder, enter it
* (inside the REALITY folder) create a TABLES folder, enter it
* (inside the REALITY folder) create a TABLES folder, enter it
* copy or cut yoru REWARDTABLE.MBIN file inside this TABLES folder
* copy or cut your edited REWARDTABLE.MBIN file inside this TABLES folder
Now you can go back and drag the METADATA folder over PSARCTool and get a clean and very small mod .pak file.
Now you can go back and drag the whole METADATA folder over PSARCTool and get a clean and very small mod .pak file.
 
{{warning small|text= if a new mod doesn't work, it's often because the original folder structure is not respected. to check it : unpak your .pak file. If you have extra folders before the game folders i.e. "My Documents\My project\METADATA" then you have to repak your mod.
 
 


Once you extracted the files from the .pak, you can now edit them directly (textures, .BIN files...) or [https://wiki.step-project.com/NMS:Tutorials/HowToMBINCompiler decompile them with MBINCompiler] (.MBIN files).<br>
== Possible issues ==
It's now up to make the changes that will create a great mod !
if a new mod doesn't work, it's often because the original folder structure is not respected.<br>


[[Category:No Man's Sky]][[Category:NMS-Tutorial]]
Possible causes :
{{NMSPageClose}}
* somewhere in the path you have some folders with uncommon characters.
* your files are nested inside so many sub folders on your computer than PSARCTool can't get the correct path (i.e. "My Documents/My project/METADATA").
The best solution in both cases is to move your mod folders closer to the root of your hard drive, like in C:/ or on the desktop.

Latest revision as of 14:44, January 11, 2023

Nomanssky flare.png

PSArcTool Guide

by: Lo2k  | Forum Topic

Introduction[edit | edit source]

All No Man's Sky game assets are stored in compressed files, the .pak files.
To compress and uncompress .pak files, a little program called PSARCTool was created by Periander at the early days of No Man's Sky, but as the format never evolved, you can still use PSARCtool to unpak mods created for the very first game version !

Using PSARCTool[edit | edit source]

PSARTool is very easy to use :

  • drag and drop any .pak file over it and it will decompress the files and folders contained in the .pak file.
  • drag and drop any group of files and folders over it and it will compress them into a "psarc.pak" file.

Extracting all the game assets[edit | edit source]

If you want to start modding, the first thing to do is to extract all the .pak files.
To do so, select all the .pak files from the game PCBANKS folder and drag them over the tool icon.

Be aware though that this will open as many instances of PSARCTool than there are .pak files !
This means you won't really be able to use your computer for a few minutes, the time all the game assets will be extracted.
Be also aware that you will need some free space on your hard drive as the 4.08 game version assets occupy 32.4GB !

Warning-Logo.png
WARNING:
Extracting all the .pak at once will occupy your CPU at 100% for some minutes and will fill about 33GB of your hard drive !

repacking a simple mod[edit | edit source]

For a mod, you often only edit a single file, or just a few of them.
If the file is a global, no problem as it is at the root of the extracted files.
But if it is nested inside some folders, it is important that the exact same folder structure will be kept and dragged over PSARCTool exe.
Moreover, you don't need all the other files around in each folder or subfolder, only the one(s) you edited for your mod.
So to prepare your mod, it's better to recreate the same folder structure before dragging it over PSARCTool.

For example :
You edited the REWARDTABLE.MBIN that was previously inside METADATA/REALITY/TABLES (You didn't edit it directly in the original folder, didn't you ?). Then to prepare your mod :

  • create a METADATA folder, enter it
  • (inside the MEDATATA folder) create a REALITY folder, enter it
  • (inside the REALITY folder) create a TABLES folder, enter it
  • copy or cut your edited REWARDTABLE.MBIN file inside this TABLES folder

Now you can go back and drag the whole METADATA folder over PSARCTool and get a clean and very small mod .pak file.

Possible issues[edit | edit source]

if a new mod doesn't work, it's often because the original folder structure is not respected.

Possible causes :

  • somewhere in the path you have some folders with uncommon characters.
  • your files are nested inside so many sub folders on your computer than PSARCTool can't get the correct path (i.e. "My Documents/My project/METADATA").

The best solution in both cases is to move your mod folders closer to the root of your hard drive, like in C:/ or on the desktop.