Tutorial · Sistem game

Cara membuat teleporter di Roblox Studio

Teleporter di Roblox adalah salah satu dari dua hal: memindahkan karakter ke tempat lain di server yang sama, atau mengirim pemain ke place lain di game kamu. Panduan ini membuat keduanya dari satu script server: pad yang mengirimmu ke pad pasangannya, menu Teleport yang spot terkuncinya terbuka dengan Wins, dan portal ke place lain yang mencoba lagi saat teleport Roblox gagal.

Diperbarui 12 November 202620 menit bacaDitulis oleh

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. Mengatur HumanoidRootPart.Position memindahkan 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. Pakai TeleportAsync di server, bungkus dengan pcall, coba lagi, dan tangani TeleportInitFailed.
Di halaman ini
  1. Cara kerjanya
  2. 1. Pad teleport
  3. 2. Script teleport
  4. 3. Menu teleport
  5. 4. Place lain
  6. Tutorial lama
  7. Batas exploit
  8. 5. Tes
  9. Mengembangkannya
  10. Error umum
  11. Dengan RoCode
  12. Pertanyaan umum
  13. Sumber dan bacaan lanjutan

Dua jenis teleport

IlustrasiMenyentuh PadA menaruhmu tepat di depan PadB, jadi PadB tidak langsung mengirimmu balik, dan server menolak Castle yang terkunci tapi memindahkanmu ke Lake.

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.

Dua jenis teleport
Di dalam server yang samaKe place lain di game kamu
Panggilannyacharacter:PivotTo(cframe)TeleportService:TeleportAsync(placeId, players)
Dipakai untukPad teleport, menu teleport, memindahkan pemain dari lobby ke arenaPortal ke level lain, lobby yang mengirim pemain ke place dungeon atau match yang terpisah
Berjalan diScript serverHanya Script server. Teleport() di sisi client sudah deprecated.
Berfungsi di playtest StudioYaTidak. TeleportService Roblox tidak mendukung playtest di Studio, jadi kamu mengetesnya di game yang sudah dipublish.
Yang dilihat pemainLompatan ke seberang map, yang bisa memakan sampai 2 detik kalau area itu harus dimuat duluLoading screen Roblox, lalu place lainnya
Coin, item dan data lainTetap apa adanyaRoblox 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-bagian teleporter
BagianTempatnyaFungsinya
Folder TeleportPads berisi PadA dan PadBWorkspaceDua pad. Atribut Destination tiap pad menyebut pad tujuan pemainnya.
Folder TeleportSpotsWorkspaceSatu part untuk setiap spot yang ditampilkan menu. Atribut WinsNeeded mengunci sebuah spot.
Folder PlacePortalsWorkspacePart portal. Atribut PlaceId tiap portal adalah place tujuan pemainnya.
Script TeleportersServerScriptServiceMenjalankan ketiga jenis teleport dan membuat kedua remote. Satu-satunya tempat teleport bisa terjadi.
LocalScript TeleportMenuStarterPlayer > StarterPlayerScriptsMenggambar tombol Teleport dan daftar spot, dan mengirim nama spot yang dipilih pemain.
RemoteFunction GetTeleportSpots dan RemoteEvent TeleportRequestReplicatedStorage (dibuat Teleporters)Yang pertama mengembalikan daftar spot ke menu. Yang kedua membawa nama yang dipilih ke server.
Explorer saat teleporter selesai. Teleporters menambahkan GetTeleportSpots dan TeleportRequest ke ReplicatedStorage saat game berjalan.
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

  1. Di Explorer, arahkan kursor ke Workspace, klik tombol + dan sisipkan Folder. Beri nama TeleportPads. Script mencari nama yang persis ini.
  2. Sisipkan dua Part ke folder itu dan beri nama PadA dan PadB. 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.
  3. Pilih PadA, gulir ke bagian Attributes di jendela Properties dan klik +. Masukkan nama Destination, pilih tipe String dan klik Save, lalu isi nilainya dengan PadB. Lakukan hal yang sama di PadB dengan nilai PadA.
  4. 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
-- 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.

