요약
텔레포트 패드를 만들려면 ServerScriptService에 Script를 넣으세요. 이 스크립트는 패드의 Touched 이벤트를 듣고, Players:GetPlayerFromCharacter로 플레이어를 찾은 뒤, character:PivotTo()로 캐릭터 전체를 도착 패드 바로 앞, 패드를 등진 위치로 옮깁니다. 도착 패드가 곧바로 되돌려 보내지 않도록 플레이어마다 2초 정도의 쿨다운을 둡니다. 플레이어를 내 게임의 다른 플레이스로 보내려면 서버 Script에서 pcall 안에 TeleportService:TeleportAsync(placeId, { player })를 호출하세요. 이것은 Studio가 아니라 게시된 게임에서만 작동합니다.
PivotTo로 캐릭터 전체를 옮기세요.HumanoidRootPart.Position에 값을 넣으면 Position을 설정할 때 Roblox가 연결(joint)을 갱신하기 때문에 루트 파트가 몸의 나머지 부분에서 떨어져 나갑니다.- 텔레포트 메뉴는 서버에 위치가 아니라 목적지의 이름을 보내야 합니다. 서버는 누군가를 옮기기 전에 이름, 쿨다운, 그리고 잠금 해제 규칙을 확인합니다.
TeleportService:Teleport()는 더 이상 사용되지 않으며(deprecated) 클라이언트에서 작동합니다. 서버에서TeleportAsync를 쓰고,pcall로 감싸고, 다시 시도하고,TeleportInitFailed를 처리하세요.
이 페이지의 내용
두 가지 텔레포트
Roblox 게임에서 텔레포트는 세 가지를 뜻할 수 있습니다. 맵을 가로질러 옮겨 주는 패드, 이동할 수 있는 지점 메뉴, 또는 다른 레벨로 가는 포털입니다. 앞의 두 가지는 플레이어가 이미 있는 서버 안에서 캐릭터를 옮깁니다. 세 번째는 플레이어를 자체 서버에서 돌아가는 내 게임의 다른 플레이스로 보냅니다. 서로 다른 API를 쓰므로 어떤 것이 필요한지 알아 두면 좋습니다.
| 같은 서버 안에서 | 내 게임의 다른 플레이스로 | |
|---|---|---|
| 호출 | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| 용도 | 텔레포트 패드, 텔레포트 메뉴, 로비에서 아레나로 플레이어 옮기기 | 다른 레벨로 가는 포털, 플레이어를 던전이나 매치용 별도 플레이스로 보내는 로비 |
| 실행 위치 | 서버 Script | 서버 Script에서만. 클라이언트의 Teleport()는 더 이상 사용되지 않습니다. |
| Studio 플레이테스트에서 작동 | 예 | 아니요. Roblox의 TeleportService는 Studio 플레이테스트를 지원하지 않으므로 게시된 게임에서 테스트합니다. |
| 플레이어에게 보이는 것 | 맵을 가로지르는 이동. 그 지역을 먼저 불러와야 하면 최대 2초가 걸릴 수 있습니다 | Roblox 로딩 화면, 그다음 다른 플레이스 |
| 코인, 아이템 등 데이터 | 그대로 유지됩니다 | Roblox가 플레이어의 로컬 데이터를 초기화하므로, 중요한 것은 모두 다른 플레이스에서 데이터 저장소로부터 불러와야 합니다 |
이 가이드에서는 세 가지를 모두 서버 Script 하나에 모으므로, 규칙 하나로 게임의 모든 텔레포트를 다룹니다. 결정은 서버가 하고, 플레이어마다 쿨다운이 따로 있으며, 플레이어의 기기는 어느 지점으로 가고 싶은지만 알립니다.
| 요소 | 위치 | 하는 일 |
|---|---|---|
PadA와 PadB가 든 Folder TeleportPads | Workspace | 패드 두 개. 각 패드의 Destination 속성이 플레이어를 보낼 패드의 이름입니다. |
Folder TeleportSpots | Workspace | 메뉴 목록의 지점마다 파트 하나. WinsNeeded 속성이 지점을 잠급니다. |
Folder PlacePortals | Workspace | 포털 파트. 각 포털의 PlaceId 속성이 플레이어를 보낼 플레이스입니다. |
Script Teleporters | ServerScriptService | 세 가지 텔레포트를 모두 처리하고 리모트 두 개를 만듭니다. 텔레포트가 일어날 수 있는 유일한 곳입니다. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | Teleport 버튼과 지점 목록을 그리고, 플레이어가 고른 지점의 이름을 보냅니다. |
RemoteFunction GetTeleportSpots와 RemoteEvent TeleportRequest | ReplicatedStorage (Teleporters가 만듦) | 앞의 것은 메뉴에 지점 목록을 돌려줍니다. 뒤의 것은 고른 이름을 서버로 전달합니다. |
Workspace
TeleportPads Folder new
PadA Part new
PadB Part new
TeleportSpots Folder new
Spawn Part new
Lake Part new
Castle Part new
PlacePortals Folder new
DungeonPortal Part new
ServerScriptService
Teleporters Script new
StarterPlayer
StarterPlayerScripts
TeleportMenu LocalScript new
1단계: 텔레포트 패드 두 개 만들기
- Explorer에서 Workspace에 마우스를 올리고 + 버튼을 눌러 Folder를 넣으세요. 폴더 이름은
TeleportPads로 하세요. 스크립트는 정확히 이 이름을 찾습니다. - 폴더 안에 Part 두 개를 넣고 이름을
PadA와PadB로 하세요. 각각 6 x 1 x 6 스터드 정도의 납작한 판으로 만들고, 서로 떨어진 곳의 바닥에 놓으세요. Properties 창에서 Anchored를 체크하고, CanCollide와 CanTouch는 켜 둔 채로, 플레이어가 알아볼 수 있게 밝은 색과 Neon 재질을 지정하세요. - PadA를 선택하고 Properties 창을 Attributes 섹션까지 내린 뒤 +를 누르세요. 이름에
Destination을 입력하고 타입으로 String을 고른 뒤 Save를 누르고, 값을PadB로 정하세요. PadB에서도 같은 작업을 하되 값은PadA로 하세요. - 각 패드의 앞면이 빈 바닥을 향하도록 돌리세요. 플레이어는 도착 패드 앞면에서 3스터드 앞에 패드를 등지고 나타나므로, 그쪽에 몇 스터드의 빈 바닥을 남겨 두세요. 어느 면이 앞면인지 보려면 패드를 마우스 오른쪽 버튼으로 클릭하고 Show Orientation Indicator를 고르세요. 파란 선이 앞면을 표시합니다. 그 선이 플레이어가 걸어 나가야 할 방향을 가리킬 때까지 Rotate 도구로 패드를 돌리세요.
플레이어가 패드 위가 아니라 패드 옆에 도착하는 것은 의도된 것입니다. Roblox의 debounce 페이지에 따르면 Touched는 한 번 닿을 때 연달아 여러 번 발생하므로, 다른 패드 바로 위에 나타난 플레이어는 쿨다운이 끝나자마자 그 패드를 다시 작동시켜 맵 반대편으로 되돌아가게 됩니다.
패드가 두 개로 제한되지는 않습니다. 패드의 Destination은 TeleportPads 안의 어떤 파트든 가리킬 수 있으므로, 패드 세 개가 플레이어를 순환시키게 만들 수도 있습니다. 한 방향 패드를 만들려면 자기 Destination이 없는 TeleportPads 안의 파트를 가리키게 하세요. 그런 파트는 플레이어를 받기만 하고 아무도 다른 곳으로 보내지 않습니다.
2단계: 텔레포트 스크립트 추가하기
ServerScriptService에 마우스를 올리고 Script를 넣은 뒤 이름을 Teleporters로 하고 아래 코드를 붙여 넣으세요. 지금은 패드만 처리하지만 다음 단계들을 마치면 메뉴와 포털도 처리하므로 한 번만 추가하면 됩니다. 맨 위의 설정은 바꾸라고 만들어 둔 줄입니다.
-- ServerScriptService 안의 Script, 이름은 Teleporters.
-- 모든 텔레포트는 여기, 서버에서 결정됩니다:
-- 1. 패드: Workspace.TeleportPads 안의 파트를 밟으면 그 파트의 Destination 속성에
-- 적힌 파트로 옮겨집니다.
-- 2. 메뉴: LocalScript TeleportMenu가 Workspace.TeleportSpots의 지점을
-- 이름으로 요청합니다. 서버는 이름, 쿨다운, 그 지점에 필요한 Wins를 확인합니다.
-- 3. 포털: Workspace.PlacePortals 안의 파트를 밟으면 그 파트의 PlaceId 속성에 적힌
-- 플레이스(이 게임의 다른 플레이스)로 보내집니다.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local RunService = game:GetService("RunService")
local TeleportService = game:GetService("TeleportService")
local PAD_COOLDOWN_SECONDS = 2 -- 텔레포트 후 패드가 그 플레이어를 무시하는 시간
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- 도착 패드 앞으로 띄우는 스터드 수, 플레이어가 패드 옆에 도착하도록
local PLACE_ATTEMPTS = 3
local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")
-- 이 스크립트가 리모트 두 개를 직접 만들므로 손으로 추가하지 마세요
local getSpots = Instance.new("RemoteFunction")
getSpots.Name = "GetTeleportSpots"
getSpots.Parent = ReplicatedStorage
local teleportRequest = Instance.new("RemoteEvent")
teleportRequest.Name = "TeleportRequest"
teleportRequest.Parent = ReplicatedStorage
local lastTeleport: { [Player]: number } = {}
local warnedPads: { [Instance]: boolean } = {}
local leavingForPlace: { [Player]: boolean } = {}
local function playerFromHit(otherPart: BasePart): Player?
local character = otherPart:FindFirstAncestorOfClass("Model")
return if character then Players:GetPlayerFromCharacter(character) else nil
end
local function onCooldown(player: Player, seconds: number): boolean
return os.clock() - (lastTeleport[player] or -math.huge) < seconds
end
-- 서 있는 캐릭터의 루트 파트가 바닥에서 얼마나 높이 있는지.
-- Roblox의 Humanoid.HipHeight 레퍼런스에 있는 공식입니다(R6 리그는 다리 높이를 더합니다).
local function rootHeight(character: Model, humanoid: Humanoid, rootPart: BasePart): number
local height = rootPart.Size.Y / 2 + humanoid.HipHeight
if humanoid.RigType == Enum.HumanoidRigType.R6 then
local leg = character:FindFirstChild("Left Leg")
if leg and leg:IsA("BasePart") then
height += leg.Size.Y
end
end
return height
end
local function teleportTo(player: Player, destination: BasePart, besidePad: boolean)
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
local rootPart = humanoid and humanoid.RootPart
if not (character and humanoid and rootPart) or humanoid.Health <= 0 then
return
end
lastTeleport[player] = os.clock() -- 기다리기 전에 기록해서 두 번째 접촉이 두 번째 텔레포트를 시작하지 않게 합니다
-- 목적지의 앞면이 향하는 쪽을 바라봅니다(수평, 기울기 없음)
local facing = destination.CFrame.LookVector * Vector3.new(1, 0, 1)
if facing.Magnitude < 0.01 then
facing = Vector3.new(0, 0, -1)
end
facing = facing.Unit
-- 윗면 위에 섭니다. 캐릭터의 pivot은 루트 파트이므로 서 있는 높이만큼 올립니다.
-- 패드는 플레이어를 몇 스터드 앞에 내려놓습니다. 패드 위에 서 있는
-- 플레이어는 다음 걸음에 패드를 다시 작동시키기 때문입니다.
local lift = destination.Size.Y / 2 + rootHeight(character, humanoid, rootPart)
local top = destination.Position + destination.CFrame.UpVector * lift
if besidePad then
top += facing * (destination.Size.Z / 2 + PAD_ARRIVAL_GAP)
end
local target = CFrame.lookAlong(top, facing)
-- instance streaming이 켜져 있으면 목적지 주변 지역을 먼저 불러옵니다(최대 2초)
pcall(function()
player:RequestStreamAroundAsync(target.Position, 2)
end)
if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
return -- 지역을 불러오는 동안 나갔거나, 리스폰했거나, 죽었습니다
end
-- 앉아 있는 캐릭터는 좌석에 용접되어 있어서, 옮기면 좌석도 함께 끌려갑니다.
-- SeatWeld를 먼저 없애면 캐릭터가 좌석에서 풀려납니다.
local seat = humanoid.SeatPart
if seat then
local seatWeld = seat:FindFirstChild("SeatWeld")
if seatWeld then
seatWeld:Destroy()
end
end
character:PivotTo(target)
-- 도착하면 쿨다운을 다시 시작합니다. 위의 미리 불러오기는 최대 2초가 걸릴 수 있고,
-- 플레이어가 도착한 패드가 곧바로 되돌려 보내면 안 됩니다
lastTeleport[player] = os.clock()
player:SetAttribute("MovementCheckSkip", true) -- 속도 검사 스크립트가 있다면 그 스크립트용
end
-- 1. 패드
if padFolder then
for _, pad in padFolder:GetChildren() do
if pad:IsA("BasePart") then
pad.Touched:Connect(function(otherPart: BasePart)
local player = playerFromHit(otherPart)
local destinationName = pad:GetAttribute("Destination")
if not player or typeof(destinationName) ~= "string" or onCooldown(player, PAD_COOLDOWN_SECONDS) then
return
end
local destination = padFolder:FindFirstChild(destinationName)
if destination and destination:IsA("BasePart") then
teleportTo(player, destination, true)
elseif not warnedPads[pad] then
warnedPads[pad] = true -- 닿을 때마다가 아니라 한 번만 경고합니다
warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
end
end)
end
end
end
-- 2. 메뉴: 지점 목록, 그다음 이름으로 요청
local function winsOf(player: Player): number
local leaderstats = player:FindFirstChild("leaderstats")
local wins = leaderstats and leaderstats:FindFirstChild("Wins")
return if wins and wins:IsA("IntValue") then wins.Value else 0
end
local function winsNeeded(spot: Instance): number
local value = spot:GetAttribute("WinsNeeded")
return if typeof(value) == "number" then value else 0
end
getSpots.OnServerInvoke = function(_player: Player)
local list = {}
if spotFolder then
for _, spot in spotFolder:GetChildren() do
if spot:IsA("BasePart") then
table.insert(list, { name = spot.Name, winsNeeded = winsNeeded(spot) })
end
end
end
table.sort(list, function(a, b)
if a.winsNeeded ~= b.winsNeeded then
return a.winsNeeded < b.winsNeeded
end
return a.name < b.name -- Wins가 같으면 알파벳순, 순서가 절대 바뀌지 않도록
end)
return list
end
teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
-- 클라이언트는 이름만 보냅니다. 클라이언트가 보낸 위치나 CFrame은 절대 받지 마세요.
if typeof(spotName) ~= "string" or #spotName > 50 or not spotFolder then
return
end
if onCooldown(player, MENU_COOLDOWN_SECONDS) then
return
end
local spot = spotFolder:FindFirstChild(spotName)
if not (spot and spot:IsA("BasePart")) then
return
end
if winsOf(player) < winsNeeded(spot) then
return -- 이 플레이어에게는 잠겨 있습니다
end
teleportTo(player, spot, false)
end)
-- 3. 이 게임의 다른 플레이스로 가는 포털
local function sendToPlace(player: Player, placeId: number)
if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
return -- 이미 가는 중이거나 1초 전에 텔레포트에 닿았습니다
end
lastTeleport[player] = os.clock()
if RunService:IsStudio() then
print(`Teleporters: would send {player.Name} to place {placeId}. Place teleports only work in the published game.`)
return
end
leavingForPlace[player] = true
for attempt = 1, PLACE_ATTEMPTS do
local ok, err = pcall(function()
TeleportService:TeleportAsync(placeId, { player })
end)
if ok then
return
end
warn(`Teleporters: teleport attempt {attempt} for {player.Name} failed: {err}`)
task.wait(2)
end
leavingForPlace[player] = nil -- 포기합니다. 포털에 다시 닿으면 다시 시도합니다
end
-- 텔레포트는 시작된 뒤에도 실패할 수 있습니다. 플레이어는 여기 남아 다시 시도할 수 있습니다.
TeleportService.TeleportInitFailed:Connect(function(player: Player, result: Enum.TeleportResult, message: string)
warn(`Teleporters: {player.Name} could not leave ({result.Name}): {message}`)
leavingForPlace[player] = nil
end)
if portalFolder then
for _, portal in portalFolder:GetChildren() do
if portal:IsA("BasePart") then
portal.Touched:Connect(function(otherPart: BasePart)
local player = playerFromHit(otherPart)
local placeId = portal:GetAttribute("PlaceId")
if player and typeof(placeId) == "number" and placeId > 0 then
sendToPlace(player, placeId)
end
end)
end
end
end
Players.PlayerRemoving:Connect(function(player: Player)
lastTeleport[player] = nil
leavingForPlace[player] = nil
end)
Teleporters가 RemoteFunction GetTeleportSpots와 RemoteEvent TeleportRequest를 직접 만들므로 ReplicatedStorage에 손으로 넣을 것은 없습니다. TeleportPads의 패드와 PlacePortals의 포털은 서버가 시작될 때 한 번만 연결하므로, 게임 중에 추가한 패드와 포털은 아무 일도 하지 않습니다. 어떤 폴더가 없으면 그 종류의 텔레포트만 꺼집니다.
| 부분 | 하는 일 | 이유 |
|---|---|---|
playerFromHit | 닿은 파트가 속한 캐릭터 모델을 찾고 Players:GetPlayerFromCharacter에 누구의 것인지 묻습니다. | 패드에는 다리, 모자, 굴러다니는 파트가 닿습니다. 플레이어 캐릭터의 일부가 아닌 것은 nil이 되어 무시됩니다. |
onCooldown | os.clock()을 플레이어의 마지막 텔레포트 시각과 비교합니다. | 플레이어마다 쿨다운이 하나씩 있으므로, 패드 옆에 서 있는 플레이어가 다른 사람을 막지 않습니다. 아무것도 기다리거나 잠들지 않습니다. |
rootHeight | 서 있는 캐릭터의 루트 파트가 바닥에서 얼마나 높이 있는지 계산합니다. 루트 파트 높이의 절반에 Humanoid의 HipHeight를 더하고, R6 리그라면 다리 길이를 더합니다. | Roblox의 Humanoid.HipHeight 레퍼런스에 있는 공식입니다. 캐릭터의 pivot은 루트 파트이므로 pivot을 이만큼 올리면 작은 아바타든 큰 아바타든 R6든 발이 표면에 닿습니다. |
teleportTo 시작 부분의 확인 | 플레이어에게 루트 파트가 있는 살아 있는 캐릭터가 없으면 끝내고, 그다음 바로 시각을 기록합니다. | 아래의 스트리밍 요청 때문에 스크립트가 기다릴 수 있습니다. 시각을 미리 기록하면 그동안 쏟아지는 Touched 이벤트가 두 번째 텔레포트를 시작하지 못합니다. |
| 도착 지점 | 목적지의 윗면을 rootHeight만큼 올린 곳이며, 앞면이 향하는 쪽을 기울기 없이 바라봅니다. 패드라면 앞면에서 3스터드 더 떨어집니다. | 캐릭터는 목적지 파트 안이 아니라 서 있는 상태로 나타납니다. 패드 옆에서는 발이 패드 윗면 높이에서 시작하므로 패드 두께만큼 바닥으로 떨어집니다. CFrame.lookAlong은 주어진 위치에서 주어진 방향을 바라보는 CFrame을 만듭니다. |
RequestStreamAroundAsync | 도착 지점 주변 지역을 먼저 이 플레이어에게 보내 달라고 Roblox에 요청하고 최대 2초 기다립니다. | 새 플레이스에서는 instance streaming이 기본으로 켜져 있으므로, 맵의 먼 곳이 플레이어 기기에 아직 불러와지지 않았을 수 있습니다. Roblox는 캐릭터를 멀리 옮기기 전에 이 서버 호출을 권장하지만, 정확히 무엇이 도착할지는 보장하지 않습니다. |
| 두 번째 확인 | 기다리는 동안 플레이어가 나갔거나 캐릭터가 리스폰했거나 죽었다면 아무것도 옮기지 않습니다. | 지역을 불러오는 동안 플레이어가 reset을 하거나 게임에서 나갔을 수 있습니다. Roblox의 미리 불러오기 예제도 캐릭터를 옮기기 전에 아직 게임에 있는지 확인합니다. |
SeatWeld 줄 | 캐릭터가 앉아 있으면 좌석에 붙잡아 두는 Weld를 없앱니다. | Roblox는 앉은 캐릭터를 좌석에 용접합니다. PivotTo는 파트의 CFrame을 바꿔서 옮기는데, Roblox 레퍼런스에 따르면 파트의 CFrame을 설정하면 연결된 파트도 함께 움직이므로, 이것이 없으면 좌석과 거기에 용접된 모든 것이 플레이어와 함께 도착합니다. SeatWeld를 없애는 것은 Roblox의 Seat 레퍼런스가 스크립트로 캐릭터를 좌석에서 일으키는 방법입니다. |
character:PivotTo(target) | 팔다리와 액세서리를 포함한 캐릭터 전체를 함께 도착 지점으로 옮깁니다. | Roblox는 PivotTo를 스크립트에서 모델을 옮기는 기본 함수라고 부릅니다. |
두 번째 lastTeleport 줄 | 도착하면 쿨다운을 다시 시작합니다. | 스트리밍 요청은 패드 쿨다운과 같은 최대 2초가 걸릴 수 있으므로, 이 줄이 없으면 플레이어가 쿨다운이 이미 끝난 상태로 도착할 수 있습니다. |
MovementCheckSkip | 옮길 때마다 Player에 속성을 설정합니다. | 서버의 속도 검사는 순간 이동을 핵으로 여길 수 있습니다. 달리기 가이드의 MovementCheck는 이 속성을 읽고 새 위치부터 다시 측정합니다. 그런 스크립트가 없으면 이 속성은 아무 일도 하지 않습니다. |
| 설정 | 여기서의 값 | 바뀌는 것 |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | 텔레포트 후 패드와 포털이 그 플레이어를 무시하는 시간입니다. |
MENU_COOLDOWN_SECONDS | 3 | 한 플레이어가 메뉴로 텔레포트할 수 있는 가장 짧은 간격입니다. 패드와 메뉴는 플레이어마다 같은 시계를 쓰므로, 패드 텔레포트 후 3초 안에 보낸 메뉴 요청도 무시됩니다. |
PAD_ARRIVAL_GAP | 3 | 도착 패드 앞면에서 몇 스터드 떨어진 곳에 플레이어가 나타나는지입니다. 패드 위가 아니라 패드 옆에 도착하게 합니다. |
PLACE_ATTEMPTS | 3 | 포털이 포기하기 전에 2초 간격으로 TeleportAsync를 시도하는 횟수입니다. |
지금 바로 Play를 누르고 PadA를 밟아 보세요. PadB 앞에 나타날 것입니다. 메뉴와 포털에는 다음 두 단계가 필요하지만, 스크립트는 그것 없이도 이미 작동합니다.
4단계: 다른 플레이스로 텔레포트
플레이스는 게임 안의 별도 세계로, 자체 서버를 가집니다. 로비와 던전, 또는 허브와 여러 레벨 같은 것입니다. 플레이어는 TeleportService로 플레이스 사이를 이동하는데, Roblox는 이것을 게시된 게임에서만 실행하므로 이 단계는 Studio가 아니라 Roblox 앱에서 끝납니다.
- 게임을 아직 게시하지 않았다면 File > Publish를 고르세요. 새 게임은 공개하기 전까지 나 자신, Edit 권한을 준 사람, 그리고 적절한 역할을 가진 그룹 멤버에게만 열려 있으며, 직접 텔레포트를 테스트하기에는 그것으로 충분합니다.
- 두 번째 플레이스를 만드세요. Studio의 아무 템플릿으로 새 플레이스를 열고 던전을 만든 뒤, File > Publish As를 고르고, 내 게임 타일을 클릭하고, Add as a new place를 고른 뒤 Create를 누르세요.
- 새 플레이스의 ID를 복사하세요. Window 메뉴나 Home 탭에서 Asset Manager를 열고, Places In Experience로 가서 플레이스를 마우스 오른쪽 버튼으로 클릭하고 Copy Asset ID를 고르세요. 이것이 place ID를 복사합니다.
- 첫 번째 플레이스로 돌아와 Workspace에 이름이
PlacePortals인 Folder를 넣고, 그 안에 이름이DungeonPortal인 고정된 Part를 넣으세요. 이름이PlaceId인 Number 타입 속성을 추가하고 값으로 ID를 붙여 넣으세요. - Play를 누르고 포털에 닿으세요. Output에
Teleporters: would send로 시작하는 줄이 출력됩니다. Studio에서 포털은 그 이상 아무것도 하지 않습니다. - 포털이 게시된 게임에 나타나도록 File > Publish로 게임을 다시 게시하고, 5단계처럼 Roblox 앱에서 확인하세요.
Teleporters는 pcall 안에서 TeleportAsync를 시도 사이에 2초씩 쉬며 최대 3번 호출합니다. Roblox의 텔레포트 페이지에 텔레포트가 실패하고 오류를 낼 수 있으며 다시 시도하는 것이 좋다고 쓰여 있기 때문입니다. 텔레포트는 오류 없이 시작되었다가 마지막 순간에 실패해 플레이어를 원래 자리에 남길 수도 있습니다. 이 경우 Roblox가 TeleportInitFailed를 발생시키고, 스크립트는 플레이어의 "떠나는 중" 표시를 지우므로 포털에 다시 닿으면 다시 시도합니다.
플레이어를 돌려보내려면 다른 플레이스에서도 같은 작업을 하세요. 그 플레이스의 ServerScriptService에 Teleporters 사본을 넣고, PlaceId가 첫 번째 플레이스의 ID인 포털을 추가하세요. ID는 같은 방법으로 Asset Manager에서 복사합니다.
다른 플레이스에 누가 들어올 수 있나
Roblox 보안 문서는 이렇게 경고합니다. 클라이언트가 게임의 한 플레이스에 들어오면, 의도한 경로와 상관없이 그 게임의 다른 어떤 플레이스로든 텔레포트할 수 있으며, 플레이스의 Direct Access를 끄면 웹사이트의 Join 버튼만 사라집니다. 이것은 Creator Dashboard의 Audience > Access Settings에 있는 Access Control for Places 설정이 바꿉니다.
| 설정 | 시작 플레이스가 아닌 플레이스에 들어올 수 있는 사람 |
|---|---|
| Fully open | 누구나. 다른 게임에서의 텔레포트, deep link, 게임 초대, 친구 따라가기로 들어올 수 있습니다. |
| Limited to same universe | 내 게임 안에서 텔레포트하는 플레이어만. 클라이언트와 서버 텔레포트가 모두 허용됩니다. |
| Secure within universe only | 이 게임 안에서 내 서버 스크립트가 텔레포트시킨 플레이어만. |
던전처럼 플레이어가 포털을 통해서만 플레이스에 들어와야 한다면 Secure within universe only를 고르세요. 이 가이드의 모든 텔레포트는 서버에서 시작하므로 계속 작동합니다. Roblox는 많은 게임에 보안 텔레포트가 필요하지 않다고도 말하므로, 모든 플레이스가 모두에게 열려 있는 게임이라면 설정을 그대로 두어도 됩니다.
오래된 텔레포트 튜토리얼이 틀리는 부분
이 가이드를 영상이나 포럼 글과 비교하고 있다면, 중요한 차이점과 각 방법이 문제를 일으키는 이유는 다음과 같습니다.
| 튜토리얼 | 문제 | 이 가이드 |
|---|---|---|
hit.Parent.HumanoidRootPart.Position = target.Position을 설정 | Roblox 레퍼런스에 따르면 Position을 설정하면 파트의 연결이 갱신되어 연결된 파트들에 대해 어긋납니다. 루트 파트가 몸 없이 이동합니다. | PivotTo로 캐릭터 전체를 옮깁니다. |
HumanoidRootPart.CFrame = target.CFrame을 설정 | 캐릭터의 중심이 목표 파트의 중심에 놓여 일부가 그 안에 박히고, 파트의 기울기를 이어받습니다. | 캐릭터가 윗면 위에 서 있는 높이로, 패드 옆에, 기울기 없이 나타납니다. |
패드 전체에 debounce 변수 하나 | 한 플레이어가 텔레포트하는 동안 패드가 다른 모든 사람을 무시합니다. 그리고 debounce가 아예 없으면 다른 패드에 나타난 플레이어가 곧바로 되돌아갑니다. | 기다리기 전에 기록하는 플레이어별 쿨다운, 그리고 플레이어는 패드 옆에 나타납니다. |
LocalScript에서 TeleportService:Teleport(placeId, player) 호출 | Roblox는 Teleport()를 더 이상 사용되지 않는 것으로 표시하고, 새 작업에 쓰지 말라고 권하며, TeleportAsync는 서버 스크립트에서만 허용합니다. | 서버 스크립트에서 TeleportAsync를 호출합니다. |
pcall도, 재시도도 없음 | Roblox의 텔레포트 페이지에 따르면 텔레포트는 실패하며 오류를 낼 수 있고, 시작된 뒤에도 실패할 수 있습니다. | pcall 안에서 최대 3번 시도하고, TeleportInitFailed 덕분에 플레이어가 다시 시도할 수 있습니다. |
| Studio에서 "작동하지 않아서" 포기 | TeleportService는 Studio 플레이테스트를 지원하지 않습니다. | RunService:IsStudio()로 대신 포털이 무엇을 했을지 출력합니다. |
| 버튼이 위치를 보내는 텔레포트 GUI | 치터가 같은 리모트를 아무 위치로나 호출할 수 있습니다. | 버튼은 지점 이름을 보내고, 서버가 그것을 찾습니다. |
| 코인을 teleport data로 전달 | Roblox에 따르면 teleport data는 클라이언트에게 보이고 암호화되지 않습니다. | 코인과 Wins를 데이터 저장소에 두고 다른 플레이스에서 불러오라고 권합니다(다른 플레이스로 데이터 옮기기 참고). |
플레이어가 속일 수 있는 것과 없는 것
치터가 자기 기기의 모든 것을 조종한다고 가정하세요. TeleportMenu를 고칠 수 있고, 두 리모트를 아무 인자로나 원하는 만큼 호출할 수 있고, 자기 캐릭터를 움직일 수 있습니다. 이 텔레포트에서 그것으로 얻는 것은 다음과 같습니다.
| 치터의 시도 | 결과 | 이유 |
|---|---|---|
| 메뉴 리모트로 위치나 CFrame 보내기 | 무시됨 | TeleportRequest는 문자열 하나, 50자 이하의 지점 이름만 읽습니다. 나머지는 모두 버립니다. |
| Wins 3 없이 Castle 요청하기 | 거절됨 | 서버는 자기 쪽 leaderstats에서 Wins를 읽습니다. 회색 버튼은 힌트일 뿐입니다. |
| 존재하지 않는 지점 요청하기 | 무시됨 | 서버는 TeleportSpots에서 이름을 찾고, 그 이름의 파트가 없으면 아무것도 하지 않습니다. |
| 메뉴 리모트를 계속 호출하기 | 메뉴 텔레포트는 3초에 한 번까지 | 쿨다운은 서버에 플레이어마다 저장됩니다. |
| 패드에 다가가지 않고 작동시키기 | 어차피 걸어갈 수 있었던 짝 패드로 갑니다 | Roblox는 어느 위치로든 텔레포트하는 것과 Touched 이벤트 조작을 클라이언트가 자기 캐릭터로 할 수 있는 일로 꼽습니다. |
| 내 게임의 다른 플레이스에 바로 들어가기 | Access Control for Places가 Secure within universe only가 아니면 가능 | 다른 플레이스에 누가 들어올 수 있나를 참고하세요. |
| 자기 캐릭터를 잠긴 지점을 포함해 아무 곳으로나 옮기기 | 가능 | 각 기기는 자기 캐릭터의 움직임을 조종합니다. 잠긴 지점은 편의 기능이지 금고가 아니므로, 거기서 가치 있는 것을 주기 전에 서버에서 확인하세요. |
마지막 줄은 모든 텔레포트의 솔직한 한계입니다. 경쟁 게임이라면 달리기 가이드처럼 서버 이동 검사를 추가하세요. Teleporters는 이미 그 검사가 읽는 MovementCheckSkip 속성을 설정하므로 자기 텔레포트는 위반으로 표시되지 않습니다. Roblox 보안 문서에도 정당한 텔레포트가 있는 게임은 이동 검사에 바로 이런 예외가 필요하다고 쓰여 있습니다.
5단계: 확인하기
- Play를 누르세요. PadA를 밟으면 PadB 바로 앞에 PadB를 등지고 나타납니다. 돌아서서 바로 PadB를 밟아 보세요. 패드는 도착 후 2초 동안 나를 무시하므로 아무 일도 일어나지 않습니다. 내려와서 2초 기다린 뒤 다시 PadB에 올라서면 PadA 앞에 나타납니다.
- 몇 초 기다린 뒤 화면 왼쪽의 Teleport를 누르세요. 목록에 Lake, Spawn, 그리고 회색 "Castle (needs 3 wins)"가 보입니다. Lake를 고르면 그곳에 나타납니다. 메뉴를 다시 열고 Castle을 고르면 아무 일도 일어나지 않고 Output도 조용합니다.
- 자신에게 Wins 3을 주세요(이를 위해 IntValue Wins가 있는 leaderstats 스크립트가 필요합니다. 예를 들어 리더보드 가이드의 것). Client/Server 전환 버튼을 눌러 Server로 바꾸고, Explorer에서
Players, 내 이름,leaderstats,Wins를 찾아 Properties 창에서 Value를 3으로 하세요. 다시 Client로 바꾸고 메뉴를 열면 Castle이 보라색이 되어 그곳으로 옮겨 줍니다. - DungeonPortal에 닿으세요. Output에 내 이름과 place ID가 들어간,
Teleporters: would send로 시작하는 줄이 출력됩니다. Studio에서는 이것이 정상이며, 포털 위에 얼마나 오래 서 있든 2초에 한 번보다 자주 출력되지 않습니다. - 테스트 모드 드롭다운에서 Server & Clients를 고르고 클라이언트를 2개로 설정한 뒤 Play를 누르세요. 두 플레이어가 동시에 패드를 쓸 수 있고, 한 사람의 쿨다운이 다른 사람을 막지 않습니다.
- 테스트를 멈추고 게임을 게시한 뒤 Roblox 앱에서 실행하세요. 포털에 닿으면 Roblox 로딩 화면이 나타나고 다른 플레이스에 도착합니다. 그대로 남아 있다면 F9로 Developer Console을 열고, 게임 소유자와 편집 권한이 있는 그룹 멤버만 볼 수 있는 Server 로그 보기로 바꾼 뒤
Teleporters:경고를 찾으세요. 거기에 Roblox가 알려 준 이유가 적혀 있습니다.
Studio에서 단계를 진행하는 동안 Output 창을 열어 두세요(Window 메뉴, 그다음 Output). Teleporters는 작동할 때 4단계의 포털 줄 말고는 아무것도 출력하지 않으므로, 경고나 빨간 오류는 읽어 볼 가치가 있습니다. 자주 나는 오류를 참고하세요.
확장하기
팀이나 파티를 함께 텔레포트하기
TeleportAsync는 플레이어 목록을 받으므로 포털 하나가 그룹 전체를 한 플레이스로 보낼 수 있습니다. Roblox의 텔레포트 페이지는 포털에 닿은 플레이어에서 시작하라고 제안합니다. 팀이라면 player.Team과 Team:GetPlayers(), 파티라면 player.PartyId와 함께 SocialService:GetPlayersByPartyId()를 쓰세요. { player } 대신 그 목록을 넘기고, 목록의 모든 플레이어에게 leavingForPlace 표시를 설정하세요.
그룹을 전용 서버로 보내기
기본적으로 텔레포트된 플레이어는 다른 플레이스의 공개 서버에 들어갑니다. 매치처럼 그룹을 새 예약 서버로 보내려면 TeleportOptions를 만들고 ShouldReserveServer를 true로 설정한 뒤 세 번째 인자로 넘기세요. TeleportService:TeleportAsync(placeId, players, options). Roblox는 예약 서버와 관련된 실패에서 특히 재시도가 유용하다고 말하며, 스크립트는 이미 재시도합니다.
다른 플레이스로 데이터 옮기기
텔레포트하면 그 플레이어의 로컬 데이터가 모두 초기화됩니다. TeleportOptions:SetTeleportData()로 설정하고 다른 플레이스에서 player:GetJoinData()로 읽는 Roblox의 teleport data는 클라이언트에게 보이고 암호화되지 않으므로, 어떤 맵을 불러올지 같은 무해한 선택에만 쓰세요. 코인, Wins, 아이템은 DataStore 튜토리얼처럼 데이터 저장소에 두고, 플레이어가 다른 플레이스에 도착하면 다시 불러오세요.
나만의 로딩 화면
플레이스 텔레포트를 불러오는 동안 플레이어는 기본 Roblox 로딩 화면을 봅니다. 직접 만든 화면을 보여 주려면 클라이언트에서 ScreenGui와 함께 TeleportService:SetTeleportGui()를 호출하세요. 예를 들어 ReplicatedStorage에 있는 것을 쓰면 됩니다. 이 가이드의 텔레포트는 서버에서 시작하므로 클라이언트가 미리, 예를 들어 플레이어가 들어오자마자 호출해야 합니다. Roblox는 텔레포트할 때마다 화면을 다시 설정해야 하고 다른 게임의 플레이스에는 쓰이지 않는다고 말합니다. 같은 곳에 그 ScreenGui 안의 스크립트는 실행되지 않는다고 쓰여 있으므로 정적인 화면으로 만드세요.
라운드 텔레포트와 체크포인트
라운드 시스템은 라운드가 시작될 때마다 같은 PivotTo 호출로 모든 플레이어를 아레나로 옮기고, 오비 가이드의 PivotTo와 SpawnLocation 섹션은 이 방식을 Roblox의 스폰 지점과 비교합니다. 라운드를 마친 뒤에만 지점이 열려야 한다면, 라운드 시스템이 이미 WinsNeeded가 읽는 Wins를 줍니다.
자주 발생하는 오류와 해결 방법
Play를 누르기 전에 Output 창(Window 메뉴, 그다음 Output)을 여세요. Destination이 아무것도 가리키지 않으면 Teleporters가 패드 이름을 알려 주므로, 대부분의 문제가 거기에 보입니다.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'
TeleportMenu가 Teleporters가 만드는 리모트를 기다리고 있으므로 Teleporters가 실행되지 않은 것입니다. LocalScript가 아니라 Script인지, ServerScriptService 바로 안에 있는지, 꺼져 있지 않은지, Output에 그 스크립트의 빨간 오류가 없는지 확인하세요. 스크립트 오류 가이드가 이 경고를 자세히 설명합니다.
Teleporters: PadA points to PadC, which is not a part in TeleportPads
패드의 Destination 속성이 TeleportPads 폴더 바로 안의 파트가 아닌 것을 가리킵니다. 속성 값과 도착 패드 이름의 철자와 대소문자를 확인하세요. 경고는 플레이어가 그 패드를 처음 밟을 때 패드마다 한 번 나타납니다.
패드를 밟아도 아무 일도 일어나지 않아요
게임이 시작될 때 폴더 이름이 정확히 TeleportPads이고 Workspace 바로 안에 있는지, 패드의 Destination 속성 타입이 String인지(Number 타입 속성은 무시됩니다), 마지막 텔레포트 후 2초가 지났는지 확인하세요. 패드의 CanTouch가 켜져 있는지도 확인하세요. Roblox에 따르면 CanTouch가 꺼진 파트에 Touched를 연결하면 오류가 나고, 그 오류가 스크립트를 멈춥니다.
벽 안에 나타나거나 가장자리에서 떨어져요
플레이어는 도착 패드 앞면에서 3스터드 앞에 나타납니다. 패드를 마우스 오른쪽 버튼으로 클릭하고 Show Orientation Indicator를 고른 뒤, 파란 선이 빈 바닥을 가리킬 때까지 패드를 돌리세요. 메뉴 지점은 플레이어를 파트 위에 올려놓으므로 각 지점을 바닥에 두세요.
Wins 3을 얻었는데 Castle 버튼이 계속 회색이에요
목록은 메뉴를 열 때 그려지므로 메뉴를 닫았다가 다시 여세요. 그래도 회색이라면 leaderstats 안에 이름이 정확히 Wins인 IntValue가 있는지, 그리고 Wins가 Client 모드에서만이 아니라 서버에서 바뀌었는지 확인하세요.
게시된 게임에서 포털이 아무것도 하지 않아요
F9로 Developer Console을 열고 Server 로그 보기로 바꾼 뒤(Teleporters가 서버 Script이므로 게임 소유자와 편집 권한이 있는 그룹 멤버만 볼 수 있습니다) Teleporters: 경고를 읽으세요. 거기에 Roblox가 알려 준 이유가 적혀 있습니다. 포털의 PlaceId 속성 타입이 Number이고 Asset Manager의 ID가 들어 있는지, 포털을 추가한 뒤 플레이스를 다시 게시했는지 확인하세요.
RoCode로 만들기
이 모든 것을 직접 만들기 싫다면 RoCode가 지금 열려 있는 플레이스에 만들어 줄 수 있습니다. RoCode는 Roblox가 아닌 독립 제품으로, Roblox Studio용 AI 에이전트입니다. 웹 채팅에서 기능을 설명하면 Studio 플러그인이 Explorer에 파트와 스크립트를 만들므로 채팅 창에서 코드를 복사할 필요가 없습니다.
텔레포트를 추가해 줘. Workspace.TeleportPads의 패드는 자기 Destination 속성의 패드로 플레이어를 보내고 쿨다운은 2초, Workspace.TeleportSpots의 지점을 위한 Teleport 메뉴에서 Castle은 Wins 3이 필요하고 서버에서 확인, 그리고 Workspace.PlacePortals의 포털은 자기 PlaceId 속성의 ID를 가진 플레이스로 플레이어를 보내고 재시도도 해 줘.
- 단계에 필요할 때 Search Game과 Search Scripts로 플레이스를 살펴볼 수 있어서, 두 번째 시스템을 추가하는 대신 이미 있는 아이템, 리모트, 저장 코드를 바탕으로 작업합니다
- Create Instance로 패드 폴더와 파트를 만들고, Set Property로 속성을 정하고, Create Script로 Teleporters와 TeleportMenu를 작성합니다
- 작성한 모든 스크립트가 컴파일되는지 Check Script로 확인하도록 지시받습니다. Check Script는 실행하지 않고 Studio에서 컴파일합니다
- 변경을 묶음으로 보내며, 각 묶음은 Studio 기록의 실행 취소 지점이 됩니다
플레이스 간 텔레포트는 게시된 게임에서만 작동하므로 Roblox 앱에서 직접 확인하세요. 플러그인 3.9 이상에서는 RoCode가 짧은 플레이테스트를 실행하고 오류를 읽을 수 있고, 플러그인 3.9.15 이상에서는 테스트 캐릭터가 패드를 밟고 메뉴 버튼을 누를 수 있습니다. 하지만 스스로 테스트하기로 정한 것만 확인하므로, 패드를 밟고 메뉴를 직접 열어 보세요. 텔레포트는 게임의 여러 시스템 중 하나입니다. RoCode로 게임 전체 만들기도 같은 방식으로, 프롬프트 하나에 시스템 하나씩 진행합니다. RoCode가 Studio에 연결되는 방법.
자주 묻는 질문
Roblox Studio에서 텔레포트 패드는 어떻게 만드나요?
두 파트에 서로의 이름을 값으로 하는 Destination 속성을 주고, 서버 스크립트 하나가 패드에 닿은 사람을 character:PivotTo로 다른 패드 바로 앞에 옮기게 하세요. 플레이어마다 짧은 쿨다운을 둡니다. 1단계와 2단계가 바로 이것을 만듭니다.
Studio에서 텔레포트가 왜 작동하지 않나요?
패드와 메뉴는 Studio에서 작동합니다. 다른 플레이스로 가는 텔레포트는 작동하지 않습니다. Roblox의 TeleportService는 Studio 플레이테스트를 지원하지 않으므로 게임을 게시하고 Roblox 앱에서 테스트하세요. 이 가이드의 스크립트는 텔레포트 대신 포털이 무엇을 했을지 출력하므로, 작동하는지는 그래도 확인할 수 있습니다.
플레이어를 내 게임의 다른 플레이스로 어떻게 텔레포트하나요?
File > Publish As(Add as a new place)로 플레이스를 추가하고, Asset Manager에서 place ID를 복사한 뒤, 서버 Script에서 pcall 안에 TeleportService:TeleportAsync(placeId, { player })를 호출하고 실패하면 다시 시도하세요. 4단계가 이 과정을 모두 안내합니다.
텔레포트 GUI는 어떻게 만드나요?
LocalScript에서 버튼을 만들고, 플레이어가 고른 지점의 이름만 서버에 보내세요. 서버는 폴더에서 이름을 찾고, 쿨다운과 잠금 해제 규칙을 확인한 뒤 캐릭터를 옮깁니다. 클라이언트에서 위치를 보내지 마세요. 치터는 아무 위치나 보낼 수 있습니다.
텔레포트 후 캐릭터가 끼거나 분해되는 이유는 뭔가요?
루트 파트의 Position에 값을 넣으면 연결된 몸 없이 그 파트만 움직이고, 패드의 CFrame을 복사하면 캐릭터의 중심이 패드 안에 놓입니다. Humanoid의 HipHeight로 계산한, 바닥 위에 서 있는 높이의 지점으로 character:PivotTo를 쓰세요.
텔레포트할 때 코인이나 아이템을 함께 넘길 수 있나요?
안전하게는 안 됩니다. Roblox에 따르면 teleport data는 클라이언트에게 보이고 암호화되지 않으므로 고른 맵 같은 것에는 괜찮지만 코인에는 맞지 않습니다. 코인과 아이템은 데이터 저장소에 저장하고 다른 플레이스에서 불러오세요.
출처와 더 읽을거리
- Roblox Creator Docs: Teleport between places (영어). TeleportAsync, Studio 플레이테스트, Access Control for Places, 텔레포트 화면, teleport data, 실패한 텔레포트
- Roblox Creator Docs: TeleportService (영어). 더 이상 사용되지 않는 Teleport, 서버 전용 TeleportAsync, TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (영어). 스크립트에서 모델을 옮기는 기본 함수
- Roblox Creator Docs: BasePart.Position (영어). 연결된 파트의 Position을 설정하면 나머지에 대해 어긋나는 이유
- Roblox Creator Docs: Humanoid.HipHeight (영어). R15와 R6 리그에서 서 있는 캐릭터의 루트 파트 높이
- Roblox Creator Docs: Seat (영어). 앉은 캐릭터를 붙잡는 SeatWeld와, 캐릭터를 일으키려고 그것을 없애는 방법
- Roblox Creator Docs: Player:RequestStreamAroundAsync (영어). 캐릭터가 이동하기 전에 지역을 요청하기, 무엇이 도착할지는 보장 없음
- Roblox Creator Docs: Streaming techniques and conversion (영어). 텔레포트 전 미리 스트리밍하기
- Roblox Creator Docs: Access control and confidentiality (영어). 텔레포트가 보호되지 않으면 클라이언트가 게임의 어떤 플레이스에든 들어갈 수 있는 이유
- Roblox Creator Docs: Network ownership, movement validation, and physics (영어). 클라이언트가 자기 캐릭터로 할 수 있는 일과 이동 검사의 텔레포트 예외
- Roblox Creator Docs: Create and publish games and places (영어). 게시, 새 게임을 열 수 있는 사람, Publish As로 플레이스 추가하기
- Roblox Creator Docs: Asset Manager (영어). place ID 복사하는 방법
- Roblox Creator Docs: Developer Console (영어). 로그의 Server 보기와 그것을 볼 수 있는 사람
- Roblox Creator Docs: Debounce patterns (영어). Touched가 한 번 닿을 때 여러 번 발생하는 이유
코드 검증 방법: 이 페이지의 모든 스크립트는 Roblox API 정의를 적용한 Luau의 엄격한 타입 검사기(luau-lsp, 2026년 11월 20일)를 통과합니다. 타입 검사는 잘못 쓴 API 이름과 잘못된 타입을 찾아내지만 게임 로직의 오류는 찾지 못하므로, 게시하기 전에 Studio에서 직접 테스트하세요.