WoW:API SetCVar

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

→ WoW API

← WoW API < SetCVar

Changes a variable located inside Config.wtf

 SetCVar( "cvar", value[, "scriptCVar"] );

Parameters

Arguments

cvar

String - CVar to modify

value

New value of the CVar - This value is stored in Config.wtf as plain text. Passing anything other than a string or number is just silly.

scriptCVar

String - First argument for the CVAR_UPDATE event, if none is passed then the event isn't fired

---

Details

Settings that are changed using this will be applied to the game UI immediately, however settings are not saved until exit and settings which were previously not defined in Config.wtf are not available to GetCVar until the file has been saved at logout.

Some options require a call to RestartGx() before they take effect.

If you try and pass an invalid CVar you'll get an error, check Console variables for a list of valid CVars.

By default CVAR_UPDATE is not fired when you call SetCVar, to make sure it does you need to pass the third argument scriptCVar which will be the first argument in the event when it's fired.