NAME¶
mupen64plus - Console front‐end for the Mupen64Plus N64 emulator
SYNOPSIS¶
mupen64plus [parameters(s)] [romfile]
DESCRIPTION¶
Mupen64Plus is a plugin‐based N64 emulator for Linux/Unix, OSX, and
Windows which is capable of accurately playing many games. Included are four
MIPS R4300 CPU emulators, with dynamic recompilers for 32‐bit x86 and
64‐bit amd64 systems, and necessary plugins for audio, graphical
rendering (RDP), signal co‐processor (RSP), and input. There are
currently two OpenGL video plugins available: the included Rice Video, and
Arachnoid (at
http://bitbucket.org/wahrhaft/mupen64plus-video-arachnoid/).
The most current documentation can be found at the project's homepage:
http://code.google.com/p/mupen64plus
- -h, --help
- Print help message.
- --noosd
- Disable onscreen display.
- --osd
- Enable onscreen display.
- --fullscreen
- Run emulator in fullscreen display mode.
- --windowed
- Run emulator in windowed display mode.
- --resolution res
- Display resolution (640x480, 800x600, 1024x768, etc)
- --cheats cheat‐spec
- Enable or list cheat codes for the given rom file.
- --corelib filepath
- Specifies a filename (optionally with a preceding directory
path) to load a specific Mupen64Plus core library.
- --configdir directory
- Specifies a directory to look for the mupen64plus.cfg file.
Default is ~/.config/mupen64plus/.
- --datadir directory
- Specifies a directory to search for shared data files
(fonts, cheat codes, .ini files). Default is
PREFIX/share/mupen64plus/.
- --plugindir directory
- Specifies a directory to search for plugin files. Default
is PREFIX/lib/mupen64plus/.
- --sshotdir directory
- Specifies a directory to save screenshots captured during
gameplay. Default is ~/.local/share/mupen64plus/screenshot/.
- --gfx plugin‐spec
- Specifies a plugin‐spec to select a graphics
plugin for use during emulation.
- --audio plugin‐spec
- Specifies a plugin‐spec to select an audio
plugin for use during emulation.
- --input plugin‐spec
- Specifies a plugin‐spec to select an input
plugin for use during emulation.
- --rsp plugin‐spec
- Specifies a plugin‐spec to select an RSP
plugin for use during emulation.
- --emumode mode
- Specifies which mode the emulator core should run in.
mode should be set to one of the following numbers: 0=Pure
Interpreter, 1=Cached Interpreter, 2=Dynamic Recompiler (DynaRec).
- --testshots list
- Take screenshots at frames given in the
comma‐separated list, then quit.
- --core-compare-send
- Use the core comparison debugging feature, in data sending
mode. If the core was not compiled with support for the Core Comparison
feature, then the emulator will exit with an error.
- --core-compare-recv
- Use the core comparison debugging feature, in data
receiving mode. If the core was not compiled with support for the Core
Comparison feature, then the emulator will exit with an error.
- --set param‐spec
- Set the value of a Mupen64Plus configuration parameter.
This option may be used multiple times. The format of
param‐spec is Section‐Name[Param‐Name]=Value
- --saveoptions
- Save the given command‐line options into the
mupen64plus configuration file to use as defaults in the future. Since the
console front‐end needs to load the core library before reading the
configuration file, the --corelib option cannot be saved.
- --verbose
- Print lots of information. Useful for debugging but
unnecessary for normal use.
plugin‐spec¶
- (plugin-name)
- Filename (without path) of plugin to use. Application will
search through several directories to look for a matching plugin
name.
- (plugin-path)
- Full directory path and filename of plugin.
- 'dummy'
- Use the dummy plugin.
cheat‐spec¶
- 'list'
- Show all of the available cheat codes.
- 'all'
- Enable all of the available cheat codes.
- (codelist)
- A comma separated list of cheat code numbers to
enable.
KEY COMMANDS¶
The following shortcut keys can be used during emulation. These are the default
key values; nearly all of them may be set to different keys by editing the
mupen64plus configuration file.
- Escape
- Quit the emulator.
- 0-9
- Select virtual 'slot' for save/load state.
- F5
- Save emulator state to current slot.
- F7
- Load emulator state from current slot.
- F9
- Reset emulator.
- F10
- Slow down emulator speed by 5 percent.
- F11
- Speed up emulator speed by 5 percent.
- F12
- Take screenshot.
- Alt‐Enter
- Toggle fullscreen mode. This is not supported on
Windows.
- p or P
- Pause/continue emulation.
- m or M
- Mute/unmute sound.
- f or F
- Fast Forward (playback at 250% normal speed as long as key
is pressed)
- g or G
- Press GameShark button (if cheats are enabled).
- / or ?
- Advance one frame if paused.
- [
- Decrease volume.
- ]
- Increase volume.
FILES¶
The default location for the Mupen64plus configuration file is
~/.config/mupen64plus/. The default location of the saved screenshots
is
~/.local/share/mupen64plus/screenshot/. The default location of the
save states is
~/.local/share/mupen64plus/save/.
BUGS¶
To report bugs or make feature requests, use the issue tracker on the
Mupen64Plus project site:
http://code.google.com/p/mupen64plus/issues/list
AUTHORS¶
Mupen64Plus was originally started by Richard42 and nmn, and is based on Mupen64
(originally written by Hacktarux).
This man page was written by ebenblues, and updated by Richard42.
COPYRIGHT¶
Mupen64Plus is © 2008-2010 The Mupen64Plus Team License GPLv2+: GNU GPL
version 2 or later <
http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO
WARRANTY, to the extent permitted by law.