Tutorial · Sistem permainan

Cara buat teleport dalam Roblox Studio

Teleport dalam Roblox ialah salah satu daripada dua: memindahkan watak ke tempat lain dalam pelayan yang sama, atau menghantar pemain ke place lain dalam game anda. Dalam panduan ini kita bina kedua-duanya daripada satu skrip pelayan: pad yang menghantar anda ke pad pasangannya, menu Teleport di mana lokasi berkunci dibuka dengan Wins, dan portal ke place lain yang mencuba semula apabila teleport Roblox gagal.

Dikemas kini 20 November 202620 minit bacaanDitulis oleh

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. Menetapkan HumanoidRootPart.Position memisahkan 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. Gunakan TeleportAsync pada pelayan, balut dalam pcall, cuba semula dan kendalikan TeleportInitFailed.
Di halaman ini
  1. Cara ia berfungsi
  2. 1. Pad
  3. 2. Skrip teleport
  4. 3. Menu teleport
  5. 4. Place lain
  6. Tutorial lama
  7. Had perlindungan
  8. 5. Ujian
  9. Pengembangan
  10. Common errors
  11. Dengan RoCode
  12. Soalan lazim
  13. Sumber dan bacaan lanjut

Dua jenis teleport

IlustrasiMenyentuh PadA meletakkan anda betul-betul di hadapan PadB, jadi PadB tidak terus menghantar anda balik, dan pelayan menolak lokasi berkunci Castle tetapi memindahkan anda ke Lake.

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.

Dua jenis teleport
Dalam pelayan yang samaKe place lain dalam game anda
Panggilancharacter:PivotTo(cframe)TeleportService:TeleportAsync(placeId, players)
Untuk apaPad teleport, menu teleport, memindahkan pemain dari lobi ke arenaPortal ke peringkat lain, lobi yang menghantar pemain ke place berasingan dengan dungeon atau perlawanan
Di mana ia berjalanScript pelayanHanya Script pelayan. Teleport() pada klien sudah lapuk.
Berfungsi dalam playtest StudioYaTidak. TeleportService dalam Roblox tidak menyokong playtest dalam Studio, jadi ujian dibuat dalam game yang diterbitkan.
Apa yang pemain nampakLompatan merentasi peta, yang boleh mengambil masa sehingga 2 saat jika kawasan itu perlu dimuatkan dahuluSkrin loading Roblox, kemudian place yang lain
Syiling, item dan data lainKekal seperti sedia adaRoblox 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.

Komponen teleport
ElemenLokasiApa yang dilakukan
Folder TeleportPads dengan PadA dan PadBWorkspaceDua pad. Atribut Destination setiap satu menamakan pad yang menjadi destinasi pemain.
Folder TeleportSpotsWorkspaceSatu part untuk setiap lokasi dalam senarai menu. Atribut WinsNeeded mengunci lokasi.
Folder PlacePortalsWorkspacePart portal. Atribut PlaceId setiap portal ialah place yang menjadi destinasi pemain.
Script TeleportersServerScriptServiceMengendalikan ketiga-tiga jenis teleport dan mencipta dua remote. Satu-satunya tempat teleport boleh berlaku.
LocalScript TeleportMenuStarterPlayer > StarterPlayerScriptsMelukis butang Teleport dan senarai lokasi, dan menghantar nama lokasi yang dipilih pemain.
RemoteFunction GetTeleportSpots dan RemoteEvent TeleportRequestReplicatedStorage (dicipta oleh Teleporters)Yang pertama memulangkan senarai lokasi kepada menu. Yang kedua membawa nama yang dipilih ke pelayan.
Explorer apabila teleport siap. Teleporters menambah GetTeleportSpots dan TeleportRequest ke dalam ReplicatedStorage apabila 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: bina dua pad teleport

  1. Dalam Explorer, halakan kursor pada Workspace, klik butang + dan masukkan Folder. Namakan folder itu TeleportPads. Skrip mencari nama ini dengan tepat.
  2. Masukkan dua Part ke dalam folder dan namakan PadA dan PadB. 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.
  3. Pilih PadA, tatal tetingkap Properties ke bahagian Attributes dan klik +. Masukkan nama Destination, pilih jenis String dan klik Save, kemudian tetapkan nilai PadB. Lakukan yang sama pada PadB dengan nilai PadA.
  4. 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
