Skip to content
FTL: Hyperspace

Install FTL: Hyperspace on macOS manually

  1. Find your FTL folder

    Section titled “Find your FTL folder”
    Where you bought itLocation
    Steam~/Library/Application Support/Steam/steamapps/common/FTL Faster Than Light/
    GOG/Applications/
    Other~/Games/

    In Finder, press Cmd + Shift + G and paste the path. Steam users can also right-click FTL in their library and choose Manage → Browse Local Files.

  2. Point the app at Hyperspace

    Section titled “Point the app at Hyperspace”

    Right-click FTL.app, choose Show Package Contents, open Contents, and open Info.plist in a text editor.

    Change:

    <key>CFBundleExecutable</key>
    <string>FTL</string>

    to:

    <key>CFBundleExecutable</key>
    <string>Hyperspace.command</string>

    While you are in there, note CFBundleVersion. You need it next.

  3. Copy the Hyperspace files

    Section titled “Copy the Hyperspace files”

    Download FTL.Hyperspace.x.xx.x-MacOS.zip from the latest release. From the MacOS/ folder inside it, copy into Contents/MacOS:

    • Hyperspace.command
    • exactly one dylib matching the version you just noted: Hyperspace.1.6.13.amd64.dylib or Hyperspace.1.6.12.amd64.dylib

  4. Set up a mod manager

    Section titled “Set up a mod manager”

    You need a mod manager to patch .ftl files into the game. Pick one. The rest of this guide follows whichever tab you choose.

    Actively maintained, reads the same mods as Slipstream, and can install Hyperspace for you.

    1. Download the build for your machine from the ftlman releases page. Windows users want ftlman-x86_64-pc-windows-gnu.zip.
    2. Extract the ftlman folder anywhere you like. It does not have to live in your FTL directory.
    3. If FTL is currently modded, revert it to vanilla first. Coming from Slipstream, that means opening Slipstream, unticking every mod, and patching.
    4. Run ftlman. A Steam install is detected automatically; otherwise open Settings and paste your FTL folder into FTL data directory.

    Point ftlman at FTL.app/Contents/Resources, the folder holding ftl.dat. In Finder you can right-click ftl.dat, hold Option, and choose Copy as Pathname, then delete the trailing ftl.dat from the path. Click Scan.

  5. Sign the app

    Section titled “Sign the app”

    macOS refuses to run the patched app until it is signed. In Terminal:

    Terminal window
    codesign -f -s - --timestamp=none --all-architectures --deep /path/to/FTL.app

    Type the command up to --deep , then drag FTL.app from Finder into the Terminal window to fill in the path.

  6. Launch

    Section titled “Launch”

    Open FTL.app directly. Do not launch it through Steam.

Adding Multiverse

Section titled “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:
  • Tick Multiverse Assets first, then Multiverse Data
  • Leave Hyperspace unticked
  • Press Apply

Uninstalling

Section titled “Uninstalling”

Right-click FTL.app, choose Show Package Contents, then:

  1. In Contents/Info.plist, change Hyperspace.command back to FTL.
  2. Delete Hyperspace.command and Hyperspace.*.dylib from Contents/MacOS.
  3. In Contents/Resources, delete ftl.dat and rename ftl.dat.vanilla to ftl.dat.