Skip to content

Troubleshooting on macOS

Your save folder is ~/Library/Application Support/FasterThanLight.

Open System Settings → Privacy & Security, scroll to the bottom, and click Open Anyway. On older macOS versions, right-click the app and choose Open.

The game will not start after a manual install

Section titled “The game will not start after a manual install”

You almost certainly skipped the signing step. Run it again:

  1. Open Terminal.

  2. Paste this in, then press the space bar:

    Terminal window
    codesign -f -s - --timestamp=none --all-architectures --deep
  3. Drag FTL.app from Finder into the Terminal window. Its full path is filled in for you, so there is nothing to type.

  4. Press Return.

Right-click FTL: Faster Than Light in your library and open Properties.

Show me how to open PropertiesRight-clicking FTL in the Steam library and choosing Properties

Under General, untick Keep game saves in the Steam Cloud. Turn off Steam Cloud first. It restores outdated saves with broken state, which can keep Hyperspace from launching and will undo any save fix you try later.

Show me the checkboxThe General tab of FTL's Steam properties with the Steam Cloud checkbox unticked

Then under Updates, set automatic updates to Only update this game when I launch it.

Rename FasterThanLight to FasterThanLight-backup, then launch FTL. The game makes a fresh folder, and your original saves stay in the backup if you ever want them back.

Do this once, right after turning Steam Cloud off. Cloud sync leaves behind a save that Hyperspace cannot read, which freezes the game at the end of the loading bar.

Make sure you are on the latest Hyperspace. The Multiverse installer is frequently behind, and this is by far the most common cause.

If you are on a laptop with both integrated and dedicated graphics, try forcing FTL onto one or the other. Otherwise your save file is probably corrupt, see below.

Your save file is corrupt.

My game hangs while loading but I can hear music

Section titled “My game hangs while loading but I can hear music”

Your save file is corrupt.

  1. Find your save folder and locate hs_mv_prof.sav and hs_mv_version.sav.

  2. Delete hs_mv_version.sav.

  3. Move hs_mv_prof.sav somewhere else. Do not delete it.

  4. Launch the game, let it reach the main menu, then quit.

  5. Move your original hs_mv_prof.sav back, replacing the one the game just made.

Still stuck? Ask in the Hyperspace channels on the Multiverse Discord.

macOS problems have their own channel on the Multiverse Discord: #mac-support. Say which macOS version you are on, whether you used the installer or installed by hand, and where you bought FTL.