-
Notifications
You must be signed in to change notification settings - Fork 143
Slippi on macOS
Your life will be immensely easier if you spend 5-10 minutes reading this document.
The best way to run Slippi on macOS is to grab the Slippi Launcher from slippi.gg. Place it in your Applications folder and run the app, then sign in or register for an account.
| macOS Version | Processor | Support Level | Graphics Driver |
|---|---|---|---|
| Monterey (12.0) | M1/Intel | Unsupported* | |
| Big Sur (11.0) | M1 | Beta* | Vulkan, OpenGL |
| Big Sur (11.0) | Intel | Supported | Vulkan, OpenGL |
| Catalina (10.15) | Intel | Supported | Vulkan, OpenGL |
| Mojave (10.14) | Intel | Supported | Vulkan, OpenGL |
| High Sierra (10.13) | Intel | Supported | OpenGL |
Slippi on M1 machines runs under the Rosetta 2 translation layer. This (surprisingly) runs fairly well - just make sure to set your graphics driver to Vulkan (Experimental), and see the performance notes at the end of this document.
Monterey is currently in Apple public beta and subject to change before release, so any use of Slippi on that OS is at your own discretion/risk. Check this table after release for any updates.
Bugs should be reported to the #mac-support channel in the Slippi Discord. When doing so, please make sure to note the following:
- What macOS version you're on.
- What Mac hardware you're running on (model and processor, can be found in Apple Menu -> About This Mac).
- Whatever is not working, and any accompanying logs if you have them.
Gamecube controllers are by far the most common way to play Melee. To use one on macOS requires a driver installation. Visit the GCAdapterDriver project page to download the appropriate installer for your macOS version.
- If you're on macOS High Sierra, Mojave, or Catalina, make sure you check the "overclocked" option in the driver installation process.
- Note: Some USB-C hubs may limit the polling rate; for that there is unfortunately no workaround as it's a hardware limitation.
Note that the overclocked driver on macOS Big Sur currently requires disabling a system lock in Recovery Mode. Detailed instructions on how to do this can be found here. This is a temporary workaround for the Big Sur GCAdapterDriver app not supporting the overclock procedure - once it's updated to do so, you should switch to that, as Apple has deprecated kernel extensions in macOS and the level of support for them will continue to diminish with each OS release.
- If your adapter has a Wii Mode switch, make sure it's set to that.
- If you're on High Sierra, Mojave, or Catalina: always plug your adapter in before starting Netplay from the Launcher, or opening a Netplay Dolphin build.
- If you're on Big Sur and running GCAdapterDriver.app, you might need to unplug and plug your adapter back in after activating the driver, and before starting Netplay from the launcher or opening a Netplay Dolphin build. This is due to a bug in the DriverKit framework where Apple internal devices match first.
- B0XX specific:
- Note that native mode for B0XX under Big Sur requires macOS Big Sur 11.3.
- Note that Frame1 controllers are not supported by default and need to be manually configured.
- If you want to try to play on a Pro/PS4/Xbox Controller you can attempt to use Steam as a translation layer.
- This guide may not work on M1 Macs.
- Note that the version of Dolphin that Slippi is forked from is not the same as modern Dolphin builds, so what works there may not work here.
- If, for whatever reason, you can't use any of the controller methods listed above, you can use any controller adapter that has a "PC Mode" switch as a Standard Controller in Dolphin. This has increased latency and should be used as a last resort (e.g, you're on a mostly locked down system and can't install or change system files).
If you use the Slippi Launcher, automatic updates are built in, with settings migration built-in.
If you run Netplay by itself (increasingly unsupported), you'll have to update manually each time there's a new release (this will require reconfiguring settings each time).
Performance on macOS has historically been tricky, but has gotten better over time. macOS supports two graphics backends: OpenGL, and Vulkan (Metal). You'll need to experiment with both graphics backends to see what works for you, as the performance will differ depending on macOS version and hardware.
Some common performance tips to try, regardless of graphics driver choice:
- Playing on an external monitor will often feel smoother than the built-in Mac displays, which are generally 60hz.
- Play full screen and make sure the game is focused (clicked).
- macOS Slippi defaults to
@1xresolution, as the built-in retina display makes things already scale up aggressively. You can try to bump the value if you want, but don't be surprised if this makes your machine work harder than you'd think. - Consider enabling "Do Not Disturb". Notifications can tank the frame rate on some devices.
- Some older Macs (and, oddly, the 8GB 2020 M1 MacBook Pro) can achieve higher performance by running the game in low resolution mode. To do so:
- In Slippi Launcher, navigate to Settings > Netplay > Open Containing Folder.
-
CMD-click (or right click/two-finger-click) on the app > Get Info > check "low resolution mode".
This backend is a port of an older mainline Dolphin MoltenVK/Metal backend. It offers generally increased performance on most modern macOS versions. In general, the absolute first thing you should do if you're not on High Sierra is to set this as your graphics driver.
To do so:
- In Slippi Launcher, navigate to Settings > Netplay > Configure Dolphin.
- In Dolphin, click on the Graphics icon in the toolbar.
- Change the dropdown from OpenGL to Vulkan (Experimental).
- If you have a Mac that has a dedicated graphics card built in, in addition to an integrated graphics card, you'll want to try playing with both to see what performs better.
This backend is not supported under High Sierra, as that OS version lacks a few Metal framework pieces that were introduced in Mojave.
If you experience screen-tearing, you can try starting Netplay Slippi with the following Terminal command (this is Vulkan-specific, and whether it works on your Mac model varies):
MVK_CONFIG_SYNCHRONOUS_QUEUE_SUBMITS=0 ~/Library/Application\ Support/Slippi\ Launcher/netplay/Slippi\ Dolphin.app/Contents/MacOS/Slippi\ Dolphin
OpenGL as a framework has been deprecated by Apple for a few OS releases now, and it lacks a critical extension that's beneficial for smooth rendering. With that said, some older Macs oddly see better performance with this backend, so it's up to you to try both and see what works.
The below settings changes refer specifically to Slippi Dolphin Netplay settings.
- If your ping and FPS counters shows up as squares, try backing out to the title screen
- Some people have positive experiences with going to config > last tab > enable "cpu clock override" and drag the slider to 80%. Your mileage may vary, but feel free to play around.
- Some people have increased frame rates by enforcing Graphics>Enhancements Force 24-bit Color.
- Try setting aspect ratio to integer.
Macs that are older than mid-2015 can often struggle to play well on Slippi (iMacs being the notable exception). If you've tried everything in this document and still aren't seeing performance on an acceptable level, you can consider running BootCamp to play under Windows instead. If you go this route, you'll want to consult Windows-specific tutorials after getting BootCamp up and running.
BootCamp is not supported for M1 models.
-
Mainline Dolphin supports the M1 natively, why doesn't Slippi?
If Slippi migrates to more closely follow mainline Dolphin, then it's possible the same M1 support could show up here. There is currently no timeline or ETA for this, and as a general rule the Slippi devs don't give timelines to begin with. -
Can I remap buttons on my Gamecube controller?
No. You could use your controller as a a Standard controller, but you'll exchange latency and precision by doing so. -
I keep getting immediate crashes with an error saying memory was allocated above 2GB. What do I do?
This is an unfortunate bug that can't be fixed unless Slippi moves to more closely follow mainline Dolphin. You can read more on this issue, which contains some possible hacks to get around it. Additionally (oddly) a reinstall of Slippi will sometimes cause the issue to disappear. -
Login works, but the game doesn't say you're logged in?
Make sure you're not playing from the mounted installer volume - which is mounted as read-only, and the login process won't be able to write your user profile to the system.To fix:
- In Finder, look in your left sidebar. If Slippi Installer is mounted, press the eject button.
- Remove the Installer and the App.
- Redownload the installer, run the installation process to drag the app to Applications
- Important: Unmount/eject the installer
- Run the app from Applications
Your login should work now.