Singkatnya
Untuk pad teleport, taruh Script di ServerScriptService yang mendengarkan event Touched milik pad, mencari pemainnya dengan Players:GetPlayerFromCharacter, dan memindahkan seluruh karakter dengan character:PivotTo() ke titik tepat di depan pad tujuan, menghadap menjauhinya, dengan cooldown beberapa detik per pemain supaya pad tujuan tidak langsung mengirim mereka balik. Untuk mengirim pemain ke place lain di game kamu, panggil TeleportService:TeleportAsync(placeId, { player }) dari Script server di dalam pcall; ini hanya berfungsi di game yang sudah dipublish, tidak di Studio.
- Pindahkan seluruh karakter dengan
PivotTo. MengaturHumanoidRootPart.Positionmemindahkan root part menjauh dari sisa tubuhnya, karena Roblox memperbarui joint saat Position diatur. - Menu teleport harus mengirim nama tujuan ke server, jangan pernah posisi. Server mengecek nama, cooldown dan aturan unlock apa pun sebelum memindahkan siapa pun.
TeleportService:Teleport()sudah deprecated dan berjalan di sisi client. PakaiTeleportAsyncdi server, bungkus denganpcall, coba lagi, dan tanganiTeleportInitFailed.
Di halaman ini
Dua jenis teleport
Teleporter bisa berarti tiga hal di game Roblox: pad yang mengirimmu ke seberang map, menu berisi spot untuk dilompati, atau portal ke level lain. Dua yang pertama memindahkan karakter di dalam server tempat pemain sudah berada. Yang ketiga mengirim pemain ke place lain di game kamu, yang berjalan di servernya sendiri. Keduanya memakai API yang berbeda, jadi ada baiknya tahu mana yang kamu butuhkan.
| Di dalam server yang sama | Ke place lain di game kamu | |
|---|---|---|
| Panggilannya | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| Dipakai untuk | Pad teleport, menu teleport, memindahkan pemain dari lobby ke arena | Portal ke level lain, lobby yang mengirim pemain ke place dungeon atau match yang terpisah |
| Berjalan di | Script server | Hanya Script server. Teleport() di sisi client sudah deprecated. |
| Berfungsi di playtest Studio | Ya | Tidak. TeleportService Roblox tidak mendukung playtest di Studio, jadi kamu mengetesnya di game yang sudah dipublish. |
| Yang dilihat pemain | Lompatan ke seberang map, yang bisa memakan sampai 2 detik kalau area itu harus dimuat dulu | Loading screen Roblox, lalu place lainnya |
| Coin, item dan data lain | Tetap apa adanya | Roblox membuang data lokal pemain, jadi apa pun yang penting harus datang dari data store di place lainnya |
Panduan ini membuat ketiga jenisnya dalam satu Script server, jadi satu set aturan mencakup setiap teleport di game kamu: server yang memutuskan, setiap pemain punya cooldown sendiri, dan perangkat pemain hanya pernah mengatakan spot mana yang diinginkannya.
| Bagian | Tempatnya | Fungsinya |
|---|---|---|
Folder TeleportPads berisi PadA dan PadB | Workspace | Dua pad. Atribut Destination tiap pad menyebut pad tujuan pemainnya. |
Folder TeleportSpots | Workspace | Satu part untuk setiap spot yang ditampilkan menu. Atribut WinsNeeded mengunci sebuah spot. |
Folder PlacePortals | Workspace | Part portal. Atribut PlaceId tiap portal adalah place tujuan pemainnya. |
Script Teleporters | ServerScriptService | Menjalankan ketiga jenis teleport dan membuat kedua remote. Satu-satunya tempat teleport bisa terjadi. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | Menggambar tombol Teleport dan daftar spot, dan mengirim nama spot yang dipilih pemain. |
RemoteFunction GetTeleportSpots dan RemoteEvent TeleportRequest | ReplicatedStorage (dibuat Teleporters) | Yang pertama mengembalikan daftar spot ke menu. Yang kedua membawa nama yang dipilih ke 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
Langkah 1: Buat dua pad teleport
- Di Explorer, arahkan kursor ke Workspace, klik tombol + dan sisipkan Folder. Beri nama
TeleportPads. Script mencari nama yang persis ini. - Sisipkan dua Part ke folder itu dan beri nama
PadAdanPadB. Buat masing-masing berupa lempengan datar, misalnya 6 kali 1 kali 6 stud, dan taruh di lantai dengan jarak tertentu. Di jendela Properties, centang Anchored, biarkan CanCollide dan CanTouch menyala, dan beri warna cerah serta material Neon supaya pemain mudah melihatnya. - Pilih PadA, gulir ke bagian Attributes di jendela Properties dan klik +. Masukkan nama
Destination, pilih tipe String dan klik Save, lalu isi nilainya denganPadB. Lakukan hal yang sama di PadB dengan nilaiPadA. - Putar setiap pad supaya sisi depannya mengarah ke lantai yang kosong. Pemain tiba 3 stud di depan sisi depan pad tujuan, menghadap menjauhinya, jadi sisakan beberapa stud lantai kosong di sana. Untuk melihat sisi mana yang depan, klik kanan pad dan pilih Show Orientation Indicator: garis biru menandai sisi depan. Putar pad dengan tool Rotate sampai garis itu mengarah ke tempat pemain harus berjalan keluar.
Pemain mendarat di samping pad, bukan di atasnya, dengan sengaja. Halaman debounce Roblox mencatat bahwa Touched terjadi berkali-kali berturut-turut dengan cepat untuk satu sentuhan, jadi pemain yang tiba di atas pad lain akan memicunya lagi begitu cooldown-nya habis, dan terpental balik ke seberang map.
Kamu tidak terbatas pada dua pad. Destination sebuah pad bisa menyebut part mana pun di TeleportPads, jadi tiga pad bisa mengirim pemain berputar dalam satu lingkaran. Untuk pad satu arah, arahkan ke part di TeleportPads yang tidak punya Destination sendiri: part itu menerima pemain dan tidak mengirim siapa pun ke mana pun.
Langkah 2: Tambahkan script teleport
Arahkan kursor ke ServerScriptService, sisipkan Script, beri nama Teleporters dan tempel kode di bawah. Script ini menangani pad sekarang, serta menu dan portal dari langkah berikutnya, jadi kamu menambahkannya sekali saja. Pengaturan di bagian atas adalah baris yang memang untuk kamu ubah.
-- Script di ServerScriptService bernama Teleporters.
-- Setiap teleport diputuskan di sini, di server:
-- 1. Pad: menyentuh part di Workspace.TeleportPads membawamu ke part yang disebut
-- di atribut Destination-nya.
-- 2. Menu: LocalScript TeleportMenu meminta sebuah spot di Workspace.TeleportSpots
-- lewat namanya. Server mengecek nama, cooldown dan Wins yang dibutuhkan spot itu.
-- 3. Portal: menyentuh part di Workspace.PlacePortals mengirimmu ke place
-- di atribut PlaceId-nya (place lain di 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 -- pad mengabaikan pemain selama ini setelah teleport apa pun
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- stud di depan pad tujuan, supaya pemain mendarat di sampingnya
local PLACE_ATTEMPTS = 3
local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")
-- Script ini membuat kedua remote sendiri, jadi jangan menambahkannya 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
-- Seberapa tinggi root part karakter yang berdiri berada di atas lantai.
-- Rumusnya dari referensi Humanoid.HipHeight Roblox (rig R6 menambahkan tinggi 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() -- diatur sebelum menunggu, supaya sentuhan kedua tidak bisa memulai teleport kedua
-- Menghadap ke arah sisi depan tujuan (rata, tidak pernah miring)
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 sisi atasnya: pivot karakter adalah root part-nya, jadi angkat ke ketinggian berdiri.
-- Pad menaruh pemain beberapa stud di depannya, karena pemain yang berdiri
-- di atas pad akan memicunya lagi di langkah berikutnya.
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 menyala, muat dulu area di sekitar tujuan (sampai 2 detik)
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 selagi areanya dimuat
end
-- Karakter yang duduk di-weld ke kursinya, dan memindahkannya akan membawa kursinya juga.
-- Menghancurkan SeatWeld mengeluarkan karakter dari kursi lebih dulu.
local seat = humanoid.SeatPart
if seat then
local seatWeld = seat:FindFirstChild("SeatWeld")
if seatWeld then
seatWeld:Destroy()
end
end
character:PivotTo(target)
-- Mulai lagi cooldown-nya saat tiba: pre-fetch di atas bisa memakan sampai 2 detik,
-- dan pad tempat mereka mendarat tidak boleh langsung mengirim mereka balik
lastTeleport[player] = os.clock()
player:SetAttribute("MovementCheckSkip", true) -- untuk script pengecek kecepatan, kalau kamu punya
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 peringatan sekali, bukan di setiap sentuhan
warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
end
end)
end
end
end
-- 2. Menu: daftar spot, lalu permintaan lewat 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: urut abjad, jadi urutannya tidak pernah berubah
end)
return list
end
teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
-- Client hanya mengirim nama. Jangan pernah menerima posisi atau CFrame dari 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 -- terkunci untuk pemain ini
end
teleportTo(player, spot, false)
end)
-- 3. Portal ke place lain di 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 saja menyentuh teleporter
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 -- menyerah; menyentuh portal lagi mencoba lagi
end
-- Teleport juga bisa gagal setelah dimulai. Pemain tetap di sini dan boleh mencoba 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 yang membuat RemoteFunction GetTeleportSpots dan RemoteEvent TeleportRequest, jadi tidak ada yang perlu disisipkan ke ReplicatedStorage secara manual. Script menyambungkan pad di TeleportPads dan portal di PlacePortals satu kali, saat server mulai, jadi pad dan portal yang ditambahkan selagi game berjalan tidak berbuat apa-apa. Folder yang tidak ada cukup mematikan jenis teleport itu.
| Bagian | Fungsinya | Alasannya |
|---|---|---|
playerFromHit | Mencari model karakter pemilik part yang menyentuh dan bertanya ke Players:GetPlayerFromCharacter itu milik siapa. | Pad disentuh oleh kaki, topi dan part lepas. Apa pun yang bukan bagian dari karakter pemain menghasilkan nil dan diabaikan. |
onCooldown | Membandingkan os.clock() dengan waktu teleport terakhir pemain. | Satu cooldown per pemain, jadi pemain yang berdiri di dekat pad tidak pernah menghalangi orang lain. Tidak ada yang menunggu atau tidur. |
rootHeight | Menghitung seberapa tinggi root part karakter yang berdiri berada di atas lantai: setengah tinggi root part ditambah HipHeight milik Humanoid, ditambah panjang kaki pada rig R6. | Ini rumus dari referensi Humanoid.HipHeight Roblox. Pivot karakter adalah root part-nya, jadi mengangkat pivot setinggi ini menaruh kaki di permukaan, baik untuk avatar kecil, besar maupun R6. |
Pengecekan di awal teleportTo | Return kecuali pemain punya karakter hidup dengan root part, lalu langsung mencatat waktunya. | Permintaan streaming di bawahnya bisa membuat script menunggu. Mencatat waktu lebih dulu berarti banyaknya event Touched pada saat itu tidak bisa memulai teleport kedua. |
| Titik kedatangan | Sisi atas tujuan, dinaikkan setinggi rootHeight, menghadap ke arah sisi depannya dengan kemiringan apa pun dihilangkan. Untuk pad, titiknya juga bergeser 3 stud melewati sisi depan pad. | Karakter tiba dalam posisi tegak, bukan di dalam part tujuan. Di samping pad, kakinya mulai sejajar dengan sisi atas pad, jadi karakter turun setebal pad ke lantai. CFrame.lookAlong membuat CFrame di sebuah posisi, menghadap sebuah arah. |
RequestStreamAroundAsync | Meminta Roblox mengirim area di sekitar titik kedatangan ke pemain itu lebih dulu, menunggu paling lama 2 detik. | Instance streaming menyala secara default untuk place baru, jadi bagian map yang jauh mungkin belum dimuat di perangkat pemain. Roblox merekomendasikan panggilan server ini sebelum memindahkan karakter ke tempat yang jauh, meski tidak menjamin apa yang sampai. |
| Pengecekan kedua | Kalau pemain keluar, atau karakternya respawn atau mati selama menunggu, tidak ada yang dipindahkan. | Pemain mungkin reset atau keluar dari game selagi areanya dimuat. Contoh pre-fetch dari Roblox sendiri juga mengecek karakter masih ada di game sebelum memindahkannya. |
Baris SeatWeld | Kalau karakter sedang duduk, menghancurkan weld yang menahannya ke kursi. | Roblox me-weld karakter yang duduk ke kursinya. PivotTo memindahkan part dengan mengubah CFrame-nya, dan referensi Roblox menyebut bahwa mengatur CFrame sebuah part juga memindahkan part yang tersambung dengannya, jadi tanpa ini kursinya, dan apa pun yang di-weld ke kursi itu, akan ikut tiba bersama pemain. Menghancurkan SeatWeld adalah cara referensi Seat Roblox mengeluarkan karakter dari kursi lewat script. |
character:PivotTo(target) | Memindahkan seluruh karakter, setiap anggota tubuh dan aksesori bersama-sama, ke titik kedatangan. | Roblox menyebut PivotTo sebagai fungsi utama untuk memindahkan model dari script. |
Baris lastTeleport kedua | Memulai lagi cooldown saat tiba. | Permintaan streaming bisa memakan sampai 2 detik, sama lamanya dengan cooldown pad itu sendiri, jadi tanpa baris ini pemain bisa tiba tanpa sisa cooldown. |
MovementCheckSkip | Mengatur sebuah atribut di Player setelah setiap perpindahan. | Pengecekan kecepatan di sisi server akan menganggap lompatan itu sebagai cheat. MovementCheck di panduan sprint membaca atribut ini dan mulai mengukur lagi dari posisi baru. Tanpa script seperti itu, atribut ini tidak berbuat apa-apa. |
| Pengaturan | Nilai di sini | Yang diubahnya |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Lama pad dan portal mengabaikan pemain setelah teleport apa pun. |
MENU_COOLDOWN_SECONDS | 3 | Jeda terpendek antara dua teleport menu untuk satu pemain. Pad dan menu memakai satu jam yang sama per pemain, jadi permintaan menu dalam 3 detik setelah teleport pad juga diabaikan. |
PAD_ARRIVAL_GAP | 3 | Berapa stud melewati sisi depan pad tujuan pemain tiba, supaya mereka mendarat di samping pad, bukan di atasnya. |
PLACE_ATTEMPTS | 3 | Berapa kali sebuah portal mencoba TeleportAsync, berjarak 2 detik, sebelum menyerah. |
Tekan Play sekarang dan injak PadA: kamu muncul di depan PadB. Menu dan portal butuh dua langkah berikutnya, tapi script sudah berjalan tanpa keduanya.
Langkah 4: Teleport ke place lain
Place adalah dunia terpisah di dalam game kamu, dengan servernya sendiri: lobby dan dungeon, atau hub dan sekumpulan level. Pemain berpindah antar place dengan TeleportService, dan Roblox hanya menjalankannya di game yang sudah dipublish, jadi langkah ini berakhir di aplikasi Roblox, bukan di Studio.
- Kalau game belum dipublish, pilih File > Publish. Game baru hanya terbuka untukmu, orang yang kamu beri akses Edit dan anggota grup dengan role yang tepat sampai kamu merilisnya, dan itu sudah cukup untuk mengetes teleport sendiri.
- Buat place kedua: buka place baru dari template Studio mana pun, bangun dungeon kamu, lalu pilih File > Publish As, klik tile game kamu, pilih Add as a new place dan klik Create.
- Salin ID place baru itu. Buka Asset Manager dari menu Window atau tab Home, masuk ke Places In Experience, klik kanan place-nya dan pilih Copy Asset ID, yang menyalin place ID-nya.
- Kembali di place pertamamu, sisipkan Folder bernama
PlacePortalske Workspace, dan di dalamnya sebuah Part yang di-anchor bernamaDungeonPortal. Tambahkan atribut Number bernamaPlaceIddan tempel ID tadi sebagai nilainya. - Tekan Play dan sentuh portalnya. Output mencetak baris yang diawali
Teleporters: would send: hanya itu yang dilakukan portal di Studio. - Publish lagi dengan File > Publish, supaya game yang dipublish punya portalnya, dan tes dari aplikasi Roblox seperti di Langkah 5.
Teleporters memanggil TeleportAsync di dalam pcall, sampai 3 kali dengan jeda 2 detik antar percobaan, karena halaman teleport Roblox menyebut teleport bisa gagal dan melempar error, dan merekomendasikan mencoba lagi. Teleport juga bisa dimulai lalu gagal di saat terakhir tanpa error, membiarkan pemain di tempatnya. Roblox memicu TeleportInitFailed untuk itu, dan script menghapus flag "leaving" pemain, jadi menyentuh portal lagi mencoba lagi.
Untuk membawa pemain kembali, lakukan hal yang sama di place lainnya: taruh salinan Teleporters di ServerScriptService-nya dan tambahkan portal yang PlaceId-nya adalah ID place pertamamu, disalin dari Asset Manager dengan cara yang sama.
Siapa yang bisa masuk ke place lain milikmu
Dokumentasi keamanan Roblox memperingatkan bahwa begitu sebuah client berada di dalam satu place game kamu, client itu bisa teleport ke place lain mana pun di dalamnya, apa pun rute yang kamu maksudkan, dan bahwa mematikan Direct Access sebuah place hanya menghilangkan tombol Join di situs web. Pengaturan yang mengubah ini adalah Access Control for Places, di Audience > Access Settings pada Creator Dashboard:
| Pengaturan | Siapa yang bisa masuk ke place yang bukan start place |
|---|---|
| Fully open | Siapa saja, lewat teleport dari game mana pun, deep link, undangan game dan bergabung dengan teman. |
| Limited to same universe | Hanya pemain yang teleport dari dalam game-game kamu. Teleport dari client maupun server diizinkan. |
| Secure within universe only | Hanya pemain yang di-teleport script server kamu dari dalam game ini. |
Kalau pemain hanya boleh mencapai sebuah place lewat portal kamu, dungeon misalnya, pilih Secure within universe only. Setiap teleport di panduan ini dimulai di server, jadi tetap berfungsi. Roblox juga menyebut banyak game tidak butuh teleport yang aman, jadi game yang semua place-nya terbuka untuk semua orang bisa membiarkannya apa adanya.
Kesalahan di tutorial teleporter yang lebih lama
Kalau kamu membandingkan panduan ini dengan video atau postingan forum, inilah perbedaan yang penting, beserta alasan tiap pola bermasalah.
| Tutorialnya | Masalahnya | Panduan ini |
|---|---|---|
Mengatur hit.Parent.HumanoidRootPart.Position = target.Position | Referensi Roblox menyebut bahwa mengatur Position memperbarui joint part itu sehingga part bergerak relatif terhadap part yang tersambung dengannya: root part bergerak tanpa tubuhnya. | Memindahkan seluruh karakter dengan PivotTo. |
Mengatur HumanoidRootPart.CFrame = target.CFrame | Bagian tengah karakter mendarat di tengah part tujuan, sebagian di dalamnya, dan mengikuti kemiringan part itu. | Tiba di ketinggian berdiri di atas sisi atas, di samping pad, dijaga tetap rata. |
Memakai satu variabel debounce untuk seluruh pad | Selagi satu pemain teleport, pad mengabaikan semua orang lain. Tanpa debounce sama sekali, pemain yang mendarat di pad lain langsung dikirim balik. | Satu cooldown per pemain, dicatat sebelum ada yang menunggu, dan pemain mendarat di samping pad. |
Memanggil TeleportService:Teleport(placeId, player) dari LocalScript | Roblox menandai Teleport() deprecated, menyarankan tidak memakainya untuk pekerjaan baru, dan hanya mengizinkan TeleportAsync dari script server. | Memanggil TeleportAsync di script server. |
Tanpa pcall, tanpa mencoba lagi | Halaman teleport Roblox menyebut teleport bisa gagal dan melempar error, dan juga bisa gagal setelah dimulai. | Sampai 3 percobaan di dalam pcall, dan TeleportInitFailed membiarkan pemain mencoba lagi. |
| Menyerah karena "tidak berfungsi" di Studio | TeleportService tidak mendukung playtest di Studio. | RunService:IsStudio() mencetak apa yang seharusnya dilakukan portal. |
| GUI teleport yang tombolnya mengirim posisi | Cheater bisa memicu remote yang sama dengan posisi apa pun. | Tombolnya mengirim nama spot, dan server yang mencarinya. |
| Coin diteruskan lewat teleport data | Roblox menyebut teleport data terlihat oleh client dan tidak dienkripsi. | Menyuruhmu menyimpan coin dan Wins di data store dan memuatnya di place lainnya (lihat Membawa data ke place lain). |
Apa yang bisa dan tidak bisa dipalsukan pemain
Anggap cheater mengendalikan segala sesuatu di perangkatnya sendiri: mereka bisa mengedit TeleportMenu, memicu kedua remote sesering yang mereka mau dengan argumen apa pun, dan menggerakkan karakternya sendiri. Inilah yang mereka dapatkan dengan teleporter ini.
| Cheater mencoba | Hasil | Alasannya |
|---|---|---|
| Mengirim posisi atau CFrame lewat remote menu | Diabaikan | TeleportRequest membaca satu string, nama spot sampai 50 karakter. Apa pun selain itu dibuang. |
| Meminta Castle tanpa 3 Wins | Ditolak | Server membaca Wins dari salinan leaderstats miliknya sendiri. Tombol abu-abu hanyalah petunjuk. |
| Meminta spot yang tidak ada | Diabaikan | Server mencari namanya di TeleportSpots dan tidak berbuat apa-apa kalau tidak ada part dengan nama itu. |
| Memicu remote menu berulang-ulang | Paling banyak satu teleport menu setiap 3 detik | Cooldown-nya disimpan di server, per pemain. |
| Memicu sebuah pad tanpa berjalan ke sana | Mereka sampai di pad pasangannya, yang toh bisa mereka datangi dengan berjalan | Roblox mencantumkan teleport ke posisi mana pun dan memanipulasi event Touched di antara hal yang bisa dilakukan client dengan karakternya sendiri. |
| Masuk langsung ke place lain di game kamu | Mungkin, kecuali Access Control for Places diatur ke Secure within universe only | Lihat Siapa yang bisa masuk ke place lain milikmu. |
| Menggerakkan karakternya sendiri ke mana saja, termasuk spot terkunci | Mungkin | Setiap perangkat mengendalikan gerakan karakternya sendiri. Spot terkunci adalah kemudahan, bukan brankas, jadi cek di server sebelum membagikan apa pun yang berharga di sana. |
Baris terakhir adalah batas jujur dari teleporter mana pun. Untuk game kompetitif, tambahkan pengecekan gerakan di sisi server seperti di panduan sprint. Teleporters sudah mengatur atribut MovementCheckSkip yang dibaca pengecekan itu, jadi teleport miliknya sendiri tidak ditandai: dokumentasi keamanan Roblox menyebut game dengan teleport yang sah butuh pengecualian persis seperti ini di pengecekan gerakannya.
Langkah 5: Tes
- Tekan Play. Injak PadA: kamu muncul tepat di depan PadB, menghadap menjauhinya. Berbalik dan langsung injak lagi PadB: tidak terjadi apa-apa, karena pad mengabaikanmu selama 2 detik setelah kamu tiba. Turun dari pad, tunggu 2 detik dan berjalanlah ke PadB lagi: kamu muncul di depan PadA.
- Tunggu beberapa detik, lalu klik Teleport di kiri layar. Daftarnya menampilkan Lake, Spawn dan "Castle (needs 3 wins)" berwarna abu-abu. Pilih Lake: kamu muncul di atasnya. Buka menu lagi dan pilih Castle: tidak terjadi apa-apa, dan Output tetap sepi.
- Beri dirimu 3 Wins (ini butuh script leaderstats dengan IntValue Wins, seperti milik panduan leaderboard). Klik toggle Client/Server untuk pindah ke Server, cari
Players, namamu,leaderstats,Winsdi Explorer dan atur Value-nya ke 3 di jendela Properties. Pindah kembali ke Client dan buka menu lagi: Castle berwarna ungu dan membawamu ke sana. - Sentuh DungeonPortal. Output mencetak baris yang diawali
Teleporters: would senddengan namamu dan place ID-nya. Itu memang yang diharapkan di Studio, dan baris itu dicetak paling banyak sekali setiap 2 detik berapa lama pun kamu berdiri di portal. - Pilih Server & Clients di dropdown mode tes, atur 2 client dan tekan Play. Kedua pemain bisa memakai pad pada saat yang sama, dan cooldown satu pemain tidak pernah menghalangi yang lain.
- Hentikan tes, publish, dan mainkan game-nya dari aplikasi Roblox. Sentuh portalnya: loading screen Roblox muncul dan kamu tiba di place lainnya. Kalau kamu tetap di tempat, buka Developer Console dengan F9, pindahkan log-nya ke tampilan Server, yang hanya bisa dilihat pemilik game dan anggota grup dengan izin edit, dan cari peringatan
Teleporters:, yang menyertakan alasan dari Roblox.
Biarkan jendela Output terbuka (menu Window, lalu Output) selama langkah-langkah di Studio. Teleporters tidak mencetak apa pun saat berfungsi, selain baris portal di langkah 4, jadi peringatan atau error merah apa pun layak dibaca. Lihat Error umum.
Mengembangkannya
Teleport satu tim atau party bersama-sama
TeleportAsync menerima daftar pemain, jadi satu portal bisa mengirim seluruh kelompok ke place yang sama. Halaman teleport Roblox menyarankan mulai dari pemain yang menyentuh portal: player.Team dan Team:GetPlayers() untuk tim, atau SocialService:GetPlayersByPartyId() dengan player.PartyId untuk party. Berikan daftar itu sebagai ganti { player }, dan atur flag leavingForPlace untuk setiap pemain di dalamnya.
Kirim kelompok ke servernya sendiri
Secara default, pemain yang di-teleport masuk ke server publik place lainnya. Untuk mengirim sebuah kelompok ke reserved server baru, misalnya untuk sebuah match, buat TeleportOptions, atur ShouldReserveServer-nya ke true dan berikan sebagai argumen ketiga: TeleportService:TeleportAsync(placeId, players, options). Roblox mencatat bahwa kegagalan yang melibatkan reserved server khususnya terbantu oleh percobaan ulang, yang sudah dilakukan script ini.
Membawa data ke place lain
Teleport membuang data lokal apa pun untuk pemain itu. Teleport data Roblox, yang diatur dengan TeleportOptions:SetTeleportData() dan dibaca di place lainnya dengan player:GetJoinData(), terlihat oleh client dan tidak dienkripsi, jadi pakai hanya untuk pilihan yang tidak berbahaya seperti map mana yang dimuat. Simpan coin, Wins dan item di data store, seperti di tutorial DataStore, dan muat lagi saat pemain tiba di place lainnya.
Loading screen custom
Selagi teleport ke place dimuat, pemain melihat loading screen standar Roblox. Untuk menampilkan milikmu sendiri, panggil TeleportService:SetTeleportGui() di client dengan sebuah ScreenGui, misalnya yang disimpan di ReplicatedStorage. Teleport di panduan ini dimulai di server, jadi client harus memanggilnya lebih awal, misalnya begitu pemain bergabung. Roblox menyebut layar itu harus diatur lagi sebelum setiap teleport dan tidak dipakai untuk place di game yang berbeda. Roblox juga mencatat bahwa script di dalam ScreenGui itu tidak berjalan, jadi rancang sebagai layar diam.
Teleport ronde dan checkpoint
Round system memindahkan setiap pemain ke arena dengan panggilan PivotTo sejenis di awal setiap ronde, dan PivotTo atau SpawnLocation di panduan obby (dalam bahasa Inggris) membandingkan pendekatan ini dengan spawn point Roblox. Kalau sebuah spot baru boleh terbuka setelah satu ronde, round system sudah memberikan Wins yang dibaca WinsNeeded.
Error umum dan cara memperbaikinya
Buka jendela Output (menu Window, lalu Output) sebelum kamu menekan Play. Teleporters menyebut nama pad-nya saat sebuah Destination tidak mengarah ke mana pun, jadi sebagian besar masalah terlihat di sana.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'
TeleportMenu sedang menunggu remote yang dibuat Teleporters, jadi Teleporters tidak berjalan. Cek bahwa itu Script, bukan LocalScript, langsung di dalam ServerScriptService, tidak dinonaktifkan, dan Output tidak menampilkan error merah darinya. Panduan error script menjelaskan peringatan ini secara rinci.
Teleporters: PadA points to PadC, which is not a part in TeleportPads
Atribut Destination pad itu menyebut sesuatu yang bukan part langsung di dalam folder TeleportPads. Cek ejaan dan huruf kapital nilai atributnya dan nama pad tujuannya. Peringatannya muncul sekali per pad, saat pertama kali seorang pemain menyentuhnya.
Menginjak pad tidak berbuat apa-apa
Cek bahwa foldernya bernama persis TeleportPads dan berada langsung di Workspace saat game dimulai, bahwa atribut Destination pad bertipe String (atribut Number diabaikan), dan bahwa kamu sudah menunggu 2 detik sejak teleport terakhirmu. Cek juga CanTouch pad menyala: Roblox menyebut menyambungkan Touched ke part dengan CanTouch mati melempar error, yang menghentikan script.
Aku mendarat di dalam dinding atau jatuh dari tepi
Pemain tiba 3 stud di depan sisi depan pad tujuan. Klik kanan pad, pilih Show Orientation Indicator, dan putar pad sampai garis birunya mengarah ke lantai kosong. Spot menu menaruh pemain di atas part-nya, jadi jaga setiap spot berada di lantai.
Tombol Castle tetap abu-abu setelah aku mendapat 3 Wins
Daftarnya digambar saat menu dibuka, jadi tutup menu dan buka lagi. Kalau masih abu-abu, cek bahwa leaderstats punya IntValue bernama persis Wins, dan bahwa Wins berubah di server, bukan hanya di mode Client.
Portal tidak berbuat apa-apa di game yang sudah dipublish
Buka Developer Console dengan F9, pindahkan log-nya ke tampilan Server (hanya pemilik game dan anggota grup dengan izin edit yang melihatnya, karena Teleporters adalah Script server) dan baca peringatan Teleporters:, yang menyertakan alasan dari Roblox. Cek bahwa atribut PlaceId portal bertipe Number dan berisi ID dari Asset Manager, dan bahwa kamu mem-publish place-nya lagi setelah menambahkan portal.
Buat dengan RoCode
Kalau kamu tidak mau merangkai ini secara manual, RoCode bisa membuatnya di place yang sedang kamu buka. RoCode adalah agen AI independen untuk Roblox Studio, bukan buatan Roblox: kamu menjelaskan fiturnya di web chat-nya, dan plugin Studio-nya membuat part dan script di Explorer kamu, jadi kamu tidak menyalin kode dari jendela chat.
Tambahkan teleporter: pad di Workspace.TeleportPads yang mengirim pemain ke pad yang disebut di atribut Destination-nya dengan cooldown 2 detik, menu Teleport untuk spot di Workspace.TeleportSpots dengan Castle yang butuh 3 Wins, dicek di server, dan portal di Workspace.PlacePortals yang mengirim pemain ke place ID di atribut PlaceId-nya dengan percobaan ulang.
- Bisa memeriksa place kamu saat sebuah langkah membutuhkannya, dengan Search Game dan Search Scripts, jadi RoCode bisa melanjutkan item, remote atau kode save yang sudah kamu punya, bukan menambah sistem kedua
- Membuat folder dan part pad dengan Create Instance dan mengatur propertinya dengan Set Property, dan menulis Teleporters serta TeleportMenu dengan Create Script
- Diperintahkan untuk mengecek compile setiap script yang ditulisnya dengan Check Script, yang meng-compile-nya di Studio tanpa menjalankannya
- Mengirim perubahannya dalam batch, dan setiap batch adalah satu titik undo di history Studio
Teleport ke place hanya berjalan di game yang sudah dipublish, jadi tes sendiri di aplikasi Roblox. Dengan plugin 3.9 atau lebih baru RoCode bisa menjalankan playtest singkat dan membaca error-nya, dan dengan plugin 3.9.15 atau lebih baru karakter tesnya bisa menginjak pad dan mengklik tombol menu, tapi yang dicek hanya apa yang dipilihnya untuk dites, jadi injak sendiri pad-nya dan buka menunya. Teleporter adalah satu sistem di antara banyak sistem dalam sebuah game; membuat game utuh dengan RoCode berjalan satu sistem per prompt seperti ini. Cara RoCode tersambung ke Studio.
Pertanyaan umum
Bagaimana cara membuat pad teleport di Roblox Studio?
Beri dua part atribut Destination yang saling menyebut nama, lalu biarkan satu script server memindahkan siapa pun yang menyentuh pad dengan character:PivotTo ke titik tepat di depan pad lainnya, dengan cooldown singkat per pemain. Langkah 1 dan Langkah 2 membuat persis itu.
Kenapa teleporter tidak berfungsi di Studio?
Pad dan menu berfungsi di Studio. Teleport ke place lain tidak: TeleportService Roblox tidak mendukung playtest di Studio, jadi publish game-nya dan tes di aplikasi Roblox. Script di panduan ini mencetak apa yang seharusnya dilakukan portal, jadi kamu tetap bisa mengecek bahwa portalnya terpicu.
Bagaimana cara teleport pemain ke place lain di game?
Tambahkan place-nya dengan File > Publish As (Add as a new place), salin place ID-nya dari Asset Manager, dan panggil TeleportService:TeleportAsync(placeId, { player }) dari Script server di dalam pcall, mencoba lagi kalau gagal. Langkah 4 membahasnya langkah demi langkah.
Bagaimana cara membuat GUI teleport?
Buat tombolnya di LocalScript dan kirim ke server hanya nama spot yang dipilih pemain. Server mencari nama itu di sebuah folder, mengecek cooldown dan aturan unlock apa pun, lalu memindahkan karakternya. Jangan pernah mengirim posisi dari client: cheater bisa mengirim posisi apa pun yang mereka mau.
Kenapa karakterku macet atau berantakan setelah teleport?
Mengatur Position root part hanya memindahkan part itu, bukan tubuh yang tersambung dengannya, dan menyalin CFrame sebuah pad menaruh bagian tengah karakter di dalam pad. Pakai character:PivotTo dengan titik di ketinggian berdiri di atas lantai, yang dihitung dari HipHeight milik Humanoid.
Bisakah aku mengirim coin atau item lewat teleport?
Tidak dengan aman. Roblox menyebut teleport data terlihat oleh client dan tidak dienkripsi, jadi cocok untuk hal seperti map yang dipilih, bukan untuk coin. Simpan coin dan item di data store dan muat di place lainnya.
Sumber dan bacaan lanjutan
- Roblox Creator Docs: Teleport between places (dalam bahasa Inggris). TeleportAsync, playtest Studio, Access Control for Places, layar teleport, teleport data dan teleport yang gagal
- Roblox Creator Docs: TeleportService (dalam bahasa Inggris). Teleport yang deprecated, TeleportAsync yang hanya di server dan TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (dalam bahasa Inggris). fungsi utama untuk memindahkan model dari script
- Roblox Creator Docs: BasePart.Position (dalam bahasa Inggris). kenapa mengatur Position pada part yang tersambung memindahkannya relatif terhadap yang lain
- Roblox Creator Docs: Humanoid.HipHeight (dalam bahasa Inggris). seberapa tinggi root part karakter yang berdiri, untuk rig R15 dan R6
- Roblox Creator Docs: Seat (dalam bahasa Inggris). SeatWeld yang menahan karakter yang duduk, dan menghancurkannya untuk membuat karakter berdiri
- Roblox Creator Docs: Player:RequestStreamAroundAsync (dalam bahasa Inggris). meminta sebuah area sebelum karakter pindah ke sana, tanpa jaminan apa yang sampai
- Roblox Creator Docs: Streaming techniques and conversion (dalam bahasa Inggris). streaming proaktif sebelum teleport
- Roblox Creator Docs: Access control and confidentiality (dalam bahasa Inggris). kenapa client bisa mencapai place mana pun di sebuah game kecuali teleport-nya aman
- Roblox Creator Docs: Network ownership, movement validation, and physics (dalam bahasa Inggris). apa yang bisa dilakukan client dengan karakternya sendiri, dan pengecualian teleport di pengecekan gerakan
- Roblox Creator Docs: Create and publish games and places (dalam bahasa Inggris). publish, siapa yang bisa membuka game baru, dan menambahkan place dengan Publish As
- Roblox Creator Docs: Asset Manager (dalam bahasa Inggris). menyalin place ID
- Roblox Creator Docs: Developer Console (dalam bahasa Inggris). tampilan Server pada log, dan siapa yang bisa melihatnya
- Roblox Creator Docs: Debounce patterns (dalam bahasa Inggris). kenapa Touched terjadi beberapa kali untuk satu sentuhan
Cara kode ini dicek: setiap skrip di halaman ini lolos pemeriksa tipe strict Luau dengan definisi API Roblox (luau-lsp, 12 November 2026). Pemeriksaan tipe menangkap nama API yang salah ketik dan tipe yang keliru, bukan logika game, jadi uji dulu di Studio sebelum dipublikasikan.