Lyhyesti
Teleporttialustaa varten laita Script ServerScriptServiceen, joka kuuntelee alustan Touched-tapahtumaa, löytää pelaajan Players:GetPlayerFromCharacter-kutsulla ja siirtää koko hahmon character:PivotTo()-kutsulla kohtaan aivan kohdealustan eteen, selkä alustaa kohti, parin sekunnin pelaajakohtaisella cooldownilla, jottei kohdealusta lähetä häntä heti takaisin. Lähettääksesi pelaajat pelisi toiseen paikkaan kutsu TeleportService:TeleportAsync(placeId, { player }) palvelimen Scriptistä pcall-kutsun sisällä; tämä toimii vain julkaistussa pelissä, ei Studiossa.
- Siirrä koko hahmo
PivotTo-kutsulla.HumanoidRootPart.Position-arvon asettaminen siirtää juuripartin irti muusta kehosta, koska Positionia asetettaessa Roblox päivittää liitokset. - Teleporttivalikon pitää lähettää palvelimelle kohteen nimi, ei sijaintia. Palvelin tarkistaa nimen, cooldownin ja mahdollisen avaussäännön ennen kuin siirtää ketään.
TeleportService:Teleport()on vanhentunut ja toimii asiakkaalla. KäytäTeleportAsync-kutsua palvelimella, kääri sepcall-kutsuun, yritä uudelleen ja käsitteleTeleportInitFailed.
Tällä sivulla
Kaksi teleporttityyppiä
Teleportti Roblox-pelissä voi tarkoittaa kolmea asiaa: alustaa, joka siirtää sinut kartan poikki, valikkoa kohteista, joihin voi hypätä, tai portaalia toiseen tasoon. Kaksi ensimmäistä siirtävät hahmoa sen palvelimen sisällä, jolla pelaaja jo on. Kolmas lähettää pelaajan pelisi toiseen paikkaan, joka toimii omilla palvelimillaan. Ne käyttävät eri API:ita, joten on hyvä tietää, kumman tarvitset.
| Saman palvelimen sisällä | Pelisi toiseen paikkaan | |
|---|---|---|
| Kutsu | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| Mihin | Teleporttialustat, teleporttivalikot, pelaajien siirto aulasta areenalle | Portaalit toiseen tasoon, aula, joka lähettää pelaajat erilliseen luolasto- tai otteluun tarkoitettuun paikkaan |
| Missä toimii | Palvelimen Script | Vain palvelimen Script. Asiakkaan Teleport() on vanhentunut. |
| Toimii Studion pelitestissä | Kyllä | Ei. Robloxin TeleportService ei tue Studion pelitestiä, joten testaus tehdään julkaistussa pelissä. |
| Mitä pelaaja näkee | Hyppy kartan poikki, joka voi kestää enintään 2 sekuntia, jos alue täytyy ensin ladata | Robloxin latausnäytön, sitten toisen paikan |
| Kolikot, esineet ja muut tiedot | Pysyvät ennallaan | Roblox nollaa pelaajan paikalliset tiedot, joten kaiken tärkeän täytyy tulla tietovarastosta toisessa paikassa |
Tässä oppaassa kaikki kolme tyyppiä on koottu yhteen palvelimen Scriptiin, joten yksi sääntöjoukko kattaa pelisi jokaisen teleportin: palvelin päättää, jokaisella pelaajalla on oma cooldowninsa, ja pelaajan laite vain kertoo, mihin kohteeseen hän haluaisi.
| Osa | Missä se on | Mitä se tekee |
|---|---|---|
Folder TeleportPads, jossa PadA ja PadB | Workspace | Kaksi alustaa. Kummankin Destination-attribuutti nimeää alustan, jonka luo se lähettää pelaajat. |
Folder TeleportSpots | Workspace | Yksi part jokaista valikon listan kohdetta kohden. Attribuutti WinsNeeded lukitsee kohteen. |
Folder PlacePortals | Workspace | Portaalipartit. Kunkin portaalin PlaceId-attribuutti on paikka, johon se lähettää pelaajat. |
Script Teleporters | ServerScriptService | Hoitaa kaikki kolme teleporttityyppiä ja luo kaksi remotea. Ainoa paikka, jossa teleportti voi tapahtua. |
LocalScript TeleportMenu | StarterPlayer > StarterPlayerScripts | Piirtää Teleport-painikkeen ja kohdelistan ja lähettää pelaajan valitseman kohteen nimen. |
RemoteFunction GetTeleportSpots ja RemoteEvent TeleportRequest | ReplicatedStorage (Teleporters luo ne) | Ensimmäinen palauttaa valikolle kohdelistan. Toinen vie valitun nimen palvelimelle. |
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
Vaihe 1: rakenna kaksi teleporttialustaa
- Vie Explorerissa kursori Workspacen päälle, napsauta +-painiketta ja lisää Folder. Nimeä kansio
TeleportPads. Skripti etsii juuri tätä nimeä. - Lisää kansioon kaksi Partia ja nimeä ne
PadAjaPadB. Tee kummastakin litteä laatta, esimerkiksi 6 x 1 x 6 studia, ja aseta ne lattialle jonkin matkan päähän toisistaan. Rastita Properties-ikkunassa Anchored, jätä CanCollide ja CanTouch päälle ja anna kirkas väri ja materiaali Neon, jotta pelaajat huomaavat ne. - Valitse PadA, vieritä Properties-ikkuna Attributes-osioon ja napsauta +. Kirjoita nimeksi
Destination, valitse tyyppi String ja napsauta Save, ja aseta sitten arvoksiPadB. Tee sama PadB:lle arvollaPadA. - Käännä kumpikin alusta niin, että sen etupinta osoittaa vapaaseen lattiaan. Pelaajat ilmestyvät 3 studin päähän kohdealustan etupinnan eteen, selkä sitä kohti, joten jätä sinne muutama studi vapaata lattiaa. Nähdäksesi, mikä pinta on etupinta, napsauta alustaa hiiren oikealla ja valitse Show Orientation Indicator: sininen viiva merkitsee etupinnan. Käännä alustaa Rotate-työkalulla, kunnes viiva osoittaa sinne, minne pelaajien pitää lähteä.
Pelaajat päätyvät alustan viereen eivätkä sen päälle tarkoituksella. Robloxin debounce-sivulla todetaan, että Touched laukeaa monta kertaa peräkkäin yhdestä kosketuksesta, joten pelaaja, joka ilmestyisi suoraan toisen alustan päälle, laukaisisi sen uudelleen heti cooldowninsa päätyttyä ja lentäisi takaisin kartan poikki.
Et ole rajoitettu kahteen alustaan. Alustan Destination voi nimetä minkä tahansa TeleportPadsin partin, joten kolme alustaa voi lähettää pelaajia kehässä. Yksisuuntaista alustaa varten osoita se TeleportPadsin parttiin, jolla ei ole omaa Destination-attribuuttia: tällainen part ottaa pelaajia vastaan eikä lähetä ketään minnekään.
Vaihe 2: lisää teleporttiskripti
Vie kursori ServerScriptServicen päälle, lisää Script, nimeä se Teleporters ja liitä siihen alla oleva koodi. Nyt se hoitaa alustat ja seuraavien vaiheiden jälkeen myös valikon ja portaalit, joten lisäät sen vain kerran. Alun asetukset ovat rivejä, joita sinun kuuluukin muuttaa.
-- Script ServerScriptServicessä nimeltä Teleporters.
-- Jokainen teleportti ratkaistaan täällä, palvelimella:
-- 1. Alustat: Workspace.TeleportPadsin partin koskettaminen siirtää sinut partin luo, joka on nimetty
-- sen Destination-attribuutissa.
-- 2. Valikko: LocalScript TeleportMenu pyytää kohdetta Workspace.TeleportSpotsista
-- nimellä. Palvelin tarkistaa nimen, cooldownin ja Winsit, joita kohde vaatii.
-- 3. Portaalit: Workspace.PlacePortalsin partin koskettaminen lähettää sinut paikkaan
-- sen PlaceId-attribuutista (tämän pelin toinen paikka).
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 -- näin kauan alustat ohittavat pelaajan minkä tahansa teleportin jälkeen
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- studia kohdealustan edessä, jotta pelaajat päätyvät sen viereen
local PLACE_ATTEMPTS = 3
local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")
-- Tämä skripti luo itse molemmat remotet, joten älä lisää niitä käsin
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
-- Kuinka korkealla lattiasta seisovan hahmon juuripart on.
-- Kaava Robloxin Humanoid.HipHeight-ohjeesta (R6-rigeillä lisätään jalan korkeus).
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() -- asetetaan ennen odotusta, jotta toinen kosketus ei käynnistä toista teleporttia
-- Katsotaan sinne, minne kohteen etupinta osoittaa (suoraan, ilman kallistusta)
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
-- Seisotaan sen yläpinnalla: hahmon pivot on sen juuripart, joten nostetaan se seisomakorkeudelle.
-- Alusta taas asettaa pelaajat muutaman studin päähän eteensä, koska pelaaja, joka seisoo
-- alustalla, laukaisisi sen uudelleen seuraavalla askeleella.
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)
-- Kun instance streaming on päällä, ladataan ensin kohteen ympäristö (enintään 2 sekuntia)
pcall(function()
player:RequestStreamAroundAsync(target.Position, 2)
end)
if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
return -- poistui, syntyi uudelleen tai kuoli alueen latautuessa
end
-- Istuva hahmo on hitsattu istuimeen, ja sen siirtäminen veisi istuimen mukanaan.
-- SeatWeldin tuhoaminen vapauttaa ensin hahmon istuimesta.
local seat = humanoid.SeatPart
if seat then
local seatWeld = seat:FindFirstChild("SeatWeld")
if seatWeld then
seatWeld:Destroy()
end
end
character:PivotTo(target)
-- Perillä cooldown käynnistetään uudelleen: yllä oleva esilataus voi kestää enintään 2 sekuntia,
-- eikä alusta, jonka luo pelaaja päätyi, saa heti lähettää häntä takaisin
lastTeleport[player] = os.clock()
player:SetAttribute("MovementCheckSkip", true) -- nopeustarkistusskriptiä varten, jos sinulla on sellainen
end
-- 1. Alustat
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 -- varoitetaan kerran, ei jokaisella kosketuksella
warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
end
end)
end
end
end
-- 2. Valikko: kohteiden lista, sitten pyyntö nimellä
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 -- samat Wins: aakkosjärjestys, jotta järjestys ei koskaan muutu
end)
return list
end
teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
-- Asiakas lähettää vain nimen. Älä koskaan hyväksy asiakkaalta sijaintia tai CFramea.
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 -- lukittu tältä pelaajalta
end
teleportTo(player, spot, false)
end)
-- 3. Portaalit tämän pelin toiseen paikkaan
local function sendToPlace(player: Player, placeId: number)
if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
return -- jo matkalla tai kosketti teleporttia sekunti sitten
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 -- luovutetaan; uusi portaalin kosketus yrittää uudelleen
end
-- Teleportti voi epäonnistua myös alkamisen jälkeen. Pelaaja jää tänne ja voi yrittää uudelleen.
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 luo itse RemoteFunctionin GetTeleportSpots ja RemoteEventin TeleportRequest, joten ReplicatedStorageen ei tarvitse lisätä mitään käsin. Se kytkee TeleportPadsin alustat ja PlacePortalsin portaalit kerran, palvelimen käynnistyessä, joten pelin aikana lisätyt alustat ja portaalit eivät tee mitään. Jos jokin kansio puuttuu, kyseinen teleporttityyppi on yksinkertaisesti pois päältä.
| Osa | Mitä se tekee | Miksi |
|---|---|---|
playerFromHit | Löytää hahmomallin, johon koskettanut part kuuluu, ja kysyy Players:GetPlayerFromCharacter-kutsulta, kenen se on. | Alustoja koskettavat jalat, hatut ja irralliset partit. Kaikki, mikä ei ole osa pelaajan hahmoa, antaa nil ja ohitetaan. |
onCooldown | Vertaa os.clock()-arvoa pelaajan viimeisimmän teleportin aikaan. | Yksi cooldown pelaajaa kohden, joten alustan luona seisova pelaaja ei koskaan estä muita. Mikään ei odota eikä nuku. |
rootHeight | Laskee, kuinka korkealla lattiasta seisovan hahmon juuripart on: puolet juuripartin korkeudesta plus Humanoidin HipHeight, plus jalan pituus R6-rigeillä. | Tämä on kaava Robloxin Humanoid.HipHeight-ohjeesta. Hahmon pivot on sen juuripart, joten pivotin nostaminen tämän verran asettaa jalat pinnalle niin pienillä kuin suurillakin avatareilla ja R6:lla. |
Tarkistukset teleportTo-funktion alussa | Poistuu, jos pelaajalla ei ole elävää hahmoa, jolla on juuripart, ja kirjaa sitten heti ajan. | Alempana oleva streaming-pyyntö voi saada skriptin odottamaan. Kun aika kirjataan etukäteen, lukuisat Touched-tapahtumat tuolla hetkellä eivät käynnistä toista teleporttia. |
| Saapumiskohta | Kohteen yläpinta nostettuna rootHeight-arvon verran, katse sinne, minne sen etupinta osoittaa, ilman kallistusta. Alustalla kohtaa on lisäksi siirretty 3 studia sen etupinnasta. | Hahmo ilmestyy seisomaan eikä kohdepartin sisään. Alustan vieressä sen jalat alkavat alustan yläpinnan tasolta, joten se laskeutuu lattialle alustan paksuuden verran. CFrame.lookAlong rakentaa CFramen sijaintiin annetulla katsesuunnalla. |
RequestStreamAroundAsync | Pyytää Robloxia lähettämään ensin tälle pelaajalle saapumiskohdan ympäristön ja odottaa enintään 2 sekuntia. | Instance streaming on oletuksena päällä uusissa paikoissa, joten kartan kaukainen osa ei ehkä ole vielä latautunut pelaajan laitteelle. Roblox suosittelee tätä palvelinkutsua ennen hahmon siirtämistä kauas, vaikka ei takaa, mitä tarkalleen saapuu perille. |
| Toinen tarkistus | Jos pelaaja poistui tai hahmo syntyi uudelleen tai kuoli odotuksen aikana, mikään ei liiku. | Pelaaja on voinut tehdä resetin tai poistua pelistä alueen latautuessa. Robloxin oma esilatausesimerkki tarkistaa myös, että hahmo on yhä pelissä, ennen kuin sitä liikutetaan. |
SeatWeld-rivit | Jos hahmo istuu, tuhoaa Weldin, joka pitää sen istuimessa. | Roblox hitsaa istuvan hahmon istuimeen. PivotTo liikuttaa partteja muuttamalla niiden CFramea, ja Robloxin ohjeessa sanotaan, että partin CFramen asettaminen liikuttaa myös siihen liitettyjä partteja, joten ilman tätä istuin ja kaikki siihen hitsattu saapuisivat pelaajan mukana. SeatWeld-liitoksen tuhoaminen on tapa, jolla Robloxin Seat-ohje nostaa hahmon istuimelta skriptistä. |
character:PivotTo(target) | Siirtää koko hahmon, kaikki raajat ja asusteet yhdessä, saapumiskohtaan. | Roblox kutsuu PivotTota päätavaksi liikuttaa malleja skripteistä. |
Toinen lastTeleport-rivi | Käynnistää cooldownin uudelleen perillä. | Streaming-pyyntö voi kestää enintään 2 sekuntia, yhtä kauan kuin itse alustan cooldown, joten ilman tätä riviä pelaaja voisi saapua jo umpeutuneella cooldownilla. |
MovementCheckSkip | Asettaa Playerille attribuutin jokaisen siirron jälkeen. | Palvelimen nopeustarkistus pitäisi hyppyä huijauksena. Juoksuoppaan MovementCheck lukee tämän attribuutin ja aloittaa mittauksen alusta uudesta sijainnista. Ilman tällaista skriptiä attribuutti ei tee mitään. |
| Asetus | Arvo tässä | Mitä se muuttaa |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Kuinka kauan alustat ja portaalit ohittavat pelaajan minkä tahansa teleportin jälkeen. |
MENU_COOLDOWN_SECONDS | 3 | Lyhin väli kahden valikkoteleportin välillä samalle pelaajalle. Alustoilla ja valikolla on yhteinen pelaajakohtainen kello, joten valikkopyyntö 3 sekunnin sisällä alustateleportista ohitetaan myös. |
PAD_ARRIVAL_GAP | 3 | Kuinka monen studin päähän kohdealustan etupinnasta pelaajat ilmestyvät, jotta he päätyvät alustan viereen eivätkä sen päälle. |
PLACE_ATTEMPTS | 3 | Kuinka monta kertaa portaali yrittää TeleportAsync-kutsua 2 sekunnin välein ennen kuin luovuttaa. |
Paina Play heti ja astu PadA:lle: ilmestyt PadB:n eteen. Valikko ja portaalit tarvitsevat kaksi seuraavaa vaihetta, mutta skripti toimii jo ilman niitä.
Vaihe 4: teleportti toiseen paikkaan
Paikka on erillinen maailma pelisi sisällä, omine palvelimineen: aula ja luolasto tai keskus ja joukko tasoja. Pelaajat liikkuvat paikkojen välillä TeleportServicellä, ja Roblox ajaa sitä vain julkaistussa pelissä, joten tämä vaihe päättyy Roblox-sovellukseen eikä Studioon.
- Jos peliä ei ole vielä julkaistu, valitse File > Publish. Uudet pelit ovat ennen julkaisua auki vain sinulle, ihmisille, joille annoit Edit-oikeuden, ja ryhmän jäsenille, joilla on sopivat roolit, ja omaan teleporttien testaukseesi se riittää.
- Luo toinen paikka: avaa uusi paikka mistä tahansa Studion pohjasta, rakenna luolastosi, valitse sitten File > Publish As, napsauta pelisi ruutua, valitse Add as a new place ja napsauta Create.
- Kopioi uuden paikan ID. Avaa Asset Manager Window-valikosta tai Home-välilehdeltä, siirry kohtaan Places In Experience, napsauta paikkaa hiiren oikealla ja valitse Copy Asset ID, joka kopioi sen place ID:n.
- Palattuasi ensimmäiseen paikkaan lisää Workspaceen Folder nimeltä
PlacePortalsja sen sisään ankkuroitu Part nimeltäDungeonPortal. Lisää Number-tyyppinen attribuutti nimeltäPlaceIdja liitä ID sen arvoksi. - Paina Play ja kosketa portaalia. Output tulostaa rivin, joka alkaa
Teleporters: would send: Studiossa portaali ei tee muuta. - Julkaise peli uudelleen kohdasta File > Publish, jotta portaali ilmestyy julkaistuun peliin, ja testaa se Roblox-sovelluksesta kuten vaiheessa 5.
Teleporters kutsuu TeleportAsync-kutsua pcall-kutsun sisällä, enintään 3 kertaa 2 sekunnin tauoin yritysten välillä, koska Robloxin teleporttisivulla sanotaan, että teleportit voivat epäonnistua ja antaa virheen, ja suositellaan yrittämään uudelleen. Teleportti voi myös alkaa ja epäonnistua viime hetkellä ilman virhettä, jolloin pelaaja jää sinne, missä oli. Tätä tapausta varten Roblox kutsuu TeleportInitFailed-tapahtumaa, ja skripti poistaa pelaajalta "lähdössä"-merkinnän, joten uusi portaalin kosketus yrittää uudelleen.
Palauttaaksesi pelaajat tee sama toisessa paikassa: laita kopio Teleportersista sen ServerScriptServiceen ja lisää portaali, jonka PlaceId on ensimmäisen paikkasi ID, kopioituna Asset Managerista samalla tavalla.
Kuka pääsee muihin paikkoihisi
Robloxin tietoturvadokumentaatio varoittaa: heti kun asiakas on yhdessä pelisi paikassa, se voi teleportata mihin tahansa muuhun sen paikkaan, minkä reitin sitten suunnittelitkin, ja paikan Direct Accessin poistaminen käytöstä poistaa vain sivuston Join-painikkeen. Tätä muuttaa asetus Access Control for Places kohdassa Audience > Access Settings Creator Dashboardissa:
| Asetus | Kuka pääsee paikkaan, joka ei ole aloituspaikka |
|---|---|
| Fully open | Kuka tahansa, teleporteilla mistä tahansa pelistä, deep linkeillä, peli-kutsuilla ja liittymällä kaverin seuraan. |
| Limited to same universe | Vain pelaajat, jotka teleporttaavat peliesi sisältä. Teleportit ovat sallittuja sekä asiakkaalta että palvelimelta. |
| Secure within universe only | Vain pelaajat, jotka palvelimesi skriptit teleporttaavat tämän pelin sisältä. |
Jos pelaajien pitää päästä paikkaan vain portaalisi kautta, esimerkiksi luolastoon, valitse Secure within universe only. Tämän oppaan jokainen teleportti alkaa palvelimelta, joten se toimii edelleen. Roblox sanoo myös, että monet pelit eivät tarvitse suojattuja teleportteja, joten peli, jonka kaikki paikat ovat auki kaikille, voi jättää asetuksen ennalleen.
Missä vanhat teleporttitutoriaalit menevät pieleen
Jos vertaat tätä opasta videoon tai foorumiviestiin, tässä ovat tärkeät erot ja syy, miksi kukin keino aiheuttaa ongelman.
| Tutoriaali | Ongelma | Tämä opas |
|---|---|---|
Asettaa hit.Parent.HumanoidRootPart.Position = target.Position | Robloxin ohjeessa sanotaan, että Positionin asettaminen päivittää partin liitokset, ja se siirtyy suhteessa partteihin, joihin se on liitetty: juuripart lähtee ilman kehoa. | Siirtää koko hahmon PivotTo-kutsulla. |
Asettaa HumanoidRootPart.CFrame = target.CFrame | Hahmon keskikohta päätyy kohdepartin keskelle, osittain sen sisään, ja omaksuu partin kallistuksen. | Hahmo ilmestyy seisomakorkeudelle yläpinnan yläpuolelle, alustan viereen, ilman kallistusta. |
Käyttää yhtä debounce-muuttujaa koko alustalle | Kun yksi pelaaja teleporttaa, alusta ohittaa kaikki muut. Ja täysin ilman debouncea toisen alustan päälle ilmestynyt pelaaja lähetetään heti takaisin. | Yksi cooldown pelaajaa kohden, kirjattuna ennen mitään odotusta, ja pelaajat ilmestyvät alustan viereen. |
Kutsuu TeleportService:Teleport(placeId, player) LocalScriptistä | Roblox merkitsee Teleport()-funktion vanhentuneeksi, neuvoo olemaan käyttämättä sitä uusissa projekteissa ja sallii TeleportAsync-kutsun vain palvelimen skripteistä. | Kutsuu TeleportAsync-kutsua palvelimen skriptissä. |
Ei pcall-kutsua, ei uusintayrityksiä | Robloxin teleporttisivulla sanotaan, että ne voivat epäonnistua ja antaa virheen sekä epäonnistua vasta alkamisen jälkeen. | Enintään 3 yritystä pcall-kutsussa, ja TeleportInitFailed antaa pelaajan yrittää uudelleen. |
| Luovuttaa, koska Studiossa se "ei toimi" | TeleportService ei tue Studion pelitestiä. | RunService:IsStudio() tulostaa sen sijaan, mitä portaali tekisi. |
| Teleportti-GUI, jonka painikkeet lähettävät sijainnin | Huijari voi kutsua samaa remotea millä tahansa sijainnilla. | Painikkeet lähettävät kohteen nimen, ja palvelin etsii sen. |
| Kolikot välitetään teleport datassa | Roblox sanoo, että teleport data näkyy asiakkaalle eikä ole salattu. | Neuvoo säilyttämään kolikot ja Winsit tietovarastossa ja lataamaan ne toisessa paikassa (katso Miten tiedot siirretään toiseen paikkaan). |
Mitä pelaajat voivat ja eivät voi väärentää
Oleta, että huijari hallitsee kaikkea omalla laitteellaan: hän voi muokata TeleportMenua, kutsua kumpaakin remotea niin monta kertaa kuin haluaa millä tahansa argumenteilla ja liikuttaa hahmoaan. Tässä on, mitä se antaa hänelle tämän teleportin kanssa.
| Huijari yrittää | Tulos | Miksi |
|---|---|---|
| Lähettää sijainnin tai CFramen valikon remotella | Ohitetaan | TeleportRequest lukee yhden merkkijonon, enintään 50 merkin pituisen kohteen nimen. Kaikki muu hylätään. |
| Pyytää Castlea ilman 3 Winsiä | Hylätään | Palvelin lukee Winsit omasta leaderstats-kopiostaan. Harmaa painike on vain vihje. |
| Pyytää kohdetta, jota ei ole olemassa | Ohitetaan | Palvelin etsii nimeä TeleportSpotsista eikä tee mitään, jos sen nimistä partia ei ole. |
| Kutsua valikon remotea yhä uudelleen | Enintään yksi valikkoteleportti 3 sekunnin välein | Cooldown säilytetään palvelimella, pelaajakohtaisesti. |
| Laukaista alustan menemättä sen luo | Hän päätyy parialustan luo, jonne hän olisi voinut kävelläkin | Roblox luettelee teleporttaamisen mihin tahansa kohtaan ja Touched-tapahtumien manipuloinnin asioihin, joita asiakas voi tehdä hahmollaan. |
| Mennä suoraan pelisi toiseen paikkaan | Mahdollista, jos Access Control for Places ei ole Secure within universe only | Katso Kuka pääsee muihin paikkoihisi. |
| Siirtää hahmonsa minne tahansa, myös lukittuun kohteeseen | Mahdollista | Jokainen laite ohjaa oman hahmonsa liikettä. Lukittu kohde on mukavuus eikä kassakaappi, joten tarkista palvelimella ennen kuin annat siellä mitään arvokasta. |
Viimeinen rivi on minkä tahansa teleportin rehellinen raja. Kilpailulliseen peliin lisää palvelimen liiketarkistus, kuten juoksuoppaassa. Teleporters asettaa jo MovementCheckSkip-attribuutin, jota tuo tarkistus lukee, joten sen omia teleportteja ei merkitä rikkeiksi: Robloxin tietoturvadokumentaatiossa sanotaan, että peleissä, joissa on oikeutettuja teleportteja, liiketarkistuksiin tarvitaan juuri tällainen poikkeus.
Vaihe 5: testaa
- Paina Play. Astu PadA:lle: ilmestyt aivan PadB:n eteen, selkä sitä kohti. Käänny ja astu heti PadB:lle: mitään ei tapahdu, koska alustat ohittavat sinut 2 sekuntia saapumisen jälkeen. Astu pois, odota 2 sekuntia ja astu uudelleen PadB:lle: ilmestyt PadA:n eteen.
- Odota muutama sekunti ja napsauta sitten Teleport näytön vasemmassa reunassa. Listassa näkyvät Lake, Spawn ja harmaa "Castle (needs 3 wins)". Valitse Lake: ilmestyt sen päälle. Avaa valikko uudelleen ja valitse Castle: mitään ei tapahdu, ja Output on hiljaa.
- Anna itsellesi 3 Winsiä (tähän tarvitaan leaderstats-skripti, jossa on IntValue Wins, esimerkiksi tulostaulukko-oppaasta). Napsauta Client/Server-kytkintä vaihtaaksesi Serveriin, etsi Explorerista
Players, oma nimesi,leaderstats,Winsja aseta sen Value arvoon 3 Properties-ikkunassa. Vaihda takaisin Clientiin ja avaa valikko uudelleen: Castle on muuttunut violetiksi ja siirtää sinut sinne. - Kosketa DungeonPortalia. Output tulostaa rivin, joka alkaa
Teleporters: would send, nimesi ja place ID:n kanssa. Studiossa näin kuuluukin olla, ja rivi tulostetaan enintään kerran 2 sekunnissa, vaikka seisoisit portaalilla kuinka kauan. - Valitse Server & Clients testitilojen pudotusvalikosta, aseta 2 asiakasta ja paina Play. Molemmat pelaajat voivat käyttää alustoja yhtä aikaa, eikä toisen cooldown koskaan estä toista.
- Pysäytä testi, julkaise peli ja käynnistä se Roblox-sovelluksesta. Kosketa portaalia: Robloxin latausnäyttö ilmestyy, ja päädyt toiseen paikkaan. Jos jäit paikallesi, avaa Developer Console F9-näppäimellä, vaihda loki Server-näkymään, jonka näkevät vain pelin omistaja ja ryhmän jäsenet, joilla on muokkausoikeus, ja etsi
Teleporters:-varoitukset; niissä on syy, jonka Roblox ilmoitti.
Pidä Output-ikkuna auki Studion vaiheiden aikana (Window-valikko, sitten Output). Kun Teleporters toimii, se ei tulosta mitään paitsi vaiheen 4 portaalirivin, joten jokainen varoitus tai punainen virhe kannattaa lukea. Katso Yleiset virheet.
Miten laajentaa
Joukkueen tai partyn teleporttaaminen yhdessä
TeleportAsync ottaa listan pelaajia, joten yksi portaali voi lähettää kokonaisen ryhmän samaan paikkaan. Robloxin teleporttisivu ehdottaa lähtökohdaksi pelaajaa, joka kosketti portaalia: player.Team ja Team:GetPlayers() joukkueelle tai SocialService:GetPlayersByPartyId() ja player.PartyId partylle. Anna tämä lista { player }-listan sijaan ja aseta leavingForPlace-merkintä jokaiselle sen pelaajalle.
Ryhmän lähettäminen omalle palvelimelle
Oletuksena teleportatut pelaajat päätyvät toisen paikan julkiselle palvelimelle. Lähettääksesi ryhmän uudelle varatulle palvelimelle, esimerkiksi ottelua varten, luo TeleportOptions, aseta sen ShouldReserveServer arvoon true ja anna se kolmantena argumenttina: TeleportService:TeleportAsync(placeId, players, options). Roblox huomauttaa, että nimenomaan varattuihin palvelimiin liittyvissä virheissä uusintayritykset ovat erityisen hyödyllisiä, ja skripti tekee ne jo.
Miten tiedot siirretään toiseen paikkaan
Teleporttaaminen nollaa kaikki pelaajan paikalliset tiedot. Robloxin teleport data, joka asetetaan TeleportOptions:SetTeleportData()-kutsulla ja luetaan toisessa paikassa player:GetJoinData()-kutsulla, näkyy asiakkaalle eikä ole salattu, joten käytä sitä vain harmittomiin valintoihin, kuten siihen, mikä kartta ladataan. Säilytä kolikot, Winsit ja esineet tietovarastossa, kuten DataStore-tutoriaalissa, ja lataa ne uudelleen, kun pelaaja saapuu toiseen paikkaan.
Oma latausnäyttö
Kun teleportti paikkaan latautuu, pelaajat näkevät Robloxin vakiolatausnäytön. Näyttääksesi oman kutsu asiakkaalla TeleportService:SetTeleportGui() ScreenGuin kanssa, esimerkiksi ReplicatedStoragessa olevan. Tämän oppaan teleportit alkavat palvelimelta, joten asiakkaan täytyy kutsua sitä etukäteen, esimerkiksi heti kun pelaaja liittyy. Roblox sanoo, että näyttö täytyy asettaa uudelleen ennen jokaista teleporttia ja ettei sitä käytetä toisen pelin paikkaan. Samassa kohdassa todetaan, etteivät tämän ScreenGuin sisällä olevat skriptit käynnisty, joten tee siitä staattinen.
Kierrosten teleportit ja checkpointit
Kierrosjärjestelmä siirtää jokaisen kierroksen alussa kaikki pelaajat areenalle samanlaisella PivotTo-kutsulla, ja obby-oppaan osio PivotTo vai SpawnLocation vertaa tätä lähestymistapaa Robloxin syntymäpisteisiin. Jos kohteen pitää aueta vasta kierroksen jälkeen, kierrosjärjestelmä jakaa jo Winsit, joita WinsNeeded lukee.
Yleiset virheet ja ratkaisut
Avaa Output-ikkuna (Window-valikko, sitten Output) ennen kuin painat Play. Teleporters nimeää alustan, kun Destination osoittaa tyhjään, joten useimmat ongelmat näkyvät siellä.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'
TeleportMenu odottaa remotea, jonka Teleporters luo, eli Teleporters ei toimi. Tarkista, että se on Script eikä LocalScript, että se on suoraan ServerScriptServicessä, ei ole poistettu käytöstä ja ettei Outputissa ole siitä punaista virhettä. Skriptivirheopas selittää tämän varoituksen tarkemmin.
Teleporters: PadA points to PadC, which is not a part in TeleportPads
Alustan Destination-attribuutti nimeää jotain, mikä ei ole part suoraan TeleportPads-kansion sisällä. Tarkista kirjoitusasu ja isot kirjaimet attribuutin arvossa ja kohdealustan nimessä. Varoitus näkyy kerran alustaa kohden, kun pelaaja koskettaa sitä ensimmäisen kerran.
Astun alustalle, eikä mitään tapahdu
Tarkista, että kansion nimi on tarkalleen TeleportPads ja että se on suoraan Workspacessa pelin alkaessa, että alustan Destination-attribuutin tyyppi on String (Number-tyyppinen attribuutti ohitetaan) ja että viimeisestä teleportistasi on kulunut 2 sekuntia. Tarkista myös, että alustan CanTouch on päällä: Roblox sanoo, että Touchedin kytkeminen parttiin, jonka CanTouch on pois päältä, antaa virheen, ja se pysäyttää skriptin.
Ilmestyn seinän sisään tai putoan reunalta
Pelaajat ilmestyvät 3 studin päähän kohdealustan etupinnan eteen. Napsauta alustaa hiiren oikealla, valitse Show Orientation Indicator ja käännä alustaa, kunnes sininen viiva osoittaa vapaaseen lattiaan. Valikon kohteet asettavat pelaajat partin päälle, joten pidä jokainen kohde lattialla.
Castle-painike pysyy harmaana, vaikka ansaitsin 3 Winsiä
Lista piirretään valikon avautuessa, joten sulje valikko ja avaa se uudelleen. Jos painike on yhä harmaa, tarkista, että leaderstatsissa on IntValue, jonka nimi on tarkalleen Wins, ja että Winsit muuttuivat palvelimella eivätkä vain Client-tilassa.
Portaali ei tee mitään julkaistussa pelissä
Avaa Developer Console F9-näppäimellä, vaihda loki Server-näkymään (sen näkevät vain pelin omistaja ja ryhmän jäsenet, joilla on muokkausoikeus, koska Teleporters on palvelimen Script) ja lue Teleporters:-varoitukset; niissä on syy, jonka Roblox ilmoitti. Tarkista, että portaalin PlaceId-attribuutin tyyppi on Number ja että se sisältää Asset Managerin ID:n, ja että julkaisit paikan uudelleen portaalin lisäämisen jälkeen.
Tee se RoCodella
Jos et halua koota tätä kaikkea käsin, RoCode voi tehdä sen paikassa, joka sinulla on auki. RoCode on itsenäinen tekoälyagentti Roblox Studioon, ei Robloxin tekemä: kuvailet toiminnon sen verkkochatissa, ja sen Studio-lisäosa luo partit ja skriptit Exploreriisi, joten sinun ei tarvitse kopioida koodia chat-ikkunasta.
Lisää teleportit: Workspace.TeleportPadsin alustat, jotka lähettävät pelaajat Destination-attribuuttinsa alustan luo 2 sekunnin cooldownilla, Teleport-valikko Workspace.TeleportSpotsin kohteille, jossa Castle vaatii 3 Winsiä palvelimen tarkistuksella, ja Workspace.PlacePortalsin portaalit, jotka lähettävät pelaajat PlaceId-attribuuttinsa ID:n paikkaan uusintayrityksin.
- Voi käydä paikkasi läpi, kun vaihe sitä tarvitsee, Search Gamella ja Search Scriptsillä nojatakseen jo olemassa oleviin esineisiin, remoteihin tai tallennuskoodiin eikä lisätäkseen toista järjestelmää
- Luo alustojen kansiot ja partit Create Instancella, asettaa niiden ominaisuudet Set Propertyllä ja kirjoittaa Teleportersin ja TeleportMenun Create Scriptillä
- Sitä on ohjeistettu tarkistamaan jokaisen kirjoitetun skriptin kääntyminen Check Scriptillä, joka kääntää sen Studiossa ajamatta
- Lähettää muutokset erissä, ja jokainen erä on kumouspiste Studion historiassa
Paikkojen väliset teleportit toimivat vain julkaistussa pelissä, joten testaa ne itse Roblox-sovelluksessa. Lisäosalla 3.9 tai uudemmalla RoCode voi ajaa lyhyen pelitestin ja lukea virheet, ja lisäosalla 3.9.15 tai uudemmalla sen testihahmo voi astua alustoille ja painaa valikon painikkeita, mutta se tarkistaa vain sen, minkä se itse päätti testata, joten astu alustoille ja avaa valikko itse. Teleportti on yksi järjestelmä monien joukossa pelissä; kokonaisen pelin tekeminen RoCodella etenee samoin, yksi järjestelmä kehotetta kohden. Miten RoCode yhdistyy Studioon.
Usein kysytyt kysymykset
Miten teleporttialusta tehdään Roblox Studiossa?
Anna kahdelle partille Destination-attribuutti toistensa nimillä ja anna yhden palvelimen skriptin siirtää alustaa koskettanut character:PivotTo-kutsulla kohtaan aivan toisen alustan eteen lyhyellä pelaajakohtaisella cooldownilla. Vaihe 1 ja vaihe 2 rakentavat juuri tämän.
Miksi teleporttini ei toimi Studiossa?
Alustat ja valikot toimivat Studiossa. Teleportit toiseen paikkaan eivät: Robloxin TeleportService ei tue Studion pelitestiä, joten julkaise peli ja testaa Roblox-sovelluksessa. Tämän oppaan skripti tulostaa teleportin sijaan, mitä portaali tekisi, joten voit silti tarkistaa, että se laukeaa.
Miten pelaajat teleportataan pelini toiseen paikkaan?
Lisää paikka kohdasta File > Publish As (Add as a new place), kopioi sen place ID Asset Managerista ja kutsu TeleportService:TeleportAsync(placeId, { player }) palvelimen Scriptistä pcall-kutsun sisällä, yrittäen uudelleen epäonnistuessa. Vaihe 4 käy kaiken tämän läpi.
Miten teleportti-GUI tehdään?
Rakenna painikkeet LocalScriptissä ja lähetä palvelimelle vain pelaajan valitseman kohteen nimi. Palvelin etsii nimen kansiosta, tarkistaa cooldownin ja mahdollisen avaussäännön ja siirtää sitten hahmon. Älä koskaan lähetä sijaintia asiakkaalta: huijari voi lähettää minkä tahansa.
Miksi hahmoni jää jumiin tai hajoaa teleportin jälkeen?
Juuripartin Position-arvon asettaminen liikuttaa vain tätä parttia ilman siihen liitettyä kehoa, ja alustan CFramen kopioiminen asettaa hahmon keskikohdan alustan sisään. Käytä character:PivotTo-kutsua kohdalla, joka on seisomakorkeudella lattian yläpuolella ja lasketaan Humanoidin HipHeight-arvosta.
Voiko kolikoita tai esineitä välittää teleportin mukana?
Ei turvallisesti. Roblox sanoo, että teleport data näkyy asiakkaalle eikä ole salattu, joten se sopii esimerkiksi valittuun karttaan mutta ei kolikoihin. Tallenna kolikot ja esineet tietovarastoon ja lataa ne toisessa paikassa.
Lähteet ja lisälukemista
- Roblox Creator Docs: Teleport between places (englanniksi). TeleportAsync, Studion pelitestit, Access Control for Places, teleporttinäytöt, teleport data ja epäonnistuneet teleportit
- Roblox Creator Docs: TeleportService (englanniksi). vanhentunut Teleport, TeleportAsync vain palvelimella ja TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (englanniksi). päätapa liikuttaa malleja skripteistä
- Roblox Creator Docs: BasePart.Position (englanniksi). miksi liitetyn partin Positionin asettaminen siirtää sen suhteessa muihin
- Roblox Creator Docs: Humanoid.HipHeight (englanniksi). kuinka korkealla seisovan hahmon juuripart on, R15- ja R6-rigeille
- Roblox Creator Docs: Seat (englanniksi). SeatWeld, joka pitää istuvaa hahmoa, ja sen tuhoaminen hahmon nostamiseksi
- Roblox Creator Docs: Player:RequestStreamAroundAsync (englanniksi). alueen pyytäminen ennen kuin hahmo siirtyy sinne, ilman takuuta siitä, mitä saapuu
- Roblox Creator Docs: Streaming techniques and conversion (englanniksi). ennakoiva streaming ennen teleporttia
- Roblox Creator Docs: Access control and confidentiality (englanniksi). miksi asiakkaat pääsevät mihin tahansa pelin paikkaan, jos teleportteja ei ole suojattu
- Roblox Creator Docs: Network ownership, movement validation, and physics (englanniksi). mitä asiakas voi tehdä hahmollaan ja teleporttien poikkeukset liiketarkistuksissa
- Roblox Creator Docs: Create and publish games and places (englanniksi). julkaisu, kuka voi avata uuden pelin, ja paikan lisääminen Publish Asilla
- Roblox Creator Docs: Asset Manager (englanniksi). miten place ID kopioidaan
- Roblox Creator Docs: Developer Console (englanniksi). lokin Server-näkymä ja kuka sen näkee
- Roblox Creator Docs: Debounce patterns (englanniksi). miksi Touched laukeaa useita kertoja yhdestä kosketuksesta
Miten koodi tarkistettiin: jokainen tämän sivun skripti läpäisee Luaun tiukan tyyppitarkistuksen Roblox API:n määrittelyillä (luau-lsp, 20. marraskuuta 2026). Tyyppitarkistus löytää virheet API-nimissä ja väärät tyypit, mutta ei pelilogiikan virheitä, joten testaa kaikki Studiossa ennen julkaisua.