GetTeamWithFewestPlayers

2014-06-21T23:26:26Z

Booo:

2014-06-21T21:49:56Z

Booo:

GetTeamWithFewestPlayers

2014-06-21T21:48:55Z

Booo:

{{Useful Function}}
<lowercasetitle/>

__NOTOC__
This function gets a team from it's few players.
'''Note:''' If 2 teams has the same count, then the first one found will be returned!
==Syntax==
<syntaxhighlight lang="lua">team getTeamWithFewestPlayers ( element team1,element team2)</syntaxhighlight>

===Return===
Returns a [[team]] else false.

==Code==
<syntaxhighlight lang="lua">
function getTeamWithFewestPlayers(team1,team2)
if (isElement(team1) and getElementType(team1) == "team") and (isElement(team2) and getElementType(team2) == "team") then
local team1C = countPlayersInTeam (team1)
local team2C = countPlayersInTeam (team2)
if team1C == team2C then return team1
else
if team1C == math.min(team1C,team2C) then
return team1
else
return team2
end
end
end
return false
end
</syntaxhighlight>

==Example==
<section name="Example" class="server" show="true">

<syntaxhighlight lang="lua">

function setPlayerToTeam(source)
local redteam = getTeamFromName ( "Red" )
local blueteam = getTeamFromName ( "Blue" )
if redteam and blueteam then
local theteam = getTeamWithFewestPlayers(redteam,blueteam)
if theteam then
setPlayerTeam(source,theteam)
local PlayerName = getPlayerName ( source )
outputChatBox ( " " .. joinedPlayerName .. " Joined "..getTeamName(theteam).." team !" , root, 255, 255, 255 )
end
else
createTeam ("Red",255,0,0)
createTeam ("Blue",0,0,255)
setPlayerToTeam(source)
end
end
addEventHandler ( "onPlayerJoin", getRootElement(), setPlayerToTeam )

</syntaxhighlight>
</section>

Author: Booo

==See Also==
{{Useful_Functions}}

GetTeamWithFewestPlayers

2014-06-21T18:07:36Z

Booo:

{{Useful Function}}
<lowercasetitle/>

__NOTOC__
This function gets a team from it's few players.

'''Note:''' If 2 teams has the same count, then the first one found will be returned!
==Syntax==
<syntaxhighlight lang="lua">team getTeamWithFewestPlayers ( element team1,element team2)</syntaxhighlight>

===Return===
Returns a [[team]] else false.

==Code==
<syntaxhighlight lang="lua">
[lua]
function getTeamWithFewestPlayers(team1,team2)
if (isElement(team1) and getElementType(team1) == "team") and (isElement(team2) and getElementType(team2) == "team") then
local team1C = countPlayersInTeam (team1)
local team2C = countPlayersInTeam (team2)
if team1C == team2C then return team1
else
if team1C == math.min(team1C,team2C) then
return team1
else
return team2
end
end
end
return false
end
</syntaxhighlight>

==Example==
<section name="Example" class="server" show="true">

<syntaxhighlight lang="lua">

function setPlayerToTeam(source)
local redteam = getTeamFromName ( "Red" )
local blueteam = getTeamFromName ( "Blue" )
if redteam and blueteam then
local theteam = getTeamWithFewestPlayers(redteam,blueteam)
if theteam then
setPlayerTeam(source,theteam)
local PlayerName = getPlayerName ( source )
outputChatBox ( " " .. joinedPlayerName .. " Joined "..getTeamName(theteam).." team !" , root, 255, 255, 255 )
end
else
createTeam ("Red",255,0,0)
createTeam ("Blue",0,0,255)
setPlayerToTeam(source)
end
end
addEventHandler ( "onPlayerJoin", getRootElement(), setPlayerToTeam )

</syntaxhighlight>
</section>

Author: Booo

==See Also==
{{Useful_Functions}}

GetTeamWithFewestPlayers

2014-06-21T18:07:16Z

2014-01-17T15:51:57Z

Booo:

