gameinfo.txt

Game Definition Files

liblist.gam (GoldSrc)

gameinfo.txt (Source)

gameinfo.gi (Source 2)

See also:  Category:Gameinfo

GameInfo.txt is a KeyValues config file that describes a Source mod. Apart from containing metadata like the name of the mod or a link to the developer’s website, it also defines which games it depends on and the SearchPaths that the engine uses to look up resources. It is stored in the mod’s root folder. Source, the SDK tools and Steam rely on it.

Note:Booleans are represented as 0 or 1.

Note:If a string contains spaces or tabs you have to wrap it in "quote marks".

Basic settings

Name

Keys that affect the menu and window title.

Game <string>

The name of the mod in ASCII. Displayed in Steam and used as the window title. Only displayed in the main menu if Title isn’t specified.

Title <string>

A Unicode string displayed in the main menu of your mod. You can also new line the menu text by adding another key of the same name Title, but append either 2 or a higher number onto it.

Note:The higher the number, the further down the text will be.

GameLogo <boolean> (in all games since )

Rather than displaying the Title text on the main menu, display the content in …\resource\GameLogo.res. See Adding Your Logo to the Menu.

Options

Keys that affect what tabs and options that show up in the Options panel. Also see Customizing Options: Keyboard.

Type <string>

Affects which tabs appear in which order in the Options panel, the value will either be Singleplayer_Only or Multiplayer_Only. Omit this key if your mod has both SP and MP modes.

NoDifficulty <boolean>

Hides the difficulty tab (this happens automatically if your mod is Multiplayer_Only.)

HasPortals <boolean> (in all games since )

Shows the Portal options tab.

NoCrosshair <boolean>

Hides the multiplayer crosshair selection menu.

AdvCrosshair <boolean>

Enables the special advanced crosshair options.

Todo: How to implement.

NoModels <boolean>

Hides the multiplayer model selection menu.

NoHIModel <boolean>

Hides toggle checkbox for cl_himodels, which was used for multiplayer models in GoldSrc. Only displayed properly if cl_himodels exists in the first place.

Confirm:Does it work in ?

Hidden_Maps <subkey>

Maps in the subkey do not appear in the "Create a Server" dialogue. It does not stop users from being able to load them from the console though. Syntax is mapname 1, with one entry per line. Don’t include .bsp. Remember to open and close the subkey with { and }.

CommandLine <subkey> (only in )

List of launch options to start the mod with. Syntax is -launchoption "value", with one entry per line. Remember to open and close the subkey with { and }.

Steam games list

Keys that affect how your game or mod shows up in the Steam Library page.

Developer <string> 

Deprecated.
The developer of the mod. Usually either the Mod Team’s name, or a single person’s name. Doesn’t appear anymore in current versions of Steam.

Note:Technically, there is one singular place where this inexplicably still appears: the Steam Input default layouts screen in Big Picture mode. Given that Steam Input is otherwise severely broken in sourcemods, this is practically useless.

Developer_URL <string> 

Deprecated.
Your or the mod’s URL. Must start with http://. Doesn’t appear anymore in current versions of Steam.

Manual <string> 

Deprecated.
URL to the mod’s manual; can also be a local file. Doesn’t appear anymore in current versions of Steam.

Icon <string>

Local path relative to GameInfo.txt, to an uncompressed 16x16 TGA that will appear as your mod’s icon in Steam. Do not include the file extension. Ico file formats are not supported. The larger 32px pixel icon that appears in Steam’s Detail View should be placed next to the 16px one and called <icon>_big.tga.

Note:For transparency to work, the TGA must be saved in 32-bit mode with active alpha channel.

Todo: Is this deprecated in the new Team Fortress 2 branch? Since the new SDK seems to use the icons which you can now embed into the exe itself, does this mean the setting still works?

Engine and tools

Keys that affect how the engine/tools runs and some options for the tools themselves.

Nodegraph <boolean> (in all games since )

Whether or not to enable building nodegraphs (.ain files) for maps.

GameData <string>

Path to a FGD file, relative to Hammer’s location. This is needed for instances to be compiled into maps. It is not used by Hammer itself.

InstancePath <string> (in all games since )

The default location in which to look for Instance VMFs.

SupportsDX8 <boolean> (in all games since ) (also in )

When false, prevents the game from being ran in older DirectX versions such as DX8 and below, since they do not support the full range of graphic effects, also prevents Studiomdl from producing .sw.vtx and .dx80.vtx files for models, as they aren’t needed.

