Eğitim · Oyun sistemleri

Roblox Studio'da teleport nasıl yapılır

Roblox'ta teleport iki şeyden biridir: karakteri aynı sunucuda başka bir yere taşımak ya da oyuncuyu oyununun başka bir place'ine göndermek. Bu rehberde ikisini de tek bir sunucu scriptiyle kuruyoruz: seni eşi olan pad'e gönderen pad'ler, kilitli noktaların Wins ile açıldığı bir Teleport menüsü ve Roblox teleportu takıldığında yeniden deneyen, başka bir place'e giden portallar.

Güncellendi: 20 Kasım 202618 dk okumaYazan:

Kısaca

Bir teleport pad'i için ServerScriptService içine bir Script koy. Bu script pad'in Touched event'ini dinler, oyuncuyu Players:GetPlayerFromCharacter ile bulur ve bütün karakteri character:PivotTo() ile hedef pad'in hemen önündeki bir noktaya, sırtı pad'e dönük olarak taşır; oyuncu başına birkaç saniyelik bir cooldown, hedef pad'in onu hemen geri göndermesini engeller. Oyuncuları oyununun başka bir place'ine göndermek için bir sunucu Script'inden pcall içinde TeleportService:TeleportAsync(placeId, { player }) çağır; bu sadece yayınlanmış oyunda çalışır, Studio'da değil.

  • Bütün karakteri PivotTo ile taşı. HumanoidRootPart.Position atamak root part'ı vücudun geri kalanından ayırır, çünkü Position ayarlandığında Roblox bağlantıları günceller.
  • Bir teleport menüsü sunucuya pozisyonu değil, hedefin adını göndermeli. Sunucu birini taşımadan önce adı, cooldown'u ve varsa kilit açma kuralını kontrol eder.
  • TeleportService:Teleport() kullanımdan kalktı ve istemcide çalışır. Sunucuda TeleportAsync kullan, onu pcall içine al, yeniden dene ve TeleportInitFailed'ı ele al.
Bu sayfada
  1. Nasıl çalışır
  2. 1. Pad'ler
  3. 2. Teleport scripti
  4. 3. Teleport menüsü
  5. 4. Diğer place'ler
  6. Eski eğitimler
  7. Korumanın sınırları
  8. 5. Test
  9. Genişletmeler
  10. Common errors
  11. RoCode ile
  12. Sık sorulan sorular
  13. Kaynaklar ve ek okumalar

İki tür teleport

İllüstrasyonPadA'ya dokunmak seni PadB'nin hemen önüne koyar, bu yüzden PadB seni hemen geri göndermez; sunucu kilitli Castle noktasını reddeder ama seni Lake'e taşır.

Bir Roblox oyununda teleport üç şey anlamına gelebilir: seni haritanın öbür ucuna taşıyan bir pad, sıçrayabileceğin noktaların bir menüsü ya da başka bir seviyeye giden bir portal. İlk ikisi karakteri oyuncunun zaten bulunduğu sunucunun içinde taşır. Üçüncüsü oyuncuyu oyununun kendi sunucularında çalışan başka bir place'ine gönderir. Farklı API'ler kullanırlar, bu yüzden hangisine ihtiyacın olduğunu bilmek işe yarar.

İki tür teleport
Aynı sunucunun içindeOyununun başka bir place'ine
Çağrıcharacter:PivotTo(cframe)TeleportService:TeleportAsync(placeId, players)
Ne içinTeleport pad'leri, teleport menüleri, oyuncuları lobiden arenaya taşımakBaşka bir seviyeye giden portallar, oyuncuları ayrı bir zindan ya da maç place'ine gönderen bir lobi
Nerede çalışırSunucu Script'iSadece sunucu Script'i. İstemci tarafındaki Teleport() kullanımdan kalktı.
Studio playtest'inde çalışır mıEvetHayır. Roblox'ta TeleportService, Studio playtest'ini desteklemiyor, bu yüzden yayınlanmış oyunda test edilir.
Oyuncu ne görürHaritanın öbür ucuna bir sıçrama; o alanın önce yüklenmesi gerekiyorsa 2 saniyeye kadar sürebilirRoblox yükleme ekranı, sonra diğer place
Coin'ler, eşyalar ve diğer verilerOlduğu gibi kalırRoblox oyuncunun yerel verilerini sıfırlar, bu yüzden önemli olan her şey diğer place'te bir veri deposundan gelmeli

Bu rehberde üç türün hepsi tek bir sunucu Script'inde toplanıyor, böylece tek bir kural seti oyunundaki her teleportu kapsıyor: kararı sunucu verir, her oyuncunun kendi cooldown'u vardır ve oyuncunun cihazı sadece hangi noktaya gitmek istediğini söyler.

