Tutoriaali · Pelijärjestelmät

Miten tehdä teleportti Roblox Studiossa

Teleportti Robloxissa on jompikumpi kahdesta: hahmon siirto toiseen kohtaan samalla palvelimella tai pelaajan lähettäminen pelisi toiseen paikkaan. Tässä oppaassa kokoamme molemmat yhdestä palvelimen skriptistä: alustat, jotka lähettävät sinut parialustan luo, Teleport-valikon, jossa lukitut kohteet aukeavat Winsien avulla, ja portaalit toiseen paikkaan, jotka yrittävät uudelleen, kun Robloxin teleportti epäonnistuu.

Päivitetty 20. marraskuuta 202617 min lukuaikaKirjoittaja:

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 se pcall-kutsuun, yritä uudelleen ja käsittele TeleportInitFailed.
Tällä sivulla
  1. Miten se toimii
  2. 1. Alustat
  3. 2. Teleporttiskripti
  4. 3. Teleporttivalikko
  5. 4. Muut paikat
  6. Vanhat tutoriaalit
  7. Suojauksen rajat
  8. 5. Testaus
  9. Laajennukset
  10. Common errors
  11. RoCodella
  12. Usein kysytyt kysymykset
  13. Lähteet ja lisälukemista

Kaksi teleporttityyppiä

HavainnollistusPadA:n koskettaminen asettaa sinut aivan PadB:n eteen, joten PadB ei lähetä sinua heti takaisin, ja palvelin kieltäytyy lukitusta Castle-kohteesta mutta siirtää sinut Lakeen.

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.

Kaksi teleporttityyppiä
Saman palvelimen sisälläPelisi toiseen paikkaan
Kutsucharacter:PivotTo(cframe)TeleportService:TeleportAsync(placeId, players)
MihinTeleporttialustat, teleporttivalikot, pelaajien siirto aulasta areenallePortaalit toiseen tasoon, aula, joka lähettää pelaajat erilliseen luolasto- tai otteluun tarkoitettuun paikkaan
Missä toimiiPalvelimen ScriptVain 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äkeeHyppy kartan poikki, joka voi kestää enintään 2 sekuntia, jos alue täytyy ensin ladataRobloxin latausnäytön, sitten toisen paikan
Kolikot, esineet ja muut tiedotPysyvät ennallaanRoblox 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.

Mistä teleportti koostuu
OsaMissä se onMitä se tekee
Folder TeleportPads, jossa PadA ja PadBWorkspaceKaksi alustaa. Kummankin Destination-attribuutti nimeää alustan, jonka luo se lähettää pelaajat.
Folder TeleportSpotsWorkspaceYksi part jokaista valikon listan kohdetta kohden. Attribuutti WinsNeeded lukitsee kohteen.
Folder PlacePortalsWorkspacePortaalipartit. Kunkin portaalin PlaceId-attribuutti on paikka, johon se lähettää pelaajat.
Script TeleportersServerScriptServiceHoitaa kaikki kolme teleporttityyppiä ja luo kaksi remotea. Ainoa paikka, jossa teleportti voi tapahtua.
LocalScript TeleportMenuStarterPlayer > StarterPlayerScriptsPiirtää Teleport-painikkeen ja kohdelistan ja lähettää pelaajan valitseman kohteen nimen.
RemoteFunction GetTeleportSpots ja RemoteEvent TeleportRequestReplicatedStorage (Teleporters luo ne)Ensimmäinen palauttaa valikolle kohdelistan. Toinen vie valitun nimen palvelimelle.
Explorer, kun teleportti on valmis. Teleporters lisää GetTeleportSpotsin ja TeleportRequestin ReplicatedStorageen, kun peli on käynnissä.
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

  1. Vie Explorerissa kursori Workspacen päälle, napsauta +-painiketta ja lisää Folder. Nimeä kansio TeleportPads. Skripti etsii juuri tätä nimeä.
  2. Lisää kansioon kaksi Partia ja nimeä ne PadA ja PadB. 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.
  3. Valitse PadA, vieritä Properties-ikkuna Attributes-osioon ja napsauta +. Kirjoita nimeksi Destination, valitse tyyppi String ja napsauta Save, ja aseta sitten arvoksi PadB. Tee sama PadB:lle arvolla PadA.
  4. 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 kohteessa ServerScriptService nimeltä Teleporters
-- 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ä.

