6 .Nd console front\(hyend for the Mupen64Plus N64 emulator
13 is a plugin\(hybased N64 emulator for Linux/Unix, OSX, and Windows which is capable of accurately playing many games.
14 Included are four MIPS R4300 CPU emulators, with dynamic recompilers for 32\(hybit x86 and 64\(hybit amd64 systems, and necessary plugins for audio, graphical rendering (RDP), signal co\(hyprocessor (RSP), and input.
15 There are several OpenGL video plugins available:
18 Rice, included with the distribution
20 Glide64Mk2, included with the distribution
22 .Lk https://bitbucket.org/wahrhaft/mupen64plus-video-arachnoid Arachnoid
24 .Lk https://bitbucket.org/wahrhaft/mupen64plus-video-glide64 Glide64
27 .Lk https://bitbucket.org/wahrhaft/mupen64plus-video-z64 Z64
28 (must be used with the rsp-z64 plugin)
31 The most current documentation can be found at the project's
32 .Lk https://code.google.com/p/mupen64plus/ homepage .
34 The options are as follows:
39 Disable onscreen display.
41 Enable onscreen display.
43 Run emulator in fullscreen display mode.
45 Run emulator in windowed display mode.
46 .It Fl -resolution Ar res
47 Display resolution (640\(mu480, 800\(mu600, 1024\(mu768, etc)
49 Disable core speed limiter.
50 This should be used with the dummy audio plugin.
51 .It Fl -cheats Ar cheat-spec
52 Enable or list cheat codes for the given rom file.
53 .It Fl -corelib Ar filepath
54 Specifies a filename (optionally with a preceding directory path) to load a specific
57 .It Fl -configdir Ar directory
58 Specifies a directory to look for the
62 .Pa ~/.config/mupen64plus/ .
63 .It Fl -datadir Ar directory
64 Specifies a directory to search for shared data files (fonts, cheat codes, .ini files).
66 .Pa ${PREFIX}/share/mupen64plus/ .
67 .It Fl -plugindir Ar directory
68 Specifies a directory to search for plugin files.
70 .Pa ${PREFIX}/lib/mupen64plus/ .
71 .It Fl -sshotdir Ar directory
72 Specifies a directory to save screenshots captured during gameplay.
74 .Pa ~/.local/share/mupen64plus/screenshot/ .
75 .It Fl -gfx Ar plugin\(hyspec
78 to select a graphics plugin for use during emulation.
79 .It Fl -audio Ar plugin\(hyspec
82 to select an audio plugin for use during emulation.
83 .It Fl -input Ar plugin\(hyspec
86 to select an input plugin for use during emulation.
87 .It Fl -rsp Ar plugin\(hyspec
90 to select an RSP plugin for use during emulation.
91 .It Fl -emumode Ar mode
92 Specifies which mode the emulator core should run in.
94 should be set to one of the following numbers:
101 Dynamic Recompiler (DynaRec)
103 .It Fl -testshots Ar list
104 Take screenshots at frames given in the comma\(hyseparated
107 .It Fl -core-compare-send
108 Use the core comparison debugging feature, in data sending mode.
109 If the core was not compiled with support for the Core Comparison feature, then the emulator will exit with an error.
110 .It Fl -core-compare-recv
111 Use the core comparison debugging feature, in data receiving mode.
112 If the core was not compiled with support for the Core Comparison feature, then the emulator will exit with an error.
113 .It Fl -set Ar param\(hyspec
116 configuration parameter.
117 This option may be used multiple times.
121 .Dl Section\(hyName[Param\(hyName]=Value
122 .It Fl -nosaveoptions
123 Do not save the given command\(hyline options into the
125 configuration file to use as defaults in the future.
127 Print lots of information.
128 Useful for debugging but unnecessary for normal use.
133 Filename (without path) of plugin to use.
134 Application will search through several directories to look for a matching plugin name.
136 Full directory path and filename of plugin.
138 Use the dummy plugin.
143 Show all of the available cheat codes.
145 Enable all of the available cheat codes.
147 A comma separated list of cheat code numbers to enable.
150 The following shortcut keys can be used during emulation.
151 These are the default key values; nearly all of them may be set to different keys by editing the
154 .Bl -tag -width Alt-Enter
162 Save emulator state to current slot.
164 Load emulator state from current slot.
168 Slow down emulator speed by 5 percent.
170 Speed up emulator speed by 5 percent.
174 Toggle fullscreen mode.
175 This is not supported on Windows.
177 Pause/continue emulation.
181 Fast Forward (playback at 250% normal speed as long as key is pressed).
183 Press GameShark button (if cheats are enabled).
185 Advance one frame if paused.
192 The default location for the
194 configuration file is
195 .Pa ~/.config/mupen64plus/ .
196 The default location of the saved screenshots is
197 .Pa ~/.local/share/mupen64plus/screenshot/ .
198 The default location of the save states is
199 .Pa ~/.local/share/mupen64plus/save/ .
202 was originally started by Richard42 and nmn, and is based on Mupen64 (originally written by Hacktarux).
204 This man page was written by ebenblues, and updated by Richard42 and bentley.
206 Mupen64plus is \(co 2008\(en2013 The Mupen64plus Team
209 .Lk https://gnu.org/licenses/gpl.html GNU GPL version 2 or later
211 This is free software: you are free to change and redistribute it.
214 to the extent permitted by law.
216 To report bugs or make feature requests, use the
217 .Lk https://code.google.com/p/mupen64plus/issues/list "issue tracker"