View source for User:Yakumo koishi/Gameinfo Chinese

{{lang|Gameinfo.txt}}

:''For Half-Life 1/[[GoldSrc]], see [[The liblist.gam File Structure|liblist.gam]].''

{{toc-right}}

'''<code>GameInfo.txt</code>''' 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.

{{warning|金源游戏没有gameinfo.txt，使用Hammer 3.4版修改半条命地图}}
{{note|布尔值表示为0或1。}}
{{note|如果一个数值含有空格或者制表,请使用 "引号"进行标注。}}

== Basic settings ==

=== Name ===

Keys that affect the menu and window title.

{{KV|Game|string|The name of the mod in [[Wikipedia:ASCII|ASCII]]. Displayed in Steam and used as the window title. Only displayed in the main menu if <code>Title</code> isn't specified.}}
{{KV|Title|string|A [[Wikipedia:Unicode|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 <code>Title</code>, but append either 2 or a higher number onto it. {{note|The higher the number, the further down the text will be.}} }}
; {{KV|GameLogo|boolean|Rather than displaying the <code>Title</code> text on the main menu, display the content in <code>resource\GameLogo.res</code>. See [[Adding Your Logo to the Menu]].|since=EP2}}

=== Options ===

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


{{KV:zh-cn|Type|string|这将决定在设置选项里是否会有单人和多人模式，该值一般为M<code>Singleplayer_Only</code>或<code>Multiplayer_Only</code>。如果您的模组同时具有单人和多人模式，请忽略此键值。}}
{{KV:zh-cn|NoDifficulty|boolean|隐藏难度设置(如果你的mod是多人游戏的话，该键值将自动生成。)}}
{{KV:zh-cn|HasPortals|boolean|显示传送门漏斗选项|since=EP2}}
{{KV:zh-cn|NoCrosshair|boolean|隐藏多人游戏中的准星设置界面}}
{{KV:zh-cn|AdvCrosshair|boolean|启用特殊的高级准星设置。{{todo|如何使用？}} }}
{{KV:zh-cn|NoModels|boolean|隐藏多人游戏的玩家模型设置界面}}
{{KV:zh-cn|NoHIModel|boolean|隐藏在[[Goldsource|金源]]中使用的<code>cl_himodels</code> 切换复选框。只有在<code>cl_himodels</code>首先存在的情况下才会正常显示}}
{{KV:zh-cn|Hidden_Maps|subkey|子键值中的地图名不会出现在“创建服务器”界面中。不过这并不阻止玩家通过控制台读取地图。语法为<code>地图名 1</code>，每行一个条目。不需要包括扩展名，请记住使用 { 和 } 开始和结束子键值。}}
{{KV:zh-cn|CommandLine|subkey|mod的启动参数列表。语法为<code>-launchoption "value"</code>，每行一个参数。请记住使用 { 和 } 开始和结束子键值。|only=Mapbase}}

=== Steam games list ===

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

{{KV|Developer|string|The developer of the mod. Usually either the Mod Team's name, or a single person's name. Doesn't work on current Steam version.|deprecated=1}}
{{KV|Developer_URL|string|Your or the mod's URL. Must start with <code><nowiki>http://</nowiki></code>. Doesn't work on current Steam version.|deprecated=1}}
{{KV|Manual|string|URL to the mod's manual; can also be a local file. Doesn't work on current Steam version.|deprecated=1}}
{{KV|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. The larger 32px pixel icon that appears in Steam's Detail View should be placed next to the 16px one and called <code>&lt;icon&gt;_big.tga</code>. {{note|For transparency to work, the TGA must be saved in 32-bit mode with active alpha channel.}} }}

=== Engine and tools ===

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

{{KV|Nodegraph|boolean|Whether or not to enable building [[nodegraph]]s (.ain files) for maps.|since=EP2}}
{{KV|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.}}
{{KV|InstancePath|string|The default location in which to look for [[Instance]] VMFs.|since=2013}}
{{KV|SupportsDX8|boolean|When false, prevents the game from being ran in older [[DirectX_Versions|DirectX Versions]] such as DX8 and below, since they do not support the full range of graphic effects, also prevents [[Studiomdl]] from producing <code>.sw.vtx</code> and <code>.dx80.vtx</code> files for models, as they aren't needed.|since=L4D}}
{{KV|SupportsVR|boolean|Whether or not the game supports being ran in VR mode.|since=2013}}
{{KV|SupportsXBox360|boolean|Whether or not the game supports Xbox 360. {{confirm|Does this enable being able to use a Xbox 360 controller with the game?}}|since=L4D}}

=== FileSystem ===

Keys that are within the subkey <code>FileSystem</code>.


{{KV|SteamAppID|int|The [[Steam Application IDs|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 {{src13mp|4}}, 243730 for {{src13|4}}, 630 for {{as|4}}, 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 your 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|Your mod won't be protected by [[VAC]] if it is based on a singleplayer game.}} }}

{{KV|AdditionalContentId|int|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, [[Mounting multiple games|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 <code>SearchPath</code> to it. Remember to delete the SearchPath before you release.}} |deprecated=1}}
{{KV|ToolsAppId|int|This is the AppID of the SDK currently in use.|deprecated=1}}

== SearchPaths ==

<code>SearchPaths</code> is a subkey within <code>FileSystem</code>. 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.


{{note|A thing to keep in mind, is the order that you put the search paths in is ''important'', if there are 2 files of the same name that are in 2 different search paths, and you list them both, the search path at the top will win, and use that file.}}

=== Directories ===

The directory, which is the value of the key, will either be relative to the <code>SteamAppID</code>'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       |GameInfo_Path|. // Go to the directory of where GameInfo.txt is located, and mount the folder it's in.
 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 <code>.vpk</code> extension.  If the VPK is a multi-chunck 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, <code>|All_Source_Engine_Paths|</code> will start the directory within the root folder, and <code>|GameInfo_Path|</code> 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:

* <code>../</code> <br> 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 <code>"<SteamFolder>\SteamApps\Common\MyGame\FolderWhereGameInfoIs"</code>, 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 [[Modification|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


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

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


* <code>/*</code> <br> Mount every sub-folder and [[VPK]] in the current directory, this command is what makes the custom folder work in most update to date Source games.  An example of it's 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 <code>Game</code> and <code>Platform</code>, 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:

* <code>Game</code> <br> Adds the path as a simple search path.  Will add any content it finds.  Also writes sound.cache file in each Game directory.
* <code>Game_Write</code> {{2013 add}} <br> 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?}}
* <code>GameBin</code> {{2013 add}} <br> A special key that requires that the path lead to a game's binary files (where <code>Server.dll</code> and <code>Client.dll</code> are located), and will use any other DLL files it finds.  This should lead to your own mod's <code>Bin</code> folder, or the game you're basing it off's <code>Bin</code> folder if you're not building your own DLLs.
* <code>Platform</code> <br> Adds a special search path to the folder containing core engine files, this will usually lead to the game's <code>Platform</code> folder.
* <code>Mod</code> {{2013 add}} <br> Marks the search path as a Mod path.  This is usually where the game executable is.  Essential for displaying chapter list in New Game menu, and probably for something else.
* <code>Mod_Write</code> {{2013 add}} <br> 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.
* <code>Default_Write_Path</code> <br> 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.
* <code>VPK</code> {{Contagion add}} <br> Used to mount a [[VPK]] by name.  Do not put <code>.vpk</code> at the end.


In Source 2013, you may also append keys to each other by separating each key name by a <code>+</code> 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 <code>HL2</code>, then when your mod runs in French <code>HL2_French</code> is automatically mounted just above it, overriding any content in <code>HL2</code>. {{todo|Does this also apply for the mod folder?}}

=== Example ===

A full working GameInfo.txt ready for a {{src13|4}} game.

<source lang=ini>

"GameInfo"
{
	game 		"HALF-LIFE 2"
	title 		"HALF-LIFE'"
	type		singleplayer_only
	supportsvr	1

	FileSystem
	{
		SteamAppId				220		// This will mount all the GCFs we need (240=CS:S, 220=HL2).
		
		//
		// 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\half-life 2.
		//
		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
		}
	}
}


</source>

== Editing the game info with 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. It includes all the major keys of Source SDK 2013 Single-player and Source SDK 2013 Multi-player, more than enough for the majority of Source modders.

This can be accessed within the tool through '''Modding > Game info'''.

<gallery>
File:XBLAH's Modding Tool - Modding - Game info 1.png|Name
File:XBLAH's Modding Tool - Modding - Game info 2.png|Options
File:XBLAH's Modding Tool - Modding - Game info 3.png|Steam games list
File:XBLAH's Modding Tool - Modding - Game info 4.png|Engine and tools
</gallery>

== External links ==

*[https://modding-assets.net/source/tools/modding/xblah-modding-tool/ XBLAH's Modding Tool Homepage]

{{TODO|Move to [[Gameinfo.txt]] or [[Gameinfo.txt:zh]] as well.}}
<nowiki>
[[Category:File formats]]
[[Category:Modding]]
[[Category:Source SDK FAQ]]
</nowiki>