View source for GoldSrc/SteamPipe directories

Since the 2013 [[SteamPipe]] update, [[GoldSrc]] engine games and mods use a new directory structure for content loading and downloading.
This new structure is meant to make content management more secure and protects against malicious file downloads affecting the local user's game installation.

Previously, a server would download content to a user's game or mod directory, which could be used to affect files that are part of the game or mod's default installation.
It could also be used to alter configuration files if the user manually installed content that contains configuration files.

=Directory layout=
SteamPipe directories are added starting in "steamapps/common". Each directory consists out of one or more of the following components:
* {{path|base}}: The base game directory. For Valve games, this is {{code|{{hl|1}}}}.
* {{path|game}}: The game directory. By default, this is {{code|<nowiki>valve</nowiki>}} (Half-Life), unless the {{code|<nowiki>-basedir</nowiki>}} command line argument is provided, in which case it uses the directory specified by that argument.
* {{path|mod}}: The mod directory. This also applies to Valve games. This is affected by the {{code|<nowiki>-game</nowiki>}} command line argument. If that argument is not provided, the directory used for <game> is used instead.
* {{path|language}}: The current game language.
* {{path|fallback}}: The [[#Fallback directories|fallback directory]].
* {{path|platform}}: The {{code|<nowiki>platform</nowiki>}} directory located in the base directory.


As of this writing, the only game that uses a different {{code|<nowiki><base></nowiki>}} and {{code|<nowiki><game></nowiki>}} is {{sc|1}}. It uses {{code|<nowiki>Sven Co-op</nowiki>}} for {{code|<nowiki><base></nowiki>}}, and {{code|<nowiki>svencoop</nowiki>}} for {{code|<nowiki><game></nowiki>}}. Other games such as {{cof|1}}, {{cso|1}} and {{csnz|1}}, and many others also uses different {{code|<nowiki><base></nowiki>}} and {{code|<nowiki><game></nowiki>}}.


The game will search for files by searching through each search path in the order that they are added. This means that for example the {{code|[[#.3Cbase.3E.2F.3Cmod.3E_downloads|_downloads]]}} directory is only accessed if none of the other game directories contain the file.

In addition, game configuration files are only loaded from the {{code|<nowiki>"GAMECONFIG"</nowiki>}} search path, which prevents malicious servers and addon content from affecting game configuration and operation.



The following directories are added by the engine in the order that they are listed.

=={{path|<nowiki><base>/<mod>_lv</nowiki>}}==
If low violence is enabled, this directory is added to override violent content.

Read only.

Added to the {{code|<nowiki>"GAME"</nowiki>}} search path ID.

=={{path|<nowiki><base>/<mod>_addon</nowiki>}}==
{{Note|Most modders are most likely still overlooked and ended up continuing installing mods in the old way, by replacing anything inside base game files, <br>which doesnt offer a easy way to remove it outside verifying game files. So it is highly recommended that you put all modded contents on this folder instead.}}

If the {{code|-addons}} command line argument is specified, or the "Allow custom addon content" checkbox is enabled in '''Options ► Video''' (saved in the registry as {{path|addons_folder}}), this directory is added to enable addon content.

This is the preferred installation directory for addon content such as map packs, models, sounds, etc...

Read only.

Added to the {{code|<nowiki>"GAME"</nowiki>}} search path ID.

=={{path|<nowiki><base>/<mod>_<language></nowiki>}}==
If a language other than English is set for this game, this directory is added to provide content specific to that language, such as translated {{code|<nowiki>titles.txt</nowiki>}} files.

Read only.

Added to the {{code|<nowiki>"GAME"</nowiki>}} search path ID.

If the {{code|<nowiki>-steam</nowiki>}} command line argument is not specified, and the command line specified {{code|<nowiki>/game</nowiki>}} as part of the first command line argument (normally automatically provided by the operating system), an additional directory {{code|<nowiki><base>/localization/<mod>_<language></nowiki>}} is provided.

=={{path|<nowiki><base>/<mod>_hd</nowiki>}}==
If the {{code|<nowiki>-nohdmodels</nowiki>}} command line argument is not provided and the "Enable HD models if available" checkbox is enabled in {{code|<nowiki>Options->Video</nowiki>}} (saved in the registry as {{code|<nowiki>hdmodels</nowiki>}}), this directory is added to override models with high definition versions.

Read only.

Added to the {{code|<nowiki>"GAME"</nowiki>}} search path ID.

=={{path|<nowiki><base>/<mod></nowiki>}}==
The mod directory. Always added.

Writable.

Added to the {{code|<nowiki>"GAME"</nowiki>}} and {{code|<nowiki>"GAMECONFIG"</nowiki>}} search path IDs.

=={{path|<nowiki><base>/<mod>_downloads</nowiki>}}==
The downloads directory. Always added.

Writable.

Added to the {{code|<nowiki>"GAMEDOWNLOAD"</nowiki>}} search path ID.

==Fallback directories==
A mod may specify a [[Liblist.gam#fallback_dir|fallback directory]] in {{code|[[liblist.gam]]}} to add directories from another mod to its own.
All of the above directories are added, with the exception of the {{code|<nowiki>_downloads</nowiki>}} directory. All directories are added to the {{code|<nowiki>"GAME_FALLBACK"</nowiki>}} search path ID only.

The {{code|<nowiki>_<language></nowiki>}} directories are added as writable directories.
{{Note| This is most likely a mistake.}}

If the mod is not <game>, a localization file located in {{code|<nowiki>Resource/<fallback>_<language>.txt</nowiki>}} will be loaded for use with VGUI2.

==Language support==
When a language other than English is being used, the English directories for low violence, addon and localization for <game> are also added to the {{code|<nowiki>"DEFAULTGAME"</nowiki>}} search path ID.

==Default directories==
There are a number of directories that are also added to fall back default game content and to access files common to all mods.

* The HD directory for <game> is always added if HD models are enabled. It is added to the {{code|<nowiki>"DEFAULTGAME"</nowiki>}} search path ID.
* The <base> directory is added to the {{code|<nowiki>"BASE"</nowiki>}} search path ID.
* The mod directory for <game> is added to the {{code|<nowiki>"DEFAULTGAME"</nowiki>}} search path ID.
* The <platform> directory is added to the {{code|<nowiki>"PLATFORM"</nowiki>}} search path ID.

=Notes=

The console commands {{code|<nowiki>_sethdmodels</nowiki>}} and {{code|<nowiki>_setaddons_folder</nowiki>}} will cause the filesystem's search paths to be reset. If you have made any changes in your own mod, these will be removed.

Both commands are booleans, and set whether HD models or addon content are to be used, respectively.

=See also=
* [[SteamPipe]]
* [[IFileSystemV009]]

[[Category:GoldSrc]]
[[Category:Files]]