Team

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

Team 클래스는 Roblox 장소의 분파를 나타냅니다.팀의 유일한 유효한 부모는 Teams 서비스에 있습니다.팀은 개발자를 두 가지 거친 그룹으로 분할할 수 있는 유용한 기능의 범위를 제공합니다.

상자 밖으로 작동하는 기능
기능 개발자가 게임에 프로그래밍할 수 있는 기능.

내장 팀 행동 팀의 다음 기능은 기본적으로 존재하며 개발자가 사용자 지정 동작을 프로그래밍할 필요가 없습니다.

팀의 일부일 때, 플레이어의 캐릭터 위에 있는 이름 Model 이 색상이 Team.TeamColor로 변경됩니다.
변경하는 는 해당하는 팀으로 전환하게 만듭니다
기본 플레이어 목록을 사용할 때 사용자는 그룹화되어 팀으로 함께 표시됩니다
설정 Player.Neutral를 진실로 설정하면 Player가 팀과 분리되지만 Player.Team 또는 Player.TeamColor이 변경되지 않습니다.
게임에 Player 가 참여하면 플레이어가 가장 적은 팀에 Team.AutoAssignable 설정된 팀에 할당됩니다.자동으로 할당할 수 있는 팀이 없으면 Player.Neutral가 true로 설정됩니다
가 false로 설정되면, 와 일치하는 플레이어만 해당 에 생성될 수 있습니다.
When 가 true로 설정되면 플레이어의 가 캐릭터가 을 만질 때 변경됩니다.

선택적 확장 팀 행동 많은 개발자들이 자체 코드에서 팀에 다음 기능을 추가하기로 선택했습니다.

우호 사격을 방지하기 위해 무기 코드에서 검사를 구현합니다.
특정 팀만 사용할 수 있는 문이나 기타 기능에 검사를 구현하여 보안 강화
정기적으로 팀을 재할당하여 팀 균형 유지

코드 샘플

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)

요약

속성

AutoAssignable:boolean
병렬 읽기
이 속성은 조인할 때 에 자동으로 배치될지 여부를 결정합니다.여러 팀에서 이 속성이 true로 설정되어 있으면 Roblox는 Players가 추가될 때 팀을 평준화하려고 시도합니다.
TeamColor:BrickColor
병렬 읽기
이 속성은 Team의 색상을 설정합니다.팀의 멤버인 플레이어의 속성 Player.TeamColor 을 결정합니다.플레이어 목록과 플레이어 머리 위에 표시되는 색상도 결정합니다.

Instance에서 상속된 모든 항목 보기

Object에서 상속된 모든 항목 보기

메서드

GetPlayers():Instances
병렬 쓰기
에 할당된 목록의 리스트를 반환합니다 누구는 에 할당됩니다.A 는 그들의 1> 속성이 4> 및 7> 과 같은 경우 할당된 것으로 간주됩니다.

Instance에서 상속된 모든 항목 보기

Object에서 상속된 모든 항목 보기

이벤트

PlayerAdded(player : Player):RBXScriptSignal
Player에 할당되는 경우마다 발생하며, Team에 할당됩니다.플레이어가 할당된 것으로 간주되면 해당 Player.Team 속성이 Team 및 Player.Neutral와 같아야 합니다.
PlayerRemoved(player : Player):RBXScriptSignal
어떤 Player 가 어떤 Team 에서 제거될 때마다 발생합니다.이는 게임을 종료하거나, 트루로 설정되거나, 다른 팀에 가입하는 때문일 수 있습니다.

Instance에서 상속된 모든 항목 보기

Object에서 상속된 모든 항목 보기

속성

AutoAssignable

boolean

병렬 읽기

이 속성은 조인할 때 에 자동으로 배치될지 여부를 결정합니다.여러 팀에서 이 속성이 true로 설정되어 있으면 Roblox는 Players가 추가될 때 팀을 평준화하려고 시도합니다.

가 게임에 참여하면 플레이어가 가장 적은 세트로 설정된 에 할당됩니다.해당 팀이 없으면 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가 고유한 팀 색상을 갖도록 보장해야 합니다.

팀의 일부인 모든 플레이어의 이름이 팀의 TeamColor 속성으로 변경됩니다.플레이어 목록의 팀 제목 아래에도 배치됩니다.

코드 샘플

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

병렬 쓰기

에 할당된 목록의 리스트를 반환합니다 누구는 에 할당됩니다.A 는 그들의 1> 속성이 4> 및 7> 과 같은 경우 할당된 것으로 간주됩니다.

이 함수에는 플레이어 수를 계산하거나 Team 에서 모든 Player 에게 Team 에게 Tool 을 주는 등 여러 가지 용도가 있습니다.

반환

Instances

Players에 있는 배열입니다. 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 개체가 전달됩니다.예를 들어:

팀.플레이어추가:Connect(함수(플레이어) print(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)

PlayerRemoved

어떤 Player 가 어떤 Team 에서 제거될 때마다 발생합니다.이는 게임을 종료하거나, 트루로 설정되거나, 다른 팀에 가입하는 때문일 수 있습니다.

이 이벤트는 팀 특정이며 특정 가 떠날 때만 발생합니다.이 이벤트에 연결된 모든 함수는 팀을 떠난 플레이어의 Player 개체가 전달됩니다.예를 들어:

팀.플레이어 제거:Connect(함수(플레이어) print(player.Name.." 팀을 떠났습니다)) 끝)

매개 변수

player: Player

The 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에서 상속된 모든 항목 보기