Skip to content

Command line parameters

Jump to bottom
fgsfds edited this page Oct 11, 2023 · 9 revisions

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, where the game will store its config and EEPROM 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 working directory and 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.
  • --no-sound
    • Completely disable sound. Not sure if this has any adverse effects.

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

Clone this wiki locally