Sa madaling salita
Para sa teleport pad, maglagay ng Script sa ServerScriptService na nakikinig sa Touched event ng pad, hinahanap ang player gamit ang Players:GetPlayerFromCharacter, at inililipat ang buong character gamit ang character:PivotTo() sa puwesto mismo sa harap ng destination pad, nakatalikod dito, na may cooldown na ilang segundo bawat player para hindi siya agad ibalik ng destination pad. Para ipadala ang mga player sa ibang place ng game mo, tawagin ang TeleportService:TeleportAsync(placeId, { player }) mula sa server Script sa loob ng pcall; gumagana lang ito sa na-publish na game, hindi sa Studio.
- Ilipat ang buong character gamit ang
PivotTo. Ang pag-assign ngHumanoidRootPart.Positionay inilalayo ang root part sa iba pang bahagi ng katawan, dahil kapag sine-set ang Position, ina-update ng Roblox ang mga joint. - Dapat ang pangalan ng destination ang ipinapadala ng teleport menu sa server, hindi ang posisyon. Chine-check ng server ang pangalan, cooldown at anumang unlock rule bago maglipat ng kahit sino.
- Deprecated ang
TeleportService:Teleport()at tumatakbo sa client. Gamitin angTeleportAsyncsa server, balutin ito sapcall, umulit ng subok at i-handle angTeleportInitFailed.
Sa page na ito
Dalawang uri ng teleport
Ang teleport sa Roblox game ay puwedeng mangahulugan ng tatlong bagay: pad na naglilipat sa iyo sa kabilang dulo ng map, menu ng mga spot na puwedeng puntahan, o portal papunta sa ibang level. Ang unang dalawa ay naglilipat ng character sa loob ng server kung nasaan na ang player. Ang pangatlo ay nagpapadala sa player sa ibang place ng game mo, na tumatakbo sa sarili nitong mga server. Magkaibang API ang ginagamit nila, kaya makakatulong na malaman kung alin ang kailangan mo.
| Sa loob ng parehong server | Papunta sa ibang place ng game mo | |
|---|---|---|
| Tawag | character:PivotTo(cframe) | TeleportService:TeleportAsync(placeId, players) |
| Para saan | Teleport pads, teleport menus, paglipat ng mga player mula lobby papunta sa arena | Mga portal papunta sa ibang level, lobby na nagpapadala ng mga player sa hiwalay na place na may dungeon o match |
| Saan tumatakbo | Server Script | Server Script lang. Deprecated ang client na Teleport(). |
| Gumagana sa playtest ng Studio | Oo | Hindi. Hindi sinusuportahan ng TeleportService sa Roblox ang playtest sa Studio, kaya sa na-publish na game nagte-test. |
| Ano ang nakikita ng player | Talon sa kabilang dulo ng map, na puwedeng tumagal hanggang 2 segundo kung kailangan munang i-load ang area | Loading screen ng Roblox, saka ang ibang place |
| Coins, items at ibang data | Nananatili gaya ng dati | Nire-reset ng Roblox ang local data ng player, kaya lahat ng mahalaga ay dapat galing sa data store sa ibang place |
Sa guide na ito, ang tatlong uri ay nasa iisang server Script, kaya iisang set ng mga rule ang sumasaklaw sa bawat teleport sa game mo: server ang nagdedesisyon, may sariling cooldown ang bawat player, at ang device ng player ay nagsasabi lang kung saang spot niya gustong pumunta.
| Bahagi | Saan nakalagay | Ano ang ginagawa |
|---|---|---|
Folder na TeleportPads na may PadA at PadB | Workspace | Dalawang pad. Ang Destination attribute ng bawat isa ay nagsasabi kung saang pad nito ipinapadala ang mga player. |
Folder na TeleportSpots | Workspace | Isang part bawat spot sa listahan ng menu. Ang WinsNeeded attribute ay nagkakandado sa spot. |
Folder na PlacePortals | Workspace | Mga portal part. Ang PlaceId attribute ng bawat portal ay ang place kung saan nito ipinapadala ang mga player. |
Script na Teleporters | ServerScriptService | Hinahawakan ang tatlong uri ng teleport at gumagawa ng dalawang remote. Ang tanging lugar kung saan puwedeng mangyari ang teleport. |
LocalScript na TeleportMenu | StarterPlayer > StarterPlayerScripts | Ginuguhit ang Teleport button at ang listahan ng spots at ipinapadala ang pangalan ng spot na pinili ng player. |
RemoteFunction na GetTeleportSpots at RemoteEvent na TeleportRequest | ReplicatedStorage (ginagawa sila ng Teleporters) | Ibinabalik ng una sa menu ang listahan ng spots. Dinadala ng pangalawa ang napiling pangalan sa server. |
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
Hakbang 1: gumawa ng dalawang teleport pad
- Sa Explorer, i-hover ang Workspace, pindutin ang + at mag-insert ng Folder. Pangalanan ang folder na
TeleportPads. Eksaktong pangalang ito ang hinahanap ng script. - Mag-insert ng dalawang Part sa folder at pangalanan silang
PadAatPadB. Gawing patag na slab ang bawat isa, halimbawa 6 by 1 by 6 studs, at ilagay sila sa sahig nang may layo sa isa't isa. Sa Properties window, i-check ang Anchored, iwanang naka-on ang CanCollide at CanTouch, at mag-set ng matingkad na kulay at material na Neon para mapansin sila ng mga player. - I-select ang PadA, i-scroll ang Properties window hanggang sa section na Attributes at pindutin ang +. I-type ang pangalang
Destination, piliin ang type na String at pindutin ang Save, saka i-set ang value saPadB. Gawin din ito sa PadB na ang value ayPadA. - I-rotate ang bawat pad para nakaharap ang front face nito sa bakanteng sahig. Lumalabas ang mga player 3 studs sa harap ng front face ng destination pad, nakatalikod dito, kaya mag-iwan ng ilang stud na bakanteng sahig doon. Para makita kung aling face ang harap, i-right click ang pad at piliin ang Show Orientation Indicator: asul na linya ang nagmamarka sa front face. I-rotate ang pad gamit ang Rotate tool hanggang tumuro ang linyang iyon kung saan dapat maglakad palayo ang mga player.
Sinadya na lumalabas ang mga player sa tabi ng pad, hindi sa ibabaw nito. Sa page ng Roblox tungkol sa debounce, nakasaad na nagfa-fire ang Touched nang maraming beses nang sunod-sunod sa isang touch, kaya ang player na lumabas mismo sa ibabaw ng kabilang pad ay magti-trigger ulit dito pagkatapos ng cooldown niya, at lilipad pabalik sa kabilang dulo ng map.
Hindi ka limitado sa dalawang pad. Ang Destination ng pad ay puwedeng magpangalan ng kahit anong part sa TeleportPads, kaya puwedeng magpadala ng mga player nang paikot ang tatlong pad. Para sa one-way na pad, ituro ito sa part sa TeleportPads na walang sariling Destination: tumatanggap ng mga player ang ganitong part at walang ipinapadala kahit saan.
Hakbang 2: idagdag ang teleport script
I-hover ang ServerScriptService, mag-insert ng Script, pangalanan itong Teleporters at i-paste ang code sa ibaba. Sa ngayon, ang mga pad ang hinahawakan nito, at pagkatapos ng mga susunod na hakbang, pati ang menu at mga portal, kaya isang beses mo lang itong idadagdag. Ang mga setting sa simula ay ang mga linyang dapat mong baguhin.
-- Script sa ServerScriptService na pinangalanang Teleporters.
-- Bawat teleport ay dito dinedesisyunan, sa server:
-- 1. Mga pad: ang paghawak sa part sa Workspace.TeleportPads ay naglilipat sa iyo sa part na nakapangalan
-- sa Destination attribute nito.
-- 2. Menu: humihingi ang LocalScript na TeleportMenu ng spot mula sa Workspace.TeleportSpots
-- ayon sa pangalan. Chine-check ng server ang pangalan, cooldown at Wins na kailangan para sa spot.
-- 3. Mga portal: ang paghawak sa part sa Workspace.PlacePortals ay nagpapadala sa iyo sa place
-- mula sa PlaceId attribute nito (ibang place ng game na ito).
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 -- ganito katagal hindi pinapansin ng mga pad ang player pagkatapos ng anumang teleport
local MENU_COOLDOWN_SECONDS = 3
local PAD_ARRIVAL_GAP = 3 -- studs sa harap ng destination pad, para sa tabi nito lumabas ang mga player
local PLACE_ATTEMPTS = 3
local padFolder = workspace:FindFirstChild("TeleportPads")
local spotFolder = workspace:FindFirstChild("TeleportSpots")
local portalFolder = workspace:FindFirstChild("PlacePortals")
-- Ang script na ito mismo ang gumagawa ng dalawang remote, kaya huwag silang idagdag nang mano-mano
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
-- Gaano kataas sa sahig ang root part ng nakatayong character.
-- Formula mula sa reference ng Roblox tungkol sa Humanoid.HipHeight (sa R6 rigs, idinadagdag ang taas ng binti).
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() -- sine-set bago maghintay, para hindi mag-start ng pangalawang teleport ang pangalawang touch
-- Humarap kung saan nakatutok ang front face ng destination (pantay, walang tilt)
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
-- Tumayo sa top face nito: ang pivot ng character ay ang root part nito, kaya itinataas ito sa taas ng nakatayo.
-- Ang pad naman ay naglalagay ng mga player ilang stud sa harap nito, dahil ang player na nakatayo
-- sa pad ay magti-trigger ulit dito sa susunod na hakbang.
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)
-- Kapag naka-on ang instance streaming, i-load muna ang area sa paligid ng destination (hanggang 2 segundo)
pcall(function()
player:RequestStreamAroundAsync(target.Position, 2)
end)
if player.Parent == nil or player.Character ~= character or humanoid.Health <= 0 then
return -- umalis, nag-respawn o namatay habang naglo-load ang area
end
-- Nakaweld sa upuan ang nakaupong character, at ang paglipat dito ay hihilahin ang upuan kasama nito.
-- Ang pag-destroy sa SeatWeld ay unang pinapalaya ang character mula sa upuan.
local seat = humanoid.SeatPart
if seat then
local seatWeld = seat:FindFirstChild("SeatWeld")
if seatWeld then
seatWeld:Destroy()
end
end
character:PivotTo(target)
-- Pagdating, i-restart ang cooldown: puwedeng tumagal hanggang 2 segundo ang preload sa itaas,
-- at hindi dapat agad ibalik ng pad na kinalalagyan ng player ang player
lastTeleport[player] = os.clock()
player:SetAttribute("MovementCheckSkip", true) -- para sa speed check script, kung mayroon ka
end
-- 1. Mga pad
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 -- isang beses lang magbabala, hindi sa bawat touch
warn(`Teleporters: {pad.Name} points to {destinationName}, which is not a part in TeleportPads`)
end
end)
end
end
end
-- 2. Menu: listahan ng spots, saka request ayon sa pangalan
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 -- parehong Wins: ayon sa alpabeto, para hindi kailanman magbago ang ayos
end)
return list
end
teleportRequest.OnServerEvent:Connect(function(player: Player, spotName: unknown)
-- Pangalan lang ang ipinapadala ng client. Huwag kailanman tumanggap ng posisyon o CFrame mula sa client.
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 -- nakakandado para sa player na ito
end
teleportTo(player, spot, false)
end)
-- 3. Mga portal papunta sa ibang place ng game na ito
local function sendToPlace(player: Player, placeId: number)
if leavingForPlace[player] or onCooldown(player, PAD_COOLDOWN_SECONDS) then
return -- papunta na o humawak sa teleport isang segundo pa lang ang nakalipas
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 -- sumusuko; susubok ulit ang bagong touch sa portal
end
-- Puwede ring pumalya ang teleport pagkatapos magsimula. Nananatili dito ang player at puwedeng sumubok ulit.
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)
Ang Teleporters mismo ang gumagawa ng RemoteFunction na GetTeleportSpots at RemoteEvent na TeleportRequest, kaya hindi mo kailangang mag-insert ng kahit ano sa ReplicatedStorage nang mano-mano. Ikinokonekta nito ang mga pad mula sa TeleportPads at mga portal mula sa PlacePortals nang isang beses, pagsimula ng server, kaya walang ginagawa ang mga pad at portal na idinagdag habang naglalaro. Kung wala ang isang folder, naka-off lang ang uri ng teleport na iyon.
| Bahagi | Ano ang ginagawa | Bakit |
|---|---|---|
playerFromHit | Hinahanap ang character model na kinabibilangan ng part na humawak, at tinatanong sa Players:GetPlayerFromCharacter kung kanino ito. | Nahahawakan ang mga pad ng mga binti, sombrero at maluwag na parts. Lahat ng hindi bahagi ng character ng player ay nagbibigay ng nil at hindi pinapansin. |
onCooldown | Ikinukumpara ang os.clock() sa oras ng huling teleport ng player. | Isang cooldown bawat player, kaya ang player na nakatayo sa tabi ng pad ay hindi kailanman humaharang sa iba. Walang naghihintay o natutulog. |
rootHeight | Kinakalkula kung gaano kataas sa sahig ang root part ng nakatayong character: kalahati ng taas ng root part kasama ang HipHeight ng Humanoid, kasama ang haba ng binti sa R6 rigs. | Ito ang formula mula sa reference ng Roblox tungkol sa Humanoid.HipHeight. Ang pivot ng character ay ang root part nito, kaya ang pagtaas ng pivot nang ganito ay naglalagay sa mga paa sa surface, sa maliliit at malalaking avatar, at sa R6. |
Mga check sa simula ng teleportTo | Lumalabas kung walang buhay na character na may root part ang player, saka agad isinusulat ang oras. | Ang streaming request sa ibaba ay puwedeng magpahintay sa script. Kung isusulat nang maaga ang oras, hindi magsisimula ng pangalawang teleport ang maraming Touched event sa sandaling iyon. |
| Arrival point | Ang top face ng destination, itinaas nang rootHeight, nakaharap kung saan nakatutok ang front face nito, walang tilt. Para sa pad, inuusog pa ang punto nang 3 studs mula sa front face nito. | Lumalabas ang character na nakatayo, hindi sa loob ng destination part. Sa tabi ng pad, nagsisimula ang mga paa niya sa taas ng top face nito, kaya bumababa siya sa sahig nang kapal ng pad. Gumagawa ang CFrame.lookAlong ng CFrame sa posisyon na may ibinigay na direksyon ng tingin. |
RequestStreamAroundAsync | Hinihiling sa Roblox na ipadala muna sa player na ito ang area sa paligid ng arrival point at naghihintay nang hindi hihigit sa 2 segundo. | Naka-on by default ang instance streaming sa mga bagong place, kaya ang malayong bahagi ng map ay puwedeng hindi pa naka-load sa device ng player. Inirerekomenda ng Roblox ang server call na ito bago ilipat nang malayo ang character, kahit hindi nito ginagarantiya kung ano mismo ang darating. |
| Pangalawang check | Kung umalis ang player, o nag-respawn o namatay ang character habang naghihintay, walang gumagalaw. | Puwedeng nag-reset o umalis sa game ang player habang naglo-load ang area. Ang sariling preload example ng Roblox ay chine-check din na nasa game pa ang character bago ito galawin. |
Mga linya na may SeatWeld | Kung nakaupo ang character, dine-destroy ang Weld na humahawak sa kanya sa upuan. | Ini-weld ng Roblox ang nakaupong character sa upuan. Ginagalaw ng PivotTo ang mga part sa pagbabago ng CFrame nila, at sabi sa reference ng Roblox, ang pag-set ng CFrame ng part ay ginagalaw din ang mga part na nakakabit dito, kaya kung wala ito, darating ang upuan at lahat ng naka-weld dito kasama ng player. Ang pag-destroy sa SeatWeld ang paraan ng reference ng Roblox tungkol sa Seat para paalisin ang character sa upuan mula sa script. |
character:PivotTo(target) | Inililipat ang buong character, lahat ng limbs at accessories nang sabay, sa arrival point. | Tinatawag ng Roblox ang PivotTo na pangunahing function para sa paglipat ng models mula sa scripts. |
Pangalawang linya na may lastTeleport | Nire-restart ang cooldown pagdating. | Puwedeng tumagal hanggang 2 segundo ang streaming request, kasintagal ng mismong cooldown ng pad, kaya kung wala ang linyang ito, puwedeng dumating ang player na tapos na ang cooldown. |
MovementCheckSkip | Nagse-set ng attribute sa Player pagkatapos ng bawat paglipat. | Ituturing ng server speed check na cheat ang talon. Binabasa ng MovementCheck mula sa guide sa sprint ang attribute na ito at nagsisimulang magsukat ulit mula sa bagong posisyon. Kung wala ang ganoong script, walang ginagawa ang attribute. |
| Setting | Value dito | Ano ang binabago |
|---|---|---|
PAD_COOLDOWN_SECONDS | 2 | Gaano katagal hindi pinapansin ng mga pad at portal ang player pagkatapos ng anumang teleport. |
MENU_COOLDOWN_SECONDS | 3 | Pinakamaikling pagitan ng dalawang teleport sa menu para sa isang player. Iisang orasan bawat player ang gamit ng mga pad at menu, kaya hindi rin pinapansin ang menu request sa loob ng 3 segundo pagkatapos ng teleport sa pad. |
PAD_ARRIVAL_GAP | 3 | Ilang stud mula sa front face ng destination pad lumalabas ang mga player, para sa tabi ng pad sila mapunta, hindi sa ibabaw nito. |
PLACE_ATTEMPTS | 3 | Ilang beses sinusubukan ng portal ang TeleportAsync na may pagitan na 2 segundo bago sumuko. |
Pindutin ang Play ngayon at tumapak sa PadA: lalabas ka sa harap ng PadB. Kailangan ng menu at mga portal ang susunod na dalawang hakbang, pero gumagana na ang script kahit wala sila.
Hakbang 4: teleport papunta sa ibang place
Ang place ay hiwalay na mundo sa loob ng game mo, na may sariling mga server: lobby at dungeon, o hub at set ng mga level. Lumilipat ang mga player sa pagitan ng mga place gamit ang TeleportService, at pinapatakbo lang ito ng Roblox sa na-publish na game, kaya nagtatapos ang hakbang na ito sa Roblox app, hindi sa Studio.
- Kung hindi pa na-publish ang game, piliin ang File > Publish. Ang mga bagong game, hangga't hindi mo nire-release, ay bukas lang sa iyo, sa mga taong binigyan mo ng Edit access at sa mga miyembro ng group na may tamang roles, at sapat iyon para sa sarili mong test ng teleports.
- Gumawa ng pangalawang place: magbukas ng bagong place mula sa kahit anong template ng Studio, buuin ang dungeon mo, saka piliin ang File > Publish As, i-click ang tile ng game mo, piliin ang Add as a new place at pindutin ang Create.
- Kopyahin ang ID ng bagong place. Buksan ang Asset Manager mula sa menu na Window o sa tab na Home, pumunta sa Places In Experience, i-right click ang place at piliin ang Copy Asset ID, na kinokopya ang place ID nito.
- Pagbalik sa unang place, mag-insert sa Workspace ng Folder na pinangalanang
PlacePortals, at sa loob nito, naka-anchor na Part na pinangalanangDungeonPortal. Magdagdag ng attribute na type Number na pinangalanangPlaceIdat i-paste ang ID bilang value nito. - Pindutin ang Play at hawakan ang portal. Magpi-print ang Output ng linyang nagsisimula sa
Teleporters: would send: sa Studio, wala nang ibang ginagawa ang portal. - I-publish ulit ang game gamit ang File > Publish para lumabas ang portal sa na-publish na game, at i-test ito mula sa Roblox app, gaya sa hakbang 5.
Tinatawag ng Teleporters ang TeleportAsync sa loob ng pcall, hanggang 3 beses na may 2 segundong hinto sa pagitan ng mga subok, dahil sinasabi sa page ng Roblox tungkol sa teleports na puwedeng pumalya at mag-error ang teleports, at inirerekomendang umulit. Puwede ring magsimula ang teleport at pumalya sa huling sandali nang walang error, na iiwan ang player kung nasaan siya. Para sa kasong ito, tinatawag ng Roblox ang TeleportInitFailed, at tinatanggal ng script ang flag na "aalis" sa player, kaya susubok ulit ang bagong touch sa portal.
Para maibalik ang mga player, gawin din ito sa kabilang place: maglagay ng kopya ng Teleporters sa ServerScriptService nito at magdagdag ng portal na ang PlaceId ay ang ID ng una mong place, na kinopya mula sa Asset Manager sa parehong paraan.
Sino ang puwedeng pumasok sa ibang places mo
Nagbababala ang security documentation ng Roblox: kapag nasa isang place na ng game mo ang client, kaya nitong mag-teleport sa kahit anong ibang place nito, anuman ang rutang plinano mo, at ang pag-off ng Direct Access sa isang place ay tinatanggal lang ang Join button sa website. Binabago ito ng setting na Access Control for Places sa section na Audience > Access Settings sa Creator Dashboard:
| Setting | Sino ang puwedeng pumasok sa place na hindi starting place |
|---|---|
| Fully open | Kahit sino, gamit ang teleports mula sa kahit anong game, deep links, game invites at pagsali sa kaibigan. |
| Limited to same universe | Mga player lang na nagte-teleport mula sa loob ng mga game mo. Pinapayagan ang teleports mula sa client at sa server. |
| Secure within universe only | Mga player lang na tine-teleport ng server scripts mo mula sa loob ng game na ito. |
Kung dapat sa portal mo lang makapasok ang mga player sa isang place, halimbawa sa dungeon, piliin ang Secure within universe only. Nagsisimula sa server ang bawat teleport sa guide na ito, kaya patuloy itong gagana. Sabi rin ng Roblox, maraming game ang hindi nangangailangan ng secure teleports, kaya ang game na bukas sa lahat ang lahat ng place ay puwedeng iwanan ang setting gaya ng dati.
Saan nagkakamali ang mga lumang teleport tutorial
Kung ikinukumpara mo ang guide na ito sa isang video o forum post, narito ang mahahalagang pagkakaiba at ang dahilan kung bakit nagdudulot ng problema ang bawat technique.
| Tutorial | Problema | Ang guide na ito |
|---|---|---|
Sine-set ang hit.Parent.HumanoidRootPart.Position = target.Position | Sabi sa reference ng Roblox, ang pag-set ng Position ay nag-a-update sa mga joint ng part, at nauusog ito kumpara sa mga part na nakakabit dito: umaalis ang root part nang walang katawan. | Inililipat ang buong character gamit ang PivotTo. |
Sine-set ang HumanoidRootPart.CFrame = target.CFrame | Napupunta ang gitna ng character sa gitna ng target part, bahagyang nasa loob nito, at kinukuha ang tilt ng part. | Lumalabas ang character sa taas ng nakatayo sa ibabaw ng top face, sa tabi ng pad, walang tilt. |
Gumagamit ng iisang debounce variable para sa buong pad | Habang nagte-teleport ang isang player, hindi pinapansin ng pad ang lahat ng iba. At kung walang debounce, ang player na lumabas sa kabilang pad ay agad ibinabalik. | Isang cooldown bawat player, na isinusulat bago ang anumang paghihintay, at lumalabas ang mga player sa tabi ng pad. |
Tinatawag ang TeleportService:Teleport(placeId, player) mula sa LocalScript | Minamarkahan ng Roblox ang Teleport() bilang deprecated, pinapayong huwag itong gamitin sa mga bagong project, at pinapayagan lang ang TeleportAsync mula sa server scripts. | Tinatawag ang TeleportAsync sa server script. |
Walang pcall, walang retry | Sinasabi sa page ng Roblox tungkol sa teleports na puwede silang pumalya at mag-error, at pumalya rin pagkatapos nang magsimula. | Hanggang 3 subok sa pcall, at pinapayagan ng TeleportInitFailed ang player na sumubok ulit. |
| Sumusuko dahil "hindi gumagana" sa Studio | Hindi sinusuportahan ng TeleportService ang playtest sa Studio. | Ang RunService:IsStudio() ay nagpi-print na lang kung ano ang gagawin ng portal. |
| Teleport GUI na posisyon ang ipinapadala ng mga button | Kayang tawagin ng exploiter ang parehong remote gamit ang kahit anong posisyon. | Pangalan ng spot ang ipinapadala ng mga button, at hinahanap ito ng server. |
| Ipinapasa ang coins sa teleport data | Sabi ng Roblox, nakikita ng client ang teleport data at hindi ito naka-encrypt. | Pinapayong itago ang coins at Wins sa data store at i-load sila sa kabilang place (tingnan ang Paano dalhin ang data sa ibang place). |
Ano ang kaya at hindi kayang i-fake ng mga player
Ipagpalagay na kontrolado ng exploiter ang lahat sa device niya: kaya niyang i-edit ang TeleportMenu, tawagin ang dalawang remote kahit ilang beses gamit ang kahit anong argument, at galawin ang sarili niyang character. Narito kung ano ang nakukuha niya dito sa teleport na ito.
| Sinusubukan ng exploiter | Resulta | Bakit |
|---|---|---|
| Magpadala ng posisyon o CFrame sa remote ng menu | Hindi pinapansin | Isang string lang ang binabasa ng TeleportRequest, ang pangalan ng spot na hanggang 50 character. Itinatapon ang lahat ng iba. |
| Humingi ng Castle nang walang 3 Wins | Tinatanggihan | Binabasa ng server ang Wins mula sa sarili nitong kopya ng leaderstats. Hint lang ang gray na button. |
| Humingi ng spot na hindi umiiral | Hindi pinapansin | Hinahanap ng server ang pangalan sa TeleportSpots at walang ginagawa kung walang part na may ganitong pangalan. |
| Tawagin nang paulit-ulit ang remote ng menu | Hindi hihigit sa isang menu teleport bawat 3 segundo | Nasa server ang cooldown, para sa bawat player. |
| I-trigger ang pad nang hindi lumalapit dito | Napupunta siya sa kapares na pad, na kaya naman niyang lakarin | Kasama sa inililista ng Roblox na kayang gawin ng client sa sarili niyang character ang pag-teleport kahit saan at ang pagmanipula sa Touched events. |
| Direktang pumasok sa ibang place ng game mo | Posible, kung hindi Secure within universe only ang Access Control for Places | Tingnan ang Sino ang puwedeng pumasok sa ibang places mo. |
| Ilipat ang sarili niyang character kahit saan, kasama ang nakakandadong spot | Posible | Kontrolado ng bawat device ang galaw ng sarili niyang character. Kaginhawaan ang nakakandadong spot, hindi vault, kaya mag-check sa server bago magbigay ng kahit anong mahalaga doon. |
Ang huling row ang tapat na limit ng anumang teleport. Para sa competitive na game, magdagdag ng server movement check, gaya sa guide sa sprint. Sine-set na ng Teleporters ang attribute na MovementCheckSkip na binabasa ng check na iyon, kaya hindi minamarkahang violation ang sarili nitong teleports: sinasabi sa security documentation ng Roblox na kailangan ng mga game na may lehitimong teleports ang ganitong exception sa movement checks.
Hakbang 5: i-test ito
- Pindutin ang Play. Tumapak sa PadA: lalabas ka mismo sa harap ng PadB, nakatalikod dito. Umikot at agad tumapak sa PadB: walang mangyayari, dahil hindi ka pinapansin ng mga pad nang 2 segundo pagdating. Bumaba, maghintay ng 2 segundo at tumapak ulit sa PadB: lalabas ka sa harap ng PadA.
- Maghintay ng ilang segundo, saka pindutin ang Teleport sa kaliwang bahagi ng screen. Makikita sa listahan ang Lake, Spawn at gray na "Castle (needs 3 wins)". Piliin ang Lake: lalabas ka doon. Buksan ulit ang menu at piliin ang Castle: walang mangyayari, at tahimik ang Output.
- Bigyan ang sarili mo ng 3 Wins (kailangan dito ng leaderstats script na may Wins IntValue, halimbawa mula sa guide sa leaderboard). Pindutin ang toggle na Client/Server para lumipat sa Server, hanapin sa Explorer ang
Players, ang pangalan mo,leaderstats,Wins, at i-set ang Value nito sa 3 sa Properties window. Bumalik sa Client at buksan ulit ang menu: purple na ang Castle at dinadala ka doon. - Hawakan ang DungeonPortal. Magpi-print ang Output ng linyang nagsisimula sa
Teleporters: would send, kasama ang pangalan mo at ang place ID. Ganito talaga dapat sa Studio, at hindi ito napi-print nang higit sa isang beses bawat 2 segundo, gaano ka man katagal nakatayo sa portal. - Piliin ang Server & Clients sa dropdown ng test modes, mag-set ng 2 client at pindutin ang Play. Kayang gamitin ng dalawang player ang mga pad nang sabay, at hindi kailanman hinaharangan ng cooldown ng isa ang isa pa.
- Ihinto ang test, i-publish ang game at patakbuhin ito mula sa Roblox app. Hawakan ang portal: lalabas ang loading screen ng Roblox, at mapupunta ka sa kabilang place. Kung nanatili ka sa puwesto, buksan ang Developer Console gamit ang F9, ilipat ang log sa view na Server, na nakikita lang ng may-ari ng game at ng mga miyembro ng group na may edit permission, at hanapin ang mga babala na
Teleporters:, nakasulat doon ang dahilan na sinabi ng Roblox.
Habang ginagawa ang mga hakbang sa Studio, panatilihing bukas ang Output window (menu na Window, saka Output). Kapag gumagana ang Teleporters, wala itong pini-print maliban sa linya ng portal mula sa hakbang 4, kaya dapat basahin ang anumang babala o pulang error. Tingnan ang Mga karaniwang error.
Paano ito palawakin
Teleport ng team o party nang sabay
Tumatanggap ang TeleportAsync ng listahan ng mga player, kaya kayang magpadala ng isang portal ng buong grupo sa iisang place. Iminumungkahi ng page ng Roblox tungkol sa teleports na magsimula sa player na humawak sa portal: player.Team at Team:GetPlayers() para sa team, o SocialService:GetPlayersByPartyId() kasama ang player.PartyId para sa party. Ipasa ang listahang iyon sa halip na { player } at i-set ang flag na leavingForPlace para sa bawat player dito.
Pagpapadala ng grupo sa sarili nitong server
By default, napupunta ang mga tine-teleport na player sa public server ng kabilang place. Para ipadala ang grupo sa bagong reserved server, halimbawa para sa match, gumawa ng TeleportOptions, i-set ang ShouldReserveServer nito sa true at ipasa ito bilang pangatlong argument: TeleportService:TeleportAsync(placeId, players, options). Sabi ng Roblox, sa mga palya na partikular sa reserved servers, lalo nang kapaki-pakinabang ang retry, at ginagawa na ito ng script.
Paano dalhin ang data sa ibang place
Nire-reset ng teleport ang lahat ng local data ng player na iyon. Ang teleport data sa Roblox, na sine-set gamit ang TeleportOptions:SetTeleportData() at binabasa sa kabilang place gamit ang player:GetJoinData(), ay nakikita ng client at hindi naka-encrypt, kaya gamitin lang ito para sa mga hindi delikadong pagpili, halimbawa kung aling map ang ilo-load. Itago ang coins, Wins at items sa data store, gaya sa tutorial sa DataStore, at i-load ulit sila kapag dumating ang player sa kabilang place.
Sariling loading screen
Habang naglo-load ang teleport papunta sa place, nakikita ng mga player ang default na loading screen ng Roblox. Para ipakita ang sa iyo, tawagin sa client ang TeleportService:SetTeleportGui() gamit ang ScreenGui, halimbawa ang nasa ReplicatedStorage. Nagsisimula sa server ang teleports sa guide na ito, kaya dapat itong tawagin ng client nang maaga, halimbawa pagpasok na pagpasok ng player. Sabi ng Roblox, kailangang i-set ulit ang screen bago ang bawat teleport at hindi ito ginagamit para sa place sa ibang game. Nakasaad din doon na hindi tumatakbo ang scripts sa loob ng ScreenGui na iyon, kaya gawin itong static.
Teleports sa rounds at checkpoints
Ang round system sa simula ng bawat round ay inililipat ang lahat ng player sa arena gamit ang parehong PivotTo na tawag, at ikinukumpara ng section na PivotTo o SpawnLocation sa guide sa obby ang paraang ito sa spawn points ng Roblox. Kung dapat bumukas ang spot pagkatapos lang ng round, nagbibigay na ang round system ng Wins na binabasa ng WinsNeeded.
Mga karaniwang error at solusyon
Buksan ang Output window (menu na Window, saka Output) bago pindutin ang Play. Pinapangalanan ng Teleporters ang pad kapag walang tinuturo ang Destination, kaya karamihan sa mga problema ay makikita doon.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("GetTeleportSpots")'
Naghihintay ang TeleportMenu ng remote na ginagawa ng Teleporters, ibig sabihin hindi tumatakbo ang Teleporters. I-check na Script ito, hindi LocalScript, na direkta itong nasa ServerScriptService, hindi naka-disable, at na walang pulang error mula rito sa Output. Detalyadong ipinapaliwanag ng guide sa mga error sa script ang babalang ito.
Teleporters: PadA points to PadC, which is not a part in TeleportPads
Ang Destination attribute ng pad ay nagpapangalan ng isang bagay na hindi part na direktang nasa loob ng TeleportPads folder. I-check ang spelling at malalaking titik sa value ng attribute at sa pangalan ng destination pad. Isang beses lumalabas ang babala bawat pad, sa unang pagkakataong hinawakan ito ng player.
Tumatapak ako sa pad, at walang nangyayari
I-check na eksaktong TeleportPads ang pangalan ng folder at direkta itong nasa Workspace pagsimula ng game, na type String ang Destination attribute ng pad (hindi pinapansin ang attribute na type Number), at na lumipas na ang 2 segundo mula sa huli mong teleport. I-check din na naka-on ang CanTouch ng pad: sabi ng Roblox, ang pagkonekta ng Touched sa part na naka-off ang CanTouch ay nag-e-error, at pinapahinto nito ang script.
Lumalabas ako sa loob ng pader o nahuhulog sa gilid
Lumalabas ang mga player 3 studs sa harap ng front face ng destination pad. I-right click ang pad, piliin ang Show Orientation Indicator at i-rotate ang pad hanggang tumuro ang asul na linya sa bakanteng sahig. Inilalagay ng mga menu spot ang mga player sa ibabaw ng part, kaya panatilihin ang bawat spot sa sahig.
Nananatiling gray ang Castle button kahit nakakuha na ako ng 3 Wins
Iginuguhit ang listahan kapag binuksan ang menu, kaya isara ang menu at buksan ulit. Kung gray pa rin ang button, i-check na may IntValue sa leaderstats na eksaktong Wins ang pangalan, at na nagbago ang Wins sa server, hindi lang sa Client mode.
Walang ginagawa ang portal sa na-publish na game
Buksan ang Developer Console gamit ang F9, ilipat ang log sa view na Server (nakikita lang ito ng may-ari ng game at ng mga miyembro ng group na may edit permission, dahil server Script ang Teleporters) at basahin ang mga babala na Teleporters:, nakasulat doon ang dahilan na sinabi ng Roblox. I-check na type Number ang PlaceId attribute ng portal at naglalaman ito ng ID mula sa Asset Manager, at na in-publish mo ulit ang place pagkatapos idagdag ang portal.
Gawin gamit ang RoCode
Kung ayaw mong buuin ang lahat ng ito nang mano-mano, kayang gawin ito ng RoCode sa place na bukas mo. Ang RoCode ay isang independent na AI agent para sa Roblox Studio, hindi galing sa Roblox: ilalarawan mo ang feature sa web chat nito, at ang Studio plugin nito ang gagawa ng parts at scripts sa Explorer mo, kaya hindi mo kailangang kopyahin ang code mula sa chat window.
Magdagdag ng teleports: mga pad sa Workspace.TeleportPads na nagpapadala ng mga player sa pad mula sa Destination attribute nila na may 2 segundong cooldown, Teleport menu para sa mga spot sa Workspace.TeleportSpots kung saan kailangan ng 3 Wins para sa Castle na chine-check ng server, at mga portal sa Workspace.PlacePortals na nagpapadala ng mga player sa place na may ID mula sa PlaceId attribute nila, na may retries.
- Puwedeng tingnan ang place mo kapag kailangan ito ng hakbang, gamit ang Search Game at Search Scripts, para gamitin ang mga items, remotes o saving code na nandiyan na, sa halip na magdagdag ng pangalawang system
- Gumagawa ng mga folder at pad part gamit ang Create Instance, sine-set ang properties nila gamit ang Set Property, at isinusulat ang Teleporters at TeleportMenu gamit ang Create Script
- Inuutusan itong i-check ang compile ng bawat isinulat na script gamit ang Check Script, na kino-compile ito sa Studio nang hindi pinapatakbo
- Ipinapadala ang mga pagbabago nang pa-batch, at bawat batch ay isang undo point sa history ng Studio
Gumagana lang ang teleports sa pagitan ng places sa na-publish na game, kaya ikaw mismo ang mag-test nito sa Roblox app. Sa plugin 3.9 o mas bago, kayang magpatakbo ng RoCode ng maikling playtest at basahin ang mga error, at sa plugin 3.9.15 o mas bago, kayang tumapak sa mga pad at pumindot ng mga button sa menu ang test character nito, pero ang pinili lang nitong i-test ang tine-test nito, kaya ikaw mismo ang tumapak sa mga pad at magbukas ng menu. Isang system lang ang teleport sa marami sa isang game; ang paggawa ng buong game gamit ang RoCode ay ganito rin, isang system bawat prompt. Paano kumokonekta ang RoCode sa Studio.
Mga madalas itanong
Paano gumawa ng teleport pad sa Roblox Studio?
Bigyan ang dalawang part ng Destination attribute na may pangalan ng isa't isa, at ipalipat sa isang server script ang humawak sa pad gamit ang character:PivotTo papunta sa puwesto mismo sa harap ng kabilang pad, na may maikling cooldown bawat player. Ito mismo ang binubuo ng hakbang 1 at hakbang 2.
Bakit hindi gumagana ang teleport ko sa Studio?
Gumagana sa Studio ang mga pad at menu. Ang teleports papunta sa ibang place ay hindi: hindi sinusuportahan ng TeleportService sa Roblox ang playtest sa Studio, kaya i-publish ang game at mag-test sa Roblox app. Sa halip na teleport, nagpi-print ang script sa guide na ito kung ano ang gagawin ng portal, kaya mache-check mo pa rin na nagti-trigger ito.
Paano i-teleport ang mga player sa ibang place ng game ko?
Magdagdag ng place gamit ang File > Publish As (Add as a new place), kopyahin ang place ID nito mula sa Asset Manager, at tawagin ang TeleportService:TeleportAsync(placeId, { player }) mula sa server Script sa loob ng pcall, na umuulit kapag pumalya. Dinadala ka ng hakbang 4 sa lahat ng ito.
Paano gumawa ng teleport GUI?
Buuin ang mga button sa LocalScript at pangalan lang ng spot na pinili ng player ang ipadala sa server. Hinahanap ng server ang pangalan sa isang folder, chine-check ang cooldown at anumang unlock rule, saka inililipat ang character. Huwag kailanman magpadala ng posisyon mula sa client: kaya ng exploiter na magpadala ng kahit ano.
Bakit na-stuck o nagkakahiwa-hiwalay ang character ko pagkatapos mag-teleport?
Ang pag-assign ng Position ng root part ay ginagalaw lang ang part na iyon, nang walang katawang nakakabit dito, at ang pagkopya ng CFrame ng pad ay inilalagay ang gitna ng character sa loob ng pad. Gamitin ang character:PivotTo na may puwesto sa taas ng nakatayo sa ibabaw ng sahig, na kinakalkula mula sa HipHeight ng Humanoid.
Puwede bang dalhin ang coins o items kasama ng teleport?
Hindi nang ligtas. Sabi ng Roblox, nakikita ng client ang teleport data at hindi ito naka-encrypt, kaya bagay ito sa mga bagay gaya ng napiling map, pero hindi sa coins. I-save ang coins at items sa data store at i-load sila sa kabilang place.
Mga source at dagdag na babasahin
- Roblox Creator Docs: Teleport between places (sa English). TeleportAsync, playtests sa Studio, Access Control for Places, teleport screens, teleport data at mga pumalyang teleport
- Roblox Creator Docs: TeleportService (sa English). deprecated na Teleport, TeleportAsync sa server lang at TeleportInitFailed
- Roblox Creator Docs: PVInstance:PivotTo (sa English). pangunahing function para sa paglipat ng models mula sa scripts
- Roblox Creator Docs: BasePart.Position (sa English). bakit nauusog ang nakakabit na part kumpara sa iba kapag sine-set ang Position
- Roblox Creator Docs: Humanoid.HipHeight (sa English). gaano kataas ang root part ng nakatayong character, para sa R15 at R6 rigs
- Roblox Creator Docs: Seat (sa English). ang SeatWeld na humahawak sa nakaupong character, at ang pag-destroy dito para patayuin ang character
- Roblox Creator Docs: Player:RequestStreamAroundAsync (sa English). paghingi ng area bago lumipat doon ang character, nang walang garantiya kung ano ang darating
- Roblox Creator Docs: Streaming techniques and conversion (sa English). maagang streaming bago mag-teleport
- Roblox Creator Docs: Access control and confidentiality (sa English). bakit kayang pumasok ng clients sa kahit anong place ng game kung hindi protektado ang teleports
- Roblox Creator Docs: Network ownership, movement validation, and physics (sa English). ano ang kayang gawin ng client sa sarili niyang character at mga exception para sa teleports sa movement checks
- Roblox Creator Docs: Create and publish games and places (sa English). pag-publish, sino ang puwedeng magbukas ng bagong game, at pagdagdag ng place gamit ang Publish As
- Roblox Creator Docs: Asset Manager (sa English). paano kopyahin ang place ID
- Roblox Creator Docs: Developer Console (sa English). Server view sa log at sino ang nakakakita nito
- Roblox Creator Docs: Debounce patterns (sa English). bakit nagfa-fire nang ilang beses ang Touched sa isang touch
Paano sinuri ang code: bawat script sa page na ito ay dumaan sa strict Luau type check gamit ang mga definition ng Roblox API (luau-lsp, Nobyembre 20, 2026). Nahuhuli ng type check ang maling pangalan ng API at maling type, pero hindi ang mga mali sa game logic, kaya i-test muna ang lahat sa Studio bago mag-publish.