SetPlayerClass: Difference between revisions
DrinkyBird (talk | contribs) (3.1 is released, so Devfeature templates have been removed) |
DrinkyBird (talk | contribs) No edit summary Tag: Source edit |
||
| Line 1: | Line 1: | ||
{{Template:ACSWarning}} | {{Template:ACSWarning}} | ||
bool '''SetPlayerClass''' (int ''player'', str ''class'', bool ''respawn'') | |||
==Usage== | == Usage == | ||
Changes the class a player is currently using. Note that in order for this to work, the player must exist and not a true spectator, and the class must be a valid player class that isn't forbidden to the player (eg. the class is restricted to a team the player isn't on). | Changes the class a player is currently using. Note that in order for this to work, the player must exist and not a true spectator, and the class must be a valid player class that isn't forbidden to the player (eg. the class is restricted to a team the player isn't on). | ||
==Parameters== | === Parameters === | ||
*player: The number of the player | * ''player'': The number of the player whose class with be changed. | ||
*class: The name of the actor to change the player to. This must be a valid actor that inherits from | * ''class'': The name of the actor to change the player to. This must be a valid actor that inherits from {{Zdoomwiki|Classes:PlayerPawn|PlayerPawn}}, or the string "random" to assign a random class. | ||
*respawn: If true, the player will immediately respawn with the new class, otherwise their class won't change until they respawn normally. | * ''respawn'': If true, the player will immediately respawn with the new class, otherwise their class won't change until they respawn normally. | ||
==Return | === Return value === | ||
Returns | Returns true if the player's class was successfully changed, false on failure (eg. the player or class don't exist, or if choosing random classes is forbidden). | ||
[[ | == Examples == | ||
{{noexamples}} | |||
[[Category:ACS functions]] | |||
Revision as of 01:01, 3 July 2022
|
This article documents a Zandronum-specific ACS feature which may not be supported by ZDoom and its other child ports. |
bool SetPlayerClass (int player, str class, bool respawn)
Usage
Changes the class a player is currently using. Note that in order for this to work, the player must exist and not a true spectator, and the class must be a valid player class that isn't forbidden to the player (eg. the class is restricted to a team the player isn't on).
Parameters
- player: The number of the player whose class with be changed.
- class: The name of the actor to change the player to. This must be a valid actor that inherits from
PlayerPawn, or the string "random" to assign a random class. - respawn: If true, the player will immediately respawn with the new class, otherwise their class won't change until they respawn normally.
Return value
Returns true if the player's class was successfully changed, false on failure (eg. the player or class don't exist, or if choosing random classes is forbidden).
Examples
| This article lists no examples, please add one. |