View source for Choosing Player Models

{{lang|Choosing Player Models}}
{{subpage|[[Counter-Strike: Global Offensive Level Creation]]}}
:''See [[KeyValues]] for the file format.''
In {{csgo|4}}, custom maps can be configured to use different player models, or a variety of player models, for the Terrorist and Counter-Terrorist teams. These models are specified in a <code><mapname>.kv</code> file that lives in the <code>csgo/maps/</code> directory.

== Creating a .kv file ==
{| style=float:right
| {{pre|
"de_example"
{
	"t_models"
	{
		"tm_anarchist" ""
		"tm_anarchist_variantA" ""
		"tm_anarchist_variantB" ""
		"tm_anarchist_variantC" ""
		"tm_anarchist_variantD" ""
	}
	"ct_models"
	{
		"ctm_swat" ""
		"ctm_swat_variantA" ""
		"ctm_swat_variantB" ""
		"ctm_swat_variantC" ""
		"ctm_swat_variantD" ""
	}
}
}}<small>If this is the content of <code>csgo/maps/de_example.kv</code>, then<br><code>de_example.[[bsp]]</code> will use Anarchist and Swat player models.</small>
|}
The .kv file is simply a text file that shares a name with the map, with the <code>.txt</code> extension changed to <code>.kv</code>.
For example, if there were a custom map called <code>de_example.bsp</code> in the <code>Counter-Strike Global Offensive/csgo/maps/</code> folder, then there should be a file called <code>de_example.kv</code> in the same folder.

The .kv file contains a list of key/value pairs formatted similarly to other text files used by the source engine, such as [[VMT]] files for materials.

As can be seen in the example on the right, it is possible to configure a map to use a variety of world player models for each team.
Unlike in previous Counter-Strike games, the player's model is chosen randomly from this list, instead of allowing the player to choose.

=== Syntax ===
See the example on the right. The first word in quotes must be the [[BSP|map]]'s filename.

