wow-api-settings-system

name	wow-api-settings-system
description	Documents console variables (CVars), how to query and set them, console command usage, scope rules, and reset behavior for WoW Retail. Use when working with CVars, /console, SetCVar, GetCVar, GetCVarInfo, Config.wtf, or settings system behavior.

WoW Settings System (CVars and Console)

Use this skill when you need to explain or work with console variables (CVars) and console commands in WoW Retail.

What CVars Are

• CVars are client configuration values that affect graphics, sound, UI, and gameplay behavior.
• Many settings in the in-game Interface options map directly to CVars.
• The authoritative, up-to-date list is on the wiki. Use it instead of copying large lists.

Reference: https://warcraft.wiki.gg/wiki/Console_variables

Reading and Setting CVars

API (AddOns or scripts)

• Read: GetCVar(name) returns a string value.
• Read default: GetCVarDefault(name) returns the coded default value.
• Inspect: GetCVarInfo(name) can indicate if a CVar is secure.
• Write: SetCVar(name, value) sets a value as a string.

Example:

-- Enable UI error popups
SetCVar("scriptErrors", 1)

/console Command

• Use /console <name> <value> in chat.
• Example:

/console scriptErrors 1

Console Window

• Enable with /console enable or start the client with -console.
• Open the console window with the ` or ~ key.

Secure CVars and Combat Restrictions

• Secure CVars cannot be changed in combat.
• Secure CVars must be changed via SetCVar (not /console).
• Use GetCVarInfo to determine if a CVar is secure before changing it.

CVar Scope (Account vs Character)

• Some CVars are account-wide, others are character-specific.
• Character or account specific values may sync to the server (when synchronizeConfig is enabled).
• Changing a character specific CVar only affects the current character.

Resetting CVars

• Reset one CVar to default:

SetCVar("autoSelfCast", GetCVarDefault("autoSelfCast"))

• Console reset:

/console cvar_default autoSelfCast

• Full reset:

/console cvar_default

Note: Account or character specific CVars that are synced may persist even after reinstalling or deleting the WTF folder.

Config Files (When the Game Is Not Running)

• WTF/Config.wtf stores startup and global settings.
• WTF/Account/<AccountName>/config-cache.wtf and per-character config-cache.wtf store account or character scoped values.
• Only edit these files while the game is closed or changes will be overwritten.

Discovering CVars and Console Commands

• The wiki list is the most complete, searchable source.
• The console command list is also on the same page.
• Some console APIs expose command lists (see the API docs for C_Console).

Reference: https://warcraft.wiki.gg/wiki/Console_variables

Additional Notes

See references/CVARS-OVERVIEW.md for a short, curated set of workflow tips, pitfalls, and reset guidance.

When to Use This Skill

• You need to explain how to set or read CVars from an addon or script.
• You need to clarify CVar scope, secure restrictions, or reset behavior.
• You need guidance on console command usage or config file locations.