SupportsVR <boolean> (in all games since )

Whether or not the game supports being ran in VR mode. Deprecated in Half-Life 2 and Portal since Steam Deck update.

SupportsXbox360 <boolean> (in all games since ) (also in )

Whether or not the game supports Xbox 360 (and possibly other consoles, or it's controller).

Confirm:Does this enable being able to use a Xbox 360 controller with the game?, this was disabled in Counter-Strike 2, according to csgo_core\gameinfo.gi.
In Black Mesa, as of Necro Patch, SupportsXbox360 is disabled and Steam Input API is used instead.

TF2 branch keys

New keys that are introduced in Team Fortress 2 branch.

DependsOnAppID <string>

If this was set to any AppID (example: 440 for Team Fortress 2), you will need this game to be installed before you can play a mod that requires it.

ReplayRequired <boolean>

Enable TF2's Replay feature.^[confirm]

AdditionalLocalization <string>

Adds additional localization files^[confirm]

Todo: Can this be called multiple times to add multiple new localization files? Or is there A key to split them up e.g ;

FileSystem

Keys that are within the subkey FileSystem.

SteamAppID <integer>

The AppID of the game the mod is to be based on. The mod will have access to all of this game’s content, and will not be playable unless it is installed, the mod will also be ran with the game’s executable as well. If you’re uploading your Source game to Steam, this will be your game’s AppID. Otherwise, this will be 243750 for SDK Base 2013 - MP, 243730 for Source SDK Base 2013 - SP, 630 for Alien Swarm, or the AppID of the game you’re basing it off of if you’re not working with source code.

Note:Most older Source mods will use AppID 215 for Source 2006 and 218 for Source 2007. If you are making a new mod, you shouldn’t use these IDs as they’re for a obviously deprecated Source engine branch that was replaced by Source 2013 and Alien Swarm. Only use them for legacy support.

Note: SDK Base 2013 - MP is currently based on Team Fortress 2 branch. If you want to play older mods (made on legacy version of SDK Base 2013 - MP), you will have to switch to previous2021 beta branch.

Note:Your mod won’t be protected by VAC if it is based on a singleplayer game.

AdditionalContentId <integer> 

Deprecated.
Another AppID that the mod has access to. This feature was added to the SDK source code but somehow never made it to Valve’s other games; you will have to build your own binaries to use it. If you need to mount multiple apps using this, make these changes.

Bug:The engine understands this command, but the SDK tools unfortunately do not. The best solution, currently, is to copy the content of the game to a location on your hard drive and add an absolute SearchPath to it. Remember to delete the SearchPath before you release.  [todo tested in ?]

Todo: What about Team Fortress 2 branch new mounting method? |appid_440| can be seen in gameinfo.txt example (for creating TF2-based mods).

ToolsAppId <integer> 

Deprecated.
This is the AppID of the SDK currently in use.

SearchPaths

SearchPaths is a subkey within FileSystem. It contains a key for every search path. When the engine needs a file it traverses the search paths, stopping when the desired file has been found, hence the order of the search paths is important.

Load order for Source 2013 Singleplayer and Source 2013 Multiplayer

Note:This section was documented based on reverse engineering tests (in ).

Search paths are mounted according to the criteria below.

• VPKs must be declared in the search paths to be loaded. They will only be loaded implicitly if using the /* wildcard.
• Using the /* keyword will mount both subdirectories and VPKs found in that directory.

Criteria 1: search path list order

Search paths in higher rows have priority over search paths in lower rows.

Between two search paths, the one that is above the other will be mounted first.

Example:SearchPaths

Game dir1 // Higher priority Game dir2 // Lower priority

Note:VPKs don't have a priority over directories per se.

Criteria 2: alphabetical order

After the critera 1 is applied, VPKs and directories within the same VPK are sorted by alphabetical order of the filename without extension or directory name.

Example:SearchPaths

Game dirs/*

dirs/

dir1/ // Highest priority dir2.vpk // Higher priority dir3/ // Lower priority dir4.vpk // Lowest priority

Warning:If there is a [filename]_dir.vpk and [filename].vpk in the same search path, [filename].vpk won’t be loaded.

Warning:If there is a [filename]_dir.vpk and [filename]/ in the same search path. [filename]/ won’t be loaded.

Note:If there is a [filename]/ and [filename].vpk in the same search path, [filename] will have a priority over [filename].vpk.

Load order for Left 4 Dead engine branch, Alien Swarm engine branch and Portal 2 engine branch

Search paths are mounted according to the criteria below.

• VPKs must be named pak01_dir and be inside a search path folder. You can't mount VPKs manually.

Example:SearchPaths

Game test1

.<game_path>/test1/

pak01_dir.vpk pak01_001.vpk pak01_002.vpk

Note:The VPK can still be a single file, but it must be named pak01_dir.vpk

Criteria 1: VPKs first, then directories

All VPKs are mounted first, then all directories.

Example:SearchPaths

Game dir_with_loose_files // Lower priority Game dir_with_a_pak01_dir // Higher priority

Criteria 2: search path list order

After the critera 1 is applied, search paths in higher rows have priority over search paths in lower rows.

Between two search paths, the one that is above the other will be mounted first.

Example:SearchPaths

Game dir1 // Higher priority Game dir2 // Lower priority

Addons

Some games like Left 4 Dead 2 have an "Addons" folder that is not in the gameinfo.txt. These folders are only loaded by the game itself at runtime, not by Hammer, HLMV or other tools.

If you want to mount addon content for Hammer, you'd need to unpack the addon and mount it as a pak01_dir.vpk in a whole new folder that has priority over everything.

Directories

The directory, which is the value of the key, will either be relative to the SteamAppID’s root directory (i.e. where the executable of the game is located), relative to GameInfo.txt or absolute. A example of each one respectively would be this:

Game |All_Source_Engine_Paths|HL2 // Go to the executable directory, and mount a folder called HL2 in it. Game HL2 // Also go to the executable directory, and mount a folder called HL2 in it. Game |GameInfo_Path|. // Go to the directory of where GameInfo.txt is located, and mount the folder it’s in. Game |appid_440|tf // Go to Team Fortress 2 (AppID 440) directory, and mount a folder called TF in it. (Confirmed on TF2 branch) Game "C:\MyFolderOfContent\content" // Mount this absolute directory, useful for mounting content temporarily.

Note:In order to mount a VPK file, you need to add the VPK’s name at the end of the directory with the .vpk extension. If the VPK is a multi-chunk VPK, then put the name of the VPK in without the "_dir" or "_###" at the end.

The 2 variables above will start the search in a certain directory, |All_Source_Engine_Paths| will start the directory within the root folder, and |GameInfo_Path| will start it in the folder where GameInfo.txt is located. Both of these variables can be appended with any number of folders. There are also some special commands you can append in addition to the folders and variables, the known ones are:

• ../
  Goes back one folder, this will useful for mounting other games’ content like Portal, since AdditionalContentID is deprecated. If you wanted to mount Portal, and your game is in, say for example "<SteamFolder>\SteamApps\Common\MyGame\FolderWhereGameInfoIs", you would create a search path like this to mount it’s content:

// Start in the executable directory, then go back one folder so we're in Common, and then go into Portal/portal and mount portal_pak.vpk Game |All_Source_Engine_Paths|../Portal/portal/portal_pak.vpk

Here is also an example of how to mount a SourceMod:

// Start in the executable directory, then go back two folders so we're in SteamApps, and then go into SourceMods and mount the MySourceMod folder. Game |All_Source_Engine_Paths|../../SourceMods/MySourceMod

• .
  This stops the search in the current directory, this should only be used if you want to directly mount where |All_Source_Engine_Paths| or |GameInfo_Path| are. An example of both:

// Mount both |All_Source_Engine_Paths| and |GameInfo_Path| variables' path. Game |All_Source_Engine_Paths|. Game |GameInfo_Path|.

• /*
  Mount every sub-folder and VPK in the current directory, in alphabetical order of the filename without extension or directory name. This command is what makes the custom folder work in most up-to-date Source games. An example of its use:

// Mount the custom folder's sub-folders and VPKs. Game |GameInfo_Path|custom/*

Keys

In most older Source games, the only keys for search pathing is Game and Platform, while these keys will suit most search pathing, in Source 2013 a few new keys where introduced that add more control.

Tip: Insurgency and Day of Infamy use the same search pathing system as Source 2013, so commands and keys that work in Source 2013 will work for them as well!

The current keys known so far are:

• Game
  Adds the path as a simple search path. Will add any content it finds. Also writes sound.cache file in each Game directory.
• Game_Write (in all games since )
  Marks the search path as a Game write path. It marks the directory as the default directory for writing (what exactly?) for this game.
  Confirm:Does this do anything?
• GameBin (in all games since )
  A special key that requires that the path lead to a game’s binary files (where Server.dll and Client.dll are located), and will use any other DLL files it finds. This should lead to your own mod’s Bin folder, or the game you’re basing it off’s Bin folder if you’re not building your own DLLs.
• Game_LV (only in )
  Marks the directory as leading to Low Violence files.
• Platform
  Adds a special search path to the folder containing core engine files, this will usually lead to the game’s Platform folder.
• Mod (in all games since )
  Marks the search path as a Mod path. This is usually where the game executable is. Prioritizes search path mounting over Game. Essential for displaying chapter list in New Game menu, and probably for something else.
• Mod_Write (in all games since )
  Marks the search path as a Mod write path. This is usually where GameInfo.txt is. It marks the directory as the default directory for writing save files and downloadlists for this mod.
• Default_Write_Path
  Marks the search path as a Default write path. This is usually where GameInfo.txt is. It marks the directory as the default directory for writing config.cfg, node graphs, screenshots and some other files for this mod. Also a fallback for when either Mod_Write or Game_Write isn’t specified.
• VGUI (only in )
  Marks the search path as containing .res files.
• Download
  Marks the search path as a Download write path. Random files downloaded from servers go here.
• Custom_Mod (only in )
  Marks the search path as a Custom_Mod search path, intended for custom HUD versioning and used for the custom folder. .res files may not load without an info.vdf file in the directory.
• VPK (in all games since )
  Used to mount a VPK by name. Do not put .vpk, "_dir" or "_###" at the end. The path is relative to <base directory>/vpks/.

Todo: Test the behaviour of this key in games other than Contagion

In Source 2013, you may also append keys to each other by separating each key name by a + sign, this way if you need to use one directory for multiple keys, instead of writing this:

Game |GameInfo_Path|MyFolder Mod |GameInfo_Path|MyFolder

It can instead be shortened like this:

Game+Mod |GameInfo_Path|MyFolder

This saves you time from having to retype the directory over again.

Automatic localization

Source automatically creates localized search paths. If you mount the folder HL2, then when your mod runs in French HL2_French is automatically mounted just above it, overriding any content in HL2.

Todo: Does this also apply for the mod folder?

Source 2013 Example

A full working GameInfo.txt ready for a Source 2013 game.

"GameInfo" { game "HALF-LIFE 2" title "HALF-LIFE'" type singleplayer_only supportsvr 1 GameData "halflife2.fgd" FileSystem { SteamAppId 220 // Indicates to Steam which game this is a mod for // // Setup engine search paths. // // If a search path contains "_english", and the current language is not english, then // another search path will be inserted above the english one by replacing "_english" with // the appropriate language. // // To debug how the engine has parsed this file, type "path" at the console. // // Search paths are relative to the base directory, which is where hl2.exe is found. // // |gameinfo_path| points at the directory where gameinfo.txt is. // |all_source_engine_paths| points at the directory cintaining HL2 shared content. SearchPaths { // First, mount all user customizations. This will search for VPKs and subfolders // and mount them in alphabetical order. The easiest way to distribute a mod is to // pack up the custom content into a VPK. To "install" a mod, just drop it in this // folder. // // Note that this folder is scanned only when the game is booted. game+mod hl2/custom/* // We search VPK files before ordinary folders, because most files will be found in // VPK and we can avoid making thousands of file system calls to attempt to open files // in folders where they don't exist. (Searching a VPK is much faster than making an operating // system call.) game_lv hl2/hl2_lv.vpk game+mod hl2/hl2_sound_vo_english.vpk game+mod hl2/hl2_pak.vpk game |all_source_engine_paths|hl2/hl2_textures.vpk game |all_source_engine_paths|hl2/hl2_sound_misc.vpk game |all_source_engine_paths|hl2/hl2_misc.vpk platform |all_source_engine_paths|platform/platform_misc.vpk // Now search loose files. We'll set the directory containing the gameinfo.txt file // as the first "mod" search path (after any user customizations). This is also the one // that's used when writing to the "mod" path. mod+mod_write+default_write_path |gameinfo_path|. // Add the HL2 directory as a game search path. This is also where where writes // to the "game" path go. game+game_write hl2 // Where the game's binaries are gamebin hl2/bin // Last, mount in shared HL2 loose files game |all_source_engine_paths|hl2 platform |all_source_engine_paths|platform } } }

TF2 branch Example

A full working GameInfo.txt ready for a Source SDK Base 2013 - Multiplayer game ( Team Fortress 2 branch version).

"GameInfo" { game "Frog Fortress 2" type multiplayer_only nomodels 1 nohimodel 1 nocrosshair 0 hidden_maps { "test_speakers" 1 "test_hardware" 1 } nodegraph 0 GameData "tf.fgd" AdditionalLocalization "tf" InstancePath "maps/instances/" advcrosshair 1 supportsvr 0 ReplayRequired 1 DependsOnAppID 440 FileSystem { SteamAppId 243750 SearchPaths { // First, mount all user customizations. This will search for VPKs and subfolders // and mount them in alphabetical order. The easiest way to distribute a mod is to // pack up the custom content into a VPK. To "install" a mod, just drop it in this // folder. // // Note that this folder is scanned only when the game is booted. game+mod mod_tf/custom/* // Enable this if you want to load your TF custom content. //game+mod |appid_440|tf/custom/* // Now search loose files. We'll set the directory containing the gameinfo.txt file // as the first "mod" search path (after any user customizations). This is also the one // that's used when writing to the "mod" path. mod+mod_write |gameinfo_path|. game+game_write |gameinfo_path|. default_write_path |gameinfo_path|. gamebin |gameinfo_path|bin // We search VPK files before ordinary folders, because most files will be found in // VPK and we can avoid making thousands of file system calls to attempt to open files // in folders where they don't exist. (Searching a VPK is much faster than making an operating // system call.) game_lv |appid_440|tf/tf2_lv.vpk game+mod |appid_440|tf/tf2_textures.vpk game+mod |appid_440|tf/tf2_sound_vo_english.vpk game+mod |appid_440|tf/tf2_sound_misc.vpk game+mod+vgui |appid_440|tf/tf2_misc.vpk game |appid_243750|hl2/hl2_textures.vpk game |appid_243750|hl2/hl2_sound_vo_english.vpk game |appid_243750|hl2/hl2_sound_misc.vpk game+vgui |appid_243750|hl2/hl2_misc.vpk platform+vgui |appid_243750|platform/platform_misc.vpk // Last, mount in shared HL2 and TF2 loose files game |appid_440|tf game |appid_243750|hl2 platform |appid_243750|platform // Random files downloaded from gameservers go into a seperate directory, so // that it's easy to keep those files segregated from the official game files // or customizations intentially installed by the user. // // This directory is searched LAST. If you visit a server and download // a custom model, etc, we don't want that file to override the default // game file indefinitely (after you have left the server). Servers CAN have // custom content that overrides the default game files, it just needs to be // packed up in the .bsp file so that it will be mounted as a map search pack. // The map search pack is mounted at the top of the search path list, // but only while you are connected that server and on that map. game+download mod_tf/download } } }

CS:GO, Alien Swarm, Portal 2, & Left 4 Dead Example

CS:GO, Alien Swarm, Portal 2, & Left 4 Dead engine branch gameinfo.txt, This will only be used if your using those engine branches to mod.

"GameInfo" { game "YourModGame" title "YourModTitle" title2 "YourModTitle" type multiplayer_only nomodels 1 nohimodel 1 nocrosshair 0 bots 1 hidden_maps { "test_speakers" 1 "test_hardware" 1 } nodegraph 0 SupportsXbox360 1 SupportsDX8 0 GameData "mod.fgd" FileSystem { SteamAppId 730 // This will mount all the GCFs we need (240=CS:S, 220=HL2). ToolsAppId 211 // Tools will load this (ie: source SDK caches) to get things like materials\debug, materials\editor, etc. // // The code that loads this file automatically does a few things here: // // 1. For each "Game" search path, it adds a "GameBin" path, in <dir>\bin // 2. For each "Game" search path, it adds another "Game" path in front of it with _<langage> at the end. // For example: c:\hl2\cstrike on a french machine would get a c:\hl2\cstrike_french path added to it. // 3. For the first "Game" search path, it adds a search path called "MOD". // 4. For the first "Game" search path, it adds a search path called "DEFAULT_WRITE_PATH". // // // Search paths are relative to the base directory, which is where hl2.exe is found. // // |gameinfo_path| points at the directory where gameinfo.txt is. // We always want to mount that directory relative to gameinfo.txt, so // people can mount stuff in c:\mymod, and the main game resources are in // someplace like c:\program files\valve\steam\steamapps\<username>\half-life 2. // SearchPaths { Game |gameinfo_path|. Game Mod_Directory // replace "Mod_Directory" with your mod's folder for example: csgo, swarm, etc. } } }

Utilities

XBLAH's Modding Tool

• The mod information can be edited with XBLAH's Modding Tool through a comprehensive UI without requiring the modder to mess with text files.