Aller au contenu
FTL Hyperspace

Install FTL: Hyperspace on Linux with ftlman

Ce contenu n’est pas encore disponible dans votre langue.

ftlman is the mod manager built for Hyperspace. It downloads whichever Hyperspace release you pick, applies it to your copy of FTL, and keeps your mods in one list you can reorder and re-apply whenever you like.

  1. Steam settings

    Section titled “Steam settings”

    Skip this if you did not buy FTL on Steam.

    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.

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

    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.

  2. Set up ftlman

    Section titled “Set up ftlman”

    Ftlman is the recommended mod manager for FTL: Hyperspace modding. Actively maintained and supports Hyperspace updates

    If FTL is currently modded (ftl.dat is bigger than ~270 MB), revert it to vanilla first, either with your mod manager or by reinstalling the game.

    1. Download the build for your machine from the ftlman releases page.
    2. Extract the ftlman folder anywhere you like. It does not have to live in your FTL directory.
    3. Run ftlman. A Steam install is detected automatically. If yours sits somewhere non-standard, or you have more than one copy and want a specific one, open Settings and set FTL data directory yourself: the folder holding ftl.dat inside the game installation.

  3. Install Hyperspace and your mods

    Section titled “Install Hyperspace and your mods”

    1. At the top left of the ftlman window is a Hyperspace dropdown listing every release. Pick one. Take the newest unless a mod you want specifically asks for an older one. Multiverse usually requires the latest

    2. Put your mods in the ftlman’s mods folder.
    3. Press Scan in the top right so ftlman can find them.

    4. Tick mods you want to use. Order matters, some mods specify that they must be loaded before (e.g. Multiverse Assets). To change order simply drag the mod up or down in the list.

    5. Press Apply.

  4. Check it worked

    Section titled “Check it worked”

    Launch FTL. About halfway through the loading screen, and again on the menu, a small version string appears in the top right. That is Hyperspace reporting itself, and it means the binary is loaded.

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

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 Official Downloads board and pick the newest [FTL MULTIVERSE BASE MOD] thread.

  2. In the first post, scroll to Manual install and download both the DATA and ASSETS files. Ignore the installer above them, that one is Windows-only and does its own thing.

    Alternative way to download is to use Multiverse release thread under DOWNLOAD RAW FILES.

  3. Put both .zip files in your mod manager’s mods folder.

  1. Press Scan in the top right so the new files show up
  2. If ftlman installed Hyperspace for you (you have not disabled the installer in Settings → Advanced settings), skip this step. If you installed Hyperspace manually, drag Hyperspace.ftl to the top of the list. It must be above all other mods.
  3. Drag Multiverse Assets.zip above Multiverse Data.zip
  4. Check the order, top to bottom:
    1. Hyperspace.ftl (optional)
    2. Multiverse Assets.zip
    3. Multiverse Data.zip
  5. Select the mods: click each entry until it is highlighted blue
  6. Press Apply
Show me what it should look likeftlman with Hyperspace.ftl ticked on top, then Multiverse Assets ticked directly above Multiverse Data

Updating

Section titled “Updating”

Open ftlman, pick the newer release from the Hyperspace dropdown and press Apply. Your saves are not affected.

Uninstalling

Section titled “Uninstalling”
  1. Clear the Hyperspace dropdown.
  2. Untick every mod.
  3. Press Apply.

That puts ftl.dat and your FTL folder back to vanilla in one go.