Teleport nelerden oluşur
ParçaNerede dururNe yapar
PadA ve PadB içeren TeleportPads Folder'ıWorkspaceİki pad. Her birinin Destination attribute'u, oyuncuları gönderdiği pad'in adını verir.
TeleportSpots Folder'ıWorkspaceMenü listesindeki her nokta için bir part. WinsNeeded attribute'u noktayı kilitler.
PlacePortals Folder'ıWorkspacePortal part'ları. Her portalın PlaceId attribute'u, oyuncuları gönderdiği place'tir.
Teleporters Script'iServerScriptServiceÜç teleport türünün hepsini yönetir ve iki remote oluşturur. Bir teleportun gerçekleşebileceği tek yer.
TeleportMenu LocalScript'iStarterPlayer > StarterPlayerScriptsTeleport düğmesini ve nokta listesini çizer ve oyuncunun seçtiği noktanın adını gönderir.
GetTeleportSpots RemoteFunction'ı ve TeleportRequest RemoteEvent'iReplicatedStorage (bunları Teleporters oluşturur)İlki menüye nokta listesini döndürür. İkincisi seçilen adı sunucuya taşır.
Teleport hazır olduğunda Explorer. Oyun çalışırken Teleporters, GetTeleportSpots ve TeleportRequest'i ReplicatedStorage'a ekler.
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

Adım 1: iki teleport pad'ini kur

  1. Explorer'da fareyle Workspace üzerine gel, + düğmesine tıkla ve bir Folder ekle. Klasörün adını TeleportPads yap. Script tam olarak bu adı arar.
  2. Klasöre iki Part ekle ve adlarını PadA ve PadB yap. Her birini düz bir levha yap, örneğin 6 x 1 x 6 stud, ve zemine birbirinden biraz uzağa koy. Properties penceresinde Anchored'ı işaretle, CanCollide ve CanTouch'ı açık bırak, oyuncular fark etsin diye parlak bir renk ve Neon materyali ver.
  3. PadA'yı seç, Properties penceresini Attributes bölümüne kadar kaydır ve +'ya tıkla. Ad olarak Destination yaz, tip olarak String seç ve Save'e tıkla, sonra değerini PadB yap. Aynısını PadB'de PadA değeriyle yap.
  4. Her pad'i, ön yüzü boş zemine bakacak şekilde döndür. Oyuncular hedef pad'in ön yüzünün 3 stud önünde, sırtları ona dönük olarak belirir, bu yüzden orada birkaç stud boş zemin bırak. Hangi yüzün ön olduğunu görmek için pad'e sağ tıkla ve Show Orientation Indicator'ı seç: ön yüzü mavi bir çizgi gösterir. Bu çizgi oyuncuların gitmesi gereken yönü gösterene kadar pad'i Rotate aracıyla döndür.

Oyuncuların pad'in üstüne değil yanına inmesi bilerek yapılıyor. Roblox'un debounce sayfası, Touched'ın tek bir temasta art arda birçok kez tetiklendiğini belirtiyor, bu yüzden doğrudan diğer pad'in üstünde beliren bir oyuncu, cooldown'u biter bitmez onu yeniden tetikler ve haritanın öbür ucuna geri uçardı.

İki pad ile sınırlı değilsin. Bir pad'in Destination'ı TeleportPads içindeki herhangi bir part'ın adını verebilir, yani üç pad oyuncuları bir döngü halinde gönderebilir. Tek yönlü bir pad için onu TeleportPads içinde kendi Destination'ı olmayan bir part'a yönlendir: böyle bir part oyuncuları karşılar ve kimseyi bir yere göndermez.

Adım 2: teleport scriptini ekle

Fareyle ServerScriptService üzerine gel, bir Script ekle, adını Teleporters yap ve aşağıdaki kodu yapıştır. Şimdilik pad'leri yönetiyor, sonraki adımlardan sonra menüyü ve portalları da yönetecek, yani onu bir kez ekliyorsun. Baştaki ayarlar, değiştirmen beklenen satırlar.

Script konum: ServerScriptService adı: Teleporters
-- ServerScriptService içinde Teleporters adlı Script.
-- Her teleporta burada, sunucuda karar verilir:
--   1. Pad'ler: Workspace.TeleportPads içindeki bir part'a dokunmak seni, onun
--      Destination attribute'unda adı geçen part'a taşır.
--   2. Menü: TeleportMenu LocalScript'i Workspace.TeleportSpots'tan bir noktayı
--      adıyla ister. Sunucu adı, cooldown'u ve noktanın istediği Wins'i kontrol eder.
--   3. Portallar: Workspace.PlacePortals içindeki bir part'a dokunmak seni, onun
--      PlaceId attribute'undaki place'e (bu oyunun başka bir place'i) gönderir.

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 -- herhangi bir teleporttan sonra pad'lerin oyuncuyu yok saydığı süre
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- hedef pad'in önündeki stud sayısı, oyuncular onun yanına insin diye
local PLACE_ATTEMPTS = 3

local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")

-- Bu script iki remote'u da kendisi oluşturur, bu yüzden onları elle ekleme
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

-- Ayakta duran bir karakterin root part'ı zeminden ne kadar yüksekte durur.
-- Roblox'un Humanoid.HipHeight referansındaki formül (R6 rig'lerinde bacak yüksekliği eklenir).
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() -- beklemeden önce ayarla ki ikinci bir temas ikinci bir teleport başlatmasın

	-- Hedefin ön yüzünün baktığı yöne bak (düz, eğimsiz)
	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
	-- Üst yüzüne çık: karakterin pivot'u root part'ıdır, bu yüzden onu ayakta durma yüksekliğine kaldır.
	-- Bir pad ise oyuncuları birkaç stud önüne koyar, çünkü pad'in üstünde duran
	-- bir oyuncu bir sonraki adımda onu yeniden tetiklerdi.
	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)

	-- Instance streaming açıkken önce hedefin etrafındaki alanı yükle (2 saniyeye kadar)
	pcall(function()
		player:RequestStreamAroundAsync(target.Position, 2)
	end)
	if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
		return -- alan yüklenirken çıktı, yeniden doğdu ya da öldü
	end
	-- Oturan bir karakter koltuğa kaynaklıdır ve onu taşımak koltuğu da beraberinde sürüklerdi.
	-- SeatWeld'i yok etmek önce karakteri koltuktan serbest bırakır.
	local seat = humanoid.SeatPart
	if seat then
		local seatWeld = seat:FindFirstChild("SeatWeld")
		if seatWeld then
			seatWeld:Destroy()
		end
	end
	character:PivotTo(target)
	-- Varınca cooldown'u yeniden başlat: yukarıdaki ön yükleme 2 saniyeye kadar sürebilir
	-- ve oyuncunun yanına indiği pad onu hemen geri göndermemeli
	lastTeleport[player] = os.clock()
	player:SetAttribute("MovementCheckSkip", true) -- varsa hız kontrol scriptin için
