クリエーター
​
エンジン API
リリースノート
学ぶ
エンジンクラス
Team

*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

概要
方法
GetPlayers():{Player}
継承されたメンバー
コードサンプル
シンプルチーム再バランス
local Teams = game:GetService("Teams")



-- 2つのチームを作成

local redTeam = Instance.new("Team")

redTeam.TeamColor = BrickColor.new("明るい赤")

redTeam.AutoAssignable = true

redTeam.Name = "赤チーム"

redTeam.Parent = Teams



local blueTeam = Instance.new("Team")

blueTeam.TeamColor = BrickColor.new("明るい青")

blueTeam.AutoAssignable = true

blueTeam.Name = "青チーム"

blueTeam.Parent = Teams



-- 各チームのプレイヤー数をカウントし始める

local numberRed, numberBlue = 0, 0



local function playerAdded(team)

	-- チームのカウントを1つ増やす

	if team == redTeam then

		numberRed = numberRed + 1

	elseif team == blueTeam then

		numberBlue = numberBlue + 1

	end

end



local function playerRemoved(team)

	-- チームのカウントを1つ減らす

	if team == redTeam then

		numberRed = numberRed - 1

	elseif team == blueTeam then

		numberBlue = numberBlue - 1

	end



	-- チームが不均衡かどうかを確認

	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

		-- ランダムなプレイヤーを選ぶ

		local playerList = bigTeam:GetPlayers()

		local player = playerList[math.random(1, #playerList)]



		-- プレイヤーが存在することを確認

		if player then

			-- プレイヤーのチームを変更

			player.TeamColor = smallTeam.TeamColor

			-- プレイヤーをリスポーン

			player:LoadCharacterAsync()

		end

	end

end



-- プレイヤーが追加/削除されるのをリッスン

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)
チームキルチェック
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])
チーム専用ドア
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)
パーティ統合によるチーム再バランス
local Teams = game:GetService("Teams")

local Players = game:GetService("Players")

local SocialService = game:GetService("SocialService")



local redTeam = Instance.new("Team")

redTeam.Name = "レッドチーム"

redTeam.TeamColor = BrickColor.Red()

redTeam.AutoAssignable = false

redTeam.Parent = Teams



local blueTeam = Instance.new("Team")

blueTeam.Name = "ブルーチーム"

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



-- この関数を呼び出してチームのバランスを再調整する

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)
APIリファレンス
プロパティ
AutoAssignable
並列読み取り
機能： Players
Team.AutoAssignable:boolean
コードサンプル
シンプルチーム再バランス
local Teams = game:GetService("Teams")



-- 2つのチームを作成

local redTeam = Instance.new("Team")

redTeam.TeamColor = BrickColor.new("明るい赤")

redTeam.AutoAssignable = true

redTeam.Name = "赤チーム"

redTeam.Parent = Teams



local blueTeam = Instance.new("Team")

blueTeam.TeamColor = BrickColor.new("明るい青")

blueTeam.AutoAssignable = true

blueTeam.Name = "青チーム"

blueTeam.Parent = Teams



-- 各チームのプレイヤー数をカウントし始める

local numberRed, numberBlue = 0, 0



local function playerAdded(team)

	-- チームのカウントを1つ増やす

	if team == redTeam then

		numberRed = numberRed + 1

	elseif team == blueTeam then

		numberBlue = numberBlue + 1

	end

end



