Manual Review Required

Please finish this page using the corresponding Old Wiki article. Go to Contribution guidelines for more information.

---

This function is for returning the number of players in the specified team.

OOP Syntax Help! I don't understand this!

• Method:team:countPlayers(...)
• Variable: .playerCount

Syntax

int countPlayersInTeam ( team theTeam )

Required Arguments

• theTeam: The team you wish to retrieve the player count of.

Returns

• int: value

Returns an integer containing the number of players in the team, false if it could not be retrieved.

Code Examples

Example 1 Example 2 Example 3

shared

This example adds a command in the console to find out how many players are on your team.

function outputTeamSize ( source, commandName )
  -- Get player's team
  local theTeam = getPlayerTeam ( source )
  -- If the player is in any team
  if theTeam then
    -- Tell the player how big his team is
    outputChatBox ( "Your team has " .. countPlayersInTeam ( theTeam ) .. " players.", source )
  else
    outputChatBox ( "You're not in a team.", source )
  end
end
addCommandHandler ( "teamsize", outputTeamSize )

shared

This example adds a command in the console to find out how many players are on your team, clientside

function outputTeamSize ( commandName )
  -- Get player's team
  local theTeam = getPlayerTeam ( getLocalPlayer() )
  -- If the player is in any team
  if team then
    -- Tell the player how big his team is
    outputChatBox ( "Your team has " .. countPlayersInTeam ( theTeam ) .. " players." )
  else
    outputChatBox ( "You're not in a team." )
  end
end
addCommandHandler ( "teamsize", outputTeamSize )

shared

This example balances a gamemode, to ensure equal number of players between the "grove" and "ballas" teams. This could be triggered when a player joins the server, or for all players currently in the server when the gamemode starts.

function balanceTeams ( thePlayer )
  --get the team pointers from their names
  local groveTeam = getTeamFromName ( "grove" )
  local ballasTeam = getTeamFromName ( "ballas" )
  --count the number of players in each team, and store them
  local groveCount = countPlayersInTeam ( groveTeam )
  local ballasCount = countPlayersInTeam ( ballasTeam )
  if groveCount == ballasCount then --if the teams are equal
    setPlayerTeam ( thePlayer , groveTeam ) --place the player in grove
  elseif groveCount > ballasCount then --if there are more in grove
    setPlayerTeam ( thePlayer , ballasTeam ) --place him in ballas
  elseif groveCount < ballasCount then --if there are more in ballas
    setPlayerTeam ( thePlayer , groveTeam ) --place him in grove.
  end
end

See Also

Player Functions

• countPlayersInTeam
• forcePlayerMap
• getAlivePlayers
• getControlState
• getDeadPlayers
• getLocalPlayer
• getPlayerAnnounceValue
• getPlayerBlurLevel
• getPlayerCount
• getPlayerFromName
• getPlayerHudComponentProperty
• getPlayerIdleTime
• getPlayerIP
• getPlayerMapBoundingBox
• getPlayerMapOpacity
• getPlayerMoney
• getPlayerName
• getPlayerNametagColor
• getPlayerNametagText
• getPlayerPing
• getPlayerScriptDebugLevel
• getPlayerSerial
• getPlayersInTeam
• getPlayerTeam
• getPlayerVersion
• getPlayerWantedLevel
• getRandomPlayer
• givePlayerMoney
• isPlayerCrosshairVisible
• isPlayerHudComponentVisible
• isPlayerMapForced
• isPlayerMapVisible
• isPlayerMuted
• isPlayerNametagShowing
• isVoiceEnabled
• redirectPlayer
• resendPlayerACInfo
• resendPlayerModInfo
• resetPlayerHudComponentProperty
• setControlState
• setPlayerAnnounceValue
• setPlayerBlurLevel
• setPlayerHudComponentProperty
• setPlayerHudComponentVisible
• setPlayerMoney
• setPlayerMuted
• setPlayerName
• setPlayerNametagColor
• setPlayerNametagShowing
• setPlayerNametagText
• setPlayerScriptDebugLevel
• setPlayerTeam
• setPlayerVoiceBroadcastTo
• setPlayerVoiceIgnoreFrom
• setPlayerWantedLevel
• spawnPlayer
• takePlayerMoney
• takePlayerScreenShot

Player Events

• onClientPlayerChangeNick
• onClientPlayerChoke
• onClientPlayerDamage
• onClientPlayerHeliKilled
• onClientPlayerHitByWaterCannon
• onClientPlayerJoin
• onClientPlayerPickupHit
• onClientPlayerPickupLeave
• onClientPlayerQuit
• onClientPlayerRadioSwitch
• onClientPlayerSpawn
• onClientPlayerStealthKill
• onClientPlayerStuntFinish
• onClientPlayerStuntStart
• onClientPlayerTarget
• onClientPlayerVehicleEnter
• onClientPlayerVehicleExit
• onClientPlayerVoicePause
• onClientPlayerVoiceResumed
• onClientPlayerVoiceStart
• onClientPlayerVoiceStop
• onClientPlayerWasted
• onClientPlayerWeaponFire
• onClientPlayerWeaponSwitch
• onPlayerACInfo
• onPlayerBan
• onPlayerChangeNick
• onPlayerChangesProtectedData
• onPlayerChangesWorldSpecialProperty
• onPlayerChat
• onPlayerClick
• onPlayerCommand
• onPlayerConnect
• onPlayerContact
• onPlayerDamage
• onPlayerDetonateSatchels
• onPlayerDiscordJoin
• onPlayerJoin
• onPlayerLogin
• onPlayerLogout
• onPlayerMarkerHit
• onPlayerMarkerLeave
• onPlayerModInfo
• onPlayerMute
• onPlayerNetworkStatus
• onPlayerPickupHit
• onPlayerPickupLeave
• onPlayerPickupUse
• onPlayerPrivateMessage
• onPlayerProjectileCreation
• onPlayerQuit
• onPlayerScreenShot
• onPlayerSpawn
• onPlayerStealthKill
• onPlayerTarget
• onPlayerTeamChange
• onPlayerTeleport
• onPlayerTriggerEventThreshold
• onPlayerTriggerInvalidEvent
• onPlayerUnmute
• onPlayerVehicleEnter
• onPlayerVehicleExit
• onPlayerVoiceStart
• onPlayerVoiceStop
• onPlayerWasted
• onPlayerWeaponFire
• onPlayerWeaponReload
• onPlayerWeaponSwitch

Reference

• Scripting Functions