RemovePlayerFromTeam: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
m (Visual improvement)
 
(5 intermediate revisions by 4 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server function}}
{{Deprecated|setPlayerTeam}}
This function is for removing a player from his current team.
This function is for removing a player from his current team.


Line 11: Line 14:


===Returns===
===Returns===
Returns 'true' if the player was on a team and was successfully removed it, 'false' otherwise.
Returns ''true'' if the player was on a team and was successfully removed it, ''false'' otherwise.


==Example==
==Example==
This example creates a new team for a player, adds him to it, then removes him.
This example adds two new commands in console.  One to create a new team for a player, and another to remove the player from that team
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addCommandHandler ( "gimmeATeam", "gimmeATeam" )
function gimmeATeam ( source, key, teamName )
function gimmeATeam ( source, key, teamName )
  team = createTeam ( teamName ) -- create a new team with the specified name
    local newTeam = createTeam ( teamName ) -- create a new team with the specified name
  if ( team ) then -- if it was successfully created
    if ( newTeam ) then                     -- if it was successfully created
    addPlayerToTeam ( source, team ) -- add the player to the new team
        setPlayerTeam ( source, newTeam ) -- add the player to the new team
     removePlayerFromTeam ( source ) -- remove him from the team
     end
  end
end
addCommandHandler ( "gimmeateam", gimmeATeam )
 
function removeMyTeam ( source, key, teamName )
    local myTeam = getPlayerTeam ( source )--get his team
    if ( myTeam ) then --if he does have a team
        setPlayerTeam ( source, nil )     -- remove him from the team
        destroyElement ( myTeam ) --destroy his team
    end
end
end
addCommandHandler ( "removemyteam", removeMyTeam )
</syntaxhighlight>
</syntaxhighlight>


==See Also==
==See Also==
{{Team_functions}}
{{Team_functions}}

Latest revision as of 12:19, 26 June 2014

Emblem-important.png This function is deprecated. This means that its use is discouraged and that it might not exist in future versions.

Please use setPlayerTeam instead.


This function is for removing a player from his current team.

Syntax

bool removePlayerFromTeam ( player thePlayer )

Required Arguments

  • thePlayer: The player you wish to remove from his team.

Returns

Returns true if the player was on a team and was successfully removed it, false otherwise.

Example

This example adds two new commands in console. One to create a new team for a player, and another to remove the player from that team

function gimmeATeam ( source, key, 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 ( "gimmeateam", gimmeATeam )

function removeMyTeam ( source, key, teamName )
    local myTeam = getPlayerTeam ( source )--get his team
    if ( myTeam ) then --if he does have a team
        setPlayerTeam ( source, nil )      -- remove him from the team
        destroyElement ( myTeam ) --destroy his team
    end
end
addCommandHandler ( "removemyteam", removeMyTeam )

See Also