Röviden
Teleport platformhoz tegyél egy Scriptet a ServerScriptService-be, amely figyeli a platform Touched eseményét, a Players:GetPlayerFromCharacter segítségével megtalálja a játékost, és a character:PivotTo() segítségével az egész karaktert a célplatform elé helyezi, háttal neki, játékosonként pár másodperces cooldownnal, hogy a célplatform ne küldje azonnal vissza. Ha a játékosokat a játékod egy másik place-ébe akarod küldeni, hívd meg a TeleportService:TeleportAsync(placeId, { player }) függvényt egy szerveroldali Scriptből, pcall-on belül; ez csak a publikált játékban működik, a Studióban nem.
- Az egész karaktert a
PivotTosegítségével helyezd át. AHumanoidRootPart.Positionbeállítása elmozdítja a gyökérpartot a test többi részétől, mert a Position beállításakor a Roblox frissíti a kötéseket. - A teleport menünek a célpont nevét kell elküldenie a szervernek, nem a pozícióját. A szerver ellenőrzi a nevet, a cooldownt és minden feloldási szabályt, mielőtt bárkit áthelyezne.
- A
TeleportService:Teleport()elavult, és a kliensen fut. A szerveren aTeleportAsync-et használd, csomagoldpcall-ba, próbálkozz újra, és kezeld aTeleportInitFailedeseményt.
Ezen az oldalon
A teleport két fajtája
A teleport egy Roblox játékban háromféle dolgot jelenthet: egy platformot, amely átvisz a pályán, egy menüt pontokkal, ahová ugrani lehet, vagy egy portált egy másik pályára. Az első kettő a karaktert azon a szerveren belül mozgatja, amelyen a játékos már van. A harmadik a játékost a játékod egy másik place-ébe küldi, amely saját szervereken fut. Más API-kat használnak, ezért érdemes tudni, melyikre van szükséged.
| Ugyanazon a szerveren belül | A játékod egy másik place-ébe | |
|---|---|---|
| Hívás | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| Mire való | Teleport platformok, teleport menük, játékosok átvitele a lobbiból az arénára | Portálok egy másik pályára, lobbi, amely a játékosokat egy külön place-be küldi egy dungeonnel vagy meccsel |
| Hol fut | Szerveroldali Script | Csak szerveroldali Script. A kliensoldali Teleport() elavult. |
| Működik a Studio playtestjében | Igen | Nem. A Roblox TeleportService nem támogatja a Studio playtestet, ezért a publikált játékban tesztelnek. |
| Mit lát a játékos | Egy ugrást a pályán át, amely akár 2 másodpercig is tarthat, ha azt a területet előbb be kell tölteni | A Roblox betöltőképernyőjét, aztán a másik place-t |
| Érmék, tárgyak és egyéb adatok | Változatlanok maradnak | A Roblox törli a játékos helyi adatait, ezért minden fontosnak a másik place-ben egy data store-ból kell jönnie |
Ebben az útmutatóban mindhárom fajta egyetlen szerveroldali Scriptben van, így egyetlen szabálykészlet fedi le a játékod minden teleportját: a szerver dönt, minden játékosnak saját cooldownja van, a játékos eszköze pedig csak azt jelzi, melyik pontra szeretne eljutni.
| Elem | Hol található | Mit csinál |
|---|---|---|
TeleportPads Folder a PadA és a PadB elemmel | Workspace | Két platform. Mindegyik Destination attribútuma azt a platformot nevezi meg, ahová a játékosokat küldi. |
TeleportSpots Folder | Workspace | A menü listájának minden pontjához egy part. A WinsNeeded attribútum lezárja a pontot. |
PlacePortals Folder | Workspace | Portál partok. Minden portál PlaceId attribútuma az a place, ahová a játékosokat küldi. |
Script Teleporters | ServerScriptService | Mindhárom teleportfajtát kezeli, és létrehoz két remote-ot. Az egyetlen hely, ahol teleport történhet. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | Kirajzolja a Teleport gombot és a pontok listáját, és elküldi a játékos által választott pont nevét. |
RemoteFunction GetTeleportSpots és RemoteEvent TeleportRequest | ReplicatedStorage (a Teleporters hozza létre őket) | Az első visszaadja a menünek a pontok listáját. A második elviszi a választott nevet a szerverre. |
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
1. lépés: építs két teleport platformot
- Az Explorerben vidd az egeret a Workspace fölé, nyomd meg a + gombot, és szúrj be egy Foldert. Nevezd el a mappát
TeleportPads-nek. A script pontosan ezt a nevet keresi. - Szúrj be a mappába két Partot, és nevezd el őket
PadA-nak ésPadB-nek. Mindegyikből készíts lapos lemezt, például 6 x 1 x 6 studosat, és tedd őket a padlóra egymástól valamekkora távolságra. A Properties ablakban pipáld be az Anchored beállítást, hagyd bekapcsolva a CanCollide és a CanTouch beállítást, és adj nekik élénk színt és Neon anyagot, hogy a játékosok észrevegyék őket. - Jelöld ki a PadA-t, görgess le a Properties ablakban az Attributes részig, és nyomd meg a + gombot. Írd be a
Destinationnevet, válaszd a String típust, nyomd meg a Save gombot, aztán állítsd az értékétPadB-re. Ugyanezt csináld meg a PadB-nPadAértékkel. - Fordítsd el mindkét platformot úgy, hogy az elülső lapja szabad padlóra nézzen. A játékosok 3 studdal a célplatform elülső lapja előtt jelennek meg, háttal neki, ezért hagyj ott néhány stud szabad padlót. Hogy lásd, melyik az elülső lap, kattints jobb gombbal a platformra, és válaszd a Show Orientation Indicator lehetőséget: az elülső lapot kék vonal jelöli. A Rotate eszközzel forgasd a platformot, amíg ez a vonal arra nem mutat, amerre a játékosoknak tovább kell menniük.
A játékosok szándékosan a platform mellé kerülnek, nem rá. A Roblox debounce-ról szóló oldala megjegyzi, hogy a Touched egyetlen érintésre sokszor egymás után lefut, így egy játékos, aki közvetlenül a másik platformon jelenne meg, a cooldownja lejártakor újra elindítaná, és visszarepülne a pályán át.
Nem vagy két platformra korlátozva. Egy platform Destination értéke bármely partot megnevezheti a TeleportPads alatt, így három platform körben is küldheti a játékosokat. Egyirányú platformhoz irányítsd egy olyan partra a TeleportPads alatt, amelynek nincs saját Destination értéke: egy ilyen part fogadja a játékosokat, és senkit sem küld sehová.
2. lépés: add hozzá a teleport scriptet
Vidd az egeret a ServerScriptService fölé, szúrj be egy Scriptet, nevezd el Teleporters-nek, és illeszd be az alábbi kódot. Most a platformokat kezeli, a következő lépések után pedig a menüt és a portálokat is, így csak egyszer adod hozzá. Az elején lévő beállítások azok a sorok, amelyeket módosítanod kell.
-- Script a ServerScriptService-ben Teleporters néven.
-- Minden teleportról itt születik döntés, a szerveren:
-- 1. Platformok: ha hozzáérsz egy parthoz a Workspace.TeleportPads alatt, ahhoz a parthoz kerülsz, amelyet
-- a Destination attribútuma megnevez.
-- 2. Menü: a TeleportMenu LocalScript egy pontot kér a Workspace.TeleportSpots alól
-- név szerint. A szerver ellenőrzi a nevet, a cooldownt és a ponthoz szükséges Wins értéket.
-- 3. Portálok: ha hozzáérsz egy parthoz a Workspace.PlacePortals alatt, abba a place-be kerülsz,
-- amely a PlaceId attribútumában áll (a játék egy másik place-e).
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 -- ennyi ideig hagyják figyelmen kívül a platformok a játékost bármely teleport után
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- stud a célplatform előtt, hogy a játékosok mellé kerüljenek
local PLACE_ATTEMPTS = 3
local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")
-- Ez a script maga hozza létre mindkét remote-ot, ezért ne add hozzá őket kézzel
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
-- Milyen magasan van a padló fölött egy álló karakter gyökérpartja.
-- Képlet a Roblox Humanoid.HipHeight dokumentációjából (R6 rigeknél hozzáadódik a láb magassága).
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() -- a várakozás előtt állítjuk be, hogy egy második érintés ne indítson második teleportot
-- Arra nézünk, amerre a célpont elülső lapja mutat (egyenesen, dőlés nélkül)
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
-- A felső lapjára állunk: a karakter pivotja a gyökérpartja, ezért álló magasságba emeljük.
-- A platform viszont néhány studdal maga elé teszi a játékosokat, mert egy játékos, aki
-- a platformon áll, a következő lépésével újra elindítaná.
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)
-- Bekapcsolt instance streaming esetén először betöltjük a célpont körüli területet (legfeljebb 2 másodperc)
pcall(function()
player:RequestStreamAroundAsync(target.Position, 2)
end)
if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
return -- kilépett, újraéledt vagy meghalt, amíg a terület töltődött
end
-- Az ülő karakter az ülésre van hegesztve, és a mozgatása magával vinné az ülést.
-- A SeatWeld megsemmisítése előbb kiszabadítja a karaktert az ülésből.
local seat = humanoid.SeatPart
if seat then
local seatWeld = seat:FindFirstChild("SeatWeld")
if seatWeld then
seatWeld:Destroy()
end
end
character:PivotTo(target)
-- Érkezéskor újraindítjuk a cooldownt: a fenti előtöltés akár 2 másodpercig is tarthat,
-- és a platform, amely mellé a játékos került, nem küldheti azonnal vissza
lastTeleport[player] = os.clock()
player:SetAttribute("MovementCheckSkip", true) -- a sebességellenőrző scriptnek, ha van ilyened
end
-- 1. Platformok
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 -- egyszer figyelmeztetünk, nem minden érintésnél
warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
end
end)
end
end
end
-- 2. Menü: a pontok listája, aztán kérés név szerint
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 -- azonos Wins: ábécérendben, hogy a sorrend soha ne változzon
end)
return list
end
teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
-- A kliens csak a nevet küldi. Soha ne fogadj el a klienstől pozíciót vagy CFrame-et.
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 -- ennek a játékosnak zárva
end
teleportTo(player, spot, false)
end)
-- 3. Portálok a játék egy másik place-ébe
local function sendToPlace(player: Player, placeId: number)
if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
return -- már úton van, vagy egy másodperce ért teleporthoz
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 -- feladjuk; a portál újabb érintése újra próbálkozik
end
-- A teleport az indulás után is meghiúsulhat. A játékos itt marad, és újra próbálkozhat.
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)
A Teleporters maga hozza létre a GetTeleportSpots RemoteFunctiont és a TeleportRequest RemoteEventet, így semmit sem kell kézzel a ReplicatedStorage-ba tenni. A TeleportPads platformjait és a PlacePortals portáljait egyszer, a szerver indulásakor köti be, így a játék közben hozzáadott platformok és portálok nem csinálnak semmit. Ha valamelyik mappa hiányzik, az a teleportfajta egyszerűen ki van kapcsolva.
| Rész | Mit csinál | Miért |
|---|---|---|
playerFromHit | Megkeresi a karaktermodellt, amelyhez a hozzáérő part tartozik, és megkérdezi a Players:GetPlayerFromCharacter függvényt, kié. | A platformokhoz lábak, kalapok és szabad partok érnek hozzá. Minden, ami nem egy játékos karakterének része, nilt ad, és figyelmen kívül marad. |
onCooldown | Összeveti az os.clock() értéket a játékos utolsó teleportjának idejével. | Játékosonként egy cooldown, így egy platform mellett álló játékos soha nem blokkolja a többieket. Semmi sem vár és nem alszik. |
rootHeight | Kiszámolja, milyen magasan van a padló fölött egy álló karakter gyökérpartja: a gyökérpart magasságának fele plusz a Humanoid HipHeight értéke, R6 rigeknél plusz a lábhossz. | Ez a képlet a Roblox Humanoid.HipHeight dokumentációjából. A karakter pivotja a gyökérpartja, így a pivot ennyivel való megemelése a lábakat a felületre teszi kis és nagy avatároknál, és R6-nál is. |
Ellenőrzések a teleportTo elején | Kilép, ha a játékosnak nincs élő karaktere gyökérparttal, aztán azonnal feljegyzi az időt. | Az alábbi streaming kérés várakozásra kényszerítheti a scriptet. Ha az időt előre feljegyezzük, az ilyenkor érkező sok Touched esemény nem indít második teleportot. |
| Érkezési pont | A célpont felső lapja, rootHeight-tal megemelve, arra nézve, amerre az elülső lapja néz, dőlés nélkül. Platformnál a pont ráadásul 3 studdal el is van tolva az elülső lapjától. | A karakter állva jelenik meg, nem a célpartban. A platform mellett a lábai a platform felső lapjának magasságában kezdenek, így a platform vastagságának megfelelően leereszkedik a padlóra. A CFrame.lookAlong egy adott pozícióban, adott nézési iránnyal épít CFrame-et. |
RequestStreamAroundAsync | Megkéri a Robloxot, hogy előbb az érkezési pont körüli területet küldje el ennek a játékosnak, és legfeljebb 2 másodpercig vár. | Az instance streaming új place-ekben alapból be van kapcsolva, így a pálya távoli része még nem biztos, hogy betöltődött a játékos eszközén. A Roblox ezt a szerveroldali hívást ajánlja, mielőtt egy karaktert messzire mozgatnál, bár nem garantálja, hogy pontosan mi érkezik meg. |
| Második ellenőrzés | Ha a játékos kilépett, a karakter pedig újraéledt vagy meghalt a várakozás alatt, semmi sem mozdul. | A játékos resetelhetett vagy kiléphetett a játékból, amíg a terület töltődött. A Roblox saját előtöltési példája is ellenőrzi, hogy a karakter még a játékban van, mielőtt mozgatná. |
A SeatWeld sorok | Ha a karakter ül, megsemmisíti a Weldet, amely az ülésen tartja. | A Roblox az ülő karaktert az üléshez hegeszti. A PivotTo a partok CFrame-jének megváltoztatásával mozgat, a Roblox dokumentációja szerint pedig egy part CFrame-jének beállítása a hozzá kötött partokat is mozgatja, így enélkül az ülés és minden, ami hozzá van hegesztve, a játékossal együtt érkezne. A SeatWeld megsemmisítése az a mód, ahogy a Roblox Seat dokumentációja scriptből felállítja a karaktert az ülésből. |
character:PivotTo(target) | Az egész karaktert, minden végtagot és kiegészítőt együtt, az érkezési pontra helyezi. | A Roblox a PivotTo-t nevezi a modellek scriptből való mozgatásának fő függvényének. |
A második lastTeleport sor | Érkezéskor újraindítja a cooldownt. | A streaming kérés akár 2 másodpercig is tarthat, ugyanannyi ideig, mint maga a platform cooldownja, így e sor nélkül a játékos már lejárt cooldownnal érkezhetne meg. |
MovementCheckSkip | Minden áthelyezés után beállít egy attribútumot a Playeren. | Egy szerveroldali sebességellenőrzés csalásnak venné az ugrást. A futás útmutató MovementChecke olvassa ezt az attribútumot, és az új pozíciótól kezdi újra a mérést. Ilyen script nélkül az attribútum semmit sem csinál. |
| Beállítás | Érték itt | Mit változtat |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Mennyi ideig hagyják figyelmen kívül a platformok és a portálok a játékost bármely teleport után. |
MENU_COOLDOWN_SECONDS | 3 | A legrövidebb idő két menüs teleport között egy játékosnál. A platformoknak és a menünek közös órájuk van játékosonként, így egy platformos teleport utáni 3 másodpercen belüli menükérés is figyelmen kívül marad. |
PAD_ARRIVAL_GAP | 3 | Hány studdal a célplatform elülső lapja előtt jelennek meg a játékosok, hogy a platform mellé kerüljenek, ne rá. |
PLACE_ATTEMPTS | 3 | Hányszor próbálja meg a portál a TeleportAsync-et 2 másodperces időközzel, mielőtt feladja. |
Nyomd meg most a Play gombot, és lépj rá a PadA-ra: a PadB előtt jelensz meg. A menünek és a portáloknak a következő két lépés kell, de a script már nélkülük is működik.
4. lépés: teleport egy másik place-be
A place egy külön világ a játékodon belül, saját szerverekkel: egy lobbi és egy dungeon, vagy egy hub és egy sor pálya. A játékosok a TeleportService segítségével mozognak a place-ek között, a Roblox pedig csak a publikált játékban futtatja, ezért ez a lépés a Roblox alkalmazásban ér véget, nem a Studióban.
- Ha a játék még nincs publikálva, válaszd a File > Publish lehetőséget. Az új játékok, amíg ki nem adod őket, csak neked, azoknak, akiknek Edit hozzáférést adtál, és a megfelelő szerepkörű csoporttagoknak érhetők el, és a teleportok saját teszteléséhez ez elég.
- Hozz létre egy második place-t: nyiss meg egy új place-t bármelyik Studio sablonból, építsd meg a dungeonödet, aztán válaszd a File > Publish As lehetőséget, kattints a játékod csempéjére, válaszd az Add as a new place lehetőséget, és nyomd meg a Create gombot.
- Másold ki az új place ID-ját. Nyisd meg az Asset Managert a Window menüből vagy a Home fülről, menj a Places In Experience részhez, kattints jobb gombbal a place-re, és válaszd a Copy Asset ID lehetőséget, ez a place ID-ját másolja ki.
- Az első place-be visszatérve szúrj be a Workspace-be egy Foldert
PlacePortalsnéven, abba pedig egy anchorolt PartotDungeonPortalnéven. Adj hozzá egy Number típusú attribútumotPlaceIdnéven, és illeszd be az ID-t értéknek. - Nyomd meg a Play gombot, és érj hozzá a portálhoz. Az Output kiír egy sort, amely így kezdődik:
Teleporters: would send; a Studióban a portál mást nem csinál. - Publikáld újra a játékot a File > Publish segítségével, hogy a portál megjelenjen a publikált játékban, és próbáld ki a Roblox alkalmazásból, ahogy az 5. lépésben.
A Teleporters a TeleportAsync-et pcall-on belül hívja meg, legfeljebb 3-szor, a próbálkozások között 2 másodperc szünettel, mert a Roblox teleportokról szóló oldala szerint a teleportok meghiúsulhatnak és hibát adhatnak, és az újrapróbálkozás ajánlott. A teleport el is indulhat, és az utolsó pillanatban hiba nélkül meghiúsulhat, a játékost ott hagyva, ahol volt. Erre az esetre a Roblox kiváltja a TeleportInitFailed eseményt, a script pedig leveszi a játékosról a „távozik” jelzőt, így a portál újabb érintése újra próbálkozik.
Ha vissza akarod hozni a játékosokat, csináld meg ugyanezt a másik place-ben: tegyél a Teleporters egy másolatát a ServerScriptService-ébe, és adj hozzá egy portált, amelynek a PlaceId értéke az első place-ed ID-ja, ugyanígy kimásolva az Asset Managerből.
Ki léphet be a többi place-edbe
A Roblox biztonsági dokumentációja figyelmeztet: amint egy kliens bekerült a játékod egyik place-ébe, a játék bármely másik place-ébe teleportálhat, akármilyen útvonalat terveztél is, egy place Direct Access beállításának kikapcsolása pedig csak a Join gombot tünteti el a weboldalon. Ezt az Access Control for Places beállítás változtatja meg a Creator Dashboard Audience > Access Settings részében:
| Beállítás | Ki léphet be egy place-be, amely nem a kezdő place |
|---|---|
| Fully open | Bárki, bármely játékból jövő teleportokkal, deep linkekkel, játékmeghívókkal és barátokhoz csatlakozással. |
| Limited to same universe | Csak azok a játékosok, akik a játékaidon belülről teleportálnak. A kliensről és a szerverről indított teleportok is engedélyezettek. |
| Secure within universe only | Csak azok a játékosok, akiket a szerverscriptjeid teleportálnak ezen a játékon belülről. |
Ha a játékosoknak csak a portálodon keresztül szabad bejutniuk egy place-be, például egy dungeonbe, válaszd a Secure within universe only beállítást. Ebben az útmutatóban minden teleport a szerveren indul, így továbbra is működni fog. A Roblox azt is mondja, hogy sok játéknak nincs szüksége védett teleportokra, így egy játék, amelynek minden place-e mindenki előtt nyitva áll, hagyhatja a beállítást úgy, ahogy van.
Miben tévednek a régebbi teleport útmutatók
Ha ezt az útmutatót egy videóval vagy fórumbejegyzéssel veted össze, íme a fontos különbségek, és az ok, amiért mindegyik fogás problémát okoz.
| Útmutató | Probléma | Ez az útmutató |
|---|---|---|
Beállítja: hit.Parent.HumanoidRootPart.Position = target.Position | A Roblox dokumentációja szerint a Position beállítása frissíti a part kötéseit, és elmozdul azokhoz a partokhoz képest, amelyekhez kötve van: a gyökérpart test nélkül csúszik el. | Az egész karaktert a PivotTo segítségével helyezi át. |
Beállítja: HumanoidRootPart.CFrame = target.CFrame | A karakter közepe a célpart közepébe kerül, részben bele, és átveszi a part dőlését. | A karakter álló magasságban jelenik meg a felső lap fölött, a platform mellett, dőlés nélkül. |
Egyetlen debounce változót használ az egész platformra | Amíg egy játékos teleportál, a platform mindenki mást figyelmen kívül hagy. Debounce nélkül pedig a másik platformon megjelenő játékost azonnal visszaküldi. | Játékosonként egy cooldown, bármilyen várakozás előtt feljegyezve, és a játékosok a platform mellett jelennek meg. |
A TeleportService:Teleport(placeId, player) függvényt hívja egy LocalScriptből | A Roblox a Teleport()-ot elavultnak jelöli, azt tanácsolja, hogy új projektekben ne használd, és a TeleportAsync-et csak szerverscriptekből engedi. | A TeleportAsync-et egy szerverscriptben hívja meg. |
Nincs pcall, nincs újrapróbálkozás | A Roblox teleportokról szóló oldala szerint meghiúsulhatnak és hibát adhatnak, és az indulás után is meghiúsulhatnak. | Legfeljebb 3 próbálkozás pcall-ban, a TeleportInitFailed pedig lehetővé teszi, hogy a játékos újra próbálkozzon. |
| Feladja, mert a Studióban „nem működik” | A TeleportService nem támogatja a Studio playtestet. | A RunService:IsStudio() esetén ehelyett kiírja, mit csinálna a portál. |
| Teleport GUI, amelynek a gombjai pozíciót küldenek | Egy csaló bármilyen pozícióval meghívhatja ugyanazt a remote-ot. | A gombok a pont nevét küldik, a szerver pedig kikeresi. |
| Az érméket a teleport datában adja át | A Roblox szerint a teleport data látható a kliens számára, és nincs titkosítva. | Azt tanácsolja, hogy az érméket és a Wins értéket data store-ban tárold, és a másik place-ben töltsd be őket (lásd Hogyan vigyél át adatokat egy másik place-be). |
Mit tudnak és mit nem tudnak meghamisítani a játékosok
Számolj azzal, hogy a csaló mindent irányít a saját eszközén: módosíthatja a TeleportMenut, akárhányszor meghívhatja mindkét remote-ot bármilyen argumentummal, és mozgathatja a karakterét. Íme, mit nyer ezzel ennél a teleportnál.
| A csaló megpróbálja | Eredmény | Miért |
|---|---|---|
| Pozíciót vagy CFrame-et küldeni a menü remote-ján | Figyelmen kívül marad | A TeleportRequest egyetlen szöveget olvas, a pont legfeljebb 50 karakteres nevét. Minden mást eldob. |
| A Castle-t kérni 3 Wins nélkül | Elutasítva | A szerver a Wins értéket a leaderstats saját másolatából olvassa. A szürke gomb csak tájékoztatás. |
| Egy nem létező pontot kérni | Figyelmen kívül marad | A szerver a TeleportSpotsban keresi a nevet, és semmit sem csinál, ha nincs ilyen nevű part. |
| Újra és újra meghívni a menü remote-ját | Legfeljebb egy menüs teleport 3 másodpercenként | A cooldown a szerveren tárolódik, játékosonként. |
| Elindítani egy platformot anélkül, hogy odamenne | A párjához kerül, ahová amúgy is eljuthatott volna | A Roblox a bárhová teleportálást és a Touched események manipulálását is felsorolja azok között, amiket a kliens a saját karakterével tehet. |
| Közvetlenül belépni a játékod egy másik place-ébe | Lehetséges, ha az Access Control for Places értéke nem Secure within universe only | Lásd Ki léphet be a többi place-edbe. |
| Bárhová mozgatni a karakterét, egy zárt pontra is | Lehetséges | Minden eszköz a saját karaktere mozgását irányítja. A zárt pont kényelmi funkció, nem széf, ezért ellenőrizz a szerveren, mielőtt ott bármi értékeset kiadnál. |
Az utolsó sor minden teleport őszinte határa. Versengő játéknál adj hozzá szerveroldali mozgásellenőrzést, ahogy a futás útmutatóban. A Teleporters már beállítja a MovementCheckSkip attribútumot, amelyet az az ellenőrzés olvas, így a saját teleportjait nem jelöli szabálysértésnek: a Roblox biztonsági dokumentációja szerint a legitim teleportokat használó játékoknak pontosan ilyen kivételre van szükségük a mozgásellenőrzésekben.
5. lépés: teszteld
- Nyomd meg a Play gombot. Lépj rá a PadA-ra: közvetlenül a PadB előtt jelensz meg, háttal neki. Fordulj meg, és azonnal lépj rá a PadB-re: semmi sem történik, mert a platformok érkezés után 2 másodpercig figyelmen kívül hagynak. Lépj le, várj 2 másodpercet, és lépj újra a PadB-re: a PadA előtt jelensz meg.
- Várj néhány másodpercet, aztán nyomd meg a Teleport gombot a képernyő bal oldalán. A listában ott a Lake, a Spawn és a szürke "Castle (needs 3 wins)". Válaszd a Lake-et: ott jelensz meg. Nyisd meg újra a menüt, és válaszd a Castle-t: semmi sem történik, és az Output csendes.
- Adj magadnak 3 Wins értéket (ehhez kell egy leaderstats script Wins IntValue-val, például a ranglista útmutatóból). Nyomd meg a Client/Server kapcsolót, hogy Serverre válts, keresd meg az Explorerben a
Players, a saját neved, aleaderstats, aWinselemet, és állítsd a Value értékét 3-ra a Properties ablakban. Válts vissza Clientre, és nyisd meg újra a menüt: a Castle lila lett, és odavisz. - Érj hozzá a DungeonPortalhoz. Az Output kiír egy sort, amely így kezdődik:
Teleporters: would send, a neveddel és a place ID-val. A Studióban ennek így kell lennie, és legfeljebb 2 másodpercenként egyszer íródik ki, akármeddig állsz a portálon. - Válaszd a Server & Clients lehetőséget a tesztmódok legördülő listájában, állíts be 2 klienst, és nyomd meg a Play gombot. Mindkét játékos egyszerre használhatja a platformokat, és az egyik cooldownja soha nem blokkolja a másikat.
- Állítsd le a tesztet, publikáld a játékot, és indítsd el a Roblox alkalmazásból. Érj hozzá a portálhoz: megjelenik a Roblox betöltőképernyője, és a másik place-ben találod magad. Ha a helyeden maradtál, nyisd meg a Developer Console-t az F9 billentyűvel, kapcsold a naplót Server nézetre, amelyet csak a játék tulajdonosa és a szerkesztési joggal rendelkező csoporttagok látnak, és keresd meg a
Teleporters:figyelmeztetéseket, ezekben ott az ok, amelyet a Roblox megnevezett.
A Studiós lépések alatt tartsd nyitva az Output ablakot (Window menü, aztán Output). Amikor a Teleporters működik, semmit sem ír ki, csak a 4. lépés portálsorát, így minden figyelmeztetést vagy piros hibát érdemes elolvasni. Lásd a Gyakori hibákat.
Hogyan bővítsd
Egy csapat vagy party együttes teleportálása
A TeleportAsync játékosok listáját fogadja, így egyetlen portál egy egész csoportot küldhet ugyanabba a place-be. A Roblox teleportokról szóló oldala azt javasolja, hogy abból a játékosból indulj ki, aki hozzáért a portálhoz: player.Team és Team:GetPlayers() csapathoz, vagy SocialService:GetPlayersByPartyId() a player.PartyId értékkel partyhoz. Ezt a listát add át a { player } helyett, és a lista minden játékosára állítsd be a leavingForPlace jelzőt.
Egy csoport küldése saját szerverre
Alapból a teleportált játékosok a másik place nyilvános szerverére kerülnek. Ha egy csoportot egy új, lefoglalt szerverre akarsz küldeni, például egy meccshez, hozz létre egy TeleportOptions objektumot, állítsd a ShouldReserveServer értékét true-ra, és add át harmadik argumentumként: TeleportService:TeleportAsync(placeId, players, options). A Roblox megjegyzi, hogy a kifejezetten lefoglalt szerverekkel kapcsolatos hibáknál az újrapróbálkozások különösen hasznosak, a script pedig már végzi őket.
Hogyan vigyél át adatokat egy másik place-be
A teleportálás törli ennek a játékosnak minden helyi adatát. A Roblox teleport datája, amelyet a TeleportOptions:SetTeleportData() állít be, és a másik place-ben a player:GetJoinData() olvas ki, látható a kliens számára, és nincs titkosítva, ezért csak ártalmatlan választásokra használd, például hogy melyik pályát töltse be. Az érméket, a Wins értéket és a tárgyakat data store-ban tárold, ahogy a DataStore útmutatóban, és töltsd be őket újra, amikor a játékos megérkezik a másik place-be.
Saját betöltőképernyő
Amíg egy place-be irányuló teleport töltődik, a játékosok a Roblox alapértelmezett betöltőképernyőjét látják. Ha a sajátodat akarod mutatni, hívd meg a kliensen a TeleportService:SetTeleportGui() függvényt egy ScreenGui-val, például azzal, amelyik a ReplicatedStorage-ban van. Ebben az útmutatóban a teleportok a szerveren indulnak, ezért a kliensnek előre meg kell hívnia, például amint a játékos belépett. A Roblox szerint a képernyőt minden teleport előtt újra be kell állítani, és egy másik játék place-énél nem használódik. Ugyanott áll, hogy az ebben a ScreenGui-ban lévő scriptek nem futnak, ezért legyen statikus.
Körök teleportjai és checkpointok
A körrendszer minden kör elején ugyanilyen PivotTo hívással viszi át az összes játékost az arénára, az obby útmutató PivotTo vagy SpawnLocation része pedig ezt a megközelítést veti össze a Roblox megjelenési pontjaival. Ha egy pontnak csak egy kör után szabad megnyílnia, a körrendszer már osztja a Wins értéket, amelyet a WinsNeeded olvas.
Gyakori hibák és megoldásaik
Nyisd meg az Output ablakot (Window menü, aztán Output), mielőtt megnyomod a Play gombot. A Teleporters megnevezi a platformot, ha a Destination a semmibe mutat, így a legtöbb probléma ott látszik.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'
A TeleportMenu egy remote-ra vár, amelyet a Teleporters hoz létre, tehát a Teleporters nem működik. Ellenőrizd, hogy Script, nem LocalScript, közvetlenül a ServerScriptService-ben van, nincs letiltva, és nincs tőle piros hiba az Outputban. A script hibák útmutató részletesen elmagyarázza ezt a figyelmeztetést.
Teleporters: PadA points to PadC, which is not a part in TeleportPads
A platform Destination attribútuma olyasmit nevez meg, ami nem part közvetlenül a TeleportPads mappában. Ellenőrizd az írásmódot és a nagybetűket az attribútum értékében és a célplatform nevében. A figyelmeztetés platformonként egyszer jelenik meg, amikor egy játékos először hozzáér.
Rálépek a platformra, és semmi sem történik
Ellenőrizd, hogy a mappa neve pontosan TeleportPads, és a játék indulásakor közvetlenül a Workspace-ben van, hogy a platform Destination attribútuma String típusú (a Number típusú attribútumot figyelmen kívül hagyja), és hogy a legutóbbi teleportod óta eltelt 2 másodperc. Azt is ellenőrizd, hogy a platformon be van-e kapcsolva a CanTouch: a Roblox szerint a Touched bekötése egy kikapcsolt CanTouch tulajdonságú partra hibát ad, és ez leállítja a scriptet.
Egy falban jelenek meg, vagy leesek a szélén
A játékosok 3 studdal a célplatform elülső lapja előtt jelennek meg. Kattints jobb gombbal a platformra, válaszd a Show Orientation Indicator lehetőséget, és forgasd a platformot, amíg a kék vonal szabad padlóra nem mutat. A menü pontjai a part tetejére teszik a játékosokat, ezért minden pontot tarts a padlón.
A Castle gomb szürke marad, miután megszereztem a 3 Wins értéket
A lista a menü megnyitásakor rajzolódik ki, ezért zárd be a menüt, és nyisd meg újra. Ha a gomb még mindig szürke, ellenőrizd, hogy a leaderstatsban van egy pontosan Wins nevű IntValue, és hogy a Wins a szerveren változott meg, nem csak Client módban.
A portál semmit sem csinál a publikált játékban
Nyisd meg a Developer Console-t az F9 billentyűvel, kapcsold a naplót Server nézetre (csak a játék tulajdonosa és a szerkesztési joggal rendelkező csoporttagok látják, mert a Teleporters szerveroldali Script), és olvasd el a Teleporters: figyelmeztetéseket, ezekben ott az ok, amelyet a Roblox megnevezett. Ellenőrizd, hogy a portál PlaceId attribútuma Number típusú, és az Asset Managerből származó ID-t tartalmazza, és hogy a portál hozzáadása után újra publikáltad a place-t.
Elkészítés RoCode-dal
Ha nincs kedved mindezt kézzel összerakni, a RoCode megcsinálhatja a nálad nyitott place-ben. A RoCode egy független AI-ügynök a Roblox Studióhoz, nem a Robloxtól: a webes chatjében leírod a funkciót, a Studio pluginja pedig létrehozza a partokat és a scripteket az Explorerben, így nem kell a chatablakból kódot másolnod.
Adj hozzá teleportokat: platformokat a Workspace.TeleportPads alatt, amelyek a Destination attribútumukban megadott platformhoz küldik a játékosokat 2 másodperces cooldownnal, egy Teleport menüt a Workspace.TeleportSpots pontjaihoz, ahol a Castle-hoz 3 Wins kell szerveroldali ellenőrzéssel, és portálokat a Workspace.PlacePortals alatt, amelyek a PlaceId attribútumukban megadott ID-jú place-be küldik a játékosokat, újrapróbálkozásokkal.
- Ha egy lépésnek szüksége van rá, a Search Game és a Search Scripts segítségével átnézheti a place-edet, hogy a meglévő tárgyakra, remote-okra vagy mentési kódra építsen, ne adjon hozzá egy második rendszert
- A Create Instance segítségével létrehozza a mappákat és a platformok partjait, a Set Property segítségével beállítja a tulajdonságaikat, a Create Script segítségével pedig megírja a Teleporterst és a TeleportMenut
- Az a feladata, hogy minden megírt script fordítását ellenőrizze a Check Scripttel, amely a Studióban futtatás nélkül lefordítja
- A módosításokat csomagokban küldi, és minden csomag egy visszavonási pont a Studio előzményeiben
A place-ek közötti teleportok csak a publikált játékban működnek, ezért azokat magad ellenőrizd a Roblox alkalmazásban. 3.9-es vagy újabb pluginnal a RoCode el tud indítani egy rövid playtestet, és el tudja olvasni a hibákat, 3.9.15-ös vagy újabb pluginnal pedig a tesztkaraktere rá tud lépni a platformokra, és meg tudja nyomni a menü gombjait, de csak azt ellenőrzi, amit maga döntött el tesztelni, ezért a platformokra magad is lépj rá, és nyisd meg a menüt. A teleport egy rendszer a sok közül egy játékban; az egész játék elkészítése RoCode-dal ugyanígy halad, promptonként egy rendszerrel. Hogyan csatlakozik a RoCode a Studióhoz.
Gyakori kérdések
Hogyan készítsek teleport platformot a Roblox Studióban?
Adj két partnak Destination attribútumot egymás nevével, és egyetlen szerverscript helyezze át azt, aki hozzáért a platformhoz, a character:PivotTo segítségével közvetlenül a másik platform elé, rövid, játékosonkénti cooldownnal. Az 1. lépés és a 2. lépés pontosan ezt építi fel.
Miért nem működik a teleportom a Studióban?
A platformok és a menük működnek a Studióban. A másik place-be irányuló teleportok nem: a Roblox TeleportService nem támogatja a Studio playtestet, ezért publikáld a játékot, és a Roblox alkalmazásban tesztelj. Az útmutató scriptje teleport helyett kiírja, mit csinálna a portál, így azt azért ellenőrizheted, hogy elindul-e.
Hogyan teleportáljam a játékosokat a játékom egy másik place-ébe?
Adj hozzá egy place-t a File > Publish As (Add as a new place) segítségével, másold ki a place ID-ját az Asset Managerből, és hívd meg a TeleportService:TeleportAsync(placeId, { player }) függvényt egy szerveroldali Scriptből pcall-on belül, hiba esetén újrapróbálkozva. A 4. lépés végigvezet mindezen.
Hogyan készítsek teleport GUI-t?
Építsd fel a gombokat egy LocalScriptben, és csak a játékos által választott pont nevét küldd el a szervernek. A szerver kikeresi a nevet egy mappában, ellenőrzi a cooldownt és minden feloldási szabályt, aztán áthelyezi a karaktert. Soha ne küldj pozíciót a kliensről: egy csaló bármilyet küldhet.
Miért ragad be vagy esik szét a karakterem teleport után?
A gyökérpart Position értékének beállítása csak ezt a partot mozgatja, a hozzá kötött test nélkül, a platform CFrame-jének átmásolása pedig a karakter közepét a platformba teszi. Használd a character:PivotTo-t egy olyan ponttal, amely álló magasságban van a padló fölött, a Humanoid HipHeight értékéből számolva.
Átadhatok érméket vagy tárgyakat a teleporttal?
Biztonságosan nem. A Roblox szerint a teleport data látható a kliens számára, és nincs titkosítva, ezért olyasmire jó, mint a kiválasztott pálya, de érmékre nem. Az érméket és a tárgyakat data store-ba mentsd, és a másik place-ben töltsd be őket.
Források és további olvasnivaló
- Roblox Creator Docs: Teleport between places (angolul). TeleportAsync, Studio playtestek, Access Control for Places, teleport képernyők, teleport data és meghiúsult teleportok
- Roblox Creator Docs: TeleportService (angolul). az elavult Teleport, a csak szerveroldali TeleportAsync és a TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (angolul). a modellek scriptből való mozgatásának fő függvénye
- Roblox Creator Docs: BasePart.Position (angolul). miért mozdítja el egy kötött part Position értékének beállítása a többihez képest
- Roblox Creator Docs: Humanoid.HipHeight (angolul). milyen magasan van egy álló karakter gyökérpartja, R15 és R6 rigeknél
- Roblox Creator Docs: Seat (angolul). a SeatWeld, amely az ülő karaktert tartja, és a megsemmisítése a karakter felállításához
- Roblox Creator Docs: Player:RequestStreamAroundAsync (angolul). egy terület lekérése, mielőtt a karakter odamegy, annak garanciája nélkül, hogy mi érkezik meg
- Roblox Creator Docs: Streaming techniques and conversion (angolul). előzetes streaming teleport előtt
- Roblox Creator Docs: Access control and confidentiality (angolul). miért juthatnak be a kliensek a játék bármely place-ébe, ha a teleportok nincsenek védve
- Roblox Creator Docs: Network ownership, movement validation, and physics (angolul). mit tehet a kliens a saját karakterével, és kivételek a teleportokhoz a mozgásellenőrzésekben
- Roblox Creator Docs: Create and publish games and places (angolul). publikálás, ki nyithat meg egy új játékot, és place hozzáadása a Publish As segítségével
- Roblox Creator Docs: Asset Manager (angolul). hogyan másold ki a place ID-t
- Roblox Creator Docs: Developer Console (angolul). a napló Server nézete, és ki látja
- Roblox Creator Docs: Debounce patterns (angolul). miért fut le a Touched többször egy érintésre
Hogyan ellenőriztük a kódot: az oldalon minden script átmegy a Luau szigorú típusellenőrzésén a Roblox API definícióival (luau-lsp, 2026. november 20.). A típusellenőrzés kiszűri az elírt API-neveket és a rossz típusokat, de a játéklogikai hibákat nem, ezért publikálás előtt mindent tesztelj a Studióban.