A noob friendly solution utilizing wine to run FTL: Hyperspace and mods like FTL: Multiverse on MacOS, recommended by the official Hyperspace Team. Also able to run Vanilla FTL. (Supporting x86 and ARM)
The project began as a personal endeavor to create a visually appealing and user-friendly experience for FTL on MacOS. As I continued to work on it, I realized its potential and decided to make it a public project so that everyone can benefit from my work.
At first download the latest wrapper. I reccomend moving it into the Applications folder.
After that you should get a copy of FTL for Windows and download the latest version of Hyperspace aswell.
And this version of SMM. If you already have Slipstream Mod Manager for normal modding, you still need this version because it works differently. Your version does not support the wrapper
Owning FTL on GOG: Please download Windows version 1.6.9 (others WONT work) you can choose it in GOG.
Owning FTL on Epic: Although it is technically possible to run it, there is no Epic Launcher available for Mac.
Other Versions/Epic: Please join the FTL: Multiverse discord, I can help you with that stuff.
First, open the downloaded .DMG file and drag and drop the Wrapper that inside into your Applications folder. Since I can't afford to sign my program, you'll have to do a few extra clicks. When you double-click on the wrapper, you get this window saying that the developer cannot be verified:
Instead, please right-click on the application and select open:
This should open a window like this, still giving you the warning, but allowing you to open the wrapper (after pressing open once, it will not pop up again):
When you run it for the first time, a window will pop up telling you that the FTL files are missing:
Pressing 'OK' will open the next window asking if you own FTL on Steam:
(if you do not own FTL on Steam, please go to step 3).
Selecting 'Yes' will take you through the 'Auto-Download' opening the Steam Console where you need to paste in the following command; download_depot 212680 212681:
After Steam finishes downloading, press OK on this window. It will open the folder where FTL has been downloaded.
The wrapper will give you the option to open the designated FTL folder with this window. Pressing 'Yes' will open the directory where you are supposed to drop the FTL files.
Make sure your FTL and hyperspace files are ready. Transfer them by dragging or copying them into the new window.
Before you can play, you need to install your desired mods, such as FTL: Multiverse. Installing mods for the wrapper is not much different from installing them for basic FTL or other platforms.
First you need to grab the SMM archive you downloaded and unpack it:
Now navigate into the new folder, you should now see a bunch of files such as a folder called mods.
I recommend deleting all files in the folder.
You can now put in other mods. Download Multiverse from its thread on The FTL forum. Remember to download both the data and assets files.
Once you have placed the two files into the mods folder, you can return to the Mod Manager. To do this, right-click on the modman.command file and select 'open':
Just press 'open' once again when you see this window pop up:
When the Mod Manager first launched, you will see a window. Make sure to select 'no' as the specified path is incorrect:
Selecting 'no' will prompt you to guide the mod manager to the wrapper:
Wether FTL was obtained from Steam or not you should still select 'no' here:
Launching for the first time will look like that because the mod manager does not recognize the mods yet:
To resolve the issue, navigate to File and select Preferences.
Now enable 'allow zip' and hit 'apply':
Rescan the mods to make them visible:
To install them, simply check all of them and press 'patch'. Make sure to have them in correct order to avoid any issues.
After successfully patching, you can launch FTL from the mod manager if you want to:
Congratulations! Now you can start FTL for the first time if you havent already done so with the mod manager, either double click or left click on the wrapper and select "open".
After launching the wrapper it will check if Hyperspace is present and if it is downgraded or not. Downgrading is an automated process and is managed for you.
First you will see this window stating that hyperspace has been found but not downgraded yet.
This creepy window doesn't do much, when it's done you can press enter and it will go away.
If nothing went wrong you should see this window, just press OK and FTL will start.
If everything went smoothly and you have patched your desired mods, the game should start up fine:
This can happen because the internal script does not like names with empty keys, you must have renamed the application or something.
Your save files are corrupted. This is a common issue that occurs with Multiverse, don't worry.
Simply delete these files:
You have a broken wine prefix, don't worry, it's not harmful. To fix it, go to your Home folder (usually named after your user account) and press shift + command + . to view hidden files. Then, delete the '.wine' folder:
This is caused by a default setting in Safari and some other browsers.
To resolve it, go to Safari > Preferences > General on the top right bar, and disable 'Open safe files after downloading'. (The setting on the bottom)
- Sound bugs/tearing caused by Wine.
- Longer loading times on Apple Silicon Mac's caused by Rosetta translation.
- Secondary FTL window in the dock after downgrade, fixed by restarting the wrapper.
- Onceuponaban: Made the logo for the Wrapper
- @blizzarchon: Added support for my Wrapper to SMM
If you encounter any issues, wish to provide feedback, or request a feature, please inform me through my Discord channel on the FTL: Multiverse discord.
