VCFG
Valve Configuration file (or VCFG) is a
Source 2 games text file used to execute a newline-delimited list of console commands to the Developer Console. The .vcfg file extension can be found everywhere and is not specific to Source. Some Source 2 games (such as Half-Life: Alyx), still features .cfg file extension in some files (such as skill.cfg).
File format
- Each line is considered a command. Note that each command can still consist of multiple commands delimited with the semicolon
;. - Comments can be added by using
//. These two characters and everything following after them is ignored by the engine until the next line starts. - Cheat commands require
sv_cheats 1enabled, otherwise they have no effect. To configure a mod's default cheat convars, VScript or point_servercommand can achieve this on map start without having to enable sv_cheats.
Files
The folder <game>/cfg/ is usually dedicated to CFG files and can be further organized in subdirectories, and referred in exec by relative path.
This is a table listing common CFG files found in mods and games alike.
| CFG | Description |
|---|---|
| autoexec.vcfg | Ran on game start up, so one can easily create the file and put any commands that one doesn't want to type each time. |
| game.vcfg | Ran every time a map is loaded. |
| modsettings.vcfg | Ran on game start up, unless not found in mod folder. |
| listenserver.vcfg | Ran when a listen server is being started, and runs every time the map is changed. |
| user_keys_default.vcfg | Ran when the following file is not present:
|
| user_keys_dev_default.vcfg | Ran when no user_keys_default.vcfg is present or when player clicks the 'Use Defaults' button in the keyboard tab in the options panel, see Customizing Options: Keyboard. |
| valve.rc | Special vcfg file with the .rc extension, it's ran on game start up and executes autoexec.cfg along with a few other commands. |