Command line parameters

Filesystem and mods

• --basedir PATH
  • Override path to the base data directory, i.e. the one where your ROM file is.
• --savedir PATH
  • Override path to the save directory, i.e. the one where the game stores its config and EEPROM save file.
• --moddir PATH
  • Specify mod directory name or path.
    Files in the mod directory override files in the base directory and the contents of the ROM. It may or may not contain a modconfig.txt file.
    If you specify just the name (e.g. --moddir mymod), the game will look for it in the working directory, in the executable directory and in the home directory in that order.
• --rom-file PATH
  • Override ROM file name or path.
    If you specify just the name (e.g. --rom-file pd.z64), the game will look for it in the base and mod directories.
    Defaults to pd.ntsc-final.z64 for NTSC builds and pd.jpn-final.z64 for JPN builds.
• --eeprom-file PATH
  • Override EEPROM save file name or path.
    If you specify just the name (e.g. --eeprom-file save.bin), the game will read/write it from/to the save directory.
    Defaults to eeprom.bin.
• --portable
  • Never use any directories other than the executable directory, regardless of OS.

Game

• --boot-stage NUMBER
  • Start game on stage with ID NUMBER, according to stagetable.txt.
    NUMBER can be decimal or hexadecimal, e.g. --boot-stage 0x19.
    NOTE: MP stages and some other stages will cause crashes if you start them this way. Player file selection is also skipped.
• --profile NUMBER
  • Skip the file select menu and automatically select file NUMBER. Files are probably numbered in order of creation, unless you've deleted any before.
• --no-sound
  • Completely disable sound. Not sure if this has any adverse effects.
• --skip-intro
  • Skip intro sequence. Equivalent to --boot-stage 0x26.

Debugging

• --log
  • Log information to a file called pd.log instead of your terminal.
    File will be created in the executable directory if it's writable, or in the home directory otherwise.
    If you're trying to reproduce a crash, you should run the game with this flag. The crash report will be saved in the log file.
• --debug-gl
  • Create a debug OpenGL context instead of a normal one and turn on OpenGL debug output. Useful for diagnosing GPU-related issues.
• --gl-version VERSION
  • When creating the OpenGL context, request GL version VERSION.
    VERSION can be a version number, optionally including core if you want a core context or es if you want a GLES context, like 2.1 or 3.2core or 3.0es.
    Use this if the game fails to create a GL context on your machine for some reason, but you're sure it should support at least 2.1.

Network

Only available in the port-net branch.

• --port NUMBER
  • Set server port to NUMBER.
• --maxclients NUMBER
  • Set server player cap to NUMBER.
• --connect ADDRESS
  • Automatically try to connect to the server at ADDRESS as soon as the game reaches the main menu.
    Will attempt to use player profile #0 if not otherwise specified using --profile.
• --host
  • Automatically try to host a server as soon as the game reaches the main menu.
    Will attempt to use player profile #0 if not otherwise specified using --profile.