NoMansSky:Tutorials/When AMUMSS Fails

From Step Mods | Change The Game
Nomanssky flare.png

When AMUMSS Fails

by: Lo2k

Introduction

AMUMSS is a very robust piece of code and is very unlikely to fail per-say, but it has a weak point : it relies on MBINCompiler to decompile and recompile files.
MBINCompiler is indeed the only tool able to convert .MBIN files to .EXML and the reverse.
But as the game updates file structure regularly, it needs to constantly be updated to work properly.
And this can take some time. Please remind here that MBINCompiler is the work of one man, Monkeyman192, and that he has a life, as everyone.

So here are the situations where AMUMSS could "fail".

Game has been updated but MBINCompiler is not

It's the most common case.
A new update has been released and some files can't be converted anymore.
AMUMSS can't do anything else than using the current but not up-to-date MBINCompiler version that will fail to decompile or recompile some files.

in such case, you will result with lines like this one in AMUMSS' report:

[WARN]: MBINCompiler =[[WARN]: File not recognized. You may need to use an older version of MBINCompiler.]


There's sadly not much you can do here but wait for an MBINCompiler update. As AMUMSS is probing at each launch for an MBINCompiler update, as soon as a new MBINCompiler will be released, it will be downloaded and eventually the script or merge of scripts will work.
Be aware anyhow that MBINCompiler is often updated in a few steps and the first few releases after a big update might fix some file conversion but not all of them.
You might then need to wait a bit further for another MBINCompiler update to get your mod or merge of mods to be generated correctly.

If you want to manualy check MBINCompiler status, you can also check this page where you will get details on update progress too.

MBINCompiler has been updated for experimental branch but you're on the public branch

This is the second possible case.
It's more uncommon but it can happen as the developpers sometime release a few experimental updates before pushing the result to the public and stable branch.
As described in this page, No Man's Sky can be experienced via 2 branches : the public (default) branch and the experimental one (via a generic password).
The matter in this situation is that MBINCompiler has been updated for experimental files and can't compile or decompile anymore some of the public files correctly.

Hopefully, there's a workaround in this case. You just need to force AMUMSS to use the latest MBINCompiler made for the public version.

In practice, what you have to do is to follow "General Information for AMUMSS.txt" file and :

  • remove the x before your 'xOPT_CustomMBINCompiler.txt' in AMUMSS' folder
  • replace the MBINCOmpiler.exe file in MODBUILDER folder with the latest version made for the public branch. Here is the link to MBINCompiler release page
  • generate your mod or merged mod as usual


If you did as above, AMUMSS will use the specific version of MBINCompiler you downloaded and everything will work fine.
Just don't forget to rename the OPT file again with a x as soon as a new public version will be released to let AMUMSS downloading latest MBINCompiler version the next time it will be launched, or you will end in the first case described in the section above, using an out of date MBINCompiler version compared to the game version !