Fungsi setiap bagian Teleporters
BagianFungsinyaAlasannya
playerFromHitMencari 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.
onCooldownMembandingkan 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.
rootHeightMenghitung 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 teleportToReturn 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 kedatanganSisi 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.
RequestStreamAroundAsyncMeminta 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 keduaKalau 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 SeatWeldKalau 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 keduaMemulai 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.
MovementCheckSkipMengatur 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 di bagian atas Teleporters
PengaturanNilai di siniYang diubahnya
PAD_COOLDOWN_SECONDS2Lama pad dan portal mengabaikan pemain setelah teleport apa pun.
MENU_COOLDOWN_SECONDS3Jeda 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_GAP3Berapa stud melewati sisi depan pad tujuan pemain tiba, supaya mereka mendarat di samping pad, bukan di atasnya.
PLACE_ATTEMPTS3Berapa 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.

  1. 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.
  2. 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.
  3. 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.
  4. Kembali di place pertamamu, sisipkan Folder bernama PlacePortals ke Workspace, dan di dalamnya sebuah Part yang di-anchor bernama DungeonPortal. Tambahkan atribut Number bernama PlaceId dan tempel ID tadi sebagai nilainya.
  5. Tekan Play dan sentuh portalnya. Output mencetak baris yang diawali Teleporters: would send: hanya itu yang dilakukan portal di Studio.
  6. 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:

Tiga pengaturan Access Control for Places
PengaturanSiapa yang bisa masuk ke place yang bukan start place
Fully openSiapa saja, lewat teleport dari game mana pun, deep link, undangan game dan bergabung dengan teman.
Limited to same universeHanya pemain yang teleport dari dalam game-game kamu. Teleport dari client maupun server diizinkan.
Secure within universe onlyHanya 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.

Pola umum di tutorial teleporter, dan apa yang dilakukan panduan ini sebagai gantinya
TutorialnyaMasalahnyaPanduan ini
Mengatur hit.Parent.HumanoidRootPart.Position = target.PositionReferensi 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.CFrameBagian 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 padSelagi 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 LocalScriptRoblox 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 lagiHalaman 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 StudioTeleportService tidak mendukung playtest di Studio.RunService:IsStudio() mencetak apa yang seharusnya dilakukan portal.
GUI teleport yang tombolnya mengirim posisiCheater bisa memicu remote yang sama dengan posisi apa pun.Tombolnya mengirim nama spot, dan server yang mencarinya.
Coin diteruskan lewat teleport dataRoblox 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.

Apa yang bisa dicoba cheater, dan apa yang dilakukan Teleporters
Cheater mencobaHasilAlasannya
Mengirim posisi atau CFrame lewat remote menuDiabaikanTeleportRequest membaca satu string, nama spot sampai 50 karakter. Apa pun selain itu dibuang.
Meminta Castle tanpa 3 WinsDitolakServer membaca Wins dari salinan leaderstats miliknya sendiri. Tombol abu-abu hanyalah petunjuk.
Meminta spot yang tidak adaDiabaikanServer mencari namanya di TeleportSpots dan tidak berbuat apa-apa kalau tidak ada part dengan nama itu.
Memicu remote menu berulang-ulangPaling banyak satu teleport menu setiap 3 detikCooldown-nya disimpan di server, per pemain.
Memicu sebuah pad tanpa berjalan ke sanaMereka sampai di pad pasangannya, yang toh bisa mereka datangi dengan berjalanRoblox 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 kamuMungkin, kecuali Access Control for Places diatur ke Secure within universe onlyLihat Siapa yang bisa masuk ke place lain milikmu.
Menggerakkan karakternya sendiri ke mana saja, termasuk spot terkunciMungkinSetiap 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

  1. 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.
  2. 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.
  3. 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, Wins di 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.
  4. Sentuh DungeonPortal. Output mencetak baris yang diawali Teleporters: would send dengan 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.
  5. 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.
  6. 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.

Kamu ketik

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.

RoCode mengerjakan
  • 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

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.

Coba RoCode di game kamu sendiri.

Kredit gratis setiap hari, tanpa kartu. Pasang plugin-nya, jelaskan fiturnya, lalu cek hasilnya di Studio.