local function playerRemoved(team)

	-- チームのカウントを1つ減らす

	if team == redTeam then

		numberRed = numberRed - 1

	elseif team == blueTeam then

		numberBlue = numberBlue - 1

	end



	-- チームが不均衡かどうかを確認

	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

		-- ランダムなプレイヤーを選ぶ

		local playerList = bigTeam:GetPlayers()

		local player = playerList[math.random(1, #playerList)]



		-- プレイヤーが存在することを確認

		if player then

			-- プレイヤーのチームを変更

			player.TeamColor = smallTeam.TeamColor

			-- プレイヤーをリスポーン

			player:LoadCharacterAsync()

		end

	end

end



-- プレイヤーが追加/削除されるのをリッスン

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
非推奨
Score
非推奨
TeamColor
並列読み取り
機能： Players
Team.TeamColor:BrickColor
コードサンプル
チーム専用ドア
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)
方法
GetPlayers
並列書き込み
機能： Players
Team:GetPlayers():{Player}
戻り値
{Player}
コードサンプル
チーム チームを取得
local Teams = game:GetService("Teams")



local teams = Teams:GetTeams()



for _, team in pairs(teams) do

	local players = team:GetPlayers()

	print("チーム", team.Name, "は", #players, "人のプレイヤーがいます")

end
イベント
PlayerAdded
機能： Players
Team.PlayerAdded(player:Player):RBXScriptSignal
パラメータ
player:Player
コードサンプル
シンプルチーム再バランス
local Teams = game:GetService("Teams")



-- 2つのチームを作成

local redTeam = Instance.new("Team")

redTeam.TeamColor = BrickColor.new("明るい赤")

redTeam.AutoAssignable = true

redTeam.Name = "赤チーム"

redTeam.Parent = Teams



local blueTeam = Instance.new("Team")

blueTeam.TeamColor = BrickColor.new("明るい青")

blueTeam.AutoAssignable = true

blueTeam.Name = "青チーム"

blueTeam.Parent = Teams



-- 各チームのプレイヤー数をカウントし始める

local numberRed, numberBlue = 0, 0



local function playerAdded(team)

	-- チームのカウントを1つ増やす

	if team == redTeam then

		numberRed = numberRed + 1

	elseif team == blueTeam then

		numberBlue = numberBlue + 1

	end

end



local function playerRemoved(team)

	-- チームのカウントを1つ減らす

	if team == redTeam then

		numberRed = numberRed - 1

	elseif team == blueTeam then

		numberBlue = numberBlue - 1

	end



	-- チームが不均衡かどうかを確認

	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

		-- ランダムなプレイヤーを選ぶ

		local playerList = bigTeam:GetPlayers()

		local player = playerList[math.random(1, #playerList)]



		-- プレイヤーが存在することを確認

		if player then

			-- プレイヤーのチームを変更

			player.TeamColor = smallTeam.TeamColor

			-- プレイヤーをリスポーン

			player:LoadCharacterAsync()

		end

	end

end



-- プレイヤーが追加/削除されるのをリッスン

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
機能： Players
Team.PlayerRemoved(player:Player):RBXScriptSignal
パラメータ
player:Player
コードサンプル
シンプルチーム再バランス
local Teams = game:GetService("Teams")



-- 2つのチームを作成

local redTeam = Instance.new("Team")

redTeam.TeamColor = BrickColor.new("明るい赤")

redTeam.AutoAssignable = true

redTeam.Name = "赤チーム"

redTeam.Parent = Teams



local blueTeam = Instance.new("Team")

blueTeam.TeamColor = BrickColor.new("明るい青")

blueTeam.AutoAssignable = true

blueTeam.Name = "青チーム"

blueTeam.Parent = Teams



-- 各チームのプレイヤー数をカウントし始める

local numberRed, numberBlue = 0, 0



local function playerAdded(team)

	-- チームのカウントを1つ増やす

	if team == redTeam then

		numberRed = numberRed + 1

	elseif team == blueTeam then

		numberBlue = numberBlue + 1

	end

end



local function playerRemoved(team)

	-- チームのカウントを1つ減らす

	if team == redTeam then

		numberRed = numberRed - 1

	elseif team == blueTeam then

		numberBlue = numberBlue - 1

	end



	-- チームが不均衡かどうかを確認

	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

		-- ランダムなプレイヤーを選ぶ

		local playerList = bigTeam:GetPlayers()

		local player = playerList[math.random(1, #playerList)]



		-- プレイヤーが存在することを確認

		if player then

			-- プレイヤーのチームを変更

			player.TeamColor = smallTeam.TeamColor

			-- プレイヤーをリスポーン

			player:LoadCharacterAsync()

		end

	end

end



-- プレイヤーが追加/削除されるのをリッスン

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)
©2026 Roblox Corporation。Roblox（ロブロックス）、RobloxロゴおよびPowering Imaginationは、米国並びにその他の国における登録商標および非登録商標です。
規約·プライバシー·アクセシビリティ·サポート
日本語