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
PivotToile taşı.HumanoidRootPart.Positionatamak 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. SunucudaTeleportAsynckullan, onupcalliçine al, yeniden dene veTeleportInitFailed'ı ele al.
Bu sayfada
İki tür teleport
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.
| Aynı sunucunun içinde | Oyununun başka bir place'ine | |
|---|---|---|
| Çağrı | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| Ne için | Teleport pad'leri, teleport menüleri, oyuncuları lobiden arenaya taşımak | Başka bir seviyeye giden portallar, oyuncuları ayrı bir zindan ya da maç place'ine gönderen bir lobi |
| Nerede çalışır | Sunucu Script'i | Sadece sunucu Script'i. İstemci tarafındaki Teleport() kullanımdan kalktı. |
| Studio playtest'inde çalışır mı | Evet | Hayır. Roblox'ta TeleportService, Studio playtest'ini desteklemiyor, bu yüzden yayınlanmış oyunda test edilir. |
| Oyuncu ne görür | Haritanın öbür ucuna bir sıçrama; o alanın önce yüklenmesi gerekiyorsa 2 saniyeye kadar sürebilir | Roblox yükleme ekranı, sonra diğer place |
| Coin'ler, eşyalar ve diğer veriler | Olduğu gibi kalır | Roblox 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.
| Parça | Nerede durur | Ne 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'ı | Workspace | Menü listesindeki her nokta için bir part. WinsNeeded attribute'u noktayı kilitler. |
PlacePortals Folder'ı | Workspace | Portal part'ları. Her portalın PlaceId attribute'u, oyuncuları gönderdiği place'tir. |
Teleporters Script'i | ServerScriptService | Üç teleport türünün hepsini yönetir ve iki remote oluşturur. Bir teleportun gerçekleşebileceği tek yer. |
TeleportMenu LocalScript'i | StarterPlayer > StarterPlayerScripts | Teleport düğmesini ve nokta listesini çizer ve oyuncunun seçtiği noktanın adını gönderir. |
GetTeleportSpots RemoteFunction'ı ve TeleportRequest RemoteEvent'i | ReplicatedStorage (bunları Teleporters oluşturur) | İlki menüye nokta listesini döndürür. İkincisi seçilen adı sunucuya taşır. |
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
- Explorer'da fareyle Workspace üzerine gel, + düğmesine tıkla ve bir Folder ekle. Klasörün adını
TeleportPadsyap. Script tam olarak bu adı arar. - Klasöre iki Part ekle ve adlarını
PadAvePadByap. 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. - PadA'yı seç, Properties penceresini Attributes bölümüne kadar kaydır ve +'ya tıkla. Ad olarak
Destinationyaz, tip olarak String seç ve Save'e tıkla, sonra değeriniPadByap. Aynısını PadB'dePadAdeğeriyle yap. - 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.
-- 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.
| Parça | Ne yapar | Neden |
|---|---|---|
playerFromHit | Dokunan 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. |
onCooldown | os.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. |
rootHeight | Ayakta 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 kontroller | Oyuncunun 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. |
RequestStreamAroundAsync | Roblox'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 kontrol | Oyuncu çı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. |
MovementCheckSkip | Her 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. |
| Ayar | Buradaki değer | Neyi değiştirir |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Herhangi bir teleporttan sonra pad'lerin ve portalların oyuncuyu ne kadar yok saydığı. |
MENU_COOLDOWN_SECONDS | 3 | Bir 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_GAP | 3 | Oyuncuları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_ATTEMPTS | 3 | Bir 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.
- 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.
- İ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.
- 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.
- İlk place'e döndüğünde Workspace'e
PlacePortalsadlı bir Folder, içine deDungeonPortaladlı anchor'lanmış bir Part ekle.PlaceIdadında Number tipinde bir attribute ekle ve ID'yi değeri olarak yapıştır. - Play'e bas ve portala dokun. Output,
Teleporters: would sendile başlayan bir satır yazar: Studio'da portal başka bir şey yapmaz. - 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:
| Ayar | Başlangıç place'i olmayan bir place'e kim girebilir |
|---|---|
| Fully open | Herkes; herhangi bir oyundan teleportla, deep link'lerle, oyun davetleriyle ve bir arkadaşa katılarak. |
| Limited to same universe | Sadece senin oyunlarının içinden teleport olan oyuncular. Hem istemciden hem sunucudan teleportlara izin verilir. |
| Secure within universe only | Sadece 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.
| Eğitim | Sorun | Bu rehber |
|---|---|---|
hit.Parent.HumanoidRootPart.Position = target.Position ayarlıyor | Roblox 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ıyor | Karakterin 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ıyor | Bir 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ıyor | Roblox 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 yok | Roblox'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çiyor | TeleportService Studio playtest'ini desteklemiyor. | RunService:IsStudio() bunun yerine portalın ne yapacağını yazdırır. |
| Düğmeleri pozisyon gönderen bir teleport GUI'si | Bir 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ıyor | Roblox, 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.
| Hileci şunu dener | Sonuç | Neden |
|---|---|---|
| Menü remote'u ile pozisyon ya da CFrame göndermek | Yok sayılır | TeleportRequest tek bir string okur: 50 karaktere kadar bir nokta adı. Geri kalan her şey atılır. |
| 3 Wins olmadan Castle'ı istemek | Reddedilir | Sunucu Wins'i leaderstats'ın kendi kopyasından okur. Gri düğme sadece bir ipucu. |
| Var olmayan bir noktayı istemek | Yok sayılır | Sunucu adı TeleportSpots'ta arar ve o adda bir part yoksa hiçbir şey yapmaz. |
| Menü remote'unu tekrar tekrar çağırmak | 3 saniyede en fazla bir menü teleportu | Cooldown sunucuda, oyuncu başına tutulur. |
| Bir pad'e yaklaşmadan onu tetiklemek | Zaten yürüyerek gidebileceği eş pad'e varır | Roblox, 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 girmek | Access Control for Places, Secure within universe only değilse mümkün | Bkz. Diğer place'lerine kim girebilir. |
| Karakterini kilitli bir nokta dahil her yere taşımak | Mümkün | Her 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
- 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.
- 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.
- 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. - DungeonPortal'a dokun. Output, adın ve place ID ile
Teleporters: would sendile 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. - 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.
- 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.
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.
- 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
- Roblox Creator Docs: Teleport between places (İngilizce). TeleportAsync, Studio playtest'leri, Access Control for Places, teleport ekranları, teleport data ve takılan teleportlar
- Roblox Creator Docs: TeleportService (İngilizce). kullanımdan kalkan Teleport, sadece sunucuda TeleportAsync ve TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (İngilizce). modelleri scriptlerden taşımak için ana fonksiyon
- Roblox Creator Docs: BasePart.Position (İngilizce). bağlı bir part'ta Position ayarlamanın onu diğerlerine göre neden kaydırdığı
- Roblox Creator Docs: Humanoid.HipHeight (İngilizce). ayakta duran bir karakterin root part'ının ne kadar yüksekte olduğu, R15 ve R6 rig'leri için
- Roblox Creator Docs: Seat (İngilizce). oturan karakteri tutan SeatWeld ve karakteri kaldırmak için onu yok etmek
- Roblox Creator Docs: Player:RequestStreamAroundAsync (İngilizce). karakter oraya taşınmadan önce bir alanı istemek, neyin ulaşacağına dair garanti olmadan
- Roblox Creator Docs: Streaming techniques and conversion (İngilizce). teleporttan önce önceden streaming
- Roblox Creator Docs: Access control and confidentiality (İngilizce). teleportlar korunmuyorsa istemcilerin neden oyunun herhangi bir place'ine girebildiği
- Roblox Creator Docs: Network ownership, movement validation, and physics (İngilizce). istemcinin kendi karakteriyle neler yapabileceği ve hareket kontrollerinde teleport istisnaları
- Roblox Creator Docs: Create and publish games and places (İngilizce). yayınlama, yeni bir oyunu kimin açabileceği ve Publish As ile place eklemek
- Roblox Creator Docs: Asset Manager (İngilizce). place ID nasıl kopyalanır
- Roblox Creator Docs: Developer Console (İngilizce). log'daki Server görünümü ve onu kimin gördüğü
- Roblox Creator Docs: Debounce patterns (İngilizce). Touched'ın neden tek bir temasta birkaç kez tetiklendiği
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.