Team | Documentação - Central de Criadores Roblox

local Teams = game:GetService("Teams")

-- cria duas equipes
local redTeam = Instance.new("Team")
redTeam.TeamColor = BrickColor.new("Vermelho brilhante")
redTeam.AutoAssignable = true
redTeam.Name = "Equipe Vermelha"
redTeam.Parent = Teams

local blueTeam = Instance.new("Team")
blueTeam.TeamColor = BrickColor.new("Azul brilhante")
blueTeam.AutoAssignable = true
blueTeam.Name = "Equipe Azul"
blueTeam.Parent = Teams

-- começa a contar o número de jogadores em cada equipe
local numberRed, numberBlue = 0, 0

local function playerAdded(team)
	-- aumenta a contagem da equipe em 1
	if team == redTeam then
		numberRed = numberRed + 1
	elseif team == blueTeam then
		numberBlue = numberBlue + 1
	end
end

local function playerRemoved(team)
	-- diminui a contagem da equipe em 1
	if team == redTeam then
		numberRed = numberRed - 1
	elseif team == blueTeam then
		numberBlue = numberBlue - 1
	end

	-- verifica se as equipes estão desequilibradas
	local bigTeam, smallTeam = nil, nil
	if (numberRed - numberBlue) > 2 then
		bigTeam = redTeam
		smallTeam = blueTeam
	elseif (numberBlue - numberRed) > 2 then
		bigTeam = blueTeam
		smallTeam = redTeam
	end

	if bigTeam then
		-- escolhe um jogador aleatório
		local playerList = bigTeam:GetPlayers()
		local player = playerList[math.random(1, #playerList)]

		-- verifica se o jogador existe
		if player then
			-- muda a equipe do jogador
			player.TeamColor = smallTeam.TeamColor
			-- ressuscita o jogador
			player:LoadCharacterAsync()
		end
	end
end

-- escuta adições / remoções de jogadores
blueTeam.PlayerAdded:Connect(function(_player)
	playerAdded(blueTeam)
end)

blueTeam.PlayerRemoved:Connect(function(_player)
	playerRemoved(blueTeam)
end)

redTeam.PlayerAdded:Connect(function(_player)
	playerAdded(redTeam)
end)

redTeam.PlayerRemoved:Connect(function(_player)
	playerRemoved(redTeam)
end)

Verificação de Kill em Equipe

local Players = game:GetService("Players")

function checkTeamKill(playerAttack, playerVictim)
	-- Verifica se o jogador que ataca está em equipe diferente do jogador que é a vítima
	if playerAttack.Team ~= playerVictim.Team or playerAttack.Neutral or playerVictim.Neutral then
		return false
	end
	return true
end

local players = Players:GetPlayers()

-- Verifica se há kill em equipe entre os dois jogadores
checkTeamKill(players[1], players[2])

Porta Somente para a Equipe

local Players = game:GetService("Players")

local door = Instance.new("Part")
door.Anchored = true
door.Size = Vector3.new(7, 10, 1)
door.Position = Vector3.new(0, 5, 0)
door.Parent = workspace

local debounce = false

door.Touched:Connect(function(hit)
	if not debounce then
		debounce = true
		if hit then
			local player = Players:GetPlayerFromCharacter(hit.Parent)
			if player and player.TeamColor == BrickColor.new("Bright red") then
				door.Transparency = 0.5
				door.CanCollide = false
				task.wait(3)
				door.Transparency = 0
				door.CanCollide = true
			end
		end
		task.wait(0.5)
		debounce = false
	end
end)

Rebalance de Equipes com Integração de Partida

local Teams = game:GetService("Teams")
local Players = game:GetService("Players")
local SocialService = game:GetService("SocialService")

local redTeam = Instance.new("Team")
redTeam.Name = "Time Vermelho"
redTeam.TeamColor = BrickColor.Red()
redTeam.AutoAssignable = false
redTeam.Parent = Teams

local blueTeam = Instance.new("Team")
blueTeam.Name = "Time Azul"
blueTeam.TeamColor = BrickColor.Blue()
blueTeam.AutoAssignable = false
blueTeam.Parent = Teams

local function assignPlayerToTeam(player)
	local partyId = player.PartyId

	if partyId == "" then
		assignBalancedTeam(player)
		return
	end

	local teams = { redTeam, blueTeam }
	local matchingTeam = nil
	local partyPlayers = SocialService:GetPlayersByPartyId(partyId)

	for _, partyPlayer in partyPlayers do
		if partyPlayer ~= player and table.find(teams, partyPlayer.Team) then
			matchingTeam = partyPlayer.Team
			break
		end
	end

	if matchingTeam then
		player.Team = matchingTeam
		player.TeamColor = matchingTeam.TeamColor
	else
		assignBalancedTeam(player)
	end
end

function assignBalancedTeam(player)
	local redCount = #redTeam:GetPlayers()
	local blueCount = #blueTeam:GetPlayers()
	local chosenTeam = redCount <= blueCount and redTeam or blueTeam

	player.Team = chosenTeam
	player.TeamColor = chosenTeam.TeamColor
end

local function groupPlayersByParty()
	local seenPartyIds = {}
	local groupedPlayers = {}

	for _, player in Players:GetPlayers() do
		if player.PartyId == "" then
			table.insert(groupedPlayers, { player })
		elseif not table.find(seenPartyIds, player.PartyId) then
			table.insert(seenPartyIds, player.PartyId)

			local partyPlayers = SocialService:GetPlayersByPartyId(player.PartyId)
			table.insert(groupedPlayers, partyPlayers)
		end
	end

	return groupedPlayers
end

-- Chame esta função para reequilibrar os times
local function rebalanceTeams()
	local groups = groupPlayersByParty()

	table.sort(groups, function(a, b)
		return #a > #b
	end)

	for _, player in Players:GetPlayers() do
		player.Team = nil
	end

	for _, group in groups do
		local redCount = #redTeam:GetPlayers()
		local blueCount = #blueTeam:GetPlayers()

		local bestTeam
		if redCount <= blueCount then
			bestTeam = redTeam
		else
			bestTeam = blueTeam
		end

		for _, player in group do
			player.Team = bestTeam
			player.TeamColor = bestTeam.TeamColor
		end
	end

	for _, player in Players:GetPlayers() do
		player:LoadCharacterAsync()
	end
end

Players.PlayerAdded:Connect(function(player)
	assignPlayerToTeam(player)

	player:LoadCharacterAsync()

	player:GetPropertyChangedSignal("PartyId"):Connect(function()
		if player.PartyId ~= "" then
			assignPlayerToTeam(player)
		end
	end)
end)

Referência API

Propriedades

AutoAssignable

Ler Parallel

Recursos: Players

Team.AutoAssignable:boolean

Amostras de código

Reequilíbrio Simples de Equipes

local Teams = game:GetService("Teams")

-- cria duas equipes
local redTeam = Instance.new("Team")
redTeam.TeamColor = BrickColor.new("Vermelho brilhante")
redTeam.AutoAssignable = true
redTeam.Name = "Equipe Vermelha"
redTeam.Parent = Teams

local blueTeam = Instance.new("Team")
blueTeam.TeamColor = BrickColor.new("Azul brilhante")
blueTeam.AutoAssignable = true
blueTeam.Name = "Equipe Azul"
blueTeam.Parent = Teams

-- começa a contar o número de jogadores em cada equipe
local numberRed, numberBlue = 0, 0

local function playerAdded(team)
	-- aumenta a contagem da equipe em 1
	if team == redTeam then
		numberRed = numberRed + 1
	elseif team == blueTeam then
		numberBlue = numberBlue + 1
	end
end

local function playerRemoved(team)
	-- diminui a contagem da equipe em 1
	if team == redTeam then
		numberRed = numberRed - 1
	elseif team == blueTeam then
		numberBlue = numberBlue - 1
	end

	-- verifica se as equipes estão desequilibradas
	local bigTeam, smallTeam = nil, nil
	if (numberRed - numberBlue) > 2 then
		bigTeam = redTeam
		smallTeam = blueTeam
	elseif (numberBlue - numberRed) > 2 then
		bigTeam = blueTeam
		smallTeam = redTeam
	end

	if bigTeam then
		-- escolhe um jogador aleatório
		local playerList = bigTeam:GetPlayers()
		local player = playerList[math.random(1, #playerList)]

		-- verifica se o jogador existe
		if player then
			-- muda a equipe do jogador
			player.TeamColor = smallTeam.TeamColor
			-- ressuscita o jogador
			player:LoadCharacterAsync()
		end
	end
end

-- escuta adições / remoções de jogadores
blueTeam.PlayerAdded:Connect(function(_player)
	playerAdded(blueTeam)
end)

blueTeam.PlayerRemoved:Connect(function(_player)
	playerRemoved(blueTeam)
end)

redTeam.PlayerAdded:Connect(function(_player)
	playerAdded(redTeam)
end)

redTeam.PlayerRemoved:Connect(function(_player)
	playerRemoved(redTeam)
end)

AutoColorCharacters

Obsoleto

Score

Obsoleto

TeamColor

Ler Parallel

Recursos: Players

Team.TeamColor:BrickColor

Amostras de código

Porta Somente para a Equipe

local Players = game:GetService("Players")

local door = Instance.new("Part")
door.Anchored = true
door.Size = Vector3.new(7, 10, 1)
door.Position = Vector3.new(0, 5, 0)
door.Parent = workspace

local debounce = false

door.Touched:Connect(function(hit)
	if not debounce then
		debounce = true
		if hit then
			local player = Players:GetPlayerFromCharacter(hit.Parent)
			if player and player.TeamColor == BrickColor.new("Bright red") then
				door.Transparency = 0.5
				door.CanCollide = false
				task.wait(3)
				door.Transparency = 0
				door.CanCollide = true
			end
		end
		task.wait(0.5)
		debounce = false
	end
end)

Métodos

GetPlayers

Escrever Parallel

Recursos: Players

Team:GetPlayers():{Player}

Devolução

{Player}

Amostras de código

Obter Equipes do Teams

local Teams = game:GetService("Teams")

local teams = Teams:GetTeams()

for _, team in pairs(teams) do
	local players = team:GetPlayers()
	print("Equipe", team.Name, "tem", #players, "jogadores")
end

Eventos

PlayerAdded

Recursos: Players

Team.PlayerAdded(player:Player):RBXScriptSignal

Parâmetros

player:Player

Amostras de código

Reequilíbrio Simples de Equipes

local Teams = game:GetService("Teams")

-- cria duas equipes
local redTeam = Instance.new("Team")
redTeam.TeamColor = BrickColor.new("Vermelho brilhante")
redTeam.AutoAssignable = true
redTeam.Name = "Equipe Vermelha"
redTeam.Parent = Teams

local blueTeam = Instance.new("Team")
blueTeam.TeamColor = BrickColor.new("Azul brilhante")
blueTeam.AutoAssignable = true
blueTeam.Name = "Equipe Azul"
blueTeam.Parent = Teams

-- começa a contar o número de jogadores em cada equipe
local numberRed, numberBlue = 0, 0

local function playerAdded(team)
	-- aumenta a contagem da equipe em 1
	if team == redTeam then
		numberRed = numberRed + 1
	elseif team == blueTeam then
		numberBlue = numberBlue + 1
	end
end

local function playerRemoved(team)
	-- diminui a contagem da equipe em 1
	if team == redTeam then
		numberRed = numberRed - 1
	elseif team == blueTeam then
		numberBlue = numberBlue - 1
	end

	-- verifica se as equipes estão desequilibradas
	local bigTeam, smallTeam = nil, nil
	if (numberRed - numberBlue) > 2 then
		bigTeam = redTeam
		smallTeam = blueTeam
	elseif (numberBlue - numberRed) > 2 then
		bigTeam = blueTeam
		smallTeam = redTeam
	end

	if bigTeam then
		-- escolhe um jogador aleatório
		local playerList = bigTeam:GetPlayers()
		local player = playerList[math.random(1, #playerList)]

		-- verifica se o jogador existe
		if player then
			-- muda a equipe do jogador
			player.TeamColor = smallTeam.TeamColor
			-- ressuscita o jogador
			player:LoadCharacterAsync()
		end
	end
end

-- escuta adições / remoções de jogadores
blueTeam.PlayerAdded:Connect(function(_player)
	playerAdded(blueTeam)
end)

blueTeam.PlayerRemoved:Connect(function(_player)
	playerRemoved(blueTeam)
end)

redTeam.PlayerAdded:Connect(function(_player)
	playerAdded(redTeam)
end)

redTeam.PlayerRemoved:Connect(function(_player)
	playerRemoved(redTeam)
end)

PlayerRemoved

Recursos: Players

Team.PlayerRemoved(player:Player):RBXScriptSignal

Parâmetros

player:Player

Amostras de código

Reequilíbrio Simples de Equipes

local Teams = game:GetService("Teams")

-- cria duas equipes
local redTeam = Instance.new("Team")
redTeam.TeamColor = BrickColor.new("Vermelho brilhante")
redTeam.AutoAssignable = true
redTeam.Name = "Equipe Vermelha"
redTeam.Parent = Teams

local blueTeam = Instance.new("Team")
blueTeam.TeamColor = BrickColor.new("Azul brilhante")
blueTeam.AutoAssignable = true
blueTeam.Name = "Equipe Azul"
blueTeam.Parent = Teams

-- começa a contar o número de jogadores em cada equipe
local numberRed, numberBlue = 0, 0

local function playerAdded(team)
	-- aumenta a contagem da equipe em 1
	if team == redTeam then
		numberRed = numberRed + 1
	elseif team == blueTeam then
		numberBlue = numberBlue + 1
	end
end

local function playerRemoved(team)
	-- diminui a contagem da equipe em 1
	if team == redTeam then
		numberRed = numberRed - 1
	elseif team == blueTeam then
		numberBlue = numberBlue - 1
	end

	-- verifica se as equipes estão desequilibradas
	local bigTeam, smallTeam = nil, nil
	if (numberRed - numberBlue) > 2 then
		bigTeam = redTeam
		smallTeam = blueTeam
	elseif (numberBlue - numberRed) > 2 then
		bigTeam = blueTeam
		smallTeam = redTeam
	end

	if bigTeam then
		-- escolhe um jogador aleatório
		local playerList = bigTeam:GetPlayers()
		local player = playerList[math.random(1, #playerList)]

		-- verifica se o jogador existe
		if player then
			-- muda a equipe do jogador
			player.TeamColor = smallTeam.TeamColor
			-- ressuscita o jogador
			player:LoadCharacterAsync()
		end
	end
end

-- escuta adições / remoções de jogadores
blueTeam.PlayerAdded:Connect(function(_player)
	playerAdded(blueTeam)
end)

blueTeam.PlayerRemoved:Connect(function(_player)
	playerRemoved(blueTeam)
end)

redTeam.PlayerAdded:Connect(function(_player)
	playerAdded(redTeam)
end)

redTeam.PlayerRemoved:Connect(function(_player)
	playerRemoved(redTeam)
end)

Team