*[[callClientFunction]] » This function allows you to call any clientside function from the server's side.
*[[callServerFunction]] » This function allows you to call any server-side function from the client's side.
*[[centerWindow]] » This function center the window in any resolution.
*[[Check]] » This function checks if it's arguments are of the right types and calls the error-function if one isn't.
*[[convertNumber]] » This function converts large numbers and adds commas to it. (Example: 100000 -> 100,000)
*[[coroutine.resume]] » Fix for hidden coroutine error messages
*[[dxDrawAnimWindow]] » Create Animated Dx Window
*[[dxDrawCircle]] » This function draws a 2D line in a circle shape on the screen.
*[[dxDrawColorText]] » This function draws a dx text with #RRGGBB color codes support.
*[[dxDrawGifImage]] » This function simulates the effect of a GIF image by using image sprites.
*[[dxDrawImage3D]] » This function draws a 3D image.
*[[dxDrawPartialCircle]] » This function draws a 2D line in a partial circle shape on the screen.
*[[dxDrawRectangle3D]] » This function draws a 3D rectangle.
*[[dxGetFontSizeFromHeight]] » This function calculate a font size from given height for dxDraw.
*[[dxGetRealFontHeight]] » Accurately measures the pixel height of a font.
*[[FewPlayersOnTeams]] » TThis function gets a team from it's few Players.
*[[findRotation]] » Takes two points and returns the direction from point A to point B.
*[[FormatDate]] » Formats a date on the basis of a format string and returns it.
*[[GenerateString]] » With this function you can generate a random string with any characters.
*[[getAge]] » This function calculates the age of a birthday.
*[[getAlivePlayers (Client)|getAlivePlayers]] » This function returns all the alive players by a client side, so you can store them into a Gridlist or something like that, faster.
*[[getAlivePlayersInTeam]] » This function returns a table of the alive players in a team.
*[[getBoundControls]] » This function returns a list of control names that are bound to the specified key.
*[[getCursorMoveOn]] » This function checks in which way the cursor is currently moving.
*[[getDistanceBetweenPointAndSegment2D]] » Takes point coordinates and line (a segment) starting and ending coordinates. It returns the shortest distance between the point and the line.
*[[getElementSpeed]] » This function allows you to get element speed in kph or mph units.
*[[getElementsInDimension]] » This function gets the elements that are in the specified dimension.
*[[getElementsWithinMarker]] » This function gets the elements that are in a markers colshape.
*[[getJetpackWeaponsEnabled]] » This function returns a table of enabled weapons usable on a jetpack.
*[[getOffsetFromXYZ]] » This function allows you to take an entity and a position and calculate the relative offset between them accounting for rotations.
*[[getOnlineAdmins]] » This function will give the online admins.
*[[getOnlineStaff]] » Returns all online staff, names separated by two spaces.
*[[getPlayersByData]] » This function gets players who have data name you passed to it.
*[[getPlayerFromNamePart]] » This function allows you to get player From his Name part.
*[[getPlayersInPhotograph]] » This function gets all the players in a photograph.
*[[getPlayerFromSerial]] » This function gets an online player from their serial.
*[[getPointFromDistanceRotation]] » Finds a point based on a starting point, direction and distance.
*[[getResourceSettings]] » This function returns a table of the resource settings.
*[[getResourceScripts]] » This function returns a table of the resource scripts.
*[[getRGColorFromPercentage]] »This function returns two integers representing Red and Green colors according to the percentage requested.
*[[getTeamFromColor]] » This function gets a team from it's color. (Related to: [[getTeamFromName]])
*[[getTimestamp]] » With this function you can get the UNIX timestamp.
*[[getValidVehicleModels]] » This function returns a table containing valid MTA Vehicle models.
*[[getXMLNodes]] » Returns all children of a node
*[[getVehicleRespawnPosition]] » This function allows you to get the spawn position of a vehicle.
*[[guiComboBoxAdjustHeight]] » Adjusts the combobox to have a correct height.
*[[IfElse]] » Returns one of two values based on a boolean expression.
*[[isElementInPhotograph]] » This function checks if an element was in the player's camera picture.
*[[isElementInRange]] » This function allows you to check is the element's range to the main point is smaller than (or as big as) the maximum range.
*[[isElementMoving]]» This function checks if an element is moving.
*[[isElementWithinAColShape]]» This function checks if the [[element]] is in a [[colshape]].
*[[isPedAiming]]» This function checks if a ped is aiming.
*[[isPlayerInACL]] » This function will check to see if a player element is in an ACL group.
*[[isPlayerInTeam]] » This function check if the player in the team.
*[[isLeapYear]] » Checks if the given year is a leap year.
*[[isVehicleOnRoof]] » This function checks whether vehicle is on roof.
*[[isVehicleEmpty]] » This function checks whether a vehicle is empty.
*[[isSoundFinished]] » This function checks sound finished or not.
*[[iterElements]] » Returns an iterator for your for loops saving time typing ipairs( getElementsByType( type ) ), instead you type: iterElements( type ).
*[[mathNumber]] » This function is a workaround for the clientside floating-point precision of 24-bits
*[[math.round]] » Rounds a number whereas the number of decimals to keep and the method may be set.
*[[multi_check]] » This function checks one element to many, handy and clean.
*[[onVehicleWeaponFire]] » This code implements an event that is triggered when a player in a vehicle fires a vehicles weapon.
*[[RGBToHex]] » This function returns a string representing the color in hexadecimal.
*[[setElementSpeed]] » This function allows you to set moving element speed in kph or mph units.
*[[setTableProtected]] » Protects a table and makes it read-only.
*[[setVehicleGravityPoint]] » This clientside function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.
*[[smoothMoveCamera]] » This clientside function allows you to create a cinematic camera flight.
*[[string.count]] » This function counts a text from a text.
*[[string.explode]] » This function splits a string at a given separator pattern and returns a table with the pieces.
*[[switch]] » This function allow the value of a variable or expression to control the flow of program execution via a multiway branch.
*[[table.copy]] » This function copies a whole table and all the tables in that table.
*[[table.compare]] » This function check if both tables is equal. 
*[[table.empty]] » This function check is empty table or not.
*[[table.map]] » This function goes through a table and replaces every field with the return of the passed function, where the field's value is passed as first argument and optionally more arguments.
*[[table.merge]] » Merges two or more tables in the first.
*[[table.random]] » This function retrieves a random variable from a table.
*[[table.size]] » Finds the absolute size of a table.
*[[toHex]] » This function converts a decimal number to a hexadecimal number, as a fix to be used clientside.
*[[var dump]] » This function outputs information about one or more variables using outputConsole()
*[[wavelengthToRGBA]] » This function converts a phisical wavelength of light to a RGBA color.
[[Category:Useful Functions]]