end

-- 1. Pad'ler
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 -- her temasta değil, bir kez uyar
					warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
				end
			end)
		end
	end
end

-- 2. Menü: nokta listesi, sonra adla istek
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 eşitse alfabetik, böylece sıra hiç değişmez
	end)
	return list
end

teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
	-- İstemci sadece adı gönderir. İstemciden asla pozisyon ya da CFrame kabul etme.
	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 -- bu oyuncu için kilitli
	end
	teleportTo(player, spot, false)
end)

-- 3. Bu oyunun başka bir place'ine giden portallar
local function sendToPlace(player: Player, placeId: number)
	if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
		return -- zaten yolda ya da bir saniye önce bir teleporta dokundu
	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 -- vazgeç; portala yeni bir temas yeniden dener
end

-- Bir teleport başladıktan sonra da takılabilir. Oyuncu burada kalır ve yeniden deneyebilir.
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, GetTeleportSpots RemoteFunction'ını ve TeleportRequest RemoteEvent'ini kendisi oluşturur, bu yüzden ReplicatedStorage'a elle bir şey eklemen gerekmez. TeleportPads'teki pad'leri ve PlacePortals'taki portalları sunucu başlarken bir kez bağlar, bu yüzden oyun sırasında eklenen pad'ler ve portallar hiçbir şey yapmaz. Klasörlerden biri yoksa o teleport türü sadece kapalı olur.

