ACSUtils Wiki

An ACS library for ZDoom-based ports

User Tools

Site Tools


new:player

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
new:player [2018/02/20 16:43] korshunnew:player [2018/02/21 14:29] (current) korshun
Line 1: Line 1:
 +~~NOCACHE~~
 ====== Player utilities ====== ====== Player utilities ======
  
Line 10: Line 11:
  
 Also, remember that "no player" is player number -1, while player number 0 is the first player. Also, remember that "no player" is player number -1, while player number 0 is the first player.
 +
 +===== SetActivatorToPlayer2 =====
 +
 +''bool SetActivatorToPlayer2(int player)''
 +
 +A replacement for both [[zdoom>SetActivator]] with ''AAPTR_PLAYERx'' and [[zan>SetActivatorToPlayer]] that works in any port.
 +
 +[[zdoom>SetActivator]] with ''AAPTR_PLAYERx'' only supports up to 8 players, while [[zan>SetActivatorToPlayer]] isn't supported in ZDoom. This function attemps to use ''SetActivatorToPlayer'', and then ''SetActivator(AAPTR_PLAYERx)''. This way, it works in both ZDoom and Zandronum.
 +
 +
 +===== Player classification =====
 +
 +  * ''bool PlayerIsConnected(int player)'' -- returns true if the player is connected to the server.
 +  * [[zdoom>PlayerIsBot]]
 +  * [[zdoom>PlayerInGame]]
 +  * [[zdoom>PlayerIsSpectator]]
 +  * ''bool PlayerIsDeadSpectator(int player)'' -- returns true if the player is a dead spectator.
 +
 +Functions to count various classes of players:
 +
 +  * ''int ClientCount()''
 +  * ''int BotCount()''
 +  * [[zdoom>PlayerCount]] 
 +  * ''int SpectatorConunt()''
 +  * ''int DeadSpectatorCount()''
 +  
 +Functions to pick a random player:
 +
 +  * ''int PickRandomClient()''
 +  * ''int PickRandomBot()''
 +  * ''int PickRandomPlayer()''
 +  * ''int PickRandomSpectator()''
 +  * ''int PickRandomDeadSpectator()''
 +
 +  * ''int PickRandomTeamPlayer(int team)'' -- pick a random in-game player from the team.
  
  
Line 34: Line 70:
 ''str PlayerName(int player)'' ''str PlayerName(int player)''
  
-Returns the player's name. Shorthand for ''StrParam(n:player+1)''.+Returns the player's name. Shorthand for ''StrParam(n:player + 1)''.
  
 ==== GetPlayerTeam ==== ==== GetPlayerTeam ====
Line 40: Line 76:
  
 Returns the player's team number, or ''TEAM_NONE''. Shorthand for ''GetPlayerInfo(player, PLAYERINFO_TEAM)''. Returns the player's team number, or ''TEAM_NONE''. Shorthand for ''GetPlayerInfo(player, PLAYERINFO_TEAM)''.
 +
  
  
new/player.1519137785.txt.gz · Last modified: 2018/02/20 16:43 by korshun