View source for CFG

{{lang|CFG}}
'''Configuration file''' (or '''CFG''') is a {{source|4}} games text file used to execute a newline-delimited list of [[ConCommand|console command]]s to the [[Developer Console]]. The '''.cfg''' file extension can be found everywhere and is not specific to Source.

The folder <code><game>/cfg/</code> is usually dedicated to CFG files and can be further organized in subdirectories, and referred in {{ent|exec}} by [[W:Path_(computing)#Absolute_and_relative_paths|relative path]].

CFG files can be run from the console using the {{ent|exec}} command.

{{tip|The file <code><game>/cfg/autoexec.cfg</code> is run when the game starts up if it exists, so one can easily create the file and put any commands that one doesn't want to type each time.}}

==Syntax==
* Each line is considered a command. Note that each command can still consist of multiple commands delimited with the semicolon <code>;</code>.
* Comments can be added by using <code>//</code>. These two characters and everything following after them is ignored by the engine until the next line starts.
* Cheat commands require {{ent|sv_cheats|1}} enabled, 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.

==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, so making changes to this file is most likely pointless.}}
|-
| '''[[Customizing_Options:_Keyboard#cfg.2Fconfig_default.cfg|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''' || {{src13|since}} 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.
|-
|}

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

==See also==
* [[Mini-mod tutorial]]
* [[vtest]] - Alternative to cfg files.
* {{ent|bind}}
* {{ent|alias}}
* {{ent|echo}}

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