Mitä Teleportersin kukin osa tekee
OsaMitä se tekeeMiksi
playerFromHitLö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.
onCooldownVertaa 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.
rootHeightLaskee, 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 alussaPoistuu, 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.
SaapumiskohtaKohteen 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.
RequestStreamAroundAsyncPyytää 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 tarkistusJos 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-rivitJos 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-riviKä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.
MovementCheckSkipAsettaa 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.
Asetukset Teleportersin alussa
AsetusArvo tässäMitä se muuttaa
PAD_COOLDOWN_SECONDS2Kuinka kauan alustat ja portaalit ohittavat pelaajan minkä tahansa teleportin jälkeen.
MENU_COOLDOWN_SECONDS3Lyhin 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_GAP3Kuinka monen studin päähän kohdealustan etupinnasta pelaajat ilmestyvät, jotta he päätyvät alustan viereen eivätkä sen päälle.
PLACE_ATTEMPTS3Kuinka 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.

  1. 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ää.
  2. 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.
  3. 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.
  4. Palattuasi ensimmäiseen paikkaan lisää Workspaceen Folder nimeltä PlacePortals ja sen sisään ankkuroitu Part nimeltä DungeonPortal. Lisää Number-tyyppinen attribuutti nimeltä PlaceId ja liitä ID sen arvoksi.
  5. Paina Play ja kosketa portaalia. Output tulostaa rivin, joka alkaa Teleporters: would send: Studiossa portaali ei tee muuta.
  6. 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:

Access Control for Placesin kolme arvoa
AsetusKuka pääsee paikkaan, joka ei ole aloituspaikka
Fully openKuka tahansa, teleporteilla mistä tahansa pelistä, deep linkeillä, peli-kutsuilla ja liittymällä kaverin seuraan.
Limited to same universeVain pelaajat, jotka teleporttaavat peliesi sisältä. Teleportit ovat sallittuja sekä asiakkaalta että palvelimelta.
Secure within universe onlyVain 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.

Teleporttitutoriaalien yleiset keinot ja mitä tämä opas tekee niiden sijaan
TutoriaaliOngelmaTämä opas
Asettaa hit.Parent.HumanoidRootPart.Position = target.PositionRobloxin 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.CFrameHahmon 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 alustalleKun 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 sijainninHuijari voi kutsua samaa remotea millä tahansa sijainnilla.Painikkeet lähettävät kohteen nimen, ja palvelin etsii sen.
Kolikot välitetään teleport datassaRoblox 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.

Mitä huijari voi yrittää ja mitä Teleporters tekee sille
Huijari yrittääTulosMiksi
Lähettää sijainnin tai CFramen valikon remotellaOhitetaanTeleportRequest lukee yhden merkkijonon, enintään 50 merkin pituisen kohteen nimen. Kaikki muu hylätään.
Pyytää Castlea ilman 3 WinsiäHylätäänPalvelin lukee Winsit omasta leaderstats-kopiostaan. Harmaa painike on vain vihje.
Pyytää kohdetta, jota ei ole olemassaOhitetaanPalvelin etsii nimeä TeleportSpotsista eikä tee mitään, jos sen nimistä partia ei ole.
Kutsua valikon remotea yhä uudelleenEnintään yksi valikkoteleportti 3 sekunnin väleinCooldown säilytetään palvelimella, pelaajakohtaisesti.
Laukaista alustan menemättä sen luoHän päätyy parialustan luo, jonne hän olisi voinut kävelläkinRoblox luettelee teleporttaamisen mihin tahansa kohtaan ja Touched-tapahtumien manipuloinnin asioihin, joita asiakas voi tehdä hahmollaan.
Mennä suoraan pelisi toiseen paikkaanMahdollista, jos Access Control for Places ei ole Secure within universe onlyKatso Kuka pääsee muihin paikkoihisi.
Siirtää hahmonsa minne tahansa, myös lukittuun kohteeseenMahdollistaJokainen 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

  1. 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.
  2. 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.
  3. 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, Wins ja aseta sen Value arvoon 3 Properties-ikkunassa. Vaihda takaisin Clientiin ja avaa valikko uudelleen: Castle on muuttunut violetiksi ja siirtää sinut sinne.
  4. 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.
  5. 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.
  6. 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.

Sinä kirjoitat

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.

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

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.

Kokeile RoCodea omassa pelissäsi.

Ilmaisia krediittejä joka päivä, ei korttia. Asenna lisäosa, kuvaile ominaisuus ja katso, mitä Studioon ilmestyi.