Team

顯示已棄用項目

*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

Team 類別代表 Roblox 空間置中的派系。團隊的唯一有效父親在 Teams 服務中。團隊提供一系列有用於開發人員的功能，可以分為兩個粗略的群組：

功能「從方塊子裡跳出」
功能開發者可以編寫到他們的遊戲中。

內建團隊行為以下團隊的功能預設存在，並不需要開發人員編寫任何自訂行為。

當屬於團隊時，玩家角色上的名稱 Model 會被染色到 Team.TeamColor
變更 Player.TeamColor 將導致 Player.Team 切換到相應的團隊 Team.TeamColor
當使用預設玩家列表時，使用者將被組合並顯示為團隊一起
將 Player.Neutral 設為真值會導致 Player 與團隊分離，但不會改變 Player.Team 或 Player.TeamColor
當 Player 加入遊戲時,它們將被分配給設置為Team.AutoAssignable設為真實的團隊,其中玩家最少。如果沒有可自動分配的團隊可用，Player.Neutral將設為真值
當 SpawnLocation.Neutral 設為 false 時，只有具有 Player.TeamColor 匹配 SpawnLocation.TeamColor 的玩家才能在該 SpawnLocation 上生成
當 SpawnLocation.AllowTeamChangeOnTouch 設為真實時，玩家的 Player.TeamColor 將變更為 SpawnLocation.TeamColor 當他們的角色觸碰到 SpawnLocation

可選擴展團隊行為許多開發人員選擇將以下功能添加到自己的代碼中的團隊。

在武器代碼中實現檢查，以防止友軍開觸發。
在門或其他允許只有特定團隊使用的功能中實施檢查
定期重新配置團隊以維持團隊餘額

範例程式碼

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)

概要

屬性

AutoAssignable:boolean
平行讀取
此屬性決定是否 Players 將自動放置在 Team 時加入。如果多個團隊設置此屬性為真，Roblox 將在 Players 添加時嘗試平衡團隊。
TeamColor:BrickColor
平行讀取
此屬性設置 Team 的顏色。決定團隊成員的玩家的 Player.TeamColor 屬性。也決定顯示在玩家列表和玩家頭上的顏色。

檢視繼承自Instance的所有項目

檢視繼承自Object的所有項目

方法

GetPlayers():Instances
平行寫入
返回一個列表 Players 被指派到 Team 的人。A Player 被視為已分配，如果它們的 Player.Team 屬性與 Team 和 Player.Neutral 相等，則為 false。

檢視繼承自Instance的所有項目

檢視繼承自Object的所有項目

活動

PlayerAdded(player : Player):RBXScriptSignal
每當有 Player 被指派到 Team 時，都會發生火災。如果玩家的 Player.Team 屬性與 Team 和 Player.Neutral 相等，則該玩家被視為已分配。
PlayerRemoved(player : Player):RBXScriptSignal
每當從 Player 移除一個 Team 時，都會發生火災。這可能是因為 Player 離開遊戲、Player.Neutral 設為真實或 Player 加入不同的團隊所造成的。

檢視繼承自Instance的所有項目

檢視繼承自Object的所有項目

屬性

AutoAssignable

boolean

平行讀取

此屬性決定是否 Players 將自動放置在 Team 時加入。如果多個團隊設置此屬性為真，Roblox 將在 Players 添加時嘗試平衡團隊。

當 Player 加入遊戲時,他們將被分配給Team 設為真實的最少玩家的Team.AutoAssignable 集合。如果沒有可用的團隊，Player.Neutral將設為真值。

使用此屬性時的注意事項將幫助平衡隊伍，當玩家被添加時不會做任何事情，當玩家被移除時將無法執行任何操作。因此，開發人員可能希望實現自己的團隊平衡系統。

範例程式碼

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

平行讀取

這個屬性設置了 Team 的顏色。決定了團隊伍成員的 Player.TeamColor 屬性。

Roblox 的預設團隊功能的大部分是基於團隊顏色，而不是名稱或對物件。例如，SpawnLocations 可以通過 SpawnLocation.TeamColor 被分配給一個團隊。因此，建議開發人員確保每個 Team 都有獨特的團隊顏色。

任何屬於團隊的玩家名稱將被更改為團隊的團隊顏色屬性。它們也會被放在玩家清單上的團隊標題下面。

範例程式碼

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)

檢視繼承自Instance的所有項目

檢視繼承自Object的所有項目

方法

GetPlayers

Instances

平行寫入

返回一個列表 Players 被指派到 Team 的人。A Player 被視為已分配，如果它們的 Player.Team 屬性與 Team 和 Player.Neutral 相等，則為 false。

此功能有許多潛在用途，包括在 Team 上計數玩家數量或在 Player 上給每個 Team 一個 Tool 。

Instances

在 Players 中的一個 array 在 Team 。

範例程式碼

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

檢視繼承自Instance的所有項目

檢視繼承自Object的所有項目

活動

PlayerAdded

每當有 Player 被指派到 Team 時，都會發生火災。如果玩家的 Player.Team 屬性與 Team 和 Player.Neutral 相等，則該玩家被視為已分配。

此事件是團隊特定的，只會在 Player 加入特定的 Team 時發射。連接到此事件的任何功能將傳送給加入團隊的玩家的 Player 對象。例如：

隊伍.PlayerAdded:Connect(功能(玩家) print(玩家.Name.."已加入團隊伍")結束)

參數

player: Player

被添加的 Player 。

範例程式碼

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

每當從 Player 移除一個 Team 時，都會發生火災。這可能是因為 Player 離開遊戲、Player.Neutral 設為真實或 Player 加入不同的團隊所造成的。

此事件是團隊特定的，只會在 Player 離開特定的 Team 時發射。與此事件連接的任何功能將傳送給離開團隊的玩家的 Player 對象。例如：

團隊.PlayerRemoved:Connect(功能(玩家layer) 玩家rint(player.Name.."已離開團隊")結束)

參數

player: Player

已移除 Player 。

範例程式碼

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)

檢視繼承自Instance的所有項目

檢視繼承自Object的所有項目