Team

Veraltete anzeigen

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Die Team-Klasse repräsentiert eine Fraktion in einem Roblox-Ort.Der einzige gültige Eltern für ein Team ist im Teams Dienst.Teams bieten eine Reihe von Funktionen, die für Entwickler nützlich sind, die in zwei grobe Gruppen unterteilt werden können:

Funktionen, die "aus der Schachtel" arbeiten
Funktionen, die Entwickler in ihr Spiel programmieren können.

Integriertes Teamverhalten Die folgende Funktionalität von Teams existiert standardmäßig und erfordert nicht, dass der Entwickler ein benutzerdefiniertes Verhalten programmiert.

Wenn ein Teil eines Teams, der Name über dem Charakter eines Spielers Model wird farbig, um die Team.TeamColor
Das Ändern von Player.TeamColor, wird dazu führen, dass Player.Team sich zum Team mit der entsprechenden Team.TeamColor wechselt
Wenn die Standard-Spielerliste verwendet wird, werden Benutzer in Gruppen zusammengefasst und als Team angezeigt
Die Einstellung Player.Neutral auf wahr wird dazu führen, dass die Player mit dem Team getrennt wird, aber sie wird nicht Player.Team oder Player.TeamColor ändern
Wenn sich ein Player einem Spiel anschließt, werden sie dem Team zugewiesen, das mit Team.AutoAssignable auf Wahr gesetzt wurde, das die wenigsten Spieler hat.Wenn keine automatisch zuzuweisende Team verfügbar ist, wird Player.Neutral auf wahr gesetzt
Wenn SpawnLocation.Neutral auf false gesetzt ist, können nur Spieler, deren Player.TeamColor Matches SpawnLocation.TeamColor sind, auf dieser SpawnLocation spawnen
Wenn SpawnLocation.AllowTeamChangeOnTouch auf wahr gesetzt wird, ändert sich das Player.TeamColor eines Spielers zu SpawnLocation.TeamColor, wenn sein Charakter das SpawnLocation berührt

Optionale erweiterte Teamverhaltensweisen Viele Entwickler wählten, die folgenden Funktionen zu Teams in ihrem eigenen Code hinzuzufügen.

Implementiere Überprüfungen im Waffencode, um freundliches Feuer zu verhindern.
Implementiere Prüfungen in Türen oder anderen Funktionen, die nur bestimmten Teams erlauben, sie zu verwenden
Teams periodisch neu zuweisen, um Teamausgleich zu gewährleisten

Code-Beispiele

This code sample includes a simple example of how to re-balance teams. When Team.AutoAssignable is set to true players will be added to Teams in a balanced fashion. However as Players leave the game this can lead to unbalanced teams as players are not reallocated. This code keeps track of the number of players in each team and, when players leave will check to see if the teams need re-balancing.

Simple Team Rebalance

local Teams = game:GetService("Teams")

-- create two teams
local redTeam = Instance.new("Team")
redTeam.TeamColor = BrickColor.new("Bright red")
redTeam.AutoAssignable = true
redTeam.Name = "Red Team"
redTeam.Parent = Teams

local blueTeam = Instance.new("Team")
blueTeam.TeamColor = BrickColor.new("Bright blue")
blueTeam.AutoAssignable = true
blueTeam.Name = "Blue Team"
blueTeam.Parent = Teams

-- start counting the number of players on each team
local numberRed, numberBlue = 0, 0

local function playerAdded(team)
	-- increase the team's count by 1
	if team == redTeam then
		numberRed = numberRed + 1
	elseif team == blueTeam then
		numberBlue = numberBlue + 1
	end
end

