CFG

From Valve Developer Community
< Zh
Jump to navigation Jump to search
English (en)Deutsch (de)中文 (zh)Translate (Translate)

配置文件(或 CFG)是 起源 起源 游戏中用于向开发者控制台执行一系列以换行分隔的控制台命令的文本文件。.cfg 文件扩展名非常常见,并非 Source 引擎专用。

Tip.png提示: 将特定情境的按键绑定保留在 autoexec.cfg 之外的文件中会很有用。
证实:在执行 autoexec.cfg 后究竟会发生什么。

文件格式

· 每一行被视为一条命令。请注意,每条命令仍可以由分号 ; 分隔的多个命令组成。 · 可以使用 // 添加注释。从这两个字符开始一直到行尾的所有内容都会被引擎忽略。 · 作弊命令需要启用 sv_cheats 1,否则不会生效。要配置模组的默认作弊变量,可以在不启用 sv_cheats 的情况下,在地图加载时使用 VScriptpoint_servercommand 实现。

文件

文件夹 <game>/cfg/ 通常专门用于存放 CFG 文件,可以进一步通过子目录组织,并在 exec 中使用 相对路径 引用。

下表列出了模组和游戏中常见的 CFG 文件。

CFG 文件 描述
autoexec.cfg 在游戏启动时运行,因此可以方便地创建该文件,并将不想每次输入的任意命令放入其中。
chapter#.cfg 当玩家选择章节时运行,# 为章节编号,参见 向模组添加章节
config.cfg 在游戏启动时运行,该文件在玩家首次运行游戏/模组时自动创建。
Note.png注意: 在退出游戏时,此文件中的按键绑定会被重写为当前的绑定,因此修改该文件很可能没有意义。
config_default.cfg 当没有 config.cfg 存在,或玩家在选项面板的键盘选项卡中点击“使用默认值”按钮时运行,参见 自定义选项:键盘
360controller.cfg 用于使用 Xbox 360 Xbox 360 Xbox One Xbox One Xbox Series X/S(或兼容 XInput 的)控制器的玩家,列出了控制器的控制设置。当玩家在游戏选项中启用手柄支持时自动执行。
Note.png注意:半衰期2 20周年更新起,选项菜单中的手柄选项(称为传统手柄支持)已被移除。但 joystick ConVar 仍然有效且可以启用。
360controller-linux.cfg 用于在 Linux 系统上使用 Xbox 360 Xbox 360 Xbox One Xbox One Xbox Series X/S(或兼容 XInput 的)控制器的玩家,列出了控制器的控制设置。
证实:在 360controller.cfg 之后执行。
undo360controller.cfg 用于使用 Xbox 360 Xbox 360 Xbox One Xbox One Xbox Series X/S(或兼容 XInput 的)控制器的玩家,当他们想要撤销控制器效果时使用。
待完善: 需要查明该文件何时执行。
game.cfg 每次加载地图时运行。
listenserver.cfg 在启动监听服务器时运行,并且每次更换地图时运行。
modsettings.cfg 在游戏启动时运行,除非在模组文件夹中找不到。
server.cfg 在启动专用服务器时运行,并且每次更换地图时运行。
skill_manifest.cfg 每次更换地图时运行,用于列出要执行的 skill.cfg 文件。
sourcevr<模组文件夹名>.cfg (存在于自 起源2013以来) 当玩家启用 VR 时运行,将 <模组文件夹名> 替换为包含 gameinfo.txt 的文件夹名称。
userconfig.cfg 在游戏启动时运行,用于“自定义配置”,正如 config.cfg 中的注释所描述的那样。Steam 前的《半衰期》版本不会自动加载它,用户会将配置放在 autoexec.cfg 中。 (传言)
valve.rc 带有 .rc 扩展名的特殊 cfg 文件,在游戏启动时运行,并执行 autoexec.cfg 以及其他几条命令。

参见

· 迷你模组教程 · vtest - cfg 文件的替代方案。 · alias · echo