This article's documentation is for the "GoldSrc" engine. Click here for more information.
This article's documentation is for anything that uses the Source engine. Click here for more information.
This article's documentation is for Source 2. Click here for more information.

Map (console command): Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
(add changelevel)
 
(27 intermediate revisions by 10 users not shown)
Line 1: Line 1:
The '''map''' [[ConCommand|console command]] loads the specified map and starts a game on it. {{Warning|For multiplayer games, this command will kick everyone from your server before changing the map, or does a ''hard change'', so to speak. If you want to soft change your map from console use the {{ent|changelevel}} command.}}
{{for|about=the console command|the place in a game|[[Map (level design)]]|the file format|[[MAP file format]]}}
{{this is a|console command|name=map|notitlechange=1|engine=GoldSrc|engine1=source|engine2=source 2}} It loads the specified map and starts a game on it.
{{warning|For multiplayer games, this command may kick everyone from your server before changing the map, or does a ''hard change'', so to speak. If you want a ''soft'' change, use {{ent|changelevel}}.<br>Apparently, both commands behave like <code>changelevel</code> since {{csgo}}.}}


==Usage==
==Usage==
<code>map mapname <gamemode></code> (omit the .bsp extension)
<pre>
map <mapname>
map <mapname> [*sp/*mp] // Portal 2
map <mapname> [gamemode] // CS:GO
map <mapname> [key1=value1] [key2=value2] [...] // CS2
</pre>


Can access both maps in mounted [[VPK]]s and in the <code>maps\</code> folder. Maps that are in a subdirectory of <code>maps\</code> need to have the folder name included in the console command.
The .[[BSP|bsp]] extension must be omitted. The game can access both maps in mounted [[VPK]]s and in the <code>maps\</code> folder. Maps that are in a subdirectory of <code>maps\</code> need to have the folder name included in the console command.
 
Example: <code>map de_dust2 deathmatch</code>
 
In {{csgo}}, the optional <code>gamemode</code> parameter can be <code>deathmatch, casual, competitive, armsrace, coopstrike ...</code> etc. For a list of these gamemode parameters and more details, see [[CSGO_Game_Mode_Commands]].


{{Example|1={{hl2}} <code>map d1_trainstation_01</code><br>{{portal2}} <code>map mp_coop_fan *sp</code><br>{{csgo}} <code>map de_dust2 deathmatch</code><br>{{cs2}} <code>map de_dust2 gamemode=deathmatch</code>}}
{{note|
{{l4dbranch|since}} {{also|{{src13mp}}{{tf2branch}}}} If you type the map name partially, like {{code|map l4d_river}} or {{code|map de_du}}, then submit it, it will load the first result it found ({{code|l4d_river01_docks}} or {{code|de_dust}}).</br>
{{csgo}} The optional <code>gamemode</code> parameter can be one of the values <code>deathmatch, casual, competitive, armsrace, coopstrike ...</code>, see [[CS:GO Game Modes]].
{{todo|A similar list exists for {{l4d2}}.}}
{{todo|A similar list exists for {{l4d2}}.}}
{{cs2}} A list of key-value pairs can be passed. As seen in the example above, this can be used to set the game mode.{{inline note|name=What else?}}
}}
{{note|
{{portal2}} will automatically launch maps starting with <code>mp_coop</code> in co-op mode, but you can still launch them in "singleplayer mode" by appending <code>*sp</code> at the end of the command. The inverse is also possible.
:{{Example|1=<code>map sp_a2_triple_laser *mp</code>}}
}}


==map_background==
==Similar Commands==
<code>map_background</code> is a command analogous to <code>map</code> that will load a map as a background. The player will not be able to move normally, but they can still use the console to move, attack, etc.
{| class=wikitable
 
! ConCommand !! Description
==map_commentary==
|-
<code>map_commentary</code> is a command that is analogous to <code>map</code> but also enables [[commentary mode]].
| <code>map_background</code>
 
| Analogous to <code>map</code> but loads a map as a background for the main menu. The player will not be able to move normally, but they can still use the console to move, attack, etc. This was introduced and used in {{hl2|4}} and its series but it does no longer work properly in newer games. Works in {{tf2|4}} and {{portal|4}}
==maps==
|-
<code>maps</code> lists all the maps the game has access to that begin with a certain prefix. Use <code>*</code> to list all maps.
| <code>map_commentary</code>
 
| Analogous to <code>map</code> but also enables [[commentary mode]], introduced in {{hl2lc|4}} and {{src06|4}}.
==See also==
|-
*[[Console Command List]]
| <code>maps&nbsp;<substring></code>
 
| Lists all the maps the game has access to that contain a certain character sequence. Use <code>*</code> to list all maps.
[[Category: Console Commands]]
|-
| <code>changelevel</code>
| Simillar to <code>map</code> but keeps weapons and other player information from the previous map.
|}

Latest revision as of 23:00, 3 July 2025

This article is about the console command. For the place in a game, see Map (level design).  For the file format, see MAP file format.

map is a console command available in all GoldSrc GoldSrc, Source Source, and Source 2 Source 2 games. It loads the specified map and starts a game on it.

Warning.pngWarning:For multiplayer games, this command may kick everyone from your server before changing the map, or does a hard change, so to speak. If you want a soft change, use changelevel.
Apparently, both commands behave like changelevel since Counter-Strike: Global Offensive.

Usage

map <mapname>
map <mapname> [*sp/*mp] // Portal 2
map <mapname> [gamemode] // CS:GO
map <mapname> [key1=value1] [key2=value2] [...] // CS2

The .bsp extension must be omitted. The game can access both maps in mounted VPKs and in the maps\ folder. Maps that are in a subdirectory of maps\ need to have the folder name included in the console command.

PlacementTip.pngExample:Half-Life 2 map d1_trainstation_01
Portal 2 map mp_coop_fan *sp
Counter-Strike: Global Offensive map de_dust2 deathmatch
Counter-Strike 2 map de_dust2 gamemode=deathmatch
Note.pngNote:

(in all games since Left 4 Dead engine branch) (also in Source 2013 MultiplayerTeam Fortress 2 branch) If you type the map name partially, like map l4d_river or map de_du, then submit it, it will load the first result it found (l4d_river01_docks or de_dust).
Counter-Strike: Global Offensive The optional gamemode parameter can be one of the values deathmatch, casual, competitive, armsrace, coopstrike ..., see CS:GO Game Modes.

Todo: A similar list exists for Left 4 Dead 2.

Counter-Strike 2 A list of key-value pairs can be passed. As seen in the example above, this can be used to set the game mode.[What else?]

Note.pngNote:

Portal 2 will automatically launch maps starting with mp_coop in co-op mode, but you can still launch them in "singleplayer mode" by appending *sp at the end of the command. The inverse is also possible.

PlacementTip.pngExample:map sp_a2_triple_laser *mp

Similar Commands

ConCommand Description
map_background Analogous to map but loads a map as a background for the main menu. The player will not be able to move normally, but they can still use the console to move, attack, etc. This was introduced and used in Half-Life 2 Half-Life 2 and its series but it does no longer work properly in newer games. Works in Team Fortress 2 Team Fortress 2 and Portal Portal
map_commentary Analogous to map but also enables commentary mode, introduced in Half-Life 2: Lost Coast Half-Life 2: Lost Coast and Source 2006 Source 2006.
maps <substring> Lists all the maps the game has access to that contain a certain character sequence. Use * to list all maps.
changelevel Simillar to map but keeps weapons and other player information from the previous map.
Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Map_(console_command)&oldid=484807"