-- 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.

Apa yang dilakukan setiap bahagian Teleporters
BahagianApa yang dilakukanKenapa
playerFromHitMencari 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.
onCooldownMembandingkan 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.
rootHeightMengira 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 teleportToKeluar 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 ketibaanMuka 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.
RequestStreamAroundAsyncMeminta 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 keduaJika 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 SeatWeldJika 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 lastTeleportMemulakan 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.
MovementCheckSkipMenetapkan 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 di bahagian atas Teleporters
TetapanNilai di siniApa yang diubah
PAD_COOLDOWN_SECONDS2Berapa lama pad dan portal mengabaikan pemain selepas sebarang teleport.
MENU_COOLDOWN_SECONDS3Jarak 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_GAP3Berapa stud dari muka hadapan pad destinasi pemain muncul, supaya mereka mendarat di sebelah pad, bukan di atasnya.
PLACE_ATTEMPTS3Berapa 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.

  1. 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.
  2. 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.
  3. 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.
  4. Kembali ke place pertama, masukkan Folder bernama PlacePortals ke dalam Workspace, dan di dalamnya Part yang di-anchor bernama DungeonPortal. Tambah atribut jenis Number bernama PlaceId dan tampal ID itu sebagai nilainya.
  5. Klik Play dan sentuh portal. Output mencetak baris yang bermula dengan Teleporters: would send: dalam Studio, portal tidak melakukan apa-apa lagi.
  6. 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:

Tiga nilai Access Control for Places
TetapanSiapa boleh masuk ke place yang bukan place permulaan
Fully openSesiapa sahaja, melalui teleport dari mana-mana game, deep link, jemputan ke game dan menyertai rakan.
Limited to same universeHanya pemain yang teleport dari dalam game anda. Teleport dari klien dan pelayan dibenarkan.
Secure within universe onlyHanya 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.

Teknik biasa dalam tutorial teleport dan apa yang dilakukan panduan ini sebaliknya
TutorialMasalahPanduan ini
Menetapkan hit.Parent.HumanoidRootPart.Position = target.PositionRujukan 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.CFrameBahagian 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 padSemasa 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 LocalScriptRoblox 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 semulaHalaman 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 kedudukanPenipu boleh memanggil remote yang sama dengan sebarang kedudukan.Butang menghantar nama lokasi, dan pelayan mencarinya.
Syiling dihantar dalam teleport dataRoblox 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.

Apa yang mungkin dicuba penipu dan apa yang dilakukan Teleporters
Penipu cubaHasilKenapa
Menghantar kedudukan atau CFrame melalui remote menuDiabaikanTeleportRequest membaca satu rentetan, iaitu nama lokasi sepanjang 50 aksara atau kurang. Selain itu dibuang.
Meminta Castle tanpa 3 WinsDitolakPelayan membaca Wins daripada salinan leaderstats miliknya. Butang kelabu hanyalah petunjuk.
Meminta lokasi yang tidak wujudDiabaikanPelayan mencari nama itu dalam TeleportSpots dan tidak melakukan apa-apa jika tiada part dengan nama itu.
Memanggil remote menu berulang kaliTidak lebih daripada satu teleport menu setiap 3 saatCooldown disimpan pada pelayan, bagi setiap pemain.
Mencetuskan pad tanpa mendekatinyaDia sampai ke pad pasangan, yang memang boleh dicapainya dengan berjalanRoblox 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 andaMungkin, jika Access Control for Places bukan Secure within universe onlyLihat Siapa boleh masuk ke place anda yang lain.
Menggerakkan wataknya ke mana-mana, termasuk lokasi berkunciMungkinSetiap 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

  1. 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.
  2. 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.
  3. 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, Wins dan tetapkan Valuenya kepada 3 dalam tetingkap Properties. Tukar balik ke Client dan buka menu sekali lagi: Castle menjadi ungu dan memindahkan anda ke sana.
  4. 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.
  5. 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.
  6. 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.

Anda tulis

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.

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

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.

Cuba RoCode dalam permainan anda.

Kredit percuma setiap hari, tanpa kad. Pasang plugin, terangkan ciri yang anda mahu dan semak hasilnya dalam Studio.