本技能用于说明和操作魔兽世界正式服(WoW Retail)的控制台变量(CVar)与控制台命令。CVar 是影响图形、声音、界面与游戏行为的客户端配置值,游戏内许多界面设置直接对应 CVar;权威且最新的列表以 warcraft.wiki.gg 的 Console variables 页面为准,建议直接查该页面而非复制长列表。
读取与设置:在插件或脚本中可用 GetCVar(name) 返回字符串值,GetCVarDefault(name) 返回编码默认值,GetCVarInfo(name) 可判断某 CVar 是否为安全(secure)项,SetCVar(name, value) 以字符串写入值。示例:SetCVar("scriptErrors", 1) 开启界面错误弹窗。也可在聊天中使用 /console <name> <value>,例如 /console scriptErrors 1。控制台窗口可用 /console enable 开启,或以 -console 启动客户端,再用 ` 或 ~ 键打开。
安全与限制:安全 CVar 不能在战斗中修改,且必须通过 SetCVar 而非 /console 修改;修改前可用 GetCVarInfo 判断。作用域方面,部分 CVar 为账号级,部分为角色级;当 synchronizeConfig 启用时,角色或账号级值可能同步到服务器,修改角色级 CVar 只影响当前角色。
重置:可用 SetCVar("autoSelfCast", GetCVarDefault("autoSelfCast")) 将单个 CVar 重置为默认;控制台命令为 /console cvar_default autoSelfCast,全部重置为 /console cvar_default。注意已同步的账号或角色级 CVar 即便重装或删除 WTF 文件夹也可能保留。
配置文件:游戏未运行时,WTF/Config.wtf 保存启动与全局设置,WTF/Account/<AccountName>/config-cache.wtf 及各角色 config-cache.wtf 保存账号或角色作用域值;只能在不运行游戏时编辑,否则更改会被覆盖。查找 CVar 与控制台命令时,wiki 列表最完整可搜索,同一页面也含控制台命令列表,部分控制台 API(参见 C_Console 文档)可暴露命令列表。
适用场景:需要解释如何从插件或脚本读取设置 CVar、澄清 CVar 作用域、安全限制或重置行为,以及了解控制台命令用法和配置文件位置时使用。使用前建议参考 references/CVARS-OVERVIEW.md 中精选的工作流提示、常见陷阱与重置建议。关于具体可用 CVar 的完整清单与平台支持细节,资料未逐一列出,请以官方 wiki 页面为准。