Teleporters'ın her parçası ne yapar
ParçaNe yaparNeden
playerFromHitDokunan part'ın ait olduğu karakter modelini bulur ve Players:GetPlayerFromCharacter'a kimin olduğunu sorar.Pad'lere ayaklar, şapkalar ve serbest part'lar dokunur. Bir oyuncu karakterinin parçası olmayan her şey nil verir ve yok sayılır.
onCooldownos.clock()'u oyuncunun son teleport zamanıyla karşılaştırır.Oyuncu başına bir cooldown, bu yüzden bir pad'in yanında duran oyuncu diğerlerini asla engellemez. Hiçbir şey beklemez ya da uyumaz.
rootHeightAyakta duran bir karakterin root part'ının zeminden ne kadar yüksekte olduğunu hesaplar: root part yüksekliğinin yarısı artı Humanoid'ın HipHeight'ı, R6 rig'lerinde artı bacak uzunluğu.Bu, Roblox'un Humanoid.HipHeight referansındaki formül. Karakterin pivot'u root part'ıdır, bu yüzden pivot'u bu kadar kaldırmak ayakları hem küçük hem büyük avatarlarda hem de R6'da yüzeye koyar.
teleportTo'nun başındaki kontrollerOyuncunun root part'ı olan canlı bir karakteri yoksa çıkar, sonra zamanı hemen kaydeder.Aşağıdaki streaming isteği scripti bekletebilir. Zamanı önceden kaydetmek, o anda gelen çok sayıda Touched event'inin ikinci bir teleport başlatmasını engeller.
Varış noktasıHedefin üst yüzü, rootHeight kadar yükseltilmiş, ön yüzünün baktığı yöne bakan, eğimsiz. Bir pad için nokta ayrıca ön yüzünden 3 stud öteye kaydırılır.Karakter hedef part'ın içinde değil, ayakta belirir. Bir pad'in yanında ayakları pad'in üst yüzü hizasında başlar, bu yüzden pad'in kalınlığı kadar zemine iner. CFrame.lookAlong bir pozisyonda, verilen bakış yönüyle bir CFrame kurar.
RequestStreamAroundAsyncRoblox'tan varış noktasının etrafındaki alanı önce bu oyuncuya göndermesini ister ve en fazla 2 saniye bekler.Instance streaming yeni place'lerde varsayılan olarak açık, bu yüzden haritanın uzak kısmı oyuncunun cihazında henüz yüklenmemiş olabilir. Roblox, bir karakteri uzağa taşımadan önce bu sunucu çağrısını öneriyor, ama tam olarak neyin ulaşacağını garanti etmiyor.
İkinci kontrolOyuncu çıktıysa ya da bekleme sırasında karakter yeniden doğduysa veya öldüyse hiçbir şey hareket etmez.Oyuncu alan yüklenirken reset atmış ya da oyundan çıkmış olabilir. Roblox'un kendi ön yükleme örneği de karakteri taşımadan önce hâlâ oyunda olduğunu kontrol ediyor.
SeatWeld satırlarıKarakter oturuyorsa, onu koltukta tutan Weld'i yok eder.Roblox oturan bir karakteri koltuğa kaynaklar. PivotTo part'ları CFrame'lerini değiştirerek taşır, Roblox referansına göre de bir part'ın CFrame'ini ayarlamak ona bağlı part'ları da taşır, bu yüzden bu olmadan koltuk ve ona kaynaklı her şey oyuncuyla birlikte varırdı. SeatWeld'i yok etmek, Roblox'un Seat referansının bir karakteri scriptten koltuktan kaldırma yolu.
character:PivotTo(target)Bütün karakteri, tüm uzuvları ve aksesuarlarıyla birlikte varış noktasına taşır.Roblox, PivotTo'yu modelleri scriptlerden taşımak için ana fonksiyon olarak adlandırıyor.
İkinci lastTeleport satırıVarışta cooldown'u yeniden başlatır.Streaming isteği 2 saniyeye kadar, yani pad cooldown'unun kendisi kadar sürebilir, bu yüzden bu satır olmadan oyuncu cooldown'u çoktan bitmiş olarak varabilirdi.
MovementCheckSkipHer taşımadan sonra Player üzerinde bir attribute ayarlar.Sunucu tarafındaki bir hız kontrolü sıçramayı hile sanardı. Sprint rehberindeki MovementCheck bu attribute'u okur ve yeni pozisyondan yeniden ölçmeye başlar. Böyle bir script olmadan attribute hiçbir şey yapmaz.
Teleporters'ın başındaki ayarlar
AyarBuradaki değerNeyi değiştirir
PAD_COOLDOWN_SECONDS2Herhangi bir teleporttan sonra pad'lerin ve portalların oyuncuyu ne kadar yok saydığı.
MENU_COOLDOWN_SECONDS3Bir oyuncu için iki menü teleportu arasındaki en kısa süre. Pad'ler ve menü oyuncu başına aynı saati paylaşır, bu yüzden bir pad teleportundan sonraki 3 saniye içinde gelen bir menü isteği de yok sayılır.
PAD_ARRIVAL_GAP3Oyuncuların hedef pad'in ön yüzünden kaç stud ötede belirdiği; böylece pad'in üstüne değil yanına inerler.
PLACE_ATTEMPTS3Bir portalın vazgeçmeden önce TeleportAsync'i 2 saniye arayla kaç kez denediği.

Hemen şimdi Play'e bas ve PadA'ya bas: PadB'nin önünde belirirsin. Menünün ve portalların sonraki iki adıma ihtiyacı var, ama script onlar olmadan da çalışıyor.

Adım 4: başka bir place'e teleport

Place, oyununun içinde kendi sunucuları olan ayrı bir dünyadır: bir lobi ve bir zindan ya da bir merkez ve bir dizi seviye. Oyuncular place'ler arasında TeleportService ile geçer, Roblox da onu sadece yayınlanmış oyunda çalıştırır, bu yüzden bu adım Studio'da değil Roblox uygulamasında biter.

  1. Oyun henüz yayınlanmadıysa File > Publish'i seç. Yeni oyunlar, sen yayına alana kadar sadece sana, Edit erişimi verdiğin kişilere ve uygun rollere sahip grup üyelerine açıktır; teleportları kendin test etmek için bu yeterli.
  2. İkinci bir place oluştur: herhangi bir Studio şablonundan yeni bir place aç, zindanını kur, sonra File > Publish As'i seç, oyununun kutucuğuna tıkla, Add as a new place'i seç ve Create'e tıkla.
  3. Yeni place'in ID'sini kopyala. Window menüsünden ya da Home sekmesinden Asset Manager'ı aç, Places In Experience'a git, place'e sağ tıkla ve Copy Asset ID'yi seç; bu onun place ID'sini kopyalar.
  4. İlk place'e döndüğünde Workspace'e PlacePortals adlı bir Folder, içine de DungeonPortal adlı anchor'lanmış bir Part ekle. PlaceId adında Number tipinde bir attribute ekle ve ID'yi değeri olarak yapıştır.
  5. Play'e bas ve portala dokun. Output, Teleporters: would send ile başlayan bir satır yazar: Studio'da portal başka bir şey yapmaz.
  6. Portalın yayınlanmış oyunda da olması için oyunu File > Publish ile yeniden yayınla ve onu 5. adımdaki gibi Roblox uygulamasından test et.

Teleporters, TeleportAsync'i pcall içinde, denemeler arasında 2 saniye bekleyerek 3 kereye kadar çağırır, çünkü Roblox'un teleport sayfası teleportların takılıp hata verebileceğini söylüyor ve yeniden denemeyi öneriyor. Bir teleport ayrıca başlayıp son anda hatasız takılabilir ve oyuncuyu olduğu yerde bırakabilir. Bu durum için Roblox TeleportInitFailed'ı tetikler, script de oyuncunun "ayrılıyor" işaretini kaldırır, böylece portala yeni bir temas yeniden dener.

