CCMDs:Other

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 collector. 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.

• resetcvar <cvar>

Resets cvar to the default value.

• toggle <cvar>

Toggles the value of cvar between false and true (zero and non-zero).

Demo

• 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

• CVARs
• CCMDs