SetPlayerTeam

From Multi Theft Auto: Wiki
Revision as of 10:27, 9 November 2007 by AlienX (talk | contribs) (New page: __NOTOC__ {{Server function}} This function adds a player to an existing team. The player will automatically be removed from his current team if he's on one. ==Syntax== <syntaxhighlight lang="lua">[lua...)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This function adds a player to an existing team. The player will automatically be removed from his current team if he's on one.

Syntax

bool setPlayerTeam ( player thePlayer, team theTeam )

Required Arguments

  • thePlayer: The player you wish to add to a team.
  • theTeam: The team you want to add the player to.

Note: if you wish to unassign a player from a team, set theTeam to nil

Returns

Returns true if the player was successfully added to the specified team, false otherwise.

Example

This example adds a command to create a new team for a player, then add him to it. It also adds a command to remove him from the team too.

function assignNewTeam ( source, commandName, teamName )
  local theTeam = createTeam ( teamName )  -- create a new team with the specified name
  if theTeam then                          -- if it was successfully created
    setPlayerTeam ( source, theTeam )    -- add the player to the new team
  end
end
addCommandHandler ( "gimmeateam", assignNewTeam )

function unassignNewTeam ( source, commandName )
  local theTeam = getPlayerTeam ( source )  -- Check if the player is on a team
  if theTeam then                          -- if it was successfully created
    setPlayerTeam ( source, nil )    -- add the player to the new team
  end
end
addCommandHandler ( "takeawaymeteam", assignNewTeam )

See Also