local function playerRemoved(team)
	-- decrease the team's count by 1
	if team == redTeam then
		numberRed = numberRed - 1
	elseif team == blueTeam then
		numberBlue = numberBlue - 1
	end

	-- check if the teams are unbalanced
	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
		-- pick a random player
		local playerList = bigTeam:GetPlayers()
		local player = playerList[math.random(1, #playerList)]

		-- check the player exists
		if player then
			-- change the player's team
			player.TeamColor = smallTeam.TeamColor
			-- respawn the player
			player:LoadCharacter()
		end
	end
end

-- listen for players being added / removed
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)

This code sample includes a quick function that can be added to weapons in a place to prevent them from team killing. It will return false when the two players are on different teams or if either of them is neutral.

Team Kill Check

local Players = game:GetService("Players")

function checkTeamKill(playerAttack, playerVictim)
	if playerAttack.Team ~= playerVictim.Team or playerAttack.Neutral or playerVictim.Neutral then
		return false
	end
	return true
end

local players = Players:GetPlayers()

checkTeamKill(players[1], players[2])

The following code sample will create a door in the Workspace that can only be walked through by Players on the Bright red team.

Team Only Door

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)

This code sample demonstrates how to assign players to Teams based on their Player.PartyId using the SocialService:GetPlayersByPartyId() method. When a player joins the experience, the script checks whether they're part of a party. If so, it attempts to assign them to the same team as other party members. If no match is found or the player isn't in a party, they're placed on the team with fewer members to maintain balance.

Team Rebalance with Party Integration

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

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

local blueTeam = Instance.new("Team")
blueTeam.Name = "Blue Team"
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

-- Call this function to rebalance teams
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:LoadCharacter()
	end
end

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

	player:LoadCharacter()

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

Zusammenfassung

Eigenschaften

AutoAssignable:boolean
Parallel lesen
Diese Eigenschaft bestimmt, ob Players beim Beitreten automatisch auf die Team platziert wird.Wenn mehrere Teams diese Eigenschaft auf wahr gesetzt haben, wird Roblox versuchen, die Teams auszugleichen, wenn Players hinzugefügt werden.
TeamColor:BrickColor
Parallel lesen
Diese Eigenschaft legt die Farbe des Team fest.Bestimmt die Player.TeamColor Eigenschaft von Spielern, die Mitglied des Teams sind.Bestimmt auch die Farbe, die auf der Spielerliste und über den Köpfen der Spieler angezeigt wird.

Alles Geerbte von Instance anzeigen

Alles Geerbte von Object anzeigen

Methoden

GetPlayers():Instances
Parallel schreiben
Gibt eine Liste von Players zurück, die dem Team zugewiesen sind.Ein Player wird als zugewiesen betrachtet, wenn seine Player.Team Eigenschaft dem Team und Player.Neutral gleich ist und false ist.

Alles Geerbte von Instance anzeigen

Alles Geerbte von Object anzeigen

Ereignisse

PlayerAdded(player : Player):RBXScriptSignal
Feuert immer dann, wenn ein Player dem Team zugewiesen wird.Ein Spieler wird als zugewiesen betrachtet, wenn seine Player.Team Eigenschaft gleich der Team und Player.Neutral ist falsch.
PlayerRemoved(player : Player):RBXScriptSignal
Feuert immer dann, wenn ein Player von einem Team entfernt wird.Dies kann darauf zurückzuführen sein, dass Player das Spiel verlässt, Player.Neutral auf wahr gesetzt wird oder Player einem anderen Team beitritt.

Alles Geerbte von Instance anzeigen

Alles Geerbte von Object anzeigen

Eigenschaften

AutoAssignable

boolean

Parallel lesen

Diese Eigenschaft bestimmt, ob Players beim Beitreten automatisch auf die Team platziert wird.Wenn mehrere Teams diese Eigenschaft auf wahr gesetzt haben, wird Roblox versuchen, die Teams auszugleichen, wenn Players hinzugefügt werden.

Wenn ein einem Spiel beitritt, wird es dem zugewiesen, mit dem die wenigsten Spieler eingestellt sind.Wenn kein solches Team verfügbar ist, wird Player.Neutral auf wahr gesetzt.

Beachten Sie, während Sie diese Eigenschaft verwenden, wird helfen, Teams auszugleichen, wenn Spieler hinzugefügt werden, wird nichts tun, wenn Spieler entfernt werden.Aus diesem Grund möchten Entwickler möglicherweise ihr eigenes Teamausgleichssystem implementieren.