Oyuncuları geri getirmek için aynısını diğer place'te yap: ServerScriptService'ine Teleporters'ın bir kopyasını koy ve PlaceId'si ilk place'inin ID'si olan, Asset Manager'dan aynı yolla kopyalanmış bir portal ekle.

Diğer place'lerine kim girebilir

Roblox'un güvenlik dokümantasyonu uyarıyor: bir istemci oyununun bir place'ine girdiği anda, sen hangi yolu planlamış olursan ol, oyunun diğer herhangi bir place'ine teleport olabilir; bir place'te Direct Access'i kapatmak da sadece sitedeki Join düğmesini kaldırır. Bunu Creator Dashboard'da Audience > Access Settings altındaki Access Control for Places ayarı değiştirir:

Access Control for Places'ın üç değeri
AyarBaşlangıç place'i olmayan bir place'e kim girebilir
Fully openHerkes; herhangi bir oyundan teleportla, deep link'lerle, oyun davetleriyle ve bir arkadaşa katılarak.
Limited to same universeSadece senin oyunlarının içinden teleport olan oyuncular. Hem istemciden hem sunucudan teleportlara izin verilir.
Secure within universe onlySadece sunucu scriptlerinin bu oyunun içinden teleport ettiği oyuncular.

Oyuncular bir place'e, örneğin bir zindana, sadece senin portalından girmeliyse Secure within universe only'i seç. Bu rehberdeki her teleport sunucuda başlıyor, bu yüzden çalışmaya devam eder. Roblox ayrıca birçok oyunun güvenli teleportlara ihtiyacı olmadığını söylüyor, yani bütün place'leri herkese açık olan bir oyun ayarı olduğu gibi bırakabilir.

Eski teleport eğitimleri nerede yanılıyor

Bu rehberi bir videoyla ya da bir forum gönderisiyle karşılaştırıyorsan, önemli farklar ve her yöntemin neden sorun çıkardığı burada.

Teleport eğitimlerinde sık görülen yöntemler ve bu rehberin yerine yaptığı
EğitimSorunBu rehber
hit.Parent.HumanoidRootPart.Position = target.Position ayarlıyorRoblox referansına göre Position ayarlamak part'ın bağlantılarını günceller ve part bağlı olduğu part'lara göre kayar: root part vücut olmadan gider.Bütün karakteri PivotTo ile taşır.
HumanoidRootPart.CFrame = target.CFrame ayarlıyorKarakterin ortası hedef part'ın ortasına, kısmen onun içine düşer ve part'ın eğimini alır.Karakter üst yüzün üstünde, ayakta durma yüksekliğinde, pad'in yanında ve eğimsiz belirir.
Bütün pad için tek bir debounce değişkeni kullanıyorBir oyuncu teleport olurken pad diğer herkesi yok sayar. Hiç debounce olmadan da diğer pad'de beliren bir oyuncu hemen geri gönderilir.Her beklemeden önce kaydedilen oyuncu başına bir cooldown, ve oyuncular pad'in yanında belirir.
Bir LocalScript'ten TeleportService:Teleport(placeId, player) çağırıyorRoblox Teleport()'u kullanımdan kalkmış olarak işaretliyor, yeni projelerde kullanılmamasını öneriyor ve TeleportAsync'e sadece sunucu scriptlerinden izin veriyor.TeleportAsync'i bir sunucu scriptinde çağırır.
pcall yok, yeniden deneme yokRoblox'un teleport sayfası teleportların takılıp hata verebileceğini, ayrıca başladıktan sonra da takılabileceğini söylüyor.pcall içinde 3 denemeye kadar, TeleportInitFailed da oyuncunun yeniden denemesini sağlar.
Studio'da "çalışmıyor" diye vazgeçiyorTeleportService Studio playtest'ini desteklemiyor.RunService:IsStudio() bunun yerine portalın ne yapacağını yazdırır.
Düğmeleri pozisyon gönderen bir teleport GUI'siBir hileci aynı remote'u herhangi bir pozisyonla çağırabilir.Düğmeler noktanın adını gönderir, sunucu da onu arar.
Coin'ler teleport data içinde aktarılıyorRoblox, teleport data'nın istemciye görünür olduğunu ve şifrelenmediğini söylüyor.Coin'leri ve Wins'i bir veri deposunda tutmayı ve diğer place'te yüklemeyi öneriyor (bkz. Verileri başka bir place'e taşımak).

Oyuncuların neyi taklit edip neyi edemeyeceği

Bir hilecinin kendi cihazındaki her şeyi kontrol ettiğini varsay: TeleportMenu'yü değiştirebilir, iki remote'u da istediği kadar ve istediği argümanlarla çağırabilir ve kendi karakterini hareket ettirebilir. Bunun ona bu teleportla ne kazandırdığı burada.

