Installation:

Simply download the version for your platform and unzip it to a convenient location.

No additional installation is required.

Usage:

On Windows and Linux, just run the downloaded executable. On macOS, you will need to unzip the application, after which you can run it like any other app.

After you boot the application for the first time, you will need to direct it to your Starsector installation directory.

• For Windows and Linux, this means selecting the Starsector folder (not the mods folder)
• On macOS, this means selecting the Starsector.app file

Once the Starsector installation directory is set, you are now free to use the main features of the app.

Mod Installation

• Click Install Mod(s)
• From the dropdown select From folder if you already unzipped a mod into a folder, or From archive(s) if you have one or more archives (ie: zip, rar, 7z, etc...) you'd like to install from.
  • Note¹: You can install from multiple archives at once.
  • Note²: There is no need to worry about folder nesting when installing with MOSS. Mods will always be copied into your mod folder at the correct level, eg: mods/{mod_name}.

Version Checking

By default, MOSS displays a Version column for all mods. This column displays the version of each installed mod.

You may notice that this column has different coloured backgrounds and different symbols for some mods, and nothing for others. This represents the update status of the mod, including whether the mod supports Version Checker.

Mods that support Version Checker will display one of 6 statuses:

• Up to Date: There are no updates for this mod, as far as we know.
  • Green background
  • No symbols
• Patch available: A patch update is available for this mod.
  • Blue background
  • One exclamation mark
• Minor update available: A minor update is available for this mod.
  • Yellow background
  • Two exclamation marks
• Major update available: A major update is available for this mod.
  • Orange/brown background
  • Three exclamation marks
• Discrepancy: The installed version is greater than the highest known version.
  This likely means that the mod author has forgotten to update their remote version checker file. This is not an error, but rather a configuration issue that must be resolved by the mod author.
  • Purple background
  • Question mark
• Error: This mod supports Version Checker, but checking it's update status failed. Common causes include network access is unavailable, the version checker file being written incorrectly, or the given remote version file URL is incorrect.
  • Red background
  • Stop sign (aka: exclamation mark in triangle)

Launching

It is possible to launch the game directly from MOSS. Simply click the Launch button in the right-hand panel.

Additionally, you may enable the Experimental direct launch feature in the settings pane. This will allow you to bypass the vanilla launcher entirely, skipping that one extra click.