wow-api-settings-system

WoW 设置系统（CVar 和控制台）

当你需要说明或操作 WoW Retail 中的控制台变量（CVar）和控制台命令时，请使用此技能。

什么是 CVar

• CVar 是影响图形、声音、界面和游戏行为的客户端配置值。
• 游戏内界面选项中的许多设置都直接映射到 CVar。
• 最新且权威的列表位于 Wiki。请使用该列表，而不要复制大段列表内容。

参考：https://warcraft.wiki.gg/wiki/Console_variables

读取和设置 CVar

API（插件或脚本）

• 读取：GetCVar(name) 返回字符串值。
• 读取默认值：GetCVarDefault(name) 返回代码中的默认值。
• 检查：GetCVarInfo(name) 可指示某个 CVar 是否为安全 CVar。
• 写入：SetCVar(name, value) 将值设置为字符串。

示例：

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

/console 命令

• 在聊天中使用 /console <name> <value>。
• 示例：

/console scriptErrors 1

控制台窗口

• 使用 /console enable 启用，或使用 -console 启动客户端。
• 按 ` 或 ~ 键打开控制台窗口。

安全 CVar 和战斗限制

• 战斗中无法更改安全 CVar。
• 必须通过 SetCVar 更改安全 CVar（不能使用 /console）。
• 更改 CVar 前，请使用 GetCVarInfo 确认它是否为安全 CVar。

CVar 作用范围（账号或角色）

• 有些 CVar 适用于整个账号，有些则仅适用于特定角色。
• 角色或账号特定的值可能会同步到服务器（启用 synchronizeConfig 时）。
• 更改角色特定的 CVar 只会影响当前角色。

重置 CVar

• 将一个 CVar 重置为默认值：

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

• 控制台重置：

/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 的 API 文档）。

参考：https://warcraft.wiki.gg/wiki/Console_variables

补充说明

有关精选的工作流技巧、注意事项和重置指南，请参阅 references/CVARS-OVERVIEW.md。

何时使用此技能

• 你需要说明如何从插件或脚本中设置或读取 CVar。
• 你需要澄清 CVar 的作用范围、安全限制或重置行为。
• 你需要了解控制台命令的用法或配置文件的位置。