Bir hilecinin neyi deneyebileceği ve Teleporters'ın buna ne yaptığı
Hileci şunu denerSonuçNeden
Menü remote'u ile pozisyon ya da CFrame göndermekYok sayılırTeleportRequest tek bir string okur: 50 karaktere kadar bir nokta adı. Geri kalan her şey atılır.
3 Wins olmadan Castle'ı istemekReddedilirSunucu Wins'i leaderstats'ın kendi kopyasından okur. Gri düğme sadece bir ipucu.
Var olmayan bir noktayı istemekYok sayılırSunucu adı TeleportSpots'ta arar ve o adda bir part yoksa hiçbir şey yapmaz.
Menü remote'unu tekrar tekrar çağırmak3 saniyede en fazla bir menü teleportuCooldown sunucuda, oyuncu başına tutulur.
Bir pad'e yaklaşmadan onu tetiklemekZaten yürüyerek gidebileceği eş pad'e varırRoblox, herhangi bir noktaya teleport olmayı ve Touched event'leriyle oynamayı istemcinin kendi karakteriyle yapabileceği şeyler arasında sayıyor.
Oyununun başka bir place'ine doğrudan girmekAccess Control for Places, Secure within universe only değilse mümkünBkz. Diğer place'lerine kim girebilir.
Karakterini kilitli bir nokta dahil her yere taşımakMümkünHer cihaz kendi karakterinin hareketini kontrol eder. Kilitli bir nokta bir kolaylıktır, kasa değil; bu yüzden orada değerli bir şey vermeden önce sunucuda kontrol et.

Son satır her teleportun dürüst sınırı. Rekabetçi bir oyun için sprint rehberindeki gibi sunucu tarafında bir hareket kontrolü ekle. Teleporters, o kontrolün okuduğu MovementCheckSkip attribute'unu zaten ayarlıyor, bu yüzden kendi teleportları ihlal olarak işaretlenmez: Roblox'un güvenlik dokümantasyonu, meşru teleportları olan oyunların hareket kontrollerinde tam olarak böyle bir istisnaya ihtiyaç duyduğunu söylüyor.