Code-Beispiele

Simple Team Rebalance

local Teams = game:GetService("Teams")

-- create two teams
local redTeam = Instance.new("Team")
redTeam.TeamColor = BrickColor.new("Bright red")
redTeam.AutoAssignable = true
redTeam.Name = "Red Team"
redTeam.Parent = Teams

local blueTeam = Instance.new("Team")
blueTeam.TeamColor = BrickColor.new("Bright blue")
blueTeam.AutoAssignable = true
blueTeam.Name = "Blue Team"
blueTeam.Parent = Teams

-- start counting the number of players on each team
local numberRed, numberBlue = 0, 0

local function playerAdded(team)
	-- increase the team's count by 1
	if team == redTeam then
		numberRed = numberRed + 1
	elseif team == blueTeam then
		numberBlue = numberBlue + 1
	end
end

local function playerRemoved(team)
	-- decrease the team's count by 1
	if team == redTeam then
		numberRed = numberRed - 1
	elseif team == blueTeam then
		numberBlue = numberBlue - 1
	end

	-- check if the teams are unbalanced
	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
		-- pick a random player
		local playerList = bigTeam:GetPlayers()
		local player = playerList[math.random(1, #playerList)]

		-- check the player exists
		if player then
			-- change the player's team
			player.TeamColor = smallTeam.TeamColor
			-- respawn the player
			player:LoadCharacter()
		end
	end
end

-- listen for players being added / removed
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)

TeamColor

BrickColor

Parallel lesen

Diese Eigenschaft legt die Farbe des Team fest. Legt die Eigenschaft Player.TeamColor von Spielern fest, die Mitglied des Teams sind.

Viel der Standard-Teamfunktionalität von Roblox basiert auf der Teamfarbe, nicht auf dem Namen oder dem Objekt.Zum Beispiel kann SpawnLocations einem Team über SpawnLocation.TeamColor zugewiesen werden.Aus diesem Grund wird empfohlen, dass Entwickler sicherstellen, dass jede Team ein einzigartiges Teamfarbe hat.

Jeder Spieler, der Teil eines Teams ist, wird seinen Namensfarbe auf die Teamfarbe des Teams ändern.Sie werden auch unter dem Team-Kopf auf der Spielerliste platziert.

Code-Beispiele

The following code sample will create a door in the Workspace that can only be walked through by Players on the Bright red team.

Team Only Door

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)

Alles Geerbte von Instance anzeigen

Alles Geerbte von Object anzeigen

Methoden

GetPlayers

Instances

Parallel schreiben

Gibt eine Liste von Players zurück, die dem Team zugewiesen sind.Ein Player wird als zugewiesen betrachtet, wenn seine Player.Team Eigenschaft dem Team und Player.Neutral gleich ist und false ist.

Diese Funktion hat eine Reihe von möglichen Verwendungen, einschließlich der Zählung der Anzahl der Spieler auf einem Team oder der Vergabe von jedem Player auf einem Team einem Tool .

Rückgaben

Instances

Ein Array von Players in der Team.

Code-Beispiele

The example below prints the number of players on each Team.

Teams GetTeams

local Teams = game:GetService("Teams")

local teams = Teams:GetTeams()

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

Alles Geerbte von Instance anzeigen

Alles Geerbte von Object anzeigen

Ereignisse

PlayerAdded

Feuert immer dann, wenn ein Player dem Team zugewiesen wird.Ein Spieler wird als zugewiesen betrachtet, wenn seine Player.Team Eigenschaft gleich der Team und Player.Neutral ist falsch.

Dieses Ereignis ist teamspezifisch und wird nur abgefeuert, wenn ein Player sich dem spezifischen Team anschließt.Jede Funktion, die mit diesem Ereignis verbunden ist, wird das Player Objekt des Spielers übergeben, der dem Team beigetreten ist.Zum Beispiel:

Team.PlayerAdded:Connect(function(player) print(player.Name.." ist dem Team beigetreten") end)

Parameter

player: Player

Das Player, das hinzugefügt wurde.

Code-Beispiele

