Tóm tắt
Với bệ teleport, đặt một Script trong ServerScriptService lắng nghe sự kiện Touched của bệ, tìm người chơi qua Players:GetPlayerFromCharacter và chuyển cả nhân vật bằng character:PivotTo() đến điểm ngay trước bệ đích, quay lưng về phía nó, với cooldown vài giây cho mỗi người chơi để bệ đích không đưa họ quay lại ngay. Để đưa người chơi sang một place khác trong game của bạn, gọi TeleportService:TeleportAsync(placeId, { player }) từ một Script server bên trong pcall; cách này chỉ chạy trong game đã publish, không chạy trong Studio.
- Chuyển cả nhân vật bằng
PivotTo. GánHumanoidRootPart.Positionsẽ kéo root part rời khỏi phần còn lại của cơ thể, vì khi đặt Position Roblox cập nhật các mối nối. - Menu teleport phải gửi cho server tên của điểm đến, không phải vị trí. Server kiểm tra tên, cooldown và mọi quy tắc mở khóa trước khi chuyển ai đi.
TeleportService:Teleport()đã lỗi thời và chạy trên client. DùngTeleportAsynctrên server, bọc nó trongpcall, thử lại và xử lýTeleportInitFailed.
Trong trang này
Hai loại teleport
Teleport trong game Roblox có thể là ba thứ: một bệ chuyển bạn qua bản đồ, một menu các điểm có thể nhảy tới, hoặc một cổng sang màn khác. Hai loại đầu chuyển nhân vật bên trong server mà người chơi đang ở. Loại thứ ba đưa người chơi sang một place khác trong game của bạn, chạy trên các server riêng. Chúng dùng API khác nhau, nên cần biết bạn cần loại nào.
| Trong cùng server | Sang place khác trong game của bạn | |
|---|---|---|
| Lệnh gọi | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| Dùng cho | Bệ teleport, menu teleport, chuyển người chơi từ sảnh vào đấu trường | Cổng sang màn khác, sảnh đưa người chơi sang một place riêng có hầm ngục hoặc trận đấu |
| Chạy ở đâu | Script server | Chỉ Script server. Teleport() phía client đã lỗi thời. |
| Chạy trong playtest Studio | Có | Không. TeleportService của Roblox không hỗ trợ playtest trong Studio, nên phải test trong game đã publish. |
| Người chơi thấy gì | Một cú nhảy qua bản đồ, có thể mất đến 2 giây nếu khu vực đó cần tải trước | Màn hình tải của Roblox, sau đó là place kia |
| Xu, vật phẩm và dữ liệu khác | Giữ nguyên | Roblox xóa dữ liệu cục bộ của người chơi, nên mọi thứ quan trọng phải đến từ kho dữ liệu ở place kia |
Trong hướng dẫn này cả ba loại nằm trong một Script server, nên một bộ quy tắc áp dụng cho mọi teleport trong game của bạn: server quyết định, mỗi người chơi có cooldown riêng, còn thiết bị của người chơi chỉ báo họ muốn đến điểm nào.
| Thành phần | Nằm ở đâu | Làm gì |
|---|---|---|
Folder TeleportPads với PadA và PadB | Workspace | Hai bệ. Thuộc tính Destination của mỗi bệ ghi tên bệ mà nó đưa người chơi tới. |
Folder TeleportSpots | Workspace | Mỗi điểm trong danh sách menu là một part. Thuộc tính WinsNeeded khóa điểm đó. |
Folder PlacePortals | Workspace | Các part làm cổng. Thuộc tính PlaceId của mỗi cổng là place mà nó đưa người chơi tới. |
Script Teleporters | ServerScriptService | Điều khiển cả ba loại teleport và tạo hai remote. Nơi duy nhất teleport có thể xảy ra. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | Vẽ nút Teleport và danh sách điểm, và gửi tên điểm mà người chơi chọn. |
RemoteFunction GetTeleportSpots và RemoteEvent TeleportRequest | ReplicatedStorage (do Teleporters tạo) | Cái đầu trả danh sách điểm cho menu. Cái thứ hai mang tên đã chọn lên server. |
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
Bước 1: dựng hai bệ teleport
- Trong Explorer, rê chuột lên Workspace, bấm nút + và chèn một Folder. Đặt tên thư mục là
TeleportPads. Script tìm đúng tên này. - Chèn vào thư mục hai Part và đặt tên là
PadAvàPadB. Làm mỗi cái thành một tấm phẳng, ví dụ 6 x 1 x 6 stud, và đặt chúng trên sàn cách nhau một khoảng. Trong cửa sổ Properties, đánh dấu Anchored, để CanCollide và CanTouch bật, và chọn màu sáng cùng chất liệu Neon để người chơi dễ thấy. - Chọn PadA, cuộn cửa sổ Properties xuống phần Attributes và bấm +. Nhập tên
Destination, chọn kiểu String và bấm Save, rồi đặt giá trị làPadB. Làm tương tự trên PadB với giá trịPadA. - Xoay mỗi bệ để mặt trước của nó hướng ra sàn trống. Người chơi xuất hiện cách 3 stud trước mặt trước của bệ đích, quay lưng về phía nó, nên hãy để trống vài stud sàn ở đó. Để xem mặt nào là mặt trước, bấm chuột phải lên bệ và chọn Show Orientation Indicator: mặt trước được đánh dấu bằng đường màu xanh dương. Xoay bệ bằng công cụ Rotate đến khi đường đó chỉ về hướng người chơi sẽ đi ra.
Người chơi đến cạnh bệ chứ không đứng trên nó, và đó là cố ý. Trang của Roblox về debounce lưu ý Touched kích hoạt nhiều lần liên tiếp cho một lần chạm, nên người chơi xuất hiện ngay trên bệ kia sẽ kích hoạt nó lần nữa ngay khi cooldown kết thúc, và bay ngược lại qua bản đồ.
Bạn không bị giới hạn ở hai bệ. Destination của một bệ có thể ghi tên bất kỳ part nào trong TeleportPads, nên ba bệ có thể đưa người chơi đi vòng tròn. Với bệ một chiều, cho nó trỏ tới một part trong TeleportPads không có Destination riêng: part như vậy nhận người chơi và không đưa ai đi đâu cả.
Bước 2: thêm script teleport
Rê chuột lên ServerScriptService, chèn một Script, đặt tên là Teleporters và dán đoạn code dưới đây vào. Lúc này nó phục vụ các bệ, và sau các bước tiếp theo sẽ phục vụ thêm menu và cổng, nên bạn chỉ thêm nó một lần. Phần cài đặt ở đầu là những dòng bạn được phép thay đổi.
-- Script trong ServerScriptService tên là Teleporters.
-- Mọi teleport đều được quyết định ở đây, trên server:
-- 1. Bệ: chạm vào một part trong Workspace.TeleportPads chuyển bạn đến part có tên
-- trong thuộc tính Destination của nó.
-- 2. Menu: LocalScript TeleportMenu xin một điểm từ Workspace.TeleportSpots
-- theo tên. Server kiểm tra tên, cooldown và số Wins mà điểm đó cần.
-- 3. Cổng: chạm vào một part trong Workspace.PlacePortals đưa bạn sang place
-- trong thuộc tính PlaceId của nó (một place khác của game này).
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 -- thời gian các bệ bỏ qua người chơi sau bất kỳ lần teleport nào
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- số stud trước bệ đích, để người chơi đến cạnh nó
local PLACE_ATTEMPTS = 3
local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")
-- Script này tự tạo cả hai remote, nên đừng tự thêm chúng
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
-- Root part của nhân vật đang đứng nằm cao bao nhiêu so với sàn.
-- Công thức từ tài liệu Roblox về Humanoid.HipHeight (rig R6 cộng thêm chiều cao chân).
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() -- đặt trước khi chờ, để lần chạm thứ hai không chạy teleport thứ hai
-- Nhìn theo hướng mặt trước của điểm đến (thẳng, không nghiêng)
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
-- Đứng trên mặt trên của nó: pivot của nhân vật là root part, nên nâng nó lên độ cao đứng.
-- Còn bệ thì đặt người chơi cách mình vài stud phía trước, vì người chơi đứng
-- trên bệ sẽ kích hoạt nó lần nữa ở bước chân tiếp theo.
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)
-- Khi instance streaming bật, tải trước khu vực quanh điểm đến (tối đa 2 giây)
pcall(function()
player:RequestStreamAroundAsync(target.Position, 2)
end)
if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
return -- đã thoát, hồi sinh hoặc chết trong lúc khu vực đang tải
end
-- Nhân vật đang ngồi được hàn vào ghế, và di chuyển nó sẽ kéo cả ghế theo.
-- Hủy SeatWeld trước sẽ giải phóng nhân vật khỏi ghế.
local seat = humanoid.SeatPart
if seat then
local seatWeld = seat:FindFirstChild("SeatWeld")
if seatWeld then
seatWeld:Destroy()
end
end
character:PivotTo(target)
-- Khi đến nơi, chạy lại cooldown: việc tải trước ở trên có thể mất đến 2 giây,
-- và bệ mà người chơi đến cạnh không được đưa họ quay lại ngay
lastTeleport[player] = os.clock()
player:SetAttribute("MovementCheckSkip", true) -- cho script kiểm tra tốc độ, nếu bạn có
end
-- 1. Bệ
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 -- cảnh báo một lần, không phải mỗi lần chạm
warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
end
end)
end
end
end
-- 2. Menu: danh sách điểm, sau đó yêu cầu theo tên
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 -- cùng số Wins: theo bảng chữ cái, để thứ tự không bao giờ đổi
end)
return list
end
teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
-- Client chỉ gửi tên. Đừng bao giờ nhận vị trí hay CFrame từ client.
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 -- bị khóa với người chơi này
end
teleportTo(player, spot, false)
end)
-- 3. Cổng sang place khác của game này
local function sendToPlace(player: Player, placeId: number)
if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
return -- đang trên đường đi hoặc vừa chạm teleport một giây trước
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 -- bỏ cuộc; lần chạm cổng mới sẽ thử lại
end
-- Teleport vẫn có thể thất bại sau khi đã bắt đầu. Người chơi ở lại đây và có thể thử lại.
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 tự tạo RemoteFunction GetTeleportSpots và RemoteEvent TeleportRequest, nên bạn không cần tự chèn gì vào ReplicatedStorage. Nó kết nối các bệ trong TeleportPads và các cổng trong PlacePortals một lần, khi server khởi động, nên bệ và cổng thêm vào trong lúc chơi sẽ không làm gì. Nếu thiếu thư mục nào, loại teleport đó đơn giản là bị tắt.
| Phần | Làm gì | Vì sao |
|---|---|---|
playerFromHit | Tìm model nhân vật chứa part vừa chạm, và hỏi Players:GetPlayerFromCharacter nó là của ai. | Bệ bị chạm bởi chân, mũ và các part rời. Mọi thứ không thuộc nhân vật người chơi đều cho ra nil và bị bỏ qua. |
onCooldown | So sánh os.clock() với thời điểm teleport gần nhất của người chơi. | Mỗi người chơi một cooldown, nên người chơi đứng cạnh bệ không bao giờ chặn người khác. Không có gì phải chờ hay ngủ. |
rootHeight | Tính root part của nhân vật đang đứng nằm cao bao nhiêu so với sàn: một nửa chiều cao root part cộng HipHeight của Humanoid, cộng chiều dài chân với rig R6. | Đây là công thức từ tài liệu Roblox về Humanoid.HipHeight. Pivot của nhân vật là root part, nên nâng pivot lên đúng chừng đó sẽ đặt chân lên bề mặt, với cả avatar nhỏ, avatar lớn lẫn R6. |
Các kiểm tra ở đầu teleportTo | Thoát nếu người chơi không có nhân vật còn sống có root part, rồi ghi thời gian ngay. | Yêu cầu streaming bên dưới có thể khiến script phải chờ. Ghi thời gian trước thì nhiều sự kiện Touched lúc đó không chạy teleport thứ hai. |
| Điểm đến | Mặt trên của điểm đến, nâng lên rootHeight, nhìn theo hướng mặt trước của nó, không nghiêng. Với bệ, điểm này còn được dời 3 stud ra khỏi mặt trước của nó. | Nhân vật xuất hiện ở tư thế đứng, không nằm trong part đích. Cạnh bệ, chân của nhân vật bắt đầu ngang mặt trên của bệ, nên nó rơi xuống sàn một khoảng bằng độ dày của bệ. CFrame.lookAlong tạo CFrame tại một vị trí với hướng nhìn cho trước. |
RequestStreamAroundAsync | Nhờ Roblox gửi trước cho người chơi này khu vực quanh điểm đến, và chờ không quá 2 giây. | Instance streaming mặc định bật trong place mới, nên phần xa của bản đồ có thể chưa tải trên thiết bị của người chơi. Roblox khuyên gọi lệnh server này trước khi chuyển nhân vật đi xa, dù không đảm bảo chính xác thứ gì sẽ tới. |
| Kiểm tra lần hai | Nếu người chơi đã thoát, hoặc nhân vật đã hồi sinh hay chết trong lúc chờ, không có gì di chuyển. | Người chơi có thể đã reset hoặc thoát game trong lúc khu vực đang tải. Ví dụ tải trước của chính Roblox cũng kiểm tra nhân vật vẫn còn trong game trước khi di chuyển nó. |
Các dòng có SeatWeld | Nếu nhân vật đang ngồi, hủy Weld giữ nó trên ghế. | Roblox hàn nhân vật đang ngồi vào ghế. PivotTo di chuyển các part bằng cách đổi CFrame của chúng, và tài liệu Roblox nói đặt CFrame của một part sẽ di chuyển cả các part nối với nó, nên nếu không làm vậy, ghế và mọi thứ hàn vào nó sẽ đến cùng người chơi. Hủy SeatWeld là cách tài liệu Roblox về Seat dùng để đưa nhân vật rời ghế từ script. |
character:PivotTo(target) | Chuyển cả nhân vật, mọi chi và phụ kiện cùng lúc, đến điểm đến. | Roblox gọi PivotTo là hàm chính để di chuyển model từ script. |
Dòng lastTeleport thứ hai | Chạy lại cooldown khi đến nơi. | Yêu cầu streaming có thể mất đến 2 giây, bằng đúng cooldown của bệ, nên không có dòng này người chơi có thể đến nơi khi cooldown đã hết. |
MovementCheckSkip | Đặt một thuộc tính trên Player sau mỗi lần chuyển. | Kiểm tra tốc độ phía server sẽ tưởng cú nhảy là gian lận. MovementCheck trong hướng dẫn chạy nhanh đọc thuộc tính này và bắt đầu đo lại từ vị trí mới. Không có script như vậy thì thuộc tính không làm gì. |
| Cài đặt | Giá trị ở đây | Thay đổi gì |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Thời gian các bệ và cổng bỏ qua người chơi sau bất kỳ lần teleport nào. |
MENU_COOLDOWN_SECONDS | 3 | Khoảng cách ngắn nhất giữa hai lần teleport qua menu của một người chơi. Bệ và menu dùng chung đồng hồ cho mỗi người chơi, nên yêu cầu từ menu trong vòng 3 giây sau teleport bằng bệ cũng bị bỏ qua. |
PAD_ARRIVAL_GAP | 3 | Người chơi xuất hiện cách mặt trước của bệ đích bao nhiêu stud, để họ ở cạnh bệ chứ không đứng trên nó. |
PLACE_ATTEMPTS | 3 | Cổng thử TeleportAsync bao nhiêu lần, cách nhau 2 giây, trước khi bỏ cuộc. |
Bấm Play ngay bây giờ và bước lên PadA: bạn sẽ xuất hiện trước PadB. Menu và cổng cần hai bước tiếp theo, nhưng script đã chạy được mà không cần chúng.
Bước 4: teleport sang place khác
Place là một thế giới riêng trong game của bạn, có server riêng: sảnh và hầm ngục, hoặc khu trung tâm và một loạt màn chơi. Người chơi di chuyển giữa các place qua TeleportService, và Roblox chỉ chạy nó trong game đã publish, nên bước này kết thúc trong ứng dụng Roblox, không phải trong Studio.
- Nếu game chưa được publish, chọn File > Publish. Game mới, cho đến khi bạn phát hành, chỉ mở cho bạn, những người bạn đã cấp quyền Edit và thành viên group có vai trò phù hợp, và chừng đó là đủ để bạn tự test teleport.
- Tạo place thứ hai: mở một place mới từ bất kỳ mẫu nào của Studio, dựng hầm ngục của bạn, sau đó chọn File > Publish As, bấm vào ô game của bạn, chọn Add as a new place và bấm Create.
- Sao chép ID của place mới. Mở Asset Manager từ menu Window hoặc tab Home, vào Places In Experience, bấm chuột phải vào place và chọn Copy Asset ID, thao tác này sao chép place ID của nó.
- Quay lại place đầu tiên, chèn vào Workspace một Folder tên
PlacePortals, và bên trong nó một Part đã anchor tênDungeonPortal. Thêm một thuộc tính kiểu Number tênPlaceIdvà dán ID làm giá trị của nó. - Bấm Play và chạm vào cổng. Output in ra một dòng bắt đầu bằng
Teleporters: would send: trong Studio cổng không làm gì thêm. - Publish game lại qua File > Publish để cổng có trong game đã publish, và kiểm tra nó từ ứng dụng Roblox, như ở bước 5.
Teleporters gọi TeleportAsync bên trong pcall, tối đa 3 lần với khoảng nghỉ 2 giây giữa các lần thử, vì trang của Roblox về teleport nói teleport có thể thất bại và báo lỗi, và khuyên nên thử lại. Teleport cũng có thể bắt đầu rồi thất bại vào phút cuối mà không báo lỗi, để người chơi ở lại chỗ cũ. Cho trường hợp này Roblox kích hoạt TeleportInitFailed, và script gỡ cờ "đang rời đi" khỏi người chơi, nên lần chạm cổng mới sẽ thử lại.
Để đưa người chơi quay về, làm tương tự ở place kia: đặt một bản sao Teleporters vào ServerScriptService của nó và thêm một cổng có PlaceId là ID place đầu tiên của bạn, sao chép từ Asset Manager theo cùng cách.
Ai có thể vào các place khác của bạn
Tài liệu bảo mật của Roblox cảnh báo: khi client đã ở trong một place của game bạn, nó có thể teleport sang bất kỳ place nào khác của game, bất kể bạn thiết kế lộ trình ra sao, và tắt Direct Access của một place chỉ bỏ nút Join trên website. Điều này được thay đổi bằng cài đặt Access Control for Places trong mục Audience > Access Settings ở Creator Dashboard:
| Cài đặt | Ai có thể vào place không phải place khởi đầu |
|---|---|
| Fully open | Bất kỳ ai, qua teleport từ bất kỳ game nào, deep link, lời mời vào game và tham gia cùng bạn bè. |
| Limited to same universe | Chỉ người chơi teleport từ bên trong các game của bạn. Cho phép teleport cả từ client lẫn từ server. |
| Secure within universe only | Chỉ người chơi được script server của bạn teleport từ bên trong game này. |
Nếu người chơi chỉ nên vào place qua cổng của bạn, ví dụ một hầm ngục, hãy chọn Secure within universe only. Mọi teleport trong hướng dẫn này đều bắt đầu trên server, nên nó vẫn tiếp tục chạy. Roblox cũng nói nhiều game không cần teleport bảo mật, nên game mà mọi place đều mở cho mọi người có thể để nguyên cài đặt.
Các hướng dẫn teleport cũ sai ở đâu
Nếu bạn đang so hướng dẫn này với một video hay bài trên diễn đàn, đây là những khác biệt quan trọng và lý do mỗi cách làm gây ra vấn đề.
| Hướng dẫn cũ | Vấn đề | Hướng dẫn này |
|---|---|---|
Đặt hit.Parent.HumanoidRootPart.Position = target.Position | Tài liệu Roblox nói đặt Position sẽ cập nhật các mối nối của part, và nó dịch chuyển so với các part nối với nó: root part đi mất mà không có cơ thể. | Chuyển cả nhân vật bằng PivotTo. |
Đặt HumanoidRootPart.CFrame = target.CFrame | Giữa nhân vật nằm vào giữa part đích, lún một phần vào trong nó, và nhận cả độ nghiêng của part. | Nhân vật xuất hiện ở độ cao đứng trên mặt trên, cạnh bệ, không nghiêng. |
Dùng một biến debounce cho cả bệ | Trong lúc một người chơi đang teleport, bệ bỏ qua mọi người khác. Còn nếu hoàn toàn không có debounce, người chơi xuất hiện trên bệ kia sẽ bị đưa quay lại ngay. | Mỗi người chơi một cooldown, ghi lại trước mọi lần chờ, và người chơi xuất hiện cạnh bệ. |
Gọi TeleportService:Teleport(placeId, player) từ LocalScript | Roblox đánh dấu Teleport() là đã lỗi thời, khuyên không dùng nó trong dự án mới và chỉ cho phép gọi TeleportAsync từ script server. | Gọi TeleportAsync trong script server. |
Không có pcall, không thử lại | Trang của Roblox về teleport nói chúng có thể thất bại và báo lỗi, và cũng có thể thất bại sau khi đã bắt đầu. | Tối đa 3 lần thử trong pcall, và TeleportInitFailed cho phép người chơi thử lại. |
| Bỏ cuộc vì trong Studio "không chạy" | TeleportService không hỗ trợ playtest trong Studio. | Thay vào đó RunService:IsStudio() in ra việc cổng sẽ làm. |
| GUI teleport có các nút gửi vị trí | Kẻ gian lận có thể gọi cùng remote đó với vị trí bất kỳ. | Các nút gửi tên điểm, và server tra cứu nó. |
| Truyền xu qua teleport data | Roblox nói teleport data hiện với client và không được mã hóa. | Khuyên lưu xu và Wins trong kho dữ liệu và tải chúng ở place kia (xem Cách mang dữ liệu sang place khác). |
Người chơi có thể và không thể giả mạo những gì
Hãy coi như kẻ gian lận điều khiển mọi thứ trên thiết bị của họ: họ có thể sửa TeleportMenu, gọi cả hai remote bao nhiêu lần tùy thích với tham số bất kỳ và di chuyển nhân vật của mình. Đây là những gì điều đó mang lại cho họ với teleport này.
| Kẻ gian lận thử | Kết quả | Vì sao |
|---|---|---|
| Gửi vị trí hoặc CFrame qua remote của menu | Bị bỏ qua | TeleportRequest chỉ đọc một chuỗi, tên điểm dài tối đa 50 ký tự. Mọi thứ khác bị loại bỏ. |
| Xin đến Castle khi chưa có 3 Wins | Bị từ chối | Server đọc Wins từ bản leaderstats của chính nó. Nút màu xám chỉ là gợi ý. |
| Xin đến một điểm không tồn tại | Bị bỏ qua | Server tìm tên trong TeleportSpots và không làm gì nếu không có part nào tên như vậy. |
| Gọi remote của menu liên tục | Không quá một lần teleport qua menu mỗi 3 giây | Cooldown được lưu trên server, cho từng người chơi. |
| Kích hoạt bệ mà không đi đến nó | Họ đến bệ ghép đôi, nơi đằng nào họ cũng đi bộ tới được | Roblox liệt kê việc dịch chuyển đến bất kỳ điểm nào và thao túng sự kiện Touched trong số những việc client có thể làm với nhân vật của nó. |
| Vào thẳng một place khác trong game của bạn | Có thể, nếu Access Control for Places không phải Secure within universe only | Xem Ai có thể vào các place khác của bạn. |
| Di chuyển nhân vật của mình đến bất cứ đâu, kể cả điểm bị khóa | Có thể | Mỗi thiết bị điều khiển chuyển động của nhân vật mình. Điểm bị khóa là sự tiện lợi, không phải két sắt, nên hãy kiểm tra trên server trước khi trao thứ gì có giá trị ở đó. |
Dòng cuối là giới hạn thật của mọi teleport. Với game đối kháng, hãy thêm kiểm tra chuyển động phía server, như trong hướng dẫn chạy nhanh. Teleporters đã đặt thuộc tính MovementCheckSkip mà kiểm tra đó đọc, nên các teleport của chính nó không bị đánh dấu là vi phạm: tài liệu bảo mật của Roblox nói game có teleport hợp lệ cần đúng ngoại lệ như vậy trong kiểm tra chuyển động.
Bước 5: kiểm tra
- Bấm Play. Bước lên PadA: bạn xuất hiện ngay trước PadB, quay lưng về phía nó. Quay lại và bước ngay lên PadB: không có gì xảy ra, vì các bệ bỏ qua bạn trong 2 giây sau khi đến. Bước xuống, chờ 2 giây và bước lên PadB lần nữa: bạn xuất hiện trước PadA.
- Chờ vài giây, rồi bấm Teleport ở bên trái màn hình. Danh sách hiện Lake, Spawn và nút xám "Castle (needs 3 wins)". Chọn Lake: bạn xuất hiện trên đó. Mở menu lần nữa và chọn Castle: không có gì xảy ra, và Output im lặng.
- Cho mình 3 Wins (cần một script leaderstats có IntValue Wins, ví dụ từ hướng dẫn bảng xếp hạng). Bấm nút chuyển Client/Server để sang Server, tìm trong Explorer
Players, tên của bạn,leaderstats,Winsvà đặt Value của nó bằng 3 trong cửa sổ Properties. Chuyển lại sang Client và mở menu lần nữa: Castle đã chuyển sang màu tím và đưa bạn tới đó. - Chạm vào DungeonPortal. Output in ra một dòng bắt đầu bằng
Teleporters: would send, kèm tên của bạn và place ID. Trong Studio thì đúng là như vậy, và dòng này in không quá một lần mỗi 2 giây, dù bạn đứng trên cổng bao lâu. - Chọn Server & Clients trong danh sách chế độ test, đặt 2 client và bấm Play. Cả hai người chơi có thể dùng bệ cùng lúc, và cooldown của người này không bao giờ chặn người kia.
- Dừng test, publish game và chạy nó từ ứng dụng Roblox. Chạm vào cổng: màn hình tải của Roblox hiện ra, và bạn đến place kia. Nếu bạn vẫn ở chỗ cũ, mở Developer Console bằng phím F9, chuyển log sang chế độ xem Server, thứ chỉ chủ game và thành viên group có quyền chỉnh sửa nhìn thấy, rồi tìm các cảnh báo
Teleporters:, trong đó có lý do mà Roblox đưa ra.
Trong các bước ở Studio, hãy mở cửa sổ Output (menu Window, rồi Output). Khi Teleporters chạy đúng, nó không in gì ngoài dòng của cổng ở bước 4, nên mọi cảnh báo hay lỗi màu đỏ đều đáng đọc. Xem Lỗi thường gặp.
Cách mở rộng
Teleport cả đội hoặc cả nhóm cùng lúc
TeleportAsync nhận một danh sách người chơi, nên một cổng có thể đưa cả một nhóm sang cùng một place. Trang của Roblox về teleport gợi ý bắt đầu từ người chơi đã chạm cổng: player.Team và Team:GetPlayers() cho đội, hoặc SocialService:GetPlayersByPartyId() với player.PartyId cho nhóm (party). Truyền danh sách đó thay cho { player } và đặt cờ leavingForPlace cho từng người chơi trong đó.
Đưa một nhóm sang server riêng
Mặc định, người chơi được teleport sẽ vào server công khai của place kia. Để đưa một nhóm sang một server dành riêng mới, ví dụ cho một trận đấu, tạo TeleportOptions, đặt ShouldReserveServer của nó bằng true và truyền nó làm tham số thứ ba: TeleportService:TeleportAsync(placeId, players, options). Roblox lưu ý với các lỗi liên quan riêng đến server dành riêng, việc thử lại đặc biệt hữu ích, và script đã làm việc đó rồi.
Cách mang dữ liệu sang place khác
Teleport xóa mọi dữ liệu cục bộ của người chơi đó. Teleport data của Roblox, được đặt qua TeleportOptions:SetTeleportData() và đọc ở place kia qua player:GetJoinData(), hiện với client và không được mã hóa, nên chỉ dùng nó cho những lựa chọn vô hại, ví dụ tải bản đồ nào. Xu, Wins và vật phẩm hãy lưu trong kho dữ liệu, như trong hướng dẫn DataStore, và tải lại chúng khi người chơi đến place kia.
Màn hình tải riêng
Trong lúc teleport sang place đang tải, người chơi thấy màn hình tải mặc định của Roblox. Để hiện màn hình của bạn, gọi TeleportService:SetTeleportGui() trên client với một ScreenGui, ví dụ cái nằm trong ReplicatedStorage. Teleport trong hướng dẫn này bắt đầu trên server, nên client phải gọi nó từ trước, ví dụ ngay khi người chơi vào game. Roblox nói phải đặt lại màn hình trước mỗi lần teleport, và nó không được dùng cho place thuộc game khác. Ở đó cũng lưu ý script bên trong ScreenGui này không chạy, nên hãy làm nó tĩnh.
Teleport theo vòng chơi và checkpoint
Hệ thống vòng chơi chuyển mọi người chơi vào đấu trường ở đầu mỗi vòng bằng cùng lệnh gọi PivotTo, còn phần PivotTo hay SpawnLocation trong hướng dẫn obby so sánh cách này với điểm spawn của Roblox. Nếu một điểm chỉ nên mở sau một vòng, hệ thống vòng chơi đã cộng Wins mà WinsNeeded đọc.
Lỗi thường gặp và cách sửa
Mở cửa sổ Output (menu Window, rồi Output) trước khi bấm Play. Teleporters ghi tên bệ khi Destination trỏ vào chỗ không tồn tại, nên phần lớn vấn đề hiện ra ở đó.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'
TeleportMenu đang chờ remote do Teleporters tạo, nghĩa là Teleporters không chạy. Kiểm tra nó là Script, không phải LocalScript, nằm ngay trong ServerScriptService, không bị tắt và Output không có lỗi đỏ nào từ nó. Hướng dẫn lỗi script giải thích chi tiết cảnh báo này.
Teleporters: PadA points to PadC, which is not a part in TeleportPads
Thuộc tính Destination của bệ ghi tên một thứ không phải part nằm ngay trong thư mục TeleportPads. Kiểm tra chính tả và chữ hoa trong giá trị thuộc tính và trong tên bệ đích. Cảnh báo xuất hiện một lần cho mỗi bệ, khi người chơi chạm vào nó lần đầu.
Tôi bước lên bệ mà không có gì xảy ra
Kiểm tra thư mục tên đúng là TeleportPads và nằm ngay trong Workspace khi game bắt đầu, thuộc tính Destination của bệ có kiểu String (thuộc tính kiểu Number bị bỏ qua) và đã qua 2 giây kể từ lần teleport gần nhất của bạn. Cũng kiểm tra bệ đã bật CanTouch: Roblox nói kết nối Touched vào part có CanTouch tắt sẽ báo lỗi, và lỗi đó dừng script.
Tôi xuất hiện trong tường hoặc rơi khỏi mép
Người chơi xuất hiện cách 3 stud trước mặt trước của bệ đích. Bấm chuột phải lên bệ, chọn Show Orientation Indicator và xoay bệ đến khi đường xanh dương chỉ ra sàn trống. Các điểm menu đặt người chơi lên đỉnh part, nên hãy giữ mỗi điểm trên sàn.
Nút Castle vẫn xám sau khi tôi đã có 3 Wins
Danh sách được vẽ khi mở menu, nên hãy đóng menu và mở lại. Nếu nút vẫn xám, kiểm tra trong leaderstats có IntValue tên đúng là Wins và Wins đã thay đổi trên server, không chỉ ở chế độ Client.
Cổng không làm gì trong game đã publish
Mở Developer Console bằng phím F9, chuyển log sang chế độ xem Server (chỉ chủ game và thành viên group có quyền chỉnh sửa nhìn thấy, vì Teleporters là Script server) và đọc các cảnh báo Teleporters:, trong đó có lý do mà Roblox đưa ra. Kiểm tra thuộc tính PlaceId của cổng có kiểu Number và chứa ID từ Asset Manager, và bạn đã publish lại place sau khi thêm cổng.
Làm với RoCode
Nếu không muốn tự dựng tất cả những thứ này, RoCode có thể làm nó trong place bạn đang mở. RoCode là AI agent độc lập cho Roblox Studio, không phải của Roblox: bạn mô tả tính năng trong web chat của nó, và plugin Studio của nó tạo part và script trong Explorer của bạn, nên bạn không phải copy code từ cửa sổ chat.
Thêm teleport: các bệ trong Workspace.TeleportPads đưa người chơi đến bệ ghi trong thuộc tính Destination của chúng với cooldown 2 giây, một menu Teleport cho các điểm trong Workspace.TeleportSpots, trong đó Castle cần 3 Wins và được kiểm tra trên server, và các cổng trong Workspace.PlacePortals đưa người chơi sang place có ID trong thuộc tính PlaceId của chúng, có thử lại.
- Có thể xem place của bạn khi bước đó cần, qua Search Game và Search Scripts, để dựa vào vật phẩm, remote hoặc code lưu dữ liệu đã có thay vì thêm hệ thống thứ hai
- Tạo thư mục và part của các bệ qua Create Instance, đặt thuộc tính của chúng qua Set Property và viết Teleporters và TeleportMenu qua Create Script
- Được dặn kiểm tra biên dịch mỗi script đã viết bằng Check Script, công cụ biên dịch script trong Studio mà không chạy nó
- Gửi thay đổi theo từng đợt, và mỗi đợt là một điểm hoàn tác trong lịch sử của Studio
Teleport giữa các place chỉ chạy trong game đã publish, nên hãy tự kiểm tra chúng trong ứng dụng Roblox. Với plugin 3.9 trở lên, RoCode có thể chạy một playtest ngắn và đọc lỗi, và với plugin 3.9.15 trở lên nhân vật thử nghiệm của nó có thể bước lên bệ và bấm nút menu, nhưng nó chỉ kiểm tra những gì nó tự quyết định test, nên hãy tự bước lên bệ và mở menu. Teleport là một trong nhiều hệ thống của một game; tạo cả một game với RoCode cũng diễn ra như vậy, mỗi prompt một hệ thống. RoCode kết nối với Studio thế nào.
Câu hỏi thường gặp
Làm sao làm bệ teleport trong Roblox Studio?
Cho hai part một thuộc tính Destination ghi tên của nhau, và để một script server chuyển người chạm vào bệ bằng character:PivotTo đến điểm ngay trước bệ kia, với cooldown ngắn cho mỗi người chơi. Bước 1 và bước 2 dựng đúng việc đó.
Vì sao teleport của tôi không chạy trong Studio?
Bệ và menu chạy được trong Studio. Teleport sang place khác thì không: TeleportService của Roblox không hỗ trợ playtest trong Studio, nên hãy publish game và test trong ứng dụng Roblox. Script trong hướng dẫn này in ra việc cổng sẽ làm thay vì teleport, nên bạn vẫn kiểm tra được là nó có kích hoạt.
Làm sao teleport người chơi sang place khác trong game của tôi?
Thêm place qua File > Publish As (Add as a new place), sao chép place ID của nó từ Asset Manager và gọi TeleportService:TeleportAsync(placeId, { player }) từ một Script server bên trong pcall, thử lại khi thất bại. Bước 4 hướng dẫn tất cả những việc này.
Làm sao làm GUI teleport?
Dựng các nút trong LocalScript và chỉ gửi cho server tên điểm mà người chơi đã chọn. Server tìm tên trong thư mục, kiểm tra cooldown và mọi quy tắc mở khóa, sau đó chuyển nhân vật. Đừng bao giờ gửi vị trí từ client: kẻ gian lận có thể gửi bất kỳ vị trí nào.
Vì sao nhân vật của tôi bị kẹt hoặc rời ra sau khi teleport?
Gán Position của root part chỉ di chuyển part đó, không có cơ thể nối với nó, còn sao chép CFrame của bệ đặt giữa nhân vật vào trong bệ. Dùng character:PivotTo với một điểm ở độ cao đứng trên sàn, tính từ HipHeight của Humanoid.
Có thể mang xu hoặc vật phẩm theo khi teleport không?
Không an toàn. Roblox nói teleport data hiện với client và không được mã hóa, nên nó hợp với thứ như bản đồ đã chọn, không hợp với xu. Hãy lưu xu và vật phẩm trong kho dữ liệu và tải chúng ở place kia.
Nguồn và tài liệu đọc thêm
- Roblox Creator Docs: Teleport between places (bằng tiếng Anh). TeleportAsync, playtest trong Studio, Access Control for Places, màn hình teleport, teleport data và teleport thất bại
- Roblox Creator Docs: TeleportService (bằng tiếng Anh). Teleport đã lỗi thời, TeleportAsync chỉ trên server và TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (bằng tiếng Anh). hàm chính để di chuyển model từ script
- Roblox Creator Docs: BasePart.Position (bằng tiếng Anh). vì sao đặt Position cho part có mối nối làm nó dịch chuyển so với các part còn lại
- Roblox Creator Docs: Humanoid.HipHeight (bằng tiếng Anh). root part của nhân vật đang đứng nằm ở độ cao nào, với rig R15 và R6
- Roblox Creator Docs: Seat (bằng tiếng Anh). SeatWeld giữ nhân vật đang ngồi, và hủy nó để đưa nhân vật đứng dậy
- Roblox Creator Docs: Player:RequestStreamAroundAsync (bằng tiếng Anh). yêu cầu tải khu vực trước khi nhân vật di chuyển tới đó, không đảm bảo thứ gì sẽ tới
- Roblox Creator Docs: Streaming techniques and conversion (bằng tiếng Anh). streaming trước khi teleport
- Roblox Creator Docs: Access control and confidentiality (bằng tiếng Anh). vì sao client có thể vào bất kỳ place nào của game nếu teleport không được bảo vệ
- Roblox Creator Docs: Network ownership, movement validation, and physics (bằng tiếng Anh). client có thể làm gì với nhân vật của nó và ngoại lệ cho teleport trong kiểm tra chuyển động
- Roblox Creator Docs: Create and publish games and places (bằng tiếng Anh). publish, ai có thể mở game mới, và thêm place qua Publish As
- Roblox Creator Docs: Asset Manager (bằng tiếng Anh). cách sao chép place ID
- Roblox Creator Docs: Developer Console (bằng tiếng Anh). chế độ xem Server trong log và ai nhìn thấy nó
- Roblox Creator Docs: Debounce patterns (bằng tiếng Anh). vì sao Touched kích hoạt nhiều lần cho một lần chạm
Cách kiểm tra code: mọi script trong trang này đều qua trình kiểm tra kiểu nghiêm ngặt (strict) của Luau với định nghĩa API của Roblox (luau-lsp, 20 tháng 11, 2026). Kiểm tra kiểu bắt được API gõ sai và kiểu dữ liệu sai, không bắt được lỗi logic của game, nên hãy thử trong Studio trước khi xuất bản.