AMUMSS

A tool to mod No Man's Sky (NMS) using lua scripts

AMUMSS is NOT a mod manager, nor can it be used as such. It is a script processor.

In other words: a tool that uses .lua scripts to create mod files

.lua scripts go into the ModScript folder (created after you run BULDMOD.bat)

NMS < v5.5, .pak files go into NMS PCBANKS\MODS (a folder you create to use mods with NMS)

NMS >= v5.5, mod are sub-folders in NMS GAMEDATA\MODS folder

QUESTIONS * Questions are better asked in NMS Discord: "No Man's Sky Modding" channel, "amumss-lua" room: https://discord.gg/HFjnmnwe67
We have channel #amumss-lua dedicated to AMUMSS/NMSPE with helpful modders and Wbertro#8596 (aka TheBossBoy)

FOR HELP WITH INSTALLATION: Refer to https://www.nexusmods.com/nomanssky/mods/2626

IMPORTANT NOTES: AMUMSS is always up-to-date (except with a MAJOR update like NMS > v5.5) but it needs MBINCompiler.exe to be updated (it is done automatically when available)

Current MBINCompiler.exe versions REQUIRE '.NET 8 x64 Desktop Runtime' latest version to run: It can be found at https://dotnet.microsoft.com/download/dotnet/8.0/runtime
(.NET 6/7/9/10... are NOT backward compatible with .NET 8)

STARTING July 17th, 2023: NEWER MBINCompiler.exe versions REQUIRE '.NET 6 x64 Desktop Runtime' latest version to run: It can be found at https://dotnet.microsoft.com/download/dotnet/6.0/runtime
(.NET 7/8/... are NOT backward compatible with .NET 6)

OLDER MBINCompiler.exe versions still REQUIRE '.NET 5 x64 Desktop Runtime' latest version to run: It can be found at https://dotnet.microsoft.com/download/dotnet/5.0/runtime
(.NET 6/7/8/... are NOT backward compatible with .NET 5)

For now, this is a repository of AMUMSS versions going forward.

SEE the RELEASES for latest version for NMS >= v5.5 or previous release for NMS < v5.5

These version will auto-update with the execution of BUILDMOD.bat. It may take one or many re-start of BUILDMOD.bat to bring it to the latest version. No worry, it is fast (only depends on your internet speed)

DOWNLOAD and INSTALLATION: *** Follow installation instructions found in file at https://www.nexusmods.com/nomanssky/mods/2626

DOWNLOAD COMPLETE VERSION * COMPLETE VERSION available as a .7z release at: https://github.com/HolterPhylo/AMUMSS/releases (you need the 'Latest' release: AMUMSS.7z, +/- 145MB) * 'Unblock' the downloaded file in 'Properties' in the windows explorer * you can unzip it with 7zip at: https://www.7-zip.org/download.html Unzipping in a folder like C:\AMUMSS is recommended

* IMPORTANT Note:
	+ Your anti-virus may detect some component of AMUMSS and block/quarantine it.
	  Be assure it is not a virus but its behavior may be interpreted as such by some anti-virus.
	+ Please make sure to create an 'exception' in your anti-virus BEFORE executing anything in AMUMSS main folder.
	+ Also a reboot may be required as some anti-virus do not correctly register the exception when it is created.

INSTALLATION * Complete the step in the DOWNLOAD COMPLETE VERSION section above before continuing
*** FOLLOW the instructions at https://www.nexusmods.com/nomanssky/mods/2626 ***

* No accented characters in the path of AMUMSS folder
* Always de-compress/un-zip in a new folder on any drive like X:\AMUMSS (OR in the previous folder)
  xxxxx NEVER in any system folder (Note: the Desktop, Downloads, Documents are system folders) xxxxx

    * If de-compressed/extracted in the previous folder, AMUMSS will preserve everything in user folders
      except changes made to AMUMSS files in AMUMSS main, ModScriptCollection and MODBUILDER folders

    * If de-compressed/extracted in a new folder, you can copy/paste these folders from the previous version of AMUMSS
      if you would like to preserve previous work and information...
            + 'Builds'
            + 'ModScript'
            + 'GlobalMEFTI'
            + 'TOOLS\NMSPE_Output'
            + 'TOOLS\SavedSections'
            + 'TOOLS\UNPACKED_DECOMPILED_PAKs'
            + any other files in AMUMSS main not updated by the unzip file

    * You can delete the compressed file from AMUMSS main folder when done extracting

* EXECUTE BUILDMOD.bat ONCE or more until no more updates are offered
		+ Always execute BUILDMOD.bat once to re-create all user folders (when they do not exist)
        + it will auto-download\update MBINCompiler.exe and libMBIN.dll

QUESTIONS * Questions are better asked in NMS Discord: "No Man's Sky Modding" channel, "amumss-lua" room: https://discord.gg/HFjnmnwe67
We have channel #amumss-lua dedicated to AMUMSS/NMSPE with helpful modders and Wbertro#8596 (aka TheBossBoy)

Wbertro