Install FTL: Hyperspace on macOS with the installer

The macOS installer finds your copy of FTL, installs Hyperspace and sets up ftlman for you.

Running the installer, then adding Multiverse on top. Written steps below.

1. Download the installer

   From the latest release, download FTL.Hyperspace.x.xx.x-Installer-MacOS-arm64.dmg for Apple Silicon, or ...-Installer-MacOS-x86_64.dmg for an Intel Mac.

2. Run it

   Open the .dmg and launch the installer.

   "Apple could not verify this app"

   Open System Settings → Privacy & Security, find the installer near the bottom, and click Open Anyway.

3. Follow the prompts

   The installer detects Steam, GOG and custom locations, and supports FTL 1.6.12 and 1.6.13. At the end, use the button at the bottom to open the mods folder.

Hyperspace is now installed and ready to play. Everything below is optional.

Adding Multiverse

Multiverse is the largest mod built on Hyperspace, and it installs differently from everything else.

1. Open the Multiverse release thread and scroll to DOWNLOAD RAW FILES (OTHER PLATFORMS, UPDATES, MANUAL INSTALL). Ignore the installer above it, that one is Windows-only and does its own thing.
2. Download both files listed there, the Assets File and the Data File.
3. Put both .zip files in your mod manager’s mods folder.
4. Patch them in this order, and nothing else:

ftlman (recommended)

• Tick Multiverse Assets first, then Multiverse Data
• Leave Hyperspace unticked
• Press Apply

Slipstream (legacy)

• Enable ZIP support: Preferences → allow_zip, then File → Re-Scan mods/
• Tick FTL-Multiverse first, then any Multiverse-compatible add-ons
• Leave Hyperspace unticked
• Press Patch

Do not patch Hyperspace.ftl with Multiverse

Multiverse already contains everything Hyperspace.ftl provides. Patching both is the single most common cause of a broken install.

Only add Multiverse-compatible mods

Anything not built for Multiverse can conflict with it. Add them one at a time so you know which one broke things, and ask on Discord if you are unsure about a particular favourite.

When Hyperspace updates

Updating Hyperspace does not disturb your saves, but you do need to re-patch Multiverse afterwards.

Updating later

The installer can update Hyperspace on its own. If you run Multiverse, run ftlman again afterwards to re-patch it. Your saves are not affected.

Requirements

macOS 14 or later, and FTL 1.6.12 or 1.6.13. Administrator rights are needed during installation.