From ZDoom Wiki
Jump to navigation Jump to search

These console commands are used for other miscellaneous functions.

  • bench (Windows only)
This command collects rendering speed data for five seconds then appends this information to a file called benchmarks.txt (creating it if needed). To provide reliable data, it needs to be called from a bound key rather than from the console.
  • cachesound <sound names>
Loads and caches all of the listed sound names.
  • clear
Clears the console of all text.
  • clearnodecache
Deletes all cached GL nodes that may have been generated.
  • exit
This is a synonym for quit and quits the game.
  • gc <"command">
This controls various aspects of the MiniWikipediaLogoIcon.pngcollector. The issued command can be one of those:
  • stop: stops the garbage collector entirely by setting the threshold of allocated memory to reach before the next cycle is started to an absurdly large value.
  • now: starts a garbage collection cycle by setting the threshold to the current size of allocated memory.
  • full: collects everything in one fell swoop.
  • pause [size]: if no size is given, gives the size of the pause, in percentage of memory use, between each cycle of the garbage collector; otherwise set it to the given value. A pause of 150 corresponds to waiting for memory use to increase by half before the next cycle is started. Higher values mean larger pauses, which mean slower collection.
  • stepmul [size]: gives the size of the step multiplier if no size is given, or set the step multiplier to the given value otherwise. A step is 1024 bytes, so a stepmul of 400 means the garbage collector will sweep at least 409 600 bytes of allocated memory on each cycle.
  • load <filename>
Loads the given savegame file.
  • menuconsole
Closes all menus and toggles the console. This is used to open the console from the options menu's "Go to console" entry. Calling it from the console will close it.
  • openconfig
Opens the directory where the configuration file is stored.
  • opensaves
Opens the directory where savegames are stored.
  • openscreenshots
Opens the directory where screenshots are stored.
  • quickload
Loads the last quicksaved game.
  • quicksave
Quick saves the game.
  • quit
Exits ZDoom and saves the configuration file to disk.
  • restart [params]
Restart the engine. The parameters will be interpreted as if they were command line parameters. E.g., restart -iwad plutonia will quit the current game and instead load Plutonia as the IWAD.
  • reverbedit (Windows only)
Opens the REVERBS environment editor.
  • save <filename> ["description"]
Save the current game in the given savegame file. Optionally, a description of up to 24 characters can be provided too.
  • snd_reset
Restarts the ZDoom sound system, including external software synthesizers such as FluidSynth and TiMidity++ if needed, and rereading the DMXGUS lump if using the GUS emulator or the GENMIDI lump if using OPL synth emulation. Use this if you have changed audio settings which did not take effect immediately.
  • undocolorpic
This command only has an effect when called by the select color menu. It undoes any change made since the menu was opened.
  • vid_restart
This command currently has no effect.
  • writeini [filename]
Saves the current settings to the configuration file. Optionally, a filename can be provided to write to a different file.
  • writemidi <filename>
If the currently playing song is a MIDI variant, it is written to disk. If successful, the current song will restart, since MIDI file generation involves a simulated playthrough of the song. This allows to use ZDoom to convert the MUS, HMI, HMP, and XMI formats to MIDI.
  • writeopl [songname] <filename>
If the currently playing song is a MUS/MIDI song being played through the OPL synth emulation, then you just need to specify the filename. Otherwise, you need to provide the songname (such as D_E1M1) as well. The resulting file can be played with RDOSPlay or AdPlug. If the given filename has a .dro extension, then the DRO v1.0 format will be used, otherwise the data will use the RAW format.
  • writewave <filename> [sample rate]
If the current song can be represented as a waveform, dump it to the specified file on disk. The sample rate parameter is merely a suggestion, and the dumper is free to ignore it.

CVar control

  • reset2defaults
Resets all console variables and key bindings to their default values.
  • reset2saved
Resets all console variables and key bindings to the values they currently have in the ini.
Resets cvar to the default value.
Toggles the value of cvar between false and true (zero and non-zero).


  • playdemo <demo>
Plays a demo. The demo can be a file on disk or a lump in a wad.
  • recordmap <filename> <map name> [dm|coop]
Starts a new game on the specified map, recording a demo to the specified filename. Passing * instead of a map name records a demo of the current map. Optionally the dm or coop keyword can be added to set the game mode to emulated multiplayer. Without this keyword the game mode defaults to single-player.
  • stop
Stops demo recording and exits the game.
  • timedemo
Plays a demo as fast as the refresh rate will allow and displays the average framerate attained during playback. Due to limitations in the current demo system, this command will also exit the game when the demo finishes.

Music control

  • playlist <playlist.m3u> [shuffle|position]
Loads a WinAmp .m3u playlist. Any music that would normally be played will be ignored, and the songs in the playlist will be played instead. If you add the word shuffle after the name of the .m3u file, the playlist will be replayed in a random order. In place of shuffle, you can also specify position, a number corresponding to the song number in the playlist you want to play first.
  • playlistnext
Plays the next song in the playlist.
  • playlistpos <position>
Starts playing the song at the specified position in the playlist.
  • playlistprev
Plays the previous song in the playlist.
  • playliststatus
Displays the number of songs in the playlist and the currently playing song.
  • stopmus
Stops playing the current song.

Menu control

  • closemenu
Closes the current menu. This is mainly useful to be called from custom menus as a means to close the menu and return to the game.
  • menu_advsound
Activates the advanced sound options menu.
  • menu_automap
Activates the automap options menu.
  • menu_compatibility
Activates the compatibility options menu.
  • menu_display
Activates the display options menu.
  • menu_endgame
Asks the user if they want to end the current game, and returns to the title screen if they do.
  • menu_game
Activates the new game menu.
  • menu_gameplay
Activates the gameplay options (dmflags) menu.
  • menu_help
Displays the help screen.
  • menu_joystick
Activates the joystick/game controller configuration menu.
  • menu_keys
Activates the customize controls menu.
  • menu_load
Activates the load game menu.
  • menu_main
Activates the main menu.
  • menu_mapcolors
Activates the custom automap colors menu.
  • menu_messages
Activates the message options menu.
  • menu_modreplayer
Activates the module replayer options menu.
  • menu_mouse
Activates the mouse configuration menu.
  • menu_options
Activates the options menu.
  • menu_player
Activates the player setup menu.
  • menu_quit
Activates the quit menu which asks the user if they want to quit, and quits if they do.
  • menu_save
Activates the save game menu.
  • menu_scoreboard
Activates the scoreboard options menu.
  • menu_sound
Activates the sound options menu.
  • menu_video
Activates the video mode menu.
  • openmenu <menu_name>
Opens the given menu, using its MENUDEF name.

See also