Launch Games with Mupen64Plus
This is the good part!
Mupen64Plus logo
This tutorial will go over the basics of launching an N64 game using Mupen64Plus on your Mac. Plus, I'll show you how to build your own AppleScript launcher (if you're a little shy around the Terminal), and I mention two other GUI applications that will make using Mupen64Plus a breeze.
Quick Links
Launch a Game
1. Command line (Terminal) method:
Launching a game using the command line (Terminal.app) really isn't as difficult as it may seem:
Here's a play-by-play of the steps in the video:
- Start in the mupen64plus-1.99.4-osx folder (or Mupen64Plus if you renamed and moved it to your Applications folder; skip to step 3 if you did)
- Move into the 32-bit or 64-bit folder
- Open Terminal.app (I'm using Alfred to launch applications)
- Type
cdand drop mupen64plus into the Terminal window to reveal get its path - Add
Conents/MacOSto the end of the path (I'm using the tab key to autocomplete these path names) - Optional: Type
lsand press return to view the contents of the MacOS folder (this is the list command) - Type
./mupen64plus - Drag your N64 rom file onto the Terminal window to get its path
- Press return
- Enjoy!
A few notes on this method:
- It plays well with rom files and folders that contain spaces
-
It will default to the Rice video plugin. To use another plugin, use one of these commands before dragging your rom into the Terminal window:
./mupen64plus --gfx mupen64plus-video-glide64./mupen64plus --gfx mupen64plus-video-arachnoid
-
It can do all kinds of nifty things, like:
- Set the window size (resolution) using
--res (width)x(height)(replacing those with the appropriate values) - Launch in fullscreen mode using
--fullscreenor windowed mode using--you guessed it----windowed - Use cheats (
--cheats) - And more!
- Set the window size (resolution) using
2. Applescript method:
Another method that's a little more familiar for most people is the Applescript method (developed by Mike, Dav, and me in the comments of this SpeedofMac.com blog post).
This method involves using a separate application made with Applescript to launch your N64 roms using Mupen64Plus. The application we'll be using can do the following:
- Allow you to choose whether to launch a rom, configure a gamepad, or change Mupen64Plus preferences
- Allow you to choose the video plugin you want to use
- Open rom files or folders with spaces (you may need to change
$1to"$1"in the run_(plugin).sh files)
Here's the code:
display dialog "What would you like to do today?" buttons {"Open N64 ROM", "Controller Config", "Mupen64Plus Config"}
copy the result as list to the menuChoice
if the menuChoice is {"Mupen64Plus Config"} then
do shell script "open -e ~/.config/mupen64plus/mupen64plus.cfg"
return quit
end if
set mypath to path to me
tell application "Finder" to set myFolder to folder of mypath as alias
set myPOSIXFolder to quoted form of (POSIX path of myFolder)
if the menuChoice is {"Open N64 ROM"} then
set romPath to choose file with prompt "Select a rom file to open (.n64, .v64, .z64)" default location myFolder
set romFile to quoted form of (POSIX path of romPath)
display dialog "Which plugin would you like to use?" buttons {"Glide", "Rice", "Arach"}
copy the result as list to the pluginChoice
tell application "Terminal" to activate
tell application "System Events" to keystroke "cd " & myPOSIXFolder & return
tell application "System Events" to keystroke "./run_" & pluginChoice & ".sh " & romFile & return
else if the menuChoice is {"Controller Config"} then
do shell script "open -a TextEdit " & myPOSIXFolder & "mupen64plus.app/Contents/Resources/InputAutoCfg.ini"
end if
To use this, just follow these easy steps:
- Open AppleScript Editor.app
- Copy the above code into the editor window
-
Save the file as "Mupen AppleScript Launcher" and select "Application" as the file format to launch the script by double-clicking on it
- You can save it as an AppleScript file and just run it every time you want to launch a game. This will let you change the code more easily.
- Either double-click the application you saved or run the code, and you should be off to the races!
3. MupenRocket method
If you have Snow Leopard, you can use MupenRocket, my Mupen64Plus launcher.
4. wxMupen64Plus method
You can also use Auria's wxMupen64Plus frontend.