Troubleshooting on Linux

Your saves live in ~/.local/share/FasterThanLight.

Hidden folders are not shown by default

Open your home folder in your file manager and press Ctrl-H to show hidden files, or paste the path into its location bar.

The game fails to start with Failed to install hook

Fatal Error
Failed to install hook for WeaponControl::RenderAiming:
Failed to make copy of original code executable

SELinux is blocking the Hyperspace library from being linked. Fedora ships with it enabled, so that is where this usually turns up. The fix is to add an exception.

1. Check whether SELinux is running:

   sestatus

2. If it is enabled, check whether it is enforcing:

   getenforce

   Anything other than Enforcing means SELinux is not your problem.

3. Build and install the exception. ausearch finds the denial, audit2allow turns it into a rule, and semodule loads it:

   sudo ausearch -c "FTL.amd64" --raw | audit2allow -M FTLMultiverse && sudo semodule -i FTLMultiverse.pp

   Swap FTL.amd64 for the executable your architecture runs. If ausearch finds nothing, launch FTL once more to produce a fresh denial and try again.

4. Confirm the rule loaded:

   sudo semanage module -l | grep FTLMultiverse

   You should see something like FTLMultiverse 400 pp.

Launch the game again and it should start normally.

The game crashes before loading Multiverse

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.

If neither applies, your save file is corrupt, see below.

The game hangs while loading Multiverse

It stops on the last E of the Multiverse logo, or the screen freezes while the music keeps playing. Both mean the same thing: your save file is corrupt, see below.

Clearing a corrupt save, on Steam

On Steam, start here. Steam Cloud is usually what corrupted the save in the first place. Turning it off and backing up the original Vanilla FTL save is the only way to prevent it from happening again.

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

Show me how to open 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 checkbox

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

Steam will undo your install

If Steam updates FTL it replaces the patched game files, and Hyperspace stops loading.

Your saves live in ~/.local/share/FasterThanLight.

Hidden folders are not shown by default

Open your home folder in your file manager and press Ctrl-H to show hidden files, or paste the path into its location bar.

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.

Repairing a corrupt save by hand

Slower than starting clean, but it keeps your progress. On Steam, turn Steam Cloud off first, as above, or it will corrupt the save again.

1. Open 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.