Simple Team Rebalance

local Teams = game:GetService("Teams")

-- create two teams
local redTeam = Instance.new("Team")
redTeam.TeamColor = BrickColor.new("Bright red")
redTeam.AutoAssignable = true
redTeam.Name = "Red Team"
redTeam.Parent = Teams

local blueTeam = Instance.new("Team")
blueTeam.TeamColor = BrickColor.new("Bright blue")
blueTeam.AutoAssignable = true
blueTeam.Name = "Blue Team"
blueTeam.Parent = Teams

-- start counting the number of players on each team
local numberRed, numberBlue = 0, 0

local function playerAdded(team)
	-- increase the team's count by 1
	if team == redTeam then
		numberRed = numberRed + 1
	elseif team == blueTeam then
		numberBlue = numberBlue + 1
	end
end

local function playerRemoved(team)
	-- decrease the team's count by 1
	if team == redTeam then
		numberRed = numberRed - 1
	elseif team == blueTeam then
		numberBlue = numberBlue - 1
	end

	-- check if the teams are unbalanced
	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
		-- pick a random player
		local playerList = bigTeam:GetPlayers()
		local player = playerList[math.random(1, #playerList)]

		-- check the player exists
		if player then
			-- change the player's team
			player.TeamColor = smallTeam.TeamColor
			-- respawn the player
			player:LoadCharacter()
		end
	end
end

-- listen for players being added / removed
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

Feuert immer dann, wenn ein Player von einem Team entfernt wird.Dies kann darauf zurückzuführen sein, dass Player das Spiel verlässt, Player.Neutral auf wahr gesetzt wird oder Player einem anderen Team beitritt.

Dieses Ereignis ist teamspezifisch und wird nur abgefeuert, wenn ein Player das spezifische Team verlässt.Jede Funktion, die mit diesem Ereignis verbunden ist, wird das Player Objekt des Spielers übergeben, der das Team verlassen hat.Zum Beispiel:

Team.PlayerRemoved:Connect(function(player) druck(player.Name.." hat das Team verlassen") end)

Parameter

player: Player

Die Player entfernt.

Code-Beispiele

Simple Team Rebalance

local Teams = game:GetService("Teams")

-- create two teams
local redTeam = Instance.new("Team")
redTeam.TeamColor = BrickColor.new("Bright red")
redTeam.AutoAssignable = true
redTeam.Name = "Red Team"
redTeam.Parent = Teams

local blueTeam = Instance.new("Team")
blueTeam.TeamColor = BrickColor.new("Bright blue")
blueTeam.AutoAssignable = true
blueTeam.Name = "Blue Team"
blueTeam.Parent = Teams

-- start counting the number of players on each team
local numberRed, numberBlue = 0, 0

local function playerAdded(team)
	-- increase the team's count by 1
	if team == redTeam then
		numberRed = numberRed + 1
	elseif team == blueTeam then
		numberBlue = numberBlue + 1
	end
end

local function playerRemoved(team)
	-- decrease the team's count by 1
	if team == redTeam then
		numberRed = numberRed - 1
	elseif team == blueTeam then
		numberBlue = numberBlue - 1
	end

	-- check if the teams are unbalanced
	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
		-- pick a random player
		local playerList = bigTeam:GetPlayers()
		local player = playerList[math.random(1, #playerList)]

		-- check the player exists
		if player then
			-- change the player's team
			player.TeamColor = smallTeam.TeamColor
			-- respawn the player
			player:LoadCharacter()
		end
	end
end

-- listen for players being added / removed
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)

Alles Geerbte von Instance anzeigen

Alles Geerbte von Object anzeigen

Team

Code-Beispiele

Zusammenfassung

Eigenschaften

Methoden

Ereignisse

Eigenschaften

AutoAssignable

Code-Beispiele

TeamColor

Code-Beispiele

Methoden

GetPlayers

Rückgaben

Code-Beispiele

Ereignisse

PlayerAdded

Parameter

Code-Beispiele

PlayerRemoved

Parameter

Code-Beispiele

Auf dieser Seite