1,544
edits
SetDeadSpectator: Difference between revisions
no edit summary
m (Added a note about the return value) |
DrinkyBird (talk | contribs) No edit summary Tag: Source edit |
||
| Line 1: | Line 1: | ||
{{Template:ACSWarning}} | {{Template:ACSWarning}} | ||
bool '''SetDeadSpectator''' (int ''playernumber'', bool ''state'') | |||
==Usage== | == Usage == | ||
Turns a player that is alive into a dead spectator or vice versa. This function will only | Turns a player that is alive into a dead spectator, or vice versa. This function will only affect dead spectators or players that are alive; not true spectators. Additionally, a player cannot be forced to be a dead spectator if the game currently isn't in progress (i.e. waiting for players, or is in the countdown/results sequence). They may, however, be revived at anytime so as long as the game isn't in the results sequence. | ||
If | If sv_deadplayerscankeepinventory is set, the dead spectator will be resurrected with the inventory they had before they died. If sv_samespawnspot is set, the dead spectator will be resurrected at their current location. | ||
=== Parameters === | |||
* ''playernumber'': Number of the player to effect | |||
* ''state'': The state to set on the effected player (false = alive; true = dead spectator) | |||
== | === Return value === | ||
Returns true on success, false on failure. | |||
==Examples== | == Examples == | ||
This script will turn the | This script will turn the player specified by ''pnum'' into a dead spectator if they are alive, or resurrect them if they are a dead spectator. | ||
<syntaxhighlight lang="c" line="1"> | <syntaxhighlight lang="c" line="1"> | ||
script 29999 (int pnum) | script 29999 (int pnum) | ||
| Line 23: | Line 24: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
[[ | == See also == | ||
* [[PlayerIsSpectator]] | |||
[[Category:ACS functions]] | |||