The key of each KeyValue inside <code>"t_models"</code> and/or <code>"ct_models"</code> is supposed to be the path to a player model. If <code><model></code> is such a key, then the game will try to use the first of the following models that exists:
# <code>csgo/models/player/custom_player/legacy/<model>.mdl</code>
# <code>csgo/models/player/<model>.mdl</code>
# <code>csgo/models/error.mdl</code>
The value of each of these KeyValues is ignored, so it can be left empty.
{{tip|Use the [[Hammer]] model browser to see the available models at those places. You can also see [[#Model List|below]] for lists to copy-paste.}}
{{tip|Generally, there can be '''any combination''' of player models in a list with a '''maximum number of ten''' models.}}
{{tip|If there are huge error boxes moving around the map, then you probably have misspelled at least one player model name, or listed too many models.}}
{{note|Since the glove update, it's unnecessary to define the arms model, the engine uses the sleeve model instead.}}
{{clr}}

=== Relation to [[Gamemodes.txt]] ===
The information of this file will to some extent be merged with <code>csgo/gamemodes.txt</code>. The official maps don't have a <code>csgo/maps/<mapname>.kv</code> file as their content is already in <code>gamemodes.txt</code>. The map list in that file can be extended with <code>gamemodes_server.txt</code> according to the following example. {{warning|Information in these files overrides any map specific <code>csgo/maps/<mapname>.kv</code> file!}}
{{Expand|
{{pre|
"GameModes_Server.txt"
{
	"gameTypes"
	{
		// ...
	}

	"mapgroups"
	{
		// ...
	}

	"maps"
	{
		"<mapname1>"
		{
			"t_models"
			{
				"tm_professional"""
				// ...
			} 
			
			"ct_models"
			{
				"ctm_fbi"""
				// ...
			} 
		}

		"<mapname2>"
		{
			"t_models"
			{
				"tm_professional"""
				// ...
			} 
			
			"ct_models"
			{
				"ctm_sas"""
				// ...
			} 
		}

		// ...
	}
}
}}
}}

{{clarify|<i>The official maps use more KVs than just <code>t_models</code> and <code>ct_models</code>. Apparently, the <code>nameID</code> determines the displayed map name in the loading screen, however this KV does not seem to work in <code><mapname>.kv</code>? So where is the map specific file <code><mapname>.kv</code> read in code? Ideas:
* <code>void GameTypes::AddMapKVs( KeyValues* pKVMaps, const char* curMap )</code>
* <code>void GameTypes::CheckShouldSetDefaultGameModeAndType( const char* szMapNameFull )</code>
Both are defined in {{cpp}} <code>gametypes.cpp</code>. In both cases it should actually be possible to ship more KVs with this file but apparently it isn't.{{why}}</i>}}
{{clr}}

== Model List ==
These excerpts are set up so that one block represents a commonly used group of models.

The other custom player models can also be used. In the lists below, they are named but commented out (<code>//</code>) to retain a commonly used group of models.
{{tip|You can use T models for CTs and vice versa! The models have nothing to do with the team of a [[player]] with one of these models.}}
{{note|The model of a player also determines the arms seen for the viewmodel, as well as the radio command voice. However, it will not make the player use the appropriate radio voice of the assiciated ''agent'' (e.g. no female voice this way).}}
{| width=100%
|- style=vertical-align:top
|
=== Counter-Terrorist Models ===
{| class=wikitable style=margin-right:2em
| [https://counterstrike.fandom.com/wiki/FBI FBI] {{en}}
| {{pre|style=margin:0; display:block|
	{
		"ctm_fbi"""
		"ctm_fbi_variantA"""
		"ctm_fbi_variantB"""
		"ctm_fbi_variantC"""
		"ctm_fbi_variantD"""
//		"ctm_fbi_variantE"""
//		"ctm_fbi_variantF"""
//		"ctm_fbi_variantG"""
//		"ctm_fbi_variantH"""
	}
}}
|-
| [https://counterstrike.fandom.com/wiki/GIGN GIGN] {{fr}}
| {{pre|style=margin:0; display:block|
	{
		"ctm_gign"""
		"ctm_gign_variantA"""
		"ctm_gign_variantB"""
		"ctm_gign_variantC"""
		"ctm_gign_variantD"""
	}
}}
|-
| [https://counterstrike.fandom.com/wiki/GSG-9 GSG9] {{de}}
| {{pre|style=margin:0; display:block|
	{
		"ctm_gsg9"""
		"ctm_gsg9_variantA"""
		"ctm_gsg9_variantB"""
		"ctm_gsg9_variantC"""
		"ctm_gsg9_variantD"""
	}
}}
|-
| [https://counterstrike.fandom.com/wiki/IDF IDF] {{he}}
| {{pre|style=margin:0; display:block|
	{
		"ctm_idf"""
		"ctm_idf_variantB"""
		"ctm_idf_variantC"""
		"ctm_idf_variantD"""
		"ctm_idf_variantE"""
		"ctm_idf_variantF"""
	}
}}
|-
| [https://counterstrike.fandom.com/wiki/SAS SAS] {{en gb}}
| {{pre|style=margin:0; display:block|
	{
		"ctm_sas""" // identical to A-E?
		"ctm_sas_variantA"""
		"ctm_sas_variantB"""
		"ctm_sas_variantC"""
		"ctm_sas_variantD"""
		"ctm_sas_variantE"""
//		"ctm_sas_variantF"""
//		"ctm_sas_variantG"""
	}
}}
|-
| [https://counterstrike.fandom.com/wiki/SEAL_Team_6 SEAL Team 6] {{en}}<br>(default)
| {{pre|style=margin:0; display:block|
	{
		"ctm_st6"""
		"ctm_st6_variantA"""
		"ctm_st6_variantB"""
		"ctm_st6_variantC"""
		"ctm_st6_variantD"""
//		"ctm_st6_variantE"""
//		"ctm_st6_variantG"""
//		"ctm_st6_variantI"""
//		"ctm_st6_variantJ"""
//		"ctm_st6_variantK""" // German
//		"ctm_st6_variantL"""
//		"ctm_st6_variantM"""
//		"ctm_st6_variantN""" // Brazilian
	}
}}
|-
| [https://counterstrike.fandom.com/wiki/SWAT SWAT] {{en}}
| {{pre|style=margin:0; display:block|
	{
		"ctm_swat"""
		"ctm_swat_variantA"""
		"ctm_swat_variantB"""
		"ctm_swat_variantC"""
		"ctm_swat_variantD"""
//		"ctm_swat_variantE"""
//		"ctm_swat_variantF"""
//		"ctm_swat_variantG"""
//		"ctm_swat_variantH"""
//		"ctm_swat_variantI"""
//		"ctm_swat_variantJ"""
//		"ctm_swat_variantK"""
	}
}}
|}
|

=== Terrorist Models ===
{| class=wikitable
| [https://counterstrike.fandom.com/wiki/Anarchist Anarchist] {{en}}
| {{pre|style=margin:0; display:block|
	{
		"tm_anarchist"""
		"tm_anarchist_variantA"""
		"tm_anarchist_variantB"""
		"tm_anarchist_variantC"""
		"tm_anarchist_variantD"""
	}
}}
|-
| [https://counterstrike.fandom.com/wiki/Balkan Balkan]
| {{pre|style=margin:0; display:block|
	{
		"tm_balkan_variantA"""
		"tm_balkan_variantB"""
		"tm_balkan_variantC"""
		"tm_balkan_variantD"""
		"tm_balkan_variantE"""
//		"tm_balkan_variantF"""
//		"tm_balkan_variantG"""
//		"tm_balkan_variantH"""
//		"tm_balkan_variantI"""
//		"tm_balkan_variantJ"""
//		"tm_balkan_variantK"""
//		"tm_balkan_variantL"""
	}
}}
|-
| [https://counterstrike.fandom.com/wiki/Elite_Crew Elite Crew]
| {{pre|style=margin:0; display:block|
	{
		"tm_leet_variantA"""
		"tm_leet_variantB"""
		"tm_leet_variantC"""
		"tm_leet_variantD"""
		"tm_leet_variantE"""
//		"tm_leet_variantF"""
//		"tm_leet_variantG"""
//		"tm_leet_variantH"""
//		"tm_leet_variantI"""
//		"tm_leet_variantJ"""
//		"tm_leet_variantK"""
	}
}}
|-
| [https://counterstrike.fandom.com/wiki/Phoenix_Connexion Phoenix Connexion] {{ru}}<br>(default)
| {{pre|style=margin:0; display:block|
	{
		"tm_phoenix"""
		"tm_phoenix_variantA"""
		"tm_phoenix_variantB"""
		"tm_phoenix_variantC"""
		"tm_phoenix_variantD"""
//		"tm_phoenix_variantF"""
//		"tm_phoenix_variantG"""
//		"tm_phoenix_variantH"""
//		"tm_phoenix_variantI"""
	}
}}
|-
| [https://counterstrike.fandom.com/wiki/Pirate Pirate]
| {{pre|style=margin:0; display:block|
	{
		"tm_pirate"""
		"tm_pirate_variantA"""
		"tm_pirate_variantB"""
		"tm_pirate_variantC"""
		"tm_pirate_variantD"""
	}
}}
|-
| [https://counterstrike.fandom.com/wiki/Professional Professional] {{en}}
| {{pre|style=margin:0; display:block|
	{
		"tm_professional"""
		"tm_professional_var1"""
		"tm_professional_var2"""
		"tm_professional_var3"""
		"tm_professional_var4"""
//		"tm_professional_varF"""
//		"tm_professional_varF1"""
//		"tm_professional_varF2"""
//		"tm_professional_varF3"""
//		"tm_professional_varF4"""
//		"tm_professional_varF5"""
//		"tm_professional_varG"""
//		"tm_professional_varH"""
//		"tm_professional_varI"""
//		"tm_professional_varJ"""
	}
}}
|-
| [https://counterstrike.fandom.com/wiki/Separatist Separatist] {{fr}} {{es}}
| {{pre|style=margin:0; display:block|
	{
		"tm_separatist"""
		"tm_separatist_variantA"""
		"tm_separatist_variantB"""
		"tm_separatist_variantC"""
		"tm_separatist_variantD"""
	}
}}
|}
|}

=== Other Models ===
{{note|Giving players the model of a Heavy Phoenix or a Heavy CT changes only their appearance; it does not give them an [[item_heavyassaultsuit]].}}
{| class=wikitable
| Heavy Phoenix {{ru}}
| {{pre|style=margin:0; display:block|
        {
		"tm_phoenix_heavy"""
        }
}}
|-
| Heavy CT<br>({{csgo mode|Coop}})
| {{pre|style=margin:0; display:block|
        {
		"ctm_heavy"""
        }
}}
|-
| Jumpsuit<br>({{csgo mode|Dz}})
| {{pre|style=margin:0; display:block|
	{
		"tm_jumpsuit_variantA"""
		"tm_jumpsuit_variantB"""
		"tm_jumpsuit_variantC"""
	}
}}
|-
| SEAL Frogman {{en}}<br>({{csgoOperation|Riptide}})
| {{pre|style=margin:0; display:block|
	{
		"ctm_diver_variantA"""
		"ctm_diver_variantB"""
		"ctm_diver_variantC"""
	}
}}
|-
| [https://counterstrike.fandom.com/wiki/Gendarmerie_Nationale Gendarmerie Nationale] {{fr}}<br>({{csgoOperation|Riptide}})
| {{pre|style=margin:0; display:block|
	{
		"ctm_gendarmerie_variantA"""
		"ctm_gendarmerie_variantB"""
		"ctm_gendarmerie_variantC"""
		"ctm_gendarmerie_variantD"""
		"ctm_gendarmerie_variantE"""
	}
}}
|-
| [https://counterstrike.fandom.com/wiki/Guerrilla_Warfare Guerrilla Warfare] {{pt-br}}<br>({{csgoOperation|Riptide}})
| {{pre|style=margin:0; display:block|
	{
		"tm_jungle_raider_variantA"""
		"tm_jungle_raider_variantB"""
		"tm_jungle_raider_variantB2"""
		"tm_jungle_raider_variantC"""
		"tm_jungle_raider_variantD"""
		"tm_jungle_raider_variantE"""
		"tm_jungle_raider_variantF"""
		"tm_jungle_raider_variantF2"""
	}
}}
|-
| Zombie
| {{pre|style=margin:0; display:block|
        {
		"zombie"""
        }
}}
|-
| [https://counterstrike.fandom.com/wiki/Georgian_Riot_Police Georgian Riot Police] {{ka}} <br>(Obsolete)
| {{pre|style=margin:0; display:block|
	{
		"ctm_georgian"
	}
}}
|-
| [https://counterstrike.fandom.com/wiki/MPSSC Military Police Special Services Company] {{zh-tw}} <br>(Obsolete)
| {{pre|style=margin:0; display:block|
	{
		"ctm_mpssc"
	}
}}
|-
| Yakuza {{ja}} <br>(Obsolete)
| {{pre|style=margin:0; display:block|
	{
		"tm_yakuza"
	}
}}
|}

== External Links ==
'''KV File Writer''': A gui tool that streamlines setting up and saving a CT vs T .kv
* [http://nickharuk.wordpress.com/kv-file-writer/ Creator's Page]
* [http://gamebanana.com/tools/5552 FPSBanana]

'''Web-based KV File Generator''': A web-based utility that generates a .kv based on user input.
* [http://kvfilegen.appspot.com/ kvFileGen.appspot.com]

[[Category:Counter-Strike: Global Offensive]]

[[Category:Level Design]]
[[Category:Plain text files]]

[[Category:English]]