1MUPEN64PLUS(6) BSD Games Manual MUPEN64PLUS(6)
2
4 mupen64plus — console front‐end for the Mupen64Plus N64 emulator
5
7 mupen64plus [parameters] romfile
8
10 mupen64plus is a plugin‐based N64 emulator for Linux/Unix, OSX, and Win‐
11 dows which is capable of accurately playing many games. Included are
12 four MIPS R4300 CPU emulators, with dynamic recompilers for 32‐bit x86
13 and 64‐bit amd64 systems, and necessary plugins for audio, graphical ren‐
14 dering (RDP), signal co‐processor (RSP), and input. There are several
15 OpenGL video plugins available:
16 · Rice, included with the distribution
18 · Glide64Mk2, included with the distribution
20 · Arachnoid:
22 https://github.com/mupen64plus/mupen64plus-video-arachnoid
23 · Glide64:
25 https://github.com/mupen64plus/mupen64plus-video-glide64
26 (old)
27 · Z64:
29 https://github.com/mupen64plus/mupen64plus-video-z64
30 (must be used with the rsp-z64 plugin)
31 The most current documentation can be found at the project’s homepage:
33 https://code.google.com/p/mupen64plus/.
34 The options are as follows:
36 -h, --help
38 Print help message.
39 --noosd
41 Disable onscreen display.
42 --osd
44 Enable onscreen display.
45 --fullscreen
47 Run emulator in fullscreen display mode.
48 --windowed
50 Run emulator in windowed display mode.
51 --resolution res
53 Display resolution (640×480, 800×600, 1024×768, etc)
54 --nospeedlimit
56 Disable core speed limiter. This should be used with the dummy audio
57 plugin.
58 --cheats cheat‐spec
60 Enable or list cheat codes for the given rom file.
61 --corelib filepath
63 Specifies a filename (optionally with a preceding directory path) to
64 load a specific mupen64plus core library.
65 --configdir directory
67 Specifies a directory to look for the mupen64plus.cfg file. Default
68 is ~/.config/mupen64plus/.
69 --datadir directory
71 Specifies a directory to search for shared data files (fonts, cheat
72 codes, .ini files). Default is ${PREFIX}/share/mupen64plus/.
73 --plugindir directory
75 Specifies a directory to search for plugin files. Default is
76 ${PREFIX}/lib/mupen64plus/.
77 --sshotdir directory
79 Specifies a directory to save screenshots captured during gameplay.
80 Default is ~/.local/share/mupen64plus/screenshot/.
81 --gfx plugin‐spec
83 Specifies a plugin‐spec to select a graphics plugin for use during
84 emulation.
85 --audio plugin‐spec
87 Specifies a plugin‐spec to select an audio plugin for use during emu‐
88 lation.
89 --input plugin‐spec
91 Specifies a plugin‐spec to select an input plugin for use during emu‐
92 lation.
93 --rsp plugin‐spec
95 Specifies a plugin‐spec to select an RSP plugin for use during emula‐
96 tion.
97 --emumode mode
99 Specifies which mode the emulator core should run in. mode should be
100 set to one of the following numbers:
101 0 Pure Interpreter
103 1 Cached Interpreter
105 2 Dynamic Recompiler (DynaRec)
107 --testshots list
109 Take screenshots at frames given in the comma‐separated list, then
110 quit.
111 --core-compare-send
113 Use the core comparison debugging feature, in data sending mode. If
114 the core was not compiled with support for the Core Comparison fea‐
115 ture, then the emulator will exit with an error.
116 --core-compare-recv
118 Use the core comparison debugging feature, in data receiving mode. If
119 the core was not compiled with support for the Core Comparison fea‐
120 ture, then the emulator will exit with an error.
121 --set param‐spec
123 Set the value of a mupen64plus configuration parameter. This option
124 may be used multiple times. The format of param‐spec is
125 Section‐Name[Param‐Name]=Value
126 --nosaveoptions
128 Do not save the given command‐line options into the mupen64plus con‐
129 figuration file to use as defaults in the future.
130 --verbose
132 Print lots of information. Useful for debugging but unnecessary for
133 normal use.
134
136 (plugin‐name)
137 Filename (without path) of plugin to use. Application will search
138 through several directories to look for a matching plugin name.
139 (plugin‐path)
141 Full directory path and filename of plugin.
142 ‘dummy’
144 Use the dummy plugin.
145
147 ‘list’
148 Show all of the available cheat codes.
149 ‘all’
151 Enable all of the available cheat codes.
152 (codelist)
154 A comma separated list of cheat code numbers to enable.
155
157 The following shortcut keys can be used during emulation. These are the
158 default key values; nearly all of them may be set to different keys by
159 editing the mupen64plus configuration file.
160 Escape Quit the emulator.
162 0–9 Select virtual ‘slot’ for save/load state.
164 F5 Save emulator state to current slot.
166 F7 Load emulator state from current slot.
168 F9 Reset emulator.
170 F10 Slow down emulator speed by 5 percent.
172 F11 Speed up emulator speed by 5 percent.
174 F12 Take screenshot.
176 Alt‐Enter Toggle fullscreen mode. This is not supported on Windows.
178 p or P Pause/continue emulation.
180 m or M Mute/unmute sound.
182 f or F Fast Forward (playback at 250% normal speed as long as key is
184 pressed).
185 g or G Press GameShark button (if cheats are enabled).
187 / or ? Advance one frame if paused.
189 [ Decrease volume.
191 ] Increase volume.
193
195 The default location for the mupen64plus configuration file is
196 ~/.config/mupen64plus/. The default location of the saved screenshots is
197 ~/.local/share/mupen64plus/screenshot/. The default location of the save
198 states is ~/.local/share/mupen64plus/save/.
199
201 mupen64plus was originally started by Richard42 and nmn, and is based on
202 Mupen64 (originally written by Hacktarux).
203 This man page was written by ebenblues, and updated by Richard42 and
205 Anthony J. Bentley.
206
208 Mupen64plus is © 2008–2013 The Mupen64plus Team
209 License GPLv2+, GNU:
211 https://gnu.org/licenses/gpl.html GPL version 2 or later
212 This is free software: you are free to change and redistribute it. There
214 is no warranty, to the extent permitted by law.
215
217 To report bugs or make feature requests, use the issue tracker:
218 https://code.google.com/p/mupen64plus/issues/list
219BSD September 20, 2013 BSD