RemovePlayerFromTeam: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
MrJax (talk | contribs)
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

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