No Man's Sky Modding Wiki
No edit summary
Tag: Visual edit
(Improved setup guidance for NMS Modding Station)
Tag: Visual edit
Line 11: Line 11:
 
In order to extract assets from the archives, you may use the [https://nomansskymods.com/mods/nms-modding-station/ NMS Modding Station]. NMS Modding Station is easy to use, simply download it, unzip the folder and extract the .exe and readme anywhere you like, and follow the instructions. However, you may also continue reading and this will guide you how to use it. Upon double-clicking the .exe it may appear dysfunctional, but this is because first you must go to the upper left Setup option and configure the paths to the PCBANKS folder and a folder for where you want to unpack its contents (i.e. the aforementioned .paks' content).
 
In order to extract assets from the archives, you may use the [https://nomansskymods.com/mods/nms-modding-station/ NMS Modding Station]. NMS Modding Station is easy to use, simply download it, unzip the folder and extract the .exe and readme anywhere you like, and follow the instructions. However, you may also continue reading and this will guide you how to use it. Upon double-clicking the .exe it may appear dysfunctional, but this is because first you must go to the upper left Setup option and configure the paths to the PCBANKS folder and a folder for where you want to unpack its contents (i.e. the aforementioned .paks' content).
   
Different PAK files contain different files for the game. While some modders who wish to save disk space will simply unpack specific files, it is preferable to unpack all of the game's archives for now. Reserve at least up to 13 GB of space on your game install directory. As of the 1.24 Path Finder Update, about 10.3 GB of space is used when everything is unpacked.
+
Different PAK files contain different files for the game. While some modders who wish to save disk space will simply unpack specific files, it is preferable to unpack all of the game's archives for now. Reserve at least up to 25 GB of space on your game install directory. As of the 1.50 NEXT Update, about 22.3 GB of space is used when everything is unpacked.
   
  +
In order to begin unpacking, you first have to setup few directories from the Setup menu:
In order to begin unpacking, simply select the Unpack Game Files option in the Setup dropdown menu in NMS Modding Station once you've provided it the proper paths. The unpacking process usually takes anywhere between 15-25 minutes on a standard HDD.
 
  +
* '''Set Path to Unpacked Game Files''' - This is a folder you will create, and in which all the No Man's Sky files will be unpacked. It is preferable to have made your unpacked directory in the same folder as the original /PCBANKS/, so /GAMEDATA/ but it is not essential.
  +
* '''Set Path to MBINCompiler''' - The folder where you stored MBINCompiler, one of the tools you downloaded. It is preferable to place this in a different directory as you will come back to this tool very frequently.
  +
* '''Set Path to PCBANKS''' - The path to the source files of No Man's Sky. Its location differs if you got the game on Steam (''\Steam\steamapps\common\No Man's Sky\GAMEDATA\PCBANKS\'') or GOG (''\GOG Galaxy\Games\No Man's Sky\GAMEDATA\PCBANKS'').
 
After you are done with these steps, simply select ''Unpack Game Files'' from the ''Setup'' dropdown menu in NMS Modding Station. The unpacking process usually takes anywhere between 15-25 minutes on a standard HDD.
   
 
== After Unpacking: The MBIN Format ==
 
== After Unpacking: The MBIN Format ==
After NMS Modding Station has finished unpacking, your unpacked directory should now show completely new folders and files where all the files of the game are organized. It is preferable to have made your unpacked directory in the same folder as the original /PCBANKS/, so /GAMEDATA/, but it is not essential.
+
After NMS Modding Station has finished unpacking, your unpacked directory should now show completely new folders and files where all the files of the game are organized.
   
 
The most common filetype you will see throughout these new folders are *.MBIN files. These are basically serialized [http://www.w3schools.com/xml/ XML files]. These files contain the bulk of configurations the game reads such as [[DESCRIPTOR Files|controls for procedural generation]], the [[ENTITY Files|behaviors of in-game objects]], and so on.
 
The most common filetype you will see throughout these new folders are *.MBIN files. These are basically serialized [http://www.w3schools.com/xml/ XML files]. These files contain the bulk of configurations the game reads such as [[DESCRIPTOR Files|controls for procedural generation]], the [[ENTITY Files|behaviors of in-game objects]], and so on.
   
Since MBIN files are encrypted, you will still need to decompile these files into a more human-readable form with the use of the [https://github.com/monkeyman192/MBINCompiler/releases MBINCompiler]. Download the MBINCompiler and preferably place this on another directory as you will come back to this tool very frequently.
+
Since MBIN files are encrypted, you will still need to decompile these files into a more human-readable form with the use of the [https://github.com/monkeyman192/MBINCompiler/releases MBINCompiler].
   
 
To decompile .MBINs you must drag them onto the MBINCompiler executable. Once done, you will get a completely human-readable EXML file that can be opened with any text editor of your choice. Dragging an EXML file back onto MBINCompiler does the reverse, and recompiles the EXML into an MBIN file. If any changes were made to the EXML file, it will also attempt to recompile it into an MBIN, and should the changes be valid, recompile without issue.
 
To decompile .MBINs you must drag them onto the MBINCompiler executable. Once done, you will get a completely human-readable EXML file that can be opened with any text editor of your choice. Dragging an EXML file back onto MBINCompiler does the reverse, and recompiles the EXML into an MBIN file. If any changes were made to the EXML file, it will also attempt to recompile it into an MBIN, and should the changes be valid, recompile without issue.

Revision as of 15:19, 26 July 2018

This quick guide has the goal of quickly introducing fundamental aspects to modding No Man's Sky without going into many specifics. Primarily this focuses on accessing your game files and introducing some core tools involved with modding.

You will be using three tools for the time being:

MBINCompiler is linked in the tutorial below.

Accessing Game Assets

No Man's Sky stores all of its assets, from textures to models, shader code to entity behaviors, in the PSARC archive format used in general for PlayStation games. All these archives can be found under No Man's Sky/GAMEDATA/PCBANKS/ and have the extension *.pak.

In order to extract assets from the archives, you may use the NMS Modding Station. NMS Modding Station is easy to use, simply download it, unzip the folder and extract the .exe and readme anywhere you like, and follow the instructions. However, you may also continue reading and this will guide you how to use it. Upon double-clicking the .exe it may appear dysfunctional, but this is because first you must go to the upper left Setup option and configure the paths to the PCBANKS folder and a folder for where you want to unpack its contents (i.e. the aforementioned .paks' content).

Different PAK files contain different files for the game. While some modders who wish to save disk space will simply unpack specific files, it is preferable to unpack all of the game's archives for now. Reserve at least up to 25 GB of space on your game install directory. As of the 1.50 NEXT Update, about 22.3 GB of space is used when everything is unpacked.

In order to begin unpacking, you first have to setup few directories from the Setup menu:

  • Set Path to Unpacked Game Files - This is a folder you will create, and in which all the No Man's Sky files will be unpacked. It is preferable to have made your unpacked directory in the same folder as the original /PCBANKS/, so /GAMEDATA/ but it is not essential.
  • Set Path to MBINCompiler - The folder where you stored MBINCompiler, one of the tools you downloaded. It is preferable to place this in a different directory as you will come back to this tool very frequently.
  • Set Path to PCBANKS - The path to the source files of No Man's Sky. Its location differs if you got the game on Steam (\Steam\steamapps\common\No Man's Sky\GAMEDATA\PCBANKS\) or GOG (\GOG Galaxy\Games\No Man's Sky\GAMEDATA\PCBANKS).

After you are done with these steps, simply select Unpack Game Files from the Setup dropdown menu in NMS Modding Station. The unpacking process usually takes anywhere between 15-25 minutes on a standard HDD.

After Unpacking: The MBIN Format

After NMS Modding Station has finished unpacking, your unpacked directory should now show completely new folders and files where all the files of the game are organized.

The most common filetype you will see throughout these new folders are *.MBIN files. These are basically serialized XML files. These files contain the bulk of configurations the game reads such as controls for procedural generation, the behaviors of in-game objects, and so on.

Since MBIN files are encrypted, you will still need to decompile these files into a more human-readable form with the use of the MBINCompiler.

To decompile .MBINs you must drag them onto the MBINCompiler executable. Once done, you will get a completely human-readable EXML file that can be opened with any text editor of your choice. Dragging an EXML file back onto MBINCompiler does the reverse, and recompiles the EXML into an MBIN file. If any changes were made to the EXML file, it will also attempt to recompile it into an MBIN, and should the changes be valid, recompile without issue.

However, this also means that you may wish to copy MBINs you're looking to change into a /_backup folder in its directory, so that you can revert to the default and rework any changes you may have been experimenting with, without having to unpack the archives all over again.

Where to start?

A good place to begin after this is to try adding existing objects to the build menu in the game. This is a relatively simple process that gives you a sense for how to mod the game, and helps to introduce you to the way the game files tend to be interconnected.