1,584
edits
SetCurrentGameMode: Difference between revisions
no edit summary
DrinkyBird (talk | contribs) (3.1 is released, so Devfeature templates have been removed) |
DrinkyBird (talk | contribs) No edit summary Tag: Source edit |
||
| Line 3: | Line 3: | ||
int '''SetCurrentGameMode''' (str ''gamemode'') | int '''SetCurrentGameMode''' (str ''gamemode'') | ||
==Usage== | == Usage == | ||
Changes the current game mode, which also resets the game upon success. This requires players to reconnect to the server when it happens. | Changes the current game mode, which also resets the game upon success. This requires players to reconnect to the server when it happens. | ||
==Return Value== | === Parameters === | ||
* ''gamemode'': For forwards-compatibility, the game mode is passed as a string and must be one of the following: | |||
** [[Game_Modes#Cooperative|Cooperative]] | |||
** [[Game_Modes#Cooperative_Survival|Survival]] | |||
** [[Game_Modes#Invasion|Invasion]] | |||
** [[Game_Modes#Deathmatch|Deathmatch]] | |||
** [[Game_Modes#Team_Deathmatch|Teamplay]] | |||
** [[Game_Modes#Duel|Duel]] | |||
** [[Game_Modes#Terminator|Terminator]] | |||
** [[Game_Modes#Last_Man_Standing|LastManStanding]] | |||
** [[Game_Modes#Team_Last_Man_Standing|TeamLMS]] | |||
** [[Game_Modes#Possession|Possession]] | |||
** [[Game_Modes#Team_Possession|TeamPossession]] | |||
** [[Game_Modes#Team_Game|TeamGame]] | |||
** [[Game_Modes#Capture_the_Flag|CTF]] | |||
** [[Game_Modes#One_Flag_Capture_the_Flag|OneFlagCTF]] | |||
** [[Game_Modes#Skull_Tag|Skulltag]] | |||
** [[Game_Modes#Domination|Domination]] | |||
=== Return Value === | |||
Returns 1 if the game mode was changed, or 0 if it wasn't. There are several reasons why a game mode might not change: | Returns 1 if the game mode was changed, or 0 if it wasn't. There are several reasons why a game mode might not change: | ||
* The new game mode either doesn't exist, or is already being played. | * The new game mode either doesn't exist, or is already being played. | ||
| Line 29: | Line 32: | ||
* The result sequence is currently active. Refer to [[GetGameModeState#GAMESTATE_INRESULTSEQUENCE|GetGameModeState]]. | * The result sequence is currently active. Refer to [[GetGameModeState#GAMESTATE_INRESULTSEQUENCE|GetGameModeState]]. | ||
[[category:ACS | == Examples == | ||
{{noexamples}} | |||
[[category:ACS functions]] | |||