View source for CFG

{{lang|CFG}}
The '''.cfg''' file extension can be found everywhere and is not specific to [[Source]]. It is an abbreviation of ''configuration''. In [[Source]] games, a configuration file executes a list of [[console command | console commands]].

Source games usually have a folder dedicated to CFG files. Inside, the file <code>autoexec.cfg</code> is run when the game starts up, so you can easily put any commands that you don't want to enter each time into that. They can also be ran from the console using the {{ent|exec}} command: "<code>exec <cfgname></code>" where filename is the name of the configuration file, with or without the extension. Sometimes people put exec lines into the [[autoexec]], so that other CFG files are executed when the game starts up.

CFG files can be further organized in subdirectories in the CFG folder, and referred in {{ent|exec}} by [https://en.wikipedia.org/relative_path relative path].

{{tip|You can add comments to .cfg files by using // .}}
{{note|Cheat commands sv_cheats 1 enabled. To configure a mod's default cheat convars, [[VScript]] or [[point_servercommand]] can achieve this on map start without having to enable sv_cheats}}

== Common CFGs ==
This is a table listing common .cfg files found in mods and games alike.

{| class="wikitable"
! CFG !! Description
|-
| '''[[autoexec|autoexec.cfg]]''' || Ran on game start up.
|-
| '''modsettings.cfg''' || Ran on game start up, unless not found in mod folder.
|-
| '''config.cfg''' || Ran on game start up, this is created automatically when the player runs the game/mod for the first time. {{note| On game quit, key binds in this file will be re-written to current bindings. }}
|-
| '''config_default.cfg''' || Ran when no config.cfg is present or the player clicks the 'Use Defaults' button in the keyboard tab in the options panel, see [[Customizing Options: Keyboard]].
|-
| '''chapter#.cfg''' || Ran when the player picks the chapter, with # being the chapter number, see [[Adding chapters to your mod]].
|-
| '''game.cfg''' || Ran every time a map is loaded.
|-
| '''sourcevr_modfoldername.cfg''' || {{2013 add}} Ran when the player enables VR, replace modfoldername with the name of your folder that [[gameinfo.txt]] is in.
|-
| '''skill_manifest.cfg''' || Runs every time the map is changed, used to list the skill.cfgs to execute.
|-
| '''360controller.cfg''' || Used for players using XBox 360 controllers, lists the controls for the controller. {{TODO|Find out when this is executed.}}
|-
| '''360controller-linux.cfg''' || Used for players using XBox 360 controllers on Linux systems, lists the controls for the controller. {{confirm|executed after 360controller.cfg.}}
|-
| '''undo360controller.cfg''' || Used for players using XBox 360 controllers when they want to undo the effects of the controller. {{TODO|Find out when this is executed.}}
|-
| '''listenserver.cfg''' || Ran when a listen server is being started, and runs every time the map is changed.
|-
| '''server.cfg''' || Ran when a dedicated server is being started, and runs every time the map is changed.
|-
| '''[[valve.rc]]''' || Special cfg file with the .rc extension, it's ran on game start up and executes autoexec.cfg along with a few other commands.
|-
|}

== See also ==
* [[Mini-mod tutorial]]
* [[vtest]] - Alternative to cfg files.

== External links ==
* [http://filext.com/detaillist.php?extdetail=cfg&goButton=Go More information on the format]

[[Category:File formats]]
[[Category:Glossary]]