Unreal Console Commands
Tim Sweeney
Epic MegaGames, Inc.
tim@epicgames.com
http://www.epicgames.com/
This document is a trade secret of Epic MegaGames, Inc.
[out of date -- some of these are no longer implemented, others are not yet
implemented]
Command Line Parameters
- -profile: When C++ is compiled with DO_SLOW_GUARD=1, generates an UnrealScript function
profile using the timings in the most recently played level only.
- -nosound: Disables sound.
- -nodsound: Disables DirectSound support.
- -noddraw: Disables DirectDraw support.
- -nohard: Disables 3d hardware support.
- -log: Runs with the log window initially visible.
- -conflicts: Show objects of different classes whose names conflict.
- -nommx: Disables MMX support.
- -make: Rebuilds all .u files from their source .uc files.
- -make -h: Rebuilds all .u files from their source .uc files and generate a C++ header
for each package.
- -editor: Runs Unreal for editing.
- -server: Runs as a dedicated server.
- -dumpinv: When switching levels, writes a dump of the player's travelling inventory to
System\Inv.txt.
- -strict: Treat all script warnings as critical errors; useful for tracking down the call
stack when debugging scripts.
- -nobind: Don't treat UnrealScript/C++ binding errors as critical, for rebuilding scripts
and avoiding the chicken-and-egg binding problem.
- -showdep: Causes script compiler to log dependency information when recompiling scripts.
- LOG=logfilename: Uses the specified log file instead of Unreal.log. Useful when running
multiple copies on the same machine.
- INI=inifilename: Sets the .ini file to use for configuration, normally Unreal.ini.
- PORT=num: Sets the UDP port number for the Internet server.
Console Commands
- BRIGHTNESS: Cycle through 10 screen brightness values.
- CHAT: Brings up a prompt to type chat text.
- CANCEL: Cancels an "open" command in progress that is trying to connect to a
network server.
- CDTRACK num: Play the specified CD track.
- CONSOLE FULL: Make the console fullscreen.
- CONSOLE HIDE: Hide the console.
- CONSOLE SHOW: Show the console.
- DEBUG CRASH: Test crashing the game by appError.
- DEBUG EATMEM: Test allocating memory until it fills up.
- DEBUG GPF: Test a general protection fault.
- DEBUG RECURSE: Test crash by infinite recusion.
- DUMPCACHE: Display the contents of the memory cache GCache.
- ENDFULLSCREEN: Go back to playing in a window.
- EXEC filename: Execute the console commands in the filename, default is in the System
directory.
- EXIT: Exit the program.
- FLUSH: Flush all caches. Regenerates all lighting, 3d hardware textures, etc.
- HIDEACTORS: Hide actors during gameplay.
- JUMPTO x y z: In UnrealEd, move the viewport to a certain X,Y,Z location, useful in
conjunction with tester reports generated with the REPORT command.
- LISTEN: Start the non-dedicated network game server listening for connections.
- LOADGAME num: Load a game in position 0-9.
- MEM: List memory usage; only works when Unreal is compiled with the memory-tracking
option (it's usually not).
- MEMSTAT: Show Windows overall memory statistics.
- MUSICORDER num: Change to a certain track in the song (0=ambient, 1=action, 2=suspense).
- OBJ CLASSES: Prints a list of all loaded classes.
- OBJ DEPENDENCIES PACKAGE=pkgname EXCLUDE1=otherpackage EXCLUDE2=otherpackage...: !!
- OBJ GARBAGE: Collect and purge garbage ("garbage" means objects which are no
longer in use).
- OBJ HASH: Show object hashing statistics.
- OBJ LIST CLASS=objectclass: List all objects belonging to the class (if the class isn't
specified, lists ALL objects). Gives a summary of memory usage. This is very
useful during gameplay for figuring out how much memory is being used. In UnrealEd,
this statistic isn't useful because a huge amount of extra stuff is loaded which might not
be used by your map.
- OBJ REFS CLASS=objectclass NAME=objectname: Show a list of objects which reference the
object you specify. When trimming memory usage, this is useful for figuring out why
some object is being loaded.
- OPEN url: Opens a local map (i.e. "unreal.unr") or an Internet server (i.e.
"200.0.1.16" or "unreal.epicgames.com").
- REPORT: Copies a report of the current gameplay situation to the clipboard. You
can then paste the resulting text into an email program, Notepad, etc. Extremely useful
for beta testers, because it dumps the player's X,Y,Z location, the difficulty level, etc.
- RMODE: Set the rendering mode. 0-9.
- SAVEGAME num: Save the game in a specified position, 0-9.
- SHOT: Take a screenshot and save it in the System directory with a consecutive name like
Shot0001.bmp.
- SHOWACTORS: Shows actors during gameplay.
- SOCKETS: In network play, shows a list of network sockets (UNetConnection's) in use.
- STAT ACTOR: Shows various statistics.
- STAT CACHE
- STAT CLIP
- STAT FILTER
- STAT FPS
- STAT GAME
- STAT GLOBAL
- STAT HARDWARE
- STAT ILLUM
- STAT LIGHT
- STAT MESH
- STAT POLYC
- STAT POLYV
- STAT REJECT
- STAT OCCLUSION
- STAT SOFT
- STAT SPAN
- STAT ZONE
- TOGGLEFULLSCREEN: Toggles fullscreen mode on and off.
- TYPE: Types text on the console.
- URL urlname: In network play, parses a URL and displays its components.
- VIEWUP: Sizes the view up.
- VIEWDOWN: Sizes the view down.