Adım 5: test et

  1. Play'e bas. PadA'ya bas: PadB'nin hemen önünde, sırtın ona dönük olarak belirirsin. Dön ve hemen PadB'ye bas: hiçbir şey olmaz, çünkü pad'ler varışından sonra seni 2 saniye yok sayar. İn, 2 saniye bekle ve PadB'ye yeniden çık: PadA'nın önünde belirirsin.
  2. Birkaç saniye bekle, sonra ekranın solundaki Teleport'a bas. Listede Lake, Spawn ve gri "Castle (needs 3 wins)" görünür. Lake'i seç: onun üstünde belirirsin. Menüyü yeniden aç ve Castle'ı seç: hiçbir şey olmaz ve Output sessiz kalır.
  3. Kendine 3 Wins ver (bunun için Wins IntValue'su olan bir leaderstats scripti gerekiyor, örneğin liderlik tablosu rehberindeki). Server'a geçmek için Client/Server düğmesine bas, Explorer'da Players, kendi adın, leaderstats, Wins'i bul ve Properties penceresinde Value'yu 3 yap. Client'a geri geç ve menüyü yeniden aç: Castle mor oldu ve seni oraya taşıyor.
  4. DungeonPortal'a dokun. Output, adın ve place ID ile Teleporters: would send ile başlayan bir satır yazar. Studio'da böyle olması gerekiyor, portalın üstünde ne kadar durursan dur bu satır en fazla 2 saniyede bir yazılır.
  5. Test modu açılır listesinden Server & Clients'ı seç, 2 client ayarla ve Play'e bas. İki oyuncu da pad'leri aynı anda kullanabilir ve birinin cooldown'u diğerini asla engellemez.
  6. Testi durdur, oyunu yayınla ve Roblox uygulamasından başlat. Portala dokun: Roblox yükleme ekranı çıkar ve diğer place'te olursun. Yerinde kaldıysan F9 ile Developer Console'u aç, log'u sadece oyunun sahibinin ve düzenleme yetkisi olan grup üyelerinin gördüğü Server görünümüne geçir ve Teleporters: uyarılarını bul; içlerinde Roblox'un verdiği sebep yazıyor.

Studio adımları sırasında Output penceresini açık tut (Window menüsü, sonra Output). Teleporters çalışırken 4. adımdaki portal satırı dışında hiçbir şey yazmaz, bu yüzden her uyarıyı ya da kırmızı hatayı okumaya değer. Bkz. Sık yapılan hatalar.

Nasıl genişletilir

Bir takımı ya da party'yi birlikte teleport etmek

TeleportAsync bir oyuncu listesi alır, bu yüzden tek bir portal bütün bir grubu aynı place'e gönderebilir. Roblox'un teleport sayfası portala dokunan oyuncudan yola çıkmayı öneriyor: takım için player.Team ve Team:GetPlayers(), party için player.PartyId ile SocialService:GetPlayersByPartyId(). { player } yerine bu listeyi ver ve listedeki her oyuncu için leavingForPlace işaretini ayarla.

Bir grubu kendine ait bir sunucuya göndermek

Varsayılan olarak teleport edilen oyuncular diğer place'in herkese açık bir sunucusuna düşer. Bir grubu yeni bir reserved sunucuya, örneğin bir maç için göndermek için bir TeleportOptions oluştur, ShouldReserveServer değerini true yap ve üçüncü argüman olarak ver: TeleportService:TeleportAsync(placeId, players, options). Roblox, özellikle reserved sunucularla ilgili takılmalarda yeniden denemenin çok işe yaradığını belirtiyor, script de bunu zaten yapıyor.

Verileri başka bir place'e taşımak

Teleport etmek o oyuncunun bütün yerel verilerini sıfırlar. Roblox'taki teleport data, yani TeleportOptions:SetTeleportData() ile ayarlanıp diğer place'te player:GetJoinData() ile okunan veri, istemciye görünür ve şifrelenmemiştir, bu yüzden onu sadece hangi haritanın yükleneceği gibi zararsız seçimler için kullan. Coin'leri, Wins'i ve eşyaları DataStore eğitimindeki gibi bir veri deposunda tut ve oyuncu diğer place'e vardığında yeniden yükle.

Kendi yükleme ekranın

Bir place teleportu yüklenirken oyuncular Roblox'un standart yükleme ekranını görür. Kendi ekranını göstermek için istemcide bir ScreenGui ile, örneğin ReplicatedStorage'da duran biriyle, TeleportService:SetTeleportGui() çağır. Bu rehberdeki teleportlar sunucuda başlıyor, bu yüzden istemcinin onu önceden, örneğin oyuncu girer girmez çağırması gerekiyor. Roblox, ekranın her teleporttan önce yeniden ayarlanması gerektiğini ve başka bir oyundaki bir place için kullanılmadığını söylüyor. Aynı yerde o ScreenGui içindeki scriptlerin çalışmadığı da belirtiliyor, bu yüzden onu statik yap.

Tur teleportları ve checkpoint'ler

Tur sistemi her turun başında bütün oyuncuları aynı PivotTo çağrısıyla arenaya taşır, obby rehberindeki PivotTo mu SpawnLocation mı bölümü de bu yaklaşımı Roblox'un spawn noktalarıyla karşılaştırıyor. Bir nokta sadece bir turdan sonra açılmalıysa, tur sistemi WinsNeeded'ın okuduğu Wins'i zaten veriyor.

Sık yapılan hatalar ve çözümleri

Play'e basmadan önce Output penceresini aç (Window menüsü, sonra Output). Destination hiçbir yeri göstermediğinde Teleporters pad'in adını verir, bu yüzden sorunların çoğu orada görünür.

Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'

TeleportMenu, Teleporters'ın oluşturduğu remote'u bekliyor, yani Teleporters çalışmıyor. Bunun bir LocalScript değil Script olduğunu, doğrudan ServerScriptService içinde durduğunu, kapalı olmadığını ve Output'ta ondan gelen kırmızı bir hata olmadığını kontrol et. Script hataları rehberi bu uyarıyı ayrıntılı açıklıyor.

Teleporters: PadA points to PadC, which is not a part in TeleportPads

Pad'in Destination attribute'u, doğrudan TeleportPads klasörünün içinde bir part olmayan bir şeyin adını veriyor. Attribute değerindeki ve hedef pad'in adındaki yazımı ve büyük harfleri kontrol et. Uyarı her pad için bir kez, bir oyuncu ona ilk dokunduğunda çıkar.

Pad'e basıyorum ve hiçbir şey olmuyor

Klasörün adının tam olarak TeleportPads olduğunu ve oyun başladığında doğrudan Workspace içinde durduğunu, pad'in Destination attribute'unun String tipinde olduğunu (Number tipindeki bir attribute yok sayılır) ve son teleportundan bu yana 2 saniye geçtiğini kontrol et. Pad'de CanTouch'ın açık olduğunu da kontrol et: Roblox, CanTouch kapalı bir part'a Touched bağlamanın hata verdiğini söylüyor, o hata da scripti durdurur.

Bir duvarın içinde beliriyorum ya da kenardan düşüyorum

Oyuncular hedef pad'in ön yüzünün 3 stud önünde belirir. Pad'e sağ tıkla, Show Orientation Indicator'ı seç ve mavi çizgi boş zemini gösterene kadar pad'i döndür. Menü noktaları oyuncuları part'ın üstüne koyar, bu yüzden her noktayı zeminde tut.

3 Wins kazandıktan sonra Castle düğmesi gri kalıyor

Liste menü açıldığında çizilir, bu yüzden menüyü kapat ve yeniden aç. Düğme hâlâ griyse leaderstats içinde adı tam olarak Wins olan bir IntValue olduğunu ve Wins'in sadece Client modunda değil sunucuda değiştiğini kontrol et.

Portal yayınlanmış oyunda hiçbir şey yapmıyor

F9 ile Developer Console'u aç, log'u Server görünümüne geçir (Teleporters bir sunucu Script'i olduğu için bunu sadece oyunun sahibi ve düzenleme yetkisi olan grup üyeleri görür) ve Teleporters: uyarılarını oku; içlerinde Roblox'un verdiği sebep yazıyor. Portalın PlaceId attribute'unun Number tipinde olduğunu ve Asset Manager'daki ID'yi içerdiğini, ayrıca portalı ekledikten sonra place'i yeniden yayınladığını kontrol et.

RoCode ile yap

Bunların hepsini elle kurmak istemiyorsan RoCode bunu açık olan place'inde yapabilir. RoCode, Roblox'a ait olmayan, Roblox Studio için bağımsız bir yapay zeka ajanı: özelliği web sohbetinde anlatıyorsun, Studio plugin'i de part'ları ve scriptleri Explorer'ında oluşturuyor, yani sohbet penceresinden kod kopyalaman gerekmiyor.

Sen yazarsın

Teleport ekle: Workspace.TeleportPads içinde oyuncuları kendi Destination attribute'undaki pad'e 2 saniyelik cooldown ile gönderen pad'ler, Workspace.TeleportSpots'taki noktalar için Castle'ın sunucuda kontrol edilen 3 Wins istediği bir Teleport menüsü ve Workspace.PlacePortals içinde oyuncuları kendi PlaceId attribute'undaki ID'ye sahip place'e yeniden denemelerle gönderen portallar.

RoCode yapar
  • Bir adım gerektirdiğinde place'ini Search Game ve Search Scripts ile inceleyebilir, böylece ikinci bir sistem eklemek yerine zaten olan eşyalara, remote'lara ya da kayıt koduna dayanır
  • Klasörleri ve pad part'larını Create Instance ile oluşturur, özelliklerini Set Property ile ayarlar ve Teleporters ile TeleportMenu'yü Create Script ile yazar
  • Yazdığı her scriptin derlendiğini, onu çalıştırmadan Studio'da derleyen Check Script ile kontrol etmesi söylenmiştir
  • Değişiklikleri gruplar halinde gönderir ve her grup Studio geçmişinde bir geri alma noktasıdır

Place'ler arası teleportlar sadece yayınlanmış oyunda çalışır, bu yüzden onları Roblox uygulamasında kendin test et. Plugin 3.9 ya da üstüyle RoCode kısa bir playtest başlatıp hataları okuyabilir, plugin 3.9.15 ya da üstüyle de test karakteri pad'lere basıp menü düğmelerine tıklayabilir; ama sadece test etmeye karar verdiği şeyi kontrol eder, bu yüzden pad'lere kendin bas ve menüyü kendin aç. Teleport, bir oyundaki birçok sistemden biri; RoCode ile bütün bir oyun kurmak da aynı şekilde, her prompt'ta bir sistem olarak ilerler. RoCode Studio'ya nasıl bağlanır.

Sık sorulan sorular

Roblox Studio'da teleport pad'i nasıl yapılır?

İki part'a birbirinin adını taşıyan bir Destination attribute'u ver ve tek bir sunucu scriptinin pad'e dokunanı character:PivotTo ile diğer pad'in hemen önündeki bir noktaya, oyuncu başına kısa bir cooldown ile taşımasını sağla. 1. adım ve 2. adım tam olarak bunu kuruyor.

Teleportum neden Studio'da çalışmıyor?

Pad'ler ve menü Studio'da çalışır. Başka bir place'e teleportlar çalışmaz: Roblox'ta TeleportService Studio playtest'ini desteklemiyor, bu yüzden oyunu yayınla ve Roblox uygulamasında test et. Bu rehberdeki script teleport yerine portalın ne yapacağını yazdırır, yani tetiklendiğini yine de kontrol edebilirsin.

Oyuncuları oyunumun başka bir place'ine nasıl teleport ederim?

Place'i File > Publish As (Add as a new place) ile ekle, place ID'sini Asset Manager'dan kopyala ve bir sunucu Script'inden pcall içinde TeleportService:TeleportAsync(placeId, { player }) çağır, takılırsa yeniden dene. 4. adım hepsini adım adım anlatıyor.

Teleport GUI'si nasıl yapılır?

Düğmeleri bir LocalScript'te kur ve sunucuya sadece oyuncunun seçtiği noktanın adını gönder. Sunucu adı bir klasörde arar, cooldown'u ve varsa kilit açma kuralını kontrol eder, sonra karakteri taşır. İstemciden asla pozisyon gönderme: bir hileci herhangi birini gönderebilir.

Karakterim teleporttan sonra neden takılıyor ya da dağılıyor?

Root part'ın Position'ını atamak sadece o part'ı, ona bağlı vücut olmadan taşır; pad'in CFrame'ini kopyalamak da karakterin ortasını pad'in içine koyar. Humanoid'ın HipHeight'ından hesaplanan, zeminin üstünde ayakta durma yüksekliğindeki bir noktayla character:PivotTo kullan.

Teleportla birlikte coin ya da eşya aktarabilir miyim?

Güvenli şekilde aktaramazsın. Roblox, teleport data'nın istemciye görünür olduğunu ve şifrelenmediğini söylüyor, bu yüzden seçilen harita gibi şeyler için uygun ama coin'ler için değil. Coin'leri ve eşyaları bir veri deposunda kaydet ve diğer place'te yükle.

Kaynaklar ve ek okumalar

Kod nasıl kontrol edildi: bu sayfadaki her script, Roblox API tanımlarıyla Luau'nun katı tür denetleyicisinden geçiyor (luau-lsp, 20 Kasım 2026). Tür denetimi yanlış yazılmış API'leri ve hatalı türleri yakalar, oyun mantığını değil. Bu yüzden yayınlamadan önce Studio'da test et.

RoCode'u kendi oyununda dene.

Her gün ücretsiz kredi, kart gerekmez. Plugin'i kur, özelliği anlat ve Studio'da ne oluştuğunu kontrol et.