Ringkasnya
Untuk pad teleport, letakkan Script dalam ServerScriptService yang mendengar event Touched pad, mencari pemain melalui Players:GetPlayerFromCharacter dan memindahkan seluruh watak melalui character:PivotTo() ke titik betul-betul di hadapan pad destinasi, membelakanginya, dengan cooldown beberapa saat bagi setiap pemain supaya pad destinasi tidak terus menghantarnya balik. Untuk menghantar pemain ke place lain dalam game anda, panggil TeleportService:TeleportAsync(placeId, { player }) daripada Script pelayan di dalam pcall; ini hanya berfungsi dalam game yang diterbitkan, bukan dalam Studio.
- Pindahkan seluruh watak melalui
PivotTo. MenetapkanHumanoidRootPart.Positionmemisahkan root part daripada badan yang lain, kerana apabila Position ditetapkan, Roblox mengemas kini sambungan. - Menu teleport perlu menghantar nama destinasi kepada pelayan, bukan kedudukan. Pelayan menyemak nama, cooldown dan sebarang peraturan buka kunci sebelum memindahkan sesiapa.
TeleportService:Teleport()sudah lapuk dan berjalan pada klien. GunakanTeleportAsyncpada pelayan, balut dalampcall, cuba semula dan kendalikanTeleportInitFailed.
Di halaman ini
Dua jenis teleport
Teleport dalam game Roblox boleh bermaksud tiga perkara: pad yang memindahkan anda merentasi peta, menu lokasi yang boleh anda lompat ke sana, atau portal ke peringkat lain. Dua yang pertama memindahkan watak di dalam pelayan tempat pemain sudah berada. Yang ketiga menghantar pemain ke place lain dalam game anda, yang berjalan pada pelayannya sendiri. Ia menggunakan API yang berbeza, jadi ada baiknya anda tahu yang mana satu anda perlukan.
| Dalam pelayan yang sama | Ke place lain dalam game anda | |
|---|---|---|
| Panggilan | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| Untuk apa | Pad teleport, menu teleport, memindahkan pemain dari lobi ke arena | Portal ke peringkat lain, lobi yang menghantar pemain ke place berasingan dengan dungeon atau perlawanan |
| Di mana ia berjalan | Script pelayan | Hanya Script pelayan. Teleport() pada klien sudah lapuk. |
| Berfungsi dalam playtest Studio | Ya | Tidak. TeleportService dalam Roblox tidak menyokong playtest dalam Studio, jadi ujian dibuat dalam game yang diterbitkan. |
| Apa yang pemain nampak | Lompatan merentasi peta, yang boleh mengambil masa sehingga 2 saat jika kawasan itu perlu dimuatkan dahulu | Skrin loading Roblox, kemudian place yang lain |
| Syiling, item dan data lain | Kekal seperti sedia ada | Roblox menetapkan semula data tempatan pemain, jadi semua yang penting mesti datang daripada stor data dalam place yang lain |
Dalam panduan ini ketiga-tiga jenis dikumpulkan dalam satu Script pelayan, jadi satu set peraturan meliputi setiap teleport dalam game anda: pelayan yang memutuskan, setiap pemain ada cooldown sendiri, dan peranti pemain hanya memberitahu lokasi mana yang ingin dituju.
| Elemen | Lokasi | Apa yang dilakukan |
|---|---|---|
Folder TeleportPads dengan PadA dan PadB | Workspace | Dua pad. Atribut Destination setiap satu menamakan pad yang menjadi destinasi pemain. |
Folder TeleportSpots | Workspace | Satu part untuk setiap lokasi dalam senarai menu. Atribut WinsNeeded mengunci lokasi. |
Folder PlacePortals | Workspace | Part portal. Atribut PlaceId setiap portal ialah place yang menjadi destinasi pemain. |
Script Teleporters | ServerScriptService | Mengendalikan ketiga-tiga jenis teleport dan mencipta dua remote. Satu-satunya tempat teleport boleh berlaku. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | Melukis butang Teleport dan senarai lokasi, dan menghantar nama lokasi yang dipilih pemain. |
RemoteFunction GetTeleportSpots dan RemoteEvent TeleportRequest | ReplicatedStorage (dicipta oleh Teleporters) | Yang pertama memulangkan senarai lokasi kepada menu. Yang kedua membawa nama yang dipilih ke pelayan. |
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
Langkah 1: bina dua pad teleport
- Dalam Explorer, halakan kursor pada Workspace, klik butang + dan masukkan Folder. Namakan folder itu
TeleportPads. Skrip mencari nama ini dengan tepat. - Masukkan dua Part ke dalam folder dan namakan
PadAdanPadB. Jadikan setiap satu papak rata, contohnya 6 kali 1 kali 6 stud, dan letakkan di atas lantai berjauhan antara satu sama lain. Dalam tetingkap Properties, tandakan Anchored, biarkan CanCollide dan CanTouch dihidupkan, dan tetapkan warna terang dan bahan Neon supaya pemain perasan. - Pilih PadA, tatal tetingkap Properties ke bahagian Attributes dan klik +. Masukkan nama
Destination, pilih jenis String dan klik Save, kemudian tetapkan nilaiPadB. Lakukan yang sama pada PadB dengan nilaiPadA. - Putar setiap pad supaya muka hadapannya menghadap lantai yang lapang. Pemain muncul 3 stud di hadapan muka hadapan pad destinasi, membelakanginya, jadi biarkan beberapa stud lantai lapang di situ. Untuk melihat muka mana yang di hadapan, klik kanan pad dan pilih Show Orientation Indicator: muka hadapan ditandai garis biru. Putar pad dengan alat Rotate sehingga garis itu menghala ke arah pemain sepatutnya berjalan pergi.
Pemain sengaja diletakkan di sebelah pad, bukan di atasnya. Halaman Roblox tentang debounce menyebut bahawa Touched tercetus banyak kali berturut-turut untuk satu sentuhan, jadi pemain yang muncul tepat di atas pad lain akan mencetuskannya semula sebaik sahaja cooldown tamat, dan terbang balik merentasi peta.
Anda tidak terhad kepada dua pad. Destination pad boleh menamakan mana-mana part dalam TeleportPads, jadi tiga pad boleh menghantar pemain dalam bulatan. Untuk pad sehala, halakan ia ke part dalam TeleportPads yang tiada Destination sendiri: part sebegini menerima pemain dan tidak menghantar sesiapa ke mana-mana.
Langkah 2: tambah skrip teleport
Halakan kursor pada ServerScriptService, masukkan Script, namakan Teleporters dan tampal kod di bawah. Buat masa ini ia mengendalikan pad, dan selepas langkah seterusnya juga menu dan portal, jadi anda menambahnya sekali sahaja. Tetapan di bahagian atas ialah baris yang memang dimaksudkan untuk anda ubah.
-- Script dalam ServerScriptService bernama Teleporters.
-- Setiap teleport diputuskan di sini, pada pelayan:
-- 1. Pad: menyentuh part dalam Workspace.TeleportPads memindahkan anda ke part yang dinamakan
-- dalam atribut Destination miliknya.
-- 2. Menu: LocalScript TeleportMenu meminta lokasi daripada Workspace.TeleportSpots
-- mengikut nama. Pelayan menyemak nama, cooldown dan Wins yang diperlukan untuk lokasi.
-- 3. Portal: menyentuh part dalam Workspace.PlacePortals menghantar anda ke place
-- daripada atribut PlaceId miliknya (place lain dalam game ini).
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 -- selama ini pad mengabaikan pemain selepas sebarang teleport
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- stud di hadapan pad destinasi, supaya pemain mendarat di sebelahnya
local PLACE_ATTEMPTS = 3
local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")
-- Skrip ini sendiri mencipta kedua-dua remote, jadi jangan tambahkannya secara manual
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
-- Pada ketinggian berapa di atas lantai root part watak yang berdiri berada.
-- Formula daripada rujukan Roblox untuk Humanoid.HipHeight (rig R6 menambah ketinggian kaki).
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() -- tetapkan sebelum menunggu, supaya sentuhan kedua tidak mencetuskan teleport kedua
-- Menghadap ke arah muka hadapan destinasi (rata, tanpa kecondongan)
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
-- Berdiri di atas muka atasnya: pivot watak ialah root partnya, jadi naikkan ke ketinggian berdiri.
-- Pad pula meletakkan pemain beberapa stud di hadapannya, kerana pemain yang berdiri
-- di atas pad akan mencetuskannya semula pada langkah seterusnya.
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)
-- Dengan instance streaming dihidupkan, muatkan kawasan sekitar destinasi dahulu (sehingga 2 saat)
pcall(function()
player:RequestStreamAroundAsync(target.Position, 2)
end)
if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
return -- keluar, respawn atau mati semasa kawasan dimuatkan
end
-- Watak yang duduk dikimpal pada tempat duduk, dan memindahkannya akan mengheret tempat duduk bersama.
-- Memusnahkan SeatWeld dahulu membebaskan watak daripada tempat duduk.
local seat = humanoid.SeatPart
if seat then
local seatWeld = seat:FindFirstChild("SeatWeld")
if seatWeld then
seatWeld:Destroy()
end
end
character:PivotTo(target)
-- Mulakan semula cooldown apabila tiba: pramuat di atas boleh mengambil masa sehingga 2 saat,
-- dan pad tempat pemain mendarat tidak boleh terus menghantarnya balik
lastTeleport[player] = os.clock()
player:SetAttribute("MovementCheckSkip", true) -- untuk skrip semakan kelajuan, jika anda ada
end
-- 1. Pad
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 -- beri amaran sekali, bukan pada setiap sentuhan
warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
end
end)
end
end
end
-- 2. Menu: senarai lokasi, kemudian permintaan mengikut nama
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 sama: ikut abjad, supaya susunan tidak pernah berubah
end)
return list
end
teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
-- Klien hanya menghantar nama. Jangan sekali-kali terima kedudukan atau CFrame daripada klien.
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 -- berkunci untuk pemain ini
end
teleportTo(player, spot, false)
end)
-- 3. Portal ke place lain dalam game ini
local function sendToPlace(player: Player, placeId: number)
if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
return -- sudah dalam perjalanan atau baru menyentuh teleport sesaat tadi
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 -- berputus asa; sentuhan portal yang baharu akan cuba lagi
end
-- Teleport boleh gagal walaupun selepas bermula. Pemain kekal di sini dan boleh cuba lagi.
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 sendiri mencipta RemoteFunction GetTeleportSpots dan RemoteEvent TeleportRequest, jadi anda tidak perlu memasukkan apa-apa ke dalam ReplicatedStorage secara manual. Ia menyambungkan pad daripada TeleportPads dan portal daripada PlacePortals sekali sahaja, semasa pelayan bermula, jadi pad dan portal yang ditambah semasa permainan tidak melakukan apa-apa. Jika mana-mana folder tiada, jenis teleport itu hanya dimatikan.
| Bahagian | Apa yang dilakukan | Kenapa |
|---|---|---|
playerFromHit | Mencari model watak yang memiliki part yang menyentuh, dan bertanya kepada Players:GetPlayerFromCharacter milik siapa model itu. | Pad disentuh oleh kaki, topi dan part bebas. Apa sahaja yang bukan sebahagian watak pemain memberi nil dan diabaikan. |
onCooldown | Membandingkan os.clock() dengan masa teleport terakhir pemain. | Satu cooldown bagi setiap pemain, jadi pemain yang berdiri di sebelah pad tidak pernah menyekat orang lain. Tiada apa-apa yang menunggu atau tidur. |
rootHeight | Mengira pada ketinggian berapa di atas lantai root part watak yang berdiri berada: separuh ketinggian root part ditambah HipHeight Humanoid, ditambah panjang kaki untuk rig R6. | Ini formula daripada rujukan Roblox untuk Humanoid.HipHeight. Pivot watak ialah root partnya, jadi menaikkan pivot sebanyak nilai ini meletakkan kaki di atas permukaan untuk avatar kecil, besar dan juga R6. |
Semakan di awal teleportTo | Keluar jika pemain tiada watak hidup dengan root part, kemudian terus merekod masa. | Permintaan streaming di bawah boleh membuatkan skrip menunggu. Jika masa direkod lebih awal, banyak event Touched pada ketika itu tidak akan mencetuskan teleport kedua. |
| Titik ketibaan | Muka atas destinasi, dinaikkan sebanyak rootHeight, menghadap ke arah muka hadapannya, tanpa kecondongan. Untuk pad, titik itu juga dianjak 3 stud dari muka hadapannya. | Watak muncul dalam keadaan berdiri, bukan di dalam part destinasi. Di sebelah pad, kakinya bermula pada paras muka atas pad, jadi ia turun ke lantai setebal pad itu. CFrame.lookAlong membina CFrame pada kedudukan dengan arah pandangan yang ditetapkan. |
RequestStreamAroundAsync | Meminta Roblox menghantar kawasan sekitar titik ketibaan kepada pemain ini dahulu dan menunggu tidak lebih daripada 2 saat. | Instance streaming dihidupkan secara lalai dalam place baharu, jadi bahagian peta yang jauh mungkin belum dimuatkan pada peranti pemain. Roblox mengesyorkan panggilan pelayan ini sebelum memindahkan watak jauh, walaupun tidak menjamin apa yang akan sampai. |
| Semakan kedua | Jika pemain keluar, atau watak respawn atau mati semasa menunggu, tiada apa-apa bergerak. | Pemain mungkin membuat reset atau keluar dari game semasa kawasan dimuatkan. Contoh pramuat Roblox sendiri juga menyemak bahawa watak masih dalam game sebelum memindahkannya. |
Baris dengan SeatWeld | Jika watak sedang duduk, memusnahkan Weld yang memegangnya pada tempat duduk. | Roblox mengimpal watak yang duduk pada tempat duduk. PivotTo menggerakkan part dengan mengubah CFrame mereka, dan rujukan Roblox menyatakan bahawa menetapkan CFrame part juga menggerakkan part yang disambungkan kepadanya, jadi tanpa ini tempat duduk dan semua yang dikimpal padanya akan tiba bersama pemain. Memusnahkan SeatWeld ialah cara rujukan Roblox untuk Seat mengangkat watak dari tempat duduk melalui skrip. |
character:PivotTo(target) | Memindahkan seluruh watak, semua anggota dan aksesori bersama, ke titik ketibaan. | Roblox menyebut PivotTo sebagai fungsi utama untuk memindahkan model melalui skrip. |
Baris kedua dengan lastTeleport | Memulakan semula cooldown apabila tiba. | Permintaan streaming boleh mengambil masa sehingga 2 saat, sama dengan cooldown pad itu sendiri, jadi tanpa baris ini pemain mungkin tiba dengan cooldown yang sudah tamat. |
MovementCheckSkip | Menetapkan atribut pada Player selepas setiap pemindahan. | Semakan kelajuan pelayan akan menganggap lompatan itu sebagai cheat. MovementCheck daripada panduan pecut membaca atribut ini dan mula mengukur semula dari kedudukan baharu. Tanpa skrip sebegitu, atribut ini tidak melakukan apa-apa. |
| Tetapan | Nilai di sini | Apa yang diubah |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Berapa lama pad dan portal mengabaikan pemain selepas sebarang teleport. |
MENU_COOLDOWN_SECONDS | 3 | Jarak masa paling pendek antara dua teleport melalui menu bagi seorang pemain. Pad dan menu berkongsi jam yang sama bagi setiap pemain, jadi permintaan menu dalam 3 saat selepas teleport pad juga diabaikan. |
PAD_ARRIVAL_GAP | 3 | Berapa stud dari muka hadapan pad destinasi pemain muncul, supaya mereka mendarat di sebelah pad, bukan di atasnya. |
PLACE_ATTEMPTS | 3 | Berapa kali portal mencuba TeleportAsync dengan selang 2 saat sebelum berputus asa. |
Klik Play sekarang dan pijak PadA: anda akan muncul di hadapan PadB. Menu dan portal memerlukan dua langkah seterusnya, tetapi skrip sudah berfungsi tanpanya.
Langkah 4: teleport ke place lain
Place ialah dunia berasingan di dalam game anda, dengan pelayannya sendiri: lobi dan dungeon, atau hab dan satu set peringkat. Pemain berpindah antara place melalui TeleportService, dan Roblox hanya menjalankannya dalam game yang diterbitkan, jadi langkah ini berakhir dalam aplikasi Roblox, bukan dalam Studio.
- Jika game belum diterbitkan, pilih File > Publish. Game baharu, sehingga anda melancarkannya, hanya terbuka kepada anda, orang yang anda beri akses Edit dan ahli kumpulan dengan peranan yang sesuai, dan itu sudah cukup untuk ujian teleport anda sendiri.
- Cipta place kedua: buka place baharu daripada mana-mana templat Studio, bina dungeon anda, kemudian pilih File > Publish As, klik jubin game anda, pilih Add as a new place dan klik Create.
- Salin ID place baharu itu. Buka Asset Manager daripada menu Window atau tab Home, pergi ke Places In Experience, klik kanan place itu dan pilih Copy Asset ID, yang menyalin place ID miliknya.
- Kembali ke place pertama, masukkan Folder bernama
PlacePortalske dalam Workspace, dan di dalamnya Part yang di-anchor bernamaDungeonPortal. Tambah atribut jenis Number bernamaPlaceIddan tampal ID itu sebagai nilainya. - Klik Play dan sentuh portal. Output mencetak baris yang bermula dengan
Teleporters: would send: dalam Studio, portal tidak melakukan apa-apa lagi. - Terbitkan game sekali lagi melalui File > Publish supaya portal muncul dalam game yang diterbitkan, dan uji dari aplikasi Roblox seperti dalam langkah 5.
Teleporters memanggil TeleportAsync di dalam pcall, sehingga 3 kali dengan jeda 2 saat antara cubaan, kerana halaman Roblox tentang teleport menyatakan teleport boleh gagal dan memberi ralat, dan mengesyorkan cuba semula. Teleport juga boleh bermula dan gagal pada saat akhir tanpa ralat, meninggalkan pemain di tempat asalnya. Untuk kes ini Roblox mencetuskan TeleportInitFailed, dan skrip membuang bendera «sedang pergi» daripada pemain, jadi sentuhan portal yang baharu akan cuba lagi.
Untuk membawa pemain balik, lakukan perkara yang sama dalam place yang lain: letakkan salinan Teleporters dalam ServerScriptService miliknya dan tambah portal yang PlaceIdnya ialah ID place pertama anda, disalin daripada Asset Manager dengan cara yang sama.
Siapa boleh masuk ke place anda yang lain
Dokumentasi keselamatan Roblox memberi amaran: sebaik sahaja klien berada dalam satu place game anda, ia boleh teleport ke mana-mana place lain dalam game itu, tidak kira laluan yang anda rancang, dan mematikan Direct Access pada place hanya membuang butang Join di laman web. Yang mengubahnya ialah tetapan Access Control for Places di bahagian Audience > Access Settings dalam Creator Dashboard:
| Tetapan | Siapa boleh masuk ke place yang bukan place permulaan |
|---|---|
| Fully open | Sesiapa sahaja, melalui teleport dari mana-mana game, deep link, jemputan ke game dan menyertai rakan. |
| Limited to same universe | Hanya pemain yang teleport dari dalam game anda. Teleport dari klien dan pelayan dibenarkan. |
| Secure within universe only | Hanya pemain yang diteleport oleh skrip pelayan anda dari dalam game ini. |
Jika pemain sepatutnya masuk ke place hanya melalui portal anda, contohnya dungeon, pilih Secure within universe only. Setiap teleport dalam panduan ini bermula pada pelayan, jadi ia akan terus berfungsi. Roblox juga menyatakan banyak game tidak memerlukan teleport selamat, jadi game yang semua placenya terbuka kepada semua boleh membiarkan tetapan ini seperti sedia ada.
Di mana tutorial teleport lama tersilap
Jika anda membandingkan panduan ini dengan video atau hantaran forum, inilah perbezaan penting dan sebab setiap teknik menimbulkan masalah.
| Tutorial | Masalah | Panduan ini |
|---|---|---|
Menetapkan hit.Parent.HumanoidRootPart.Position = target.Position | Rujukan Roblox menyatakan bahawa menetapkan Position mengemas kini sambungan part, dan ia beralih berbanding part yang disambungkan kepadanya: root part bergerak tanpa badan. | Memindahkan seluruh watak melalui PivotTo. |
Menetapkan HumanoidRootPart.CFrame = target.CFrame | Bahagian tengah watak berada di tengah part sasaran, separuh di dalamnya, dan mengambil kecondongan part itu. | Watak muncul pada ketinggian berdiri di atas muka atas, di sebelah pad, tanpa kecondongan. |
Menggunakan satu pemboleh ubah debounce untuk seluruh pad | Semasa seorang pemain diteleport, pad mengabaikan semua orang lain. Dan tanpa debounce langsung, pemain yang muncul di atas pad lain terus dihantar balik. | Satu cooldown bagi setiap pemain, direkod sebelum sebarang penantian, dan pemain muncul di sebelah pad. |
Memanggil TeleportService:Teleport(placeId, player) daripada LocalScript | Roblox menandakan Teleport() sebagai lapuk, menasihatkan supaya tidak menggunakannya dalam projek baharu dan membenarkan TeleportAsync hanya daripada skrip pelayan. | Memanggil TeleportAsync dalam skrip pelayan. |
Tiada pcall, tiada cubaan semula | Halaman Roblox tentang teleport menyatakan ia boleh gagal dan memberi ralat, dan juga gagal selepas bermula. | Sehingga 3 cubaan dalam pcall, dan TeleportInitFailed membolehkan pemain cuba lagi. |
| Berputus asa kerana dalam Studio ia «tidak berfungsi» | TeleportService tidak menyokong playtest dalam Studio. | RunService:IsStudio() sebaliknya mencetak apa yang akan dilakukan portal. |
| GUI teleport yang butangnya menghantar kedudukan | Penipu boleh memanggil remote yang sama dengan sebarang kedudukan. | Butang menghantar nama lokasi, dan pelayan mencarinya. |
| Syiling dihantar dalam teleport data | Roblox menyatakan teleport data boleh dilihat oleh klien dan tidak disulitkan. | Menasihatkan supaya menyimpan syiling dan Wins dalam stor data dan memuatkannya dalam place yang lain (lihat Cara membawa data ke place lain). |
Apa yang pemain boleh dan tidak boleh palsukan
Anggap penipu mengawal segala-galanya pada perantinya: dia boleh mengubah TeleportMenu, memanggil kedua-dua remote berapa kali pun dengan sebarang argumen dan menggerakkan wataknya sendiri. Inilah yang boleh dia lakukan dengan teleport ini.
| Penipu cuba | Hasil | Kenapa |
|---|---|---|
| Menghantar kedudukan atau CFrame melalui remote menu | Diabaikan | TeleportRequest membaca satu rentetan, iaitu nama lokasi sepanjang 50 aksara atau kurang. Selain itu dibuang. |
| Meminta Castle tanpa 3 Wins | Ditolak | Pelayan membaca Wins daripada salinan leaderstats miliknya. Butang kelabu hanyalah petunjuk. |
| Meminta lokasi yang tidak wujud | Diabaikan | Pelayan mencari nama itu dalam TeleportSpots dan tidak melakukan apa-apa jika tiada part dengan nama itu. |
| Memanggil remote menu berulang kali | Tidak lebih daripada satu teleport menu setiap 3 saat | Cooldown disimpan pada pelayan, bagi setiap pemain. |
| Mencetuskan pad tanpa mendekatinya | Dia sampai ke pad pasangan, yang memang boleh dicapainya dengan berjalan | Roblox menyenaraikan teleport ke mana-mana titik dan memanipulasi event Touched antara perkara yang boleh dilakukan klien dengan wataknya sendiri. |
| Masuk terus ke place lain dalam game anda | Mungkin, jika Access Control for Places bukan Secure within universe only | Lihat Siapa boleh masuk ke place anda yang lain. |
| Menggerakkan wataknya ke mana-mana, termasuk lokasi berkunci | Mungkin | Setiap peranti mengawal pergerakan wataknya sendiri. Lokasi berkunci ialah kemudahan, bukan peti besi, jadi semak pada pelayan sebelum memberi apa-apa yang bernilai di sana. |
Baris terakhir ialah had sebenar mana-mana teleport. Untuk game kompetitif, tambah semakan pergerakan pada pelayan, seperti dalam panduan pecut. Teleporters sudah menetapkan atribut MovementCheckSkip yang dibaca oleh semakan itu, jadi teleportnya sendiri tidak ditandakan sebagai pelanggaran: dokumentasi keselamatan Roblox menyatakan game dengan teleport yang sah memerlukan pengecualian sebegini dalam semakan pergerakan.
Langkah 5: uji
- Klik Play. Pijak PadA: anda muncul betul-betul di hadapan PadB, membelakanginya. Berpusing dan terus pijak PadB: tiada apa-apa berlaku, kerana pad mengabaikan anda selama 2 saat selepas tiba. Turun, tunggu 2 saat dan pijak PadB sekali lagi: anda muncul di hadapan PadA.
- Tunggu beberapa saat, kemudian klik Teleport di sebelah kiri skrin. Senarai menunjukkan Lake, Spawn dan "Castle (needs 3 wins)" yang kelabu. Pilih Lake: anda muncul di atasnya. Buka menu sekali lagi dan pilih Castle: tiada apa-apa berlaku, dan Output senyap.
- Beri diri anda 3 Wins (untuk ini anda perlukan skrip leaderstats dengan IntValue Wins, contohnya daripada panduan leaderboard). Klik suis Client/Server untuk bertukar ke Server, cari dalam Explorer
Players, nama anda,leaderstats,Winsdan tetapkan Valuenya kepada 3 dalam tetingkap Properties. Tukar balik ke Client dan buka menu sekali lagi: Castle menjadi ungu dan memindahkan anda ke sana. - Sentuh DungeonPortal. Output mencetak baris yang bermula dengan
Teleporters: would send, dengan nama anda dan place ID. Dalam Studio memang begitu sepatutnya, dan ia dicetak tidak lebih daripada sekali setiap 2 saat, tidak kira berapa lama anda berdiri di atas portal. - Pilih Server & Clients dalam senarai juntai mod ujian, tetapkan 2 klien dan klik Play. Kedua-dua pemain boleh menggunakan pad serentak, dan cooldown seorang tidak pernah menyekat yang lain.
- Hentikan ujian, terbitkan game dan lancarkannya dari aplikasi Roblox. Sentuh portal: skrin loading Roblox muncul, dan anda berada di place yang lain. Jika anda kekal di tempat yang sama, buka Developer Console dengan kekunci F9, tukar log ke paparan Server, yang hanya boleh dilihat oleh pemilik game dan ahli kumpulan dengan kebenaran mengedit, dan cari amaran
Teleporters:, yang menyatakan sebab yang diberi oleh Roblox.
Semasa langkah dalam Studio, biarkan tetingkap Output terbuka (menu Window, kemudian Output). Apabila Teleporters berfungsi, ia tidak mencetak apa-apa selain baris portal daripada langkah 4, jadi sebarang amaran atau ralat merah wajar dibaca. Lihat Ralat biasa.
Cara mengembangkannya
Teleport pasukan atau party bersama-sama
TeleportAsync menerima senarai pemain, jadi satu portal boleh menghantar seluruh kumpulan ke satu place. Halaman Roblox tentang teleport mencadangkan bermula daripada pemain yang menyentuh portal: player.Team dan Team:GetPlayers() untuk pasukan, atau SocialService:GetPlayersByPartyId() dengan player.PartyId untuk party. Hantar senarai itu dan bukannya { player }, dan tetapkan bendera leavingForPlace untuk setiap pemain di dalamnya.
Menghantar kumpulan ke pelayan sendiri
Secara lalai, pemain yang diteleport masuk ke pelayan awam place yang lain. Untuk menghantar kumpulan ke pelayan simpanan (reserved) yang baharu, contohnya untuk perlawanan, cipta TeleportOptions, tetapkan ShouldReserveServernya kepada true dan hantar sebagai argumen ketiga: TeleportService:TeleportAsync(placeId, players, options). Roblox menyebut bahawa untuk kegagalan yang berkaitan dengan pelayan simpanan khususnya, cubaan semula amat berguna, dan skrip ini sudah melakukannya.
Cara membawa data ke place lain
Teleport menetapkan semula semua data tempatan pemain itu. Teleport data dalam Roblox, yang ditetapkan melalui TeleportOptions:SetTeleportData() dan dibaca dalam place lain melalui player:GetJoinData(), boleh dilihat oleh klien dan tidak disulitkan, jadi gunakannya hanya untuk pilihan yang tidak berbahaya, contohnya peta mana yang hendak dimuatkan. Simpan syiling, Wins dan item dalam stor data, seperti dalam tutorial DataStore, dan muatkan semula apabila pemain tiba di place yang lain.
Skrin loading sendiri
Semasa teleport ke place dimuatkan, pemain melihat skrin loading standard Roblox. Untuk menunjukkan skrin sendiri, panggil TeleportService:SetTeleportGui() pada klien dengan ScreenGui, contohnya yang berada dalam ReplicatedStorage. Teleport dalam panduan ini bermula pada pelayan, jadi klien perlu memanggilnya lebih awal, contohnya sebaik sahaja pemain masuk. Roblox menyatakan skrin itu perlu ditetapkan semula sebelum setiap teleport dan ia tidak digunakan untuk place dalam game lain. Di situ juga disebut bahawa skrip di dalam ScreenGui itu tidak berjalan, jadi jadikannya statik.
Teleport pusingan dan checkpoint
Sistem pusingan memindahkan semua pemain ke arena pada permulaan setiap pusingan dengan panggilan PivotTo yang sama, dan bahagian PivotTo atau SpawnLocation dalam panduan obby membandingkan pendekatan ini dengan titik spawn Roblox. Jika lokasi hanya patut dibuka selepas pusingan, sistem pusingan sudah memberi Wins yang dibaca oleh WinsNeeded.
Ralat biasa dan cara membaikinya
Buka tetingkap Output (menu Window, kemudian Output) sebelum klik Play. Teleporters menamakan pad apabila Destination menghala ke tempat yang tiada, jadi kebanyakan masalah kelihatan di situ.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'
TeleportMenu sedang menunggu remote yang dicipta oleh Teleporters, bermakna Teleporters tidak berjalan. Semak bahawa ia Script, bukan LocalScript, bahawa ia terus berada dalam ServerScriptService, tidak dimatikan, dan tiada ralat merah daripadanya dalam Output. Panduan ralat skrip menerangkan amaran ini dengan terperinci.
Teleporters: PadA points to PadC, which is not a part in TeleportPads
Atribut Destination pad menamakan sesuatu yang bukan part terus di dalam folder TeleportPads. Semak ejaan dan huruf besar dalam nilai atribut dan dalam nama pad destinasi. Amaran muncul sekali bagi setiap pad, apabila pemain menyentuhnya buat kali pertama.
Saya pijak pad dan tiada apa-apa berlaku
Semak bahawa folder dinamakan tepat TeleportPads dan berada terus dalam Workspace semasa game bermula, bahawa atribut Destination pad berjenis String (atribut jenis Number diabaikan) dan bahawa 2 saat telah berlalu sejak teleport terakhir anda. Semak juga bahawa CanTouch pad dihidupkan: Roblox menyatakan menyambungkan Touched pada part dengan CanTouch dimatikan memberi ralat, dan ralat itu menghentikan skrip.
Saya muncul di dalam dinding atau jatuh dari tepi
Pemain muncul 3 stud di hadapan muka hadapan pad destinasi. Klik kanan pad, pilih Show Orientation Indicator dan putar pad sehingga garis biru menghala ke lantai yang lapang. Lokasi menu meletakkan pemain di atas part, jadi pastikan setiap lokasi berada di atas lantai.
Butang Castle kekal kelabu selepas saya dapat 3 Wins
Senarai dilukis apabila menu dibuka, jadi tutup menu dan buka semula. Jika butang masih kelabu, semak bahawa leaderstats ada IntValue bernama tepat Wins dan bahawa Wins berubah pada pelayan, bukan hanya dalam mod Client.
Portal tidak melakukan apa-apa dalam game yang diterbitkan
Buka Developer Console dengan kekunci F9, tukar log ke paparan Server (hanya boleh dilihat oleh pemilik game dan ahli kumpulan dengan kebenaran mengedit, kerana Teleporters ialah Script pelayan) dan baca amaran Teleporters:, yang menyatakan sebab yang diberi oleh Roblox. Semak bahawa atribut PlaceId portal berjenis Number dan mengandungi ID daripada Asset Manager, dan bahawa anda menerbitkan place semula selepas menambah portal.
Buat dengan RoCode
Jika anda tidak mahu membina semua ini dengan tangan, RoCode boleh melakukannya dalam place yang sedang anda buka. RoCode ialah ejen AI bebas untuk Roblox Studio, bukan daripada Roblox: anda menerangkan ciri dalam chat webnya, dan plugin Studionya mencipta part dan skrip dalam Explorer anda, jadi anda tidak perlu menyalin kod dari tetingkap chat.
Tambah teleport: pad dalam Workspace.TeleportPads yang menghantar pemain ke pad daripada atribut Destination masing-masing dengan cooldown 2 saat, menu Teleport untuk lokasi dalam Workspace.TeleportSpots di mana Castle memerlukan 3 Wins dengan semakan pada pelayan, dan portal dalam Workspace.PlacePortals yang menghantar pemain ke place dengan ID daripada atribut PlaceId masing-masing, dengan cubaan semula.
- Boleh meneliti place anda apabila langkah itu memerlukannya, melalui Search Game dan Search Scripts, untuk membina di atas item, remote atau kod simpanan yang sedia ada dan bukannya menambah sistem kedua
- Mencipta folder dan part pad melalui Create Instance, menetapkan sifatnya melalui Set Property dan menulis Teleporters serta TeleportMenu melalui Create Script
- Ia diarahkan menyemak kompilasi setiap skrip yang ditulis melalui Check Script, yang mengkompilnya dalam Studio tanpa menjalankannya
- Menghantar perubahan secara berkelompok, dan setiap kelompok ialah satu titik undo dalam sejarah Studio
Teleport antara place hanya berfungsi dalam game yang diterbitkan, jadi uji sendiri dalam aplikasi Roblox. Dengan plugin 3.9 atau lebih baharu, RoCode boleh menjalankan playtest pendek dan membaca ralat, dan dengan plugin 3.9.15 atau lebih baharu watak ujiannya boleh memijak pad dan menekan butang menu, tetapi ia hanya menyemak apa yang diputuskannya sendiri untuk diuji, jadi pijak pad dan buka menu sendiri. Teleport ialah satu sistem antara banyak dalam game; membina seluruh game dengan RoCode berjalan dengan cara yang sama, satu sistem bagi setiap prompt. Cara RoCode bersambung dengan Studio.
Soalan lazim
Bagaimana buat pad teleport dalam Roblox Studio?
Beri dua part atribut Destination dengan nama satu sama lain, dan biarkan satu skrip pelayan memindahkan sesiapa yang menyentuh pad melalui character:PivotTo ke titik betul-betul di hadapan pad yang satu lagi, dengan cooldown pendek bagi setiap pemain. Langkah 1 dan langkah 2 membina tepat perkara ini.
Kenapa teleport saya tidak berfungsi dalam Studio?
Pad dan menu berfungsi dalam Studio. Teleport ke place lain tidak: TeleportService dalam Roblox tidak menyokong playtest dalam Studio, jadi terbitkan game dan uji dalam aplikasi Roblox. Skrip dalam panduan ini mencetak apa yang akan dilakukan portal dan bukannya teleport, jadi anda masih boleh menyemak bahawa ia tercetus.
Bagaimana teleport pemain ke place lain dalam game saya?
Tambah place melalui File > Publish As (Add as a new place), salin place ID miliknya daripada Asset Manager dan panggil TeleportService:TeleportAsync(placeId, { player }) daripada Script pelayan di dalam pcall, cuba semula jika gagal. Langkah 4 membimbing anda melalui semuanya.
Bagaimana buat GUI teleport?
Bina butang dalam LocalScript dan hantar kepada pelayan hanya nama lokasi yang dipilih pemain. Pelayan mencari nama dalam folder, menyemak cooldown dan sebarang peraturan buka kunci, kemudian memindahkan watak. Jangan sekali-kali hantar kedudukan dari klien: penipu boleh menghantar apa sahaja.
Kenapa watak saya tersekat atau berkecai selepas teleport?
Menetapkan Position root part hanya menggerakkan part itu, tanpa badan yang disambungkan kepadanya, dan menyalin CFrame pad meletakkan bahagian tengah watak di dalam pad. Gunakan character:PivotTo dengan titik pada ketinggian berdiri di atas lantai, dikira daripada HipHeight Humanoid.
Bolehkah saya bawa syiling atau item bersama teleport?
Tidak dengan selamat. Roblox menyatakan teleport data boleh dilihat oleh klien dan tidak disulitkan, jadi ia sesuai untuk sesuatu seperti peta yang dipilih, tetapi bukan untuk syiling. Simpan syiling dan item dalam stor data dan muatkannya dalam place yang lain.
Sumber dan bacaan lanjut
- Roblox Creator Docs: Teleport between places (dalam bahasa Inggeris). TeleportAsync, playtest dalam Studio, Access Control for Places, skrin teleport, teleport data dan teleport yang gagal
- Roblox Creator Docs: TeleportService (dalam bahasa Inggeris). Teleport yang lapuk, TeleportAsync hanya pada pelayan dan TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (dalam bahasa Inggeris). fungsi utama untuk memindahkan model melalui skrip
- Roblox Creator Docs: BasePart.Position (dalam bahasa Inggeris). kenapa menetapkan Position pada part yang bersambung menganjaknya berbanding yang lain
- Roblox Creator Docs: Humanoid.HipHeight (dalam bahasa Inggeris). pada ketinggian berapa root part watak yang berdiri berada, untuk rig R15 dan R6
- Roblox Creator Docs: Seat (dalam bahasa Inggeris). SeatWeld yang memegang watak yang duduk, dan memusnahkannya untuk mengangkat watak
- Roblox Creator Docs: Player:RequestStreamAroundAsync (dalam bahasa Inggeris). meminta kawasan sebelum watak dipindahkan ke sana, tanpa jaminan apa yang akan sampai
- Roblox Creator Docs: Streaming techniques and conversion (dalam bahasa Inggeris). streaming awal sebelum teleport
- Roblox Creator Docs: Access control and confidentiality (dalam bahasa Inggeris). kenapa klien boleh masuk ke mana-mana place dalam game jika teleport tidak dilindungi
- Roblox Creator Docs: Network ownership, movement validation, and physics (dalam bahasa Inggeris). apa yang boleh dilakukan klien dengan wataknya sendiri dan pengecualian untuk teleport dalam semakan pergerakan
- Roblox Creator Docs: Create and publish games and places (dalam bahasa Inggeris). penerbitan, siapa boleh membuka game baharu, dan menambah place melalui Publish As
- Roblox Creator Docs: Asset Manager (dalam bahasa Inggeris). cara menyalin place ID
- Roblox Creator Docs: Developer Console (dalam bahasa Inggeris). paparan Server dalam log dan siapa yang boleh melihatnya
- Roblox Creator Docs: Debounce patterns (dalam bahasa Inggeris). kenapa Touched tercetus beberapa kali untuk satu sentuhan
Cara kod disemak: setiap skrip di halaman ini lulus semakan jenis Luau yang ketat dengan definisi API Roblox (luau-lsp, 20 November 2026). Semakan jenis mengesan kesilapan nama API dan jenis yang salah, tetapi bukan kesilapan logik permainan, jadi uji semuanya dalam Studio sebelum anda menerbitkannya.