The API is no longer being updated here until further notice. |
The World of Warcraft game client stores all of its configuration in the so-called Console Variables (CVars). These variables affect many aspects of the game, such as the graphics engine, the interface and the sound system.
There are several ways of setting the configuration variables:
- Config.wtf - The World of Warcraft directory contains a Config.wtf file in the WTF folder, which provides settings mostly relevant to game startup, such as
gxResolution
for the screen resolution to use andlocale
for the language. - /console command - Settings can be changed in-game using the
/console
command, which uses the same syntax as the file Config.wtf described above. Any modifications done using this command will be saved to this file. - SetCVar API command - for changing settings using addons
The syntax for the first two ways of changing a variable is:
SET variableName "value"
- Manually changing a CVar may permanently override the settings made on the in-game configuration menu. For example, having
cameraDistanceMax
set in the file Config.wtf renders the "Max Camera Distance" slider useless. You will have to quit the game and manually remove the CVar line from the file.
List of CVars
This is a categorized list of console variables, along with a short explanation for each CVar.
The list is not complete; for a complete list, see Console variables/Complete list.
Startup
These are general variables that are only relevant for starting the game (or which are only read during startup).
- accountName - Saved account name for login screen
- checkAddonVersion - Disable loading of out-of-date addons
- expansionMovie - Display Burning Crusade intro at startup (This variable is reset to 0 after the video has been shown)
- lastCharacterIndex - Number of last character that was used for logging in (initial selection for character screen)
- locale - Game language code (e.g. "enGB", "enUS", "deDE", "frFR" ...)
- movie - Display intro movie at startup (doesn't work in Burning Crusade game client)
- movieSubtitle - Display subtitles for intro movies
- readContest - Whether the user has accepted the PTR contest rules
- readEULA - Whether the user has accepted the EULA
- readScanning - Whether the user has accepted the system scanning terms
- readTOS - Whether the user has accepted the Terms of Use
- realmList - Realm list server to use (e.g. "eu.logon.worldofwarcraft.com")
- realmName - Name of most recently used realm (displayed in the lower right corner)
- showToolsUI - Enable the WoW Launcher
Camera
- cameraBobbing
- cameraBobbingFrequency
- cameraBobbingLRAmplitude
- cameraBobbingSmoothSpeed
- cameraBobbingUDAmplitude
- cameraCustomViewSmoothing
- cameraDistanceMax
- cameraDistanceMaxFactor
- cameraDistanceMoveSpeed
- cameraDistanceSmoothSpeed
- cameraDive
- cameraFlyingMountHeightSmoothSpeed
- cameraFoVSmoothSpeed
- cameraGroundSmoothSpeed
- cameraHeightIgnoreStandState
- cameraHeightSmoothSpeed
- cameraPitchMoveSpeed
- cameraPitchSmoothSpeed
- cameraPitchSmoothMin
- cameraPitchSmoothMax
- cameraPivot
- cameraPivotDXMax
- cameraPivotDYMin
- camerasmooth
- cameraSmoothPitch
- cameraSmoothStyle
- cameraSmoothTrackingStyle
- cameraSmoothYaw
- cameraSmoothTimeMin
- cameraSmoothTimeMax
- cameraSubmergeFinalPitch
- cameraSubmergePitch
- cameraSurfacePitch
- cameraSurfaceFinalPitch
- cameraTargetSmoothSpeed
- cameraTerrainTilt
- cameraTerrainTiltTimeMin
- cameraTerrainTiltTimeMax
- cameraView
- cameraViewBlendStyle
- cameraWaterCollision
- cameraYawMoveSpeed
- cameraYawSmoothMax
- cameraYawSmoothMin
- cameraYawSmoothSpeed
Graphics
- anisotropic - Anisotropic filtering
- baseMip - base level for mip mapping
- bspcache - ?
- DesktopGamma - Level of desktop gamma (?)
- DistCull - ?
- doodadAnim - Toggle animated geometry
- farclip - ?
- ffxDeath - Enable full screen death effect
- ffxGlow - Enable full screen glow effect
- ffxNetherWorld - Enable full screen "nether world" effect, e.g. for a Mage's [Invisibility]
- ffxRectangle - ?
- footstepBias - ?
- frillDensity - ?
- fullAlpha - ?
- Gamma - Gamma level
- gxApi - Graphics API to use
- gxAspect - Preserve aspect ratio for windowed mode
- gxColorBits - Color bits
- gxCursor - Enable hardware cursors
- gxDepthBits - Depth bits
- gxFixLag - Smooth mouse cursor
- gxMaximize - When using windowed mode, maximize the window
- gxMultisample - Enable anti-aliasing (e.g. "4" for 4x multisampling)
- gxMultisampleQuality - Quality for anti-aliasing (?)
- gxOverride - ?
- gxResolution - Screen resolution (e.g. "1280x1024")
- gxRefresh - Refresh rate in Hz
- gxTripleBuffer - Enable Triple Buffering
- gxVSync - Enable VSync
- gxWindow - Windowed mode
- horizonfarclip - ?
- hwDetect - Perform hardware detection for best values
- mapObjOverbright - ?
- mapObjLightLOD - ?
- mapShadows - Toggle map shadows
- MaxLights - Maximum number of hardware lights
- M2UseZFill - ?
- M2UseClipPlanes - ?
- M2UseThreads - Use multiple threads
- M2UsePixelShaders - Enable pixel shaders for models
- M2BatchDoodads - ?
- M2UseShaders - Enable vertex shaders for models
- M2Faster - Optimization level
- M2FasterDebug - ?
- UIFaster - UI acceleration level
- nearclip - ?
- occlusion - ?
- particleDensity - Particle density
- pixelShaders - Enable pixel shaders
- shadowBias - ?
- shadowLevel - Level of detail for shadow mip maps
- shadowLOD - Level of detail for (unit?) shadows
- showfootprints - Enable footprints
- showsmartrects - ?
- SkyCloudLOD - ?
- SmallCull - ?
- specular - ?
- spellEffectLevel - Spell Effect level
- SplineOpt - ?
- texLodBias - Texture Level of Detail Bias (?)
- triangleStrips - ?
- trilinear - Enable trilinear filtering
- unitDrawDist - Unit draw distance
- useWeatherShaders - Enable weather shaders
- violenceLevel - Changes the violence level of the game
- waterLOD - Level of Detail for water
- weatherDensity - Level of weather effects