CreateTeam: Difference between revisions
Jump to navigation
Jump to search
m (→See Also) |
|||
(7 intermediate revisions by one other user not shown) | |||
Line 5: | Line 5: | ||
==Syntax== | ==Syntax== | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
team createTeam ( string teamName, | team createTeam ( string teamName [, int colorR = 255, int colorG = 255, int colorB = 255 ] ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
{{OOP||Team.create||}} | {{OOP||Team.create||}} | ||
===Required Arguments=== | ===Required Arguments=== | ||
*'''teamName: | *'''teamName:''' A string representing the teams name. | ||
===Optional Arguments=== | ===Optional Arguments=== | ||
*'''colorR:''' An integer representing the red color value. | *'''colorR:''' An integer representing the red color value. | ||
Line 19: | Line 16: | ||
===Returns=== | ===Returns=== | ||
Returns a team element if it was successfully created, ''false'' if invalid arguments are passed or a team with that name already exists. | |||
==Example== | ==Example== | ||
'''Example 1:''' This example creates a new team for a player, then adds him to it. | '''Example 1:''' This example creates a new team for a player, then adds him to it. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
function gimmeATeam ( source, | function gimmeATeam(source, commandName, teamName) | ||
local newTeam = createTeam(teamName) -- create a new team with the specified name | |||
if newTeam then -- if it was successfully created | |||
setPlayerTeam(source, newTeam) -- add the player to the new team | |||
end | |||
end | end | ||
addCommandHandler("giveteam", | addCommandHandler("giveteam", gimmeATeam) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
'''Example 2:''' This example creates two teams, one for Admin and one for Freeroamers, when the resource this script is in is started. | '''Example 2:''' This example creates two teams, one for Admin and one for Freeroamers, when the resource this script is in is started. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
function createTeamsOnStart () | function createTeamsOnStart() | ||
teamAdmmin = createTeam("Admin", 0, 255, 0) -- change the 3 numbers(0,255,0), the first number is ColourR, the second is ColourG, and the last one is ColourB | |||
teamFreeroamers = createTeam("Freeroamer", 200, 0, 100) | |||
end | end | ||
addEventHandler("onResourceStart", resourceRoot, createTeamsOnStart) --we attach the function to this resource's root element | addEventHandler("onResourceStart", resourceRoot, createTeamsOnStart) -- we attach the function to this resource's root element | ||
</syntaxhighlight> | </syntaxhighlight> | ||
'''Example 3:''' This example creates a team for Admin and when an admin logs in, he will be set in the Admin team. | '''Example 3:''' This example creates a team for Admin and when an admin logs in, he will be set in the Admin team. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
function createAdminTeamOnStart () | function createAdminTeamOnStart() | ||
AdminTeam = createTeam("Admin", 0, 255, 0) -- create a new team and name it 'Admin' | |||
end | end | ||
addEventHandler("onResourceStart", resourceRoot, createAdminTeamOnStart) -- add an event handler | addEventHandler("onResourceStart", resourceRoot, createAdminTeamOnStart) -- add an event handler | ||
function setAdminTeam() | function setAdminTeam() | ||
if isObjectInACLGroup("user."..getAccountName(getPlayerAccount(source)), aclGetGroup("Admin")) then -- if he is admin | if isObjectInACLGroup("user." .. getAccountName(getPlayerAccount(source)), aclGetGroup("Admin")) then -- if he is admin | ||
setPlayerTeam(source, AdminTeam) -- set him to admin team | |||
end | |||
end | end | ||
addEventHandler("onPlayerLogin", | addEventHandler("onPlayerLogin", root, setAdminTeam) -- add an event handler | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==See Also== | ==See Also== | ||
{{Team_functions}} | {{Team_functions|server}} |
Latest revision as of 23:00, 6 September 2024
This function is for creating a new team, which can be used to group players. Players will not join the team until they are respawned.
Syntax
team createTeam ( string teamName [, int colorR = 255, int colorG = 255, int colorB = 255 ] )
OOP Syntax Help! I don't understand this!
- Method: Team.create(...)
Required Arguments
- teamName: A string representing the teams name.
Optional Arguments
- colorR: An integer representing the red color value.
- colorG: An integer representing the green color value.
- colorB: An integer representing the blue color value.
Returns
Returns a team element if it was successfully created, false if invalid arguments are passed or a team with that name already exists.
Example
Example 1: This example creates a new team for a player, then adds him to it.
function gimmeATeam(source, commandName, teamName) local newTeam = createTeam(teamName) -- create a new team with the specified name if newTeam then -- if it was successfully created setPlayerTeam(source, newTeam) -- add the player to the new team end end addCommandHandler("giveteam", gimmeATeam)
Example 2: This example creates two teams, one for Admin and one for Freeroamers, when the resource this script is in is started.
function createTeamsOnStart() teamAdmmin = createTeam("Admin", 0, 255, 0) -- change the 3 numbers(0,255,0), the first number is ColourR, the second is ColourG, and the last one is ColourB teamFreeroamers = createTeam("Freeroamer", 200, 0, 100) end addEventHandler("onResourceStart", resourceRoot, createTeamsOnStart) -- we attach the function to this resource's root element
Example 3: This example creates a team for Admin and when an admin logs in, he will be set in the Admin team.
function createAdminTeamOnStart() AdminTeam = createTeam("Admin", 0, 255, 0) -- create a new team and name it 'Admin' end addEventHandler("onResourceStart", resourceRoot, createAdminTeamOnStart) -- add an event handler function setAdminTeam() if isObjectInACLGroup("user." .. getAccountName(getPlayerAccount(source)), aclGetGroup("Admin")) then -- if he is admin setPlayerTeam(source, AdminTeam) -- set him to admin team end end addEventHandler("onPlayerLogin", root, setAdminTeam) -- add an event handler
See Also
- createTeam
- setPlayerTeam
- setTeamColor
- setTeamFriendlyFire
- setTeamName
- Shared
- countPlayersInTeam
- getPlayerTeam
- getPlayersInTeam
- getTeamColor
- getTeamFriendlyFire
- getTeamFromName
- getTeamName