CountPlayersInTeam: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
(Undo revision 56818 by Ahmedsayed Hamada (talk))
 
(9 intermediate revisions by 8 users not shown)
Line 7: Line 7:
int countPlayersInTeam ( team theTeam )
int countPlayersInTeam ( team theTeam )
</syntaxhighlight>  
</syntaxhighlight>  
 
{{OOP||[[team]]:countPlayers|playerCount|}}
===Optional Arguments===  
===Optional Arguments===  
*'''theTeam:''' The team you wish to retrieve the player count of.
*'''theTeam:''' The team you wish to retrieve the player count of.
Line 15: Line 15:


==Example==
==Example==
<section name="Example 1" class="server">  
<section name="Example 1" class="server" show="true">  
This example adds a command in the console to find out how many players are on your team.
This example adds a command in the console to find out how many players are on your team.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 22: Line 22:
local theTeam = getPlayerTeam ( source )
local theTeam = getPlayerTeam ( source )
-- If the player is in any team
-- If the player is in any team
if team then
if theTeam then
-- Tell the player how big his team is
-- Tell the player how big his team is
outputChatBox ( "Your team has " .. countPlayersInTeam ( theTeam ) .. " players.", source )
outputChatBox ( "Your team has " .. countPlayersInTeam ( theTeam ) .. " players.", source )
Line 32: Line 32:
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>
<section name="Example 2" class="client">  
<section name="Example 2" class="client" show="true">  
This example adds a command in the console to find out how many players are on your team, clientside
This example adds a command in the console to find out how many players are on your team, clientside
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 49: Line 49:
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>
<section name="Example 3" class="server">  
<section name="Example 3" class="server" show="true">  
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.
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.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 60: Line 60:
local ballasCount = countPlayersInTeam ( ballasTeam )
local ballasCount = countPlayersInTeam ( ballasTeam )
if groveCount == ballasCount then --if the teams are equal
if groveCount == ballasCount then --if the teams are equal
addPlayerToTeam ( thePlayer , groveTeam ) --place the player in grove
setPlayerTeam ( thePlayer , groveTeam ) --place the player in grove
elseif groveCount > ballasCount then --if there are more in grove
elseif groveCount > ballasCount then --if there are more in grove
addPlayerToTeam ( thePlayer , ballasTeam ) --place him in ballas
setPlayerTeam ( thePlayer , ballasTeam ) --place him in ballas
elseif groveCount < ballasCount then --if there are more in ballas
elseif groveCount < ballasCount then --if there are more in ballas
addPlayerToTeam ( thePlayer , groveTeam ) --place him in grove.
setPlayerTeam ( thePlayer , groveTeam ) --place him in grove.
end
end
end</syntaxhighlight>
end</syntaxhighlight>
</section>
</section>
==See Also==
==See Also==
{{Team functions}}
{{Team functions}}

Latest revision as of 23:59, 23 July 2018

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

Syntax

int countPlayersInTeam ( team theTeam )

OOP Syntax Help! I don't understand this!

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


Optional Arguments

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

Returns

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

Example

Click to collapse [-]
Example 1

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 )
Click to collapse [-]
Example 2

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 )
Click to collapse [-]
Example 3

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


Retrieved from "https://wiki.multitheftauto.com/wiki/CountPlayersInTeam?oldid=56865"