Útmutató · Játékrendszerek

Hogyan készíts átvezető jelenetet a Roblox Studióban

Az átvezető jelenet (cutscene) a Robloxban egy kamera, amely néhány másodpercre átveszi az irányítást: képek között vált vagy simán repül, feliratot mutat, aztán visszaadja az irányítást a játékosnak. Ebben az útmutatóban olyan átvezető jelenetet rakunk össze, amelyet úgy állítasz be, hogy láthatatlan partokat helyezel el oda, ahol a kamerának állnia kell, pluginok nélkül. A szerver dönti el, mikor látja a játékos (az első megjelenéskor vagy egy trigger érintésekor), a játékos eszköze pedig mozgatja a kamerát, megjeleníti a fekete sávokat és a Skip gombot, és visszaadja a kamerát.

Frissítve 2026. november 20.23 perc olvasásSzerző:

Röviden

Helyezz el láthatatlan, rögzített (anchored) partokat 1, 2, 3 néven egy mappában a Workspace.Cutscenes alatt, mindegyiket arra fordítva, amerre a kamerának néznie kell. Egy Script a ServerScriptService-ben kiolvassa a CFrame-jüket, egy helyben tartja a játékost, és egy RemoteEventen keresztül elküldi a képeket ennek a játékosnak. Egy LocalScript a StarterPlayerScriptsben a workspace.CurrentCamera.CameraType értékét Scriptable-re állítja, minden képkockában mozgatja a kamerát a beállítások között (a TweenService:GetValue segítségével simítva), aztán a CameraType értékét visszaállítja Custom-ra, a CameraSubject értékét pedig a játékos Humanoidjára.

  • A kamerát csak a játékos eszköze irányíthatja, ezért a kamerakód LocalScript. A szerver csak azt dönti el, ki melyik átvezető jelenetet látja és mikor.
  • Amikor a kamera Scriptable, a Roblox nem frissíti többé a Camera.Focus értéket. A dokumentáció szerint a Focust minden képkockában frissíteni kell, különben a régi fókusztól távoli dinamikus fények nem biztos, hogy megjelennek.
  • A Camera:Interpolate elavult. A Roblox dokumentációja szerint a kamerát TweenService-szel kell animálni.
Ezen az oldalon
  1. Hogyan működik
  2. 1. Képek
  3. 2. Szerverscript
  4. 3. LocalScript
  5. 4. Trigger
  6. Kamera részletei
  7. Régi oktatóanyagok
  8. Csalás elleni védelem
  9. 5. Tesztelés
  10. Bővítés
  11. Common errors
  12. RoCode-dal
  13. Gyakori kérdések
  14. Források és további olvasnivaló

Hogyan működik az átvezető jelenet

IllusztrációKétképes intro valós sebességgel: váltás az első képre, 1 másodperc szünet, repülés a hídhoz 2,5 másodperc alatt, 1 másodperc szünet, aztán a kamera visszatér a játékoshoz.

Minden játékos eszközének saját Camera objektuma van a workspace.CurrentCamera alatt, ezért azt, amit a játékos lát, csak egy LocalScript mozgathatja. Annak eldöntése, ki melyik átvezető jelenetet látja és mikor, a szerver dolga. Az útmutató pontosan így osztja fel a munkát. Egy átvezető jelenet így zajlik:

  1. A szerver eldönti, hogy a játékosnak látnia kell egy átvezető jelenetet: az Intro-t az első megjelenéskor a szerveren, vagy egy másikat, amikor megérint egy trigger partot.
  2. A CutsceneService kiolvassa a kép partok CFrame-jét és beállításait, megkéri a Robloxot, hogy töltse be ennek a játékosnak az első kép területét, rögzíti a játékos HumanoidRootPartját, hogy egy helyben álljon, és csak ennek a játékosnak küldi el a CutsceneEvent eseményt egy id-val és a képek listájával.
  3. A CutscenePlayer a játékos eszközén megjeleníti a fekete sávokat és a Skip gombot, elrejti a játékoslistát, a hátizsákot, az életerőcsíkot és az érintéses vezérlőket, Scriptable-re állítja a kamerát, és minden képkockában mozgatja.
  4. Amikor az utolsó kép véget ér, vagy a játékos megnyomja a Skip gombot, visszaadja a kamerát a karakternek, és ugyanazzal az id-val elküldi a szervernek a CutsceneEvent eseményt.
  5. A szerver feloldja a játékos rögzítését. Ha ez az üzenet sosem érkezik meg, a rögzítést akkor is feloldja, amikor letelik az átvezető jelenet hossza plusz 2 másodperc. Az időzítő akkor indul, amikor a szerver elküldi az átvezető jelenetet, lassú belépésnél viszont az eszköz néhány másodperccel később is kezdheti az introt, mert a ReplicatedFirsten kívüli LocalScript csak akkor indul el, amikor a játék betöltődött. Ilyenkor a játékos hamarabb mozoghat újra, mint ahogy az intro véget ér a képernyőjén.
Miből áll az átvezető jelenet rendszere
ElemHol találhatóMit csinál
Script CutsceneServiceServerScriptServiceEldönti, ki melyik átvezető jelenetet látja és mikor, kiolvassa a képeket, egy helyben tartja a játékost, és megjegyzi, ki mit látott már.
LocalScript CutscenePlayerStarterPlayer, StarterPlayerScriptsLejátssza az átvezető jelenetet a játékos képernyőjén: sávok, feliratok, Skip és a kamera mozgása. A végén visszaadja a kamerát.
RemoteEvent CutsceneEventReplicatedStorage (a CutsceneService hozza létre)A szervertől egy játékosnak viszi a képeket, visszafelé pedig az "átvezető jelenet véget ért" üzenetet.
Folder CutscenesWorkspaceÁtvezető jelenetenként egy mappa, például Intro, 1, 2, 3 kép partokkal.
Folder CutsceneTriggersWorkspace (nem kötelező)Partok, amelyek elindítanak egy átvezető jelenetet, amikor a játékos megérinti őket.
Az Explorer, amikor az átvezető jelenet rendszere kész. A Bridge és a CutsceneTriggers mappa a 4. lépésben kerül elő. Amikor a játék elindul, a CutsceneService hozzáad a ReplicatedStorage-hez egy CutsceneEvent nevű RemoteEventet.
Workspace
  Cutscenes Folder new
    Intro Folder new
      1 Part new
      2 Part new
      3 Part new
    Bridge Folder new
      1 Part new
      2 Part new
  CutsceneTriggers Folder new
    BridgeTrigger Part new
ServerScriptService
  CutsceneService Script new
StarterPlayer
  StarterPlayerScripts
    CutscenePlayer LocalScript new

1. lépés: Helyezd el a kameraképeket

Minden kép egy láthatatlan part. A kamera átveszi a part pozícióját, és arra néz, amerre a part elülső lapja, így egy kép elhelyezése egyenlő a kamera elhelyezésével.

  1. Az Explorerben vidd az egeret a Workspace fölé, kattints a + gombra, és szúrj be egy Cutscenes nevű Foldert. Ebbe szúrj be egy Intro nevű Foldert. A nevekben számít a kis- és nagybetű.
  2. Vidd a Studio kameráját az első kívánt nézethez, mintha egy fotót komponálnál.
  3. Szúrj be egy Partot az Introba, és nevezd át 1-re.
  4. Nyisd meg a Command Bart (a Script fülön, vagy a Window, majd Script menüben), és futtasd ezt: workspace.Cutscenes.Intro["1"].CFrame = workspace.CurrentCamera.CFrame. Szerkesztő módban a CurrentCamera az a nézet, amelyen keresztül nézel, így a part pontosan ebbe a képbe kerül. A szögletes zárójel és az idézőjelek azért kellenek, mert számmal kezdődő nevet nem lehet pont után írni.
  5. A part Properties ablakában jelöld be az Anchored opciót, vedd ki a pipát a CanCollide, a CanTouch és a CanQuery elől, és állítsd a Transparency értékét 1-re. Az Anchored megakadályozza, hogy átessen a pályán; a többi pedig azt, hogy útban legyen a játékosoknak, érintési eseményeket indítson, vagy kitakarja a raycastokat.
  6. Ismételd meg a következő nézetekkel, a partokat 2, 3 és így tovább nevezve, és a Command Bar sorában a számot is átírva. A CutsceneService a képeket számsorrendben játssza le, és az első hiányzó számnál megáll, ezért egy lyuk a számozásban idő előtt véget vet az átvezető jelenetnek.

Ha később meg akarsz változtatni egy képet, vidd a kamerát az új nézethez, és futtasd ugyanazt a sort az adott kép számával. 1-es Transparency mellett a partok a Studióban is láthatatlanok, ezért amikor kellenek, az Explorerben jelöld ki őket.

Minden képnek lehet még három nem kötelező attribútuma. Attribútum hozzáadásához jelöld ki a partot, görgesd le a Properties ablakot az Attributes részig, kattints a + gombra, írd be a nevet, válaszd ki a típust, és kattints a Save gombra.

Nem kötelező attribútumok minden kép parton
AttribútumTípusAlapértelmezésMit csinál
MoveSecondsnumber3Hány másodpercig repül a kamera az előző képtől ehhez. A 0 hirtelen váltást jelent. Az 1. kép mindig váltás, ezért ott az attribútumnak nincs hatása.
HoldSecondsnumber1Hány másodpercig áll a kamera ezen a képen, miután megérkezett.
CaptionstringnincsSzöveg az alsó sávon attól a pillanattól, hogy a kamera elindul ehhez a képhez. A Caption nélküli kép törli a szöveget.

A 0-nál kisebb vagy 60-nál nagyobb számot, valamint a rossz típusú attribútumot az alapértelmezett érték váltja fel.

2. lépés: Add hozzá a szerverscriptet

Vidd az egeret a ServerScriptService fölé, szúrj be egy CutsceneService nevű Scriptet, és illeszd bele az alábbi kódot. A fenti beállítások azok a sorok, amelyeket módosíthatsz.

Script helye: ServerScriptService neve: CutsceneService
-- Script a ServerScriptService-ben, a neve CutsceneService.
-- Eldönti, ki melyik átvezető jelenetet látja és mikor. Kiolvassa a kameraképeket a számozott
-- partokból a Workspace.Cutscenes alatt, egy helyben tartja a játékost, és szól a játékos
-- eszközének, hogy játssza le a képeket. Magát a kamerát csak az eszközön lehet mozgatni.

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- Beállítások
local INTRO_CUTSCENE = "Intro" -- egyszer fut a játékos első megjelenésekor; "" a kikapcsoláshoz
local DEFAULT_MOVE_SECONDS = 3 -- repülési idő a képhez, ha nincs MoveSeconds
local DEFAULT_HOLD_SECONDS = 1 -- idő a képen, ha nincs HoldSeconds
local MAX_SHOTS = 30

local cutscenes = workspace:WaitForChild("Cutscenes")
local triggers = workspace:FindFirstChild("CutsceneTriggers")

-- Ez a script maga hozza létre a CutsceneEventet, ezért ne add hozzá kézzel
local cutsceneEvent = Instance.new("RemoteEvent")
cutsceneEvent.Name = "CutsceneEvent"
cutsceneEvent.Parent = ReplicatedStorage

type Shot = { cframe: CFrame, move: number, hold: number, caption: string }

local seen: { [Player]: { [string]: boolean } } = {}
local playing: { [Player]: number } = {} -- annak az átvezető jelenetnek az id-ja, amelyet a játékos néz
local lastId = 0

local function secondsAttribute(part: Instance, name: string, default: number): number
	local value = part:GetAttribute(name)
	if typeof(value) == "number" and value >= 0 and value <= 60 then
		return value
	end
	return default
end

-- A képek az 1, 2, 3 ... partok az átvezető jelenet nevét viselő mappában
local function readShots(name: string): { Shot }
	local shots: { Shot } = {}
	local folder = cutscenes:FindFirstChild(name)
	if not folder then
		warn(`CutsceneService: no folder named {name} in Workspace.Cutscenes`)
		return shots
	end
	for index = 1, MAX_SHOTS do
		local part = folder:FindFirstChild(tostring(index))
		if not (part and part:IsA("BasePart")) then
			break
		end
		local caption = part:GetAttribute("Caption")
		table.insert(shots, {
			cframe = part.CFrame,
			-- az első kép váltás, ezért a kamera azonnal odaugrik
			move = if index == 1 then 0 else secondsAttribute(part, "MoveSeconds", DEFAULT_MOVE_SECONDS),
			hold = secondsAttribute(part, "HoldSeconds", DEFAULT_HOLD_SECONDS),
			caption = if typeof(caption) == "string" then caption else "",
		})
	end
	return shots
end

local function setFrozen(player: Player, frozen: boolean)
	local character = player.Character
	local rootPart = character and character:FindFirstChild("HumanoidRootPart")
	if rootPart and rootPart:IsA("BasePart") then
		rootPart.Anchored = frozen
	end
end

local function finish(player: Player, id: number)
	if playing[player] ~= id then
		return -- ez az átvezető jelenet már véget ért
	end
	playing[player] = nil
	setFrozen(player, false)
end

local function play(player: Player, name: string): boolean
	if playing[player] then
		return false -- egyszerre egy átvezető jelenet
	end
	local character = player.Character
	local humanoid = character and character:FindFirstChildOfClass("Humanoid")
	if not humanoid or humanoid.Health <= 0 then
		return false
	end
	local shots = readShots(name)
	if #shots == 0 then
		return false
	end

	lastId += 1
	local id = lastId
	playing[player] = id

	-- Bekapcsolt instance streaming mellett a játékos eszközén hiányozhat a terület,
	-- amelyre a kép néz, a kérés pedig csak ideiglenesen tölti be a területet. Betöltjük
	-- az első kép területét most (legfeljebb 2 másodpercet várunk), a többi képét pedig
	-- 2 másodperccel azelőtt, hogy a kamera elindulna hozzá.
	local function request(position: Vector3)
		pcall(function()
			player:RequestStreamAroundAsync(position, 2)
		end)
	end
	request(shots[1].cframe.Position)
	if playing[player] ~= id or player.Parent ~= Players then
		return false -- a játékos kilépett, amíg a terület töltődött
	end

	setFrozen(player, true)
	cutsceneEvent:FireClient(player, id, shots)
	local startsAt = 0 -- másodpercek mostantól az ehhez a képhez tartó repülés kezdetéig
	for index, shot in shots do
		if index > 1 then
			task.delay(math.max(startsAt - 2, 0), function()
				if playing[player] == id then
					request(shot.cframe.Position)
				end
			end)
		end
		startsAt += shot.move + shot.hold
	end
	-- Biztosíték: feloldjuk a játékost, akkor is, ha az eszköze sosem válaszolt
	task.delay(startsAt + 2, finish, player, id)
	return true
end

-- Csak akkor ad vissza true-t, ha az átvezető jelenet elindult ennél a játékosnál
local function playOnce(player: Player, name: string): boolean
	local playerSeen = seen[player]
	if not playerSeen or playerSeen[name] then
		return false
	end
	if play(player, name) then
		playerSeen[name] = true
		return true
	end
	return false
end

-- A játékos eszköze jelzi, hogy az átvezető jelenet véget ért vagy átugorták
cutsceneEvent.OnServerEvent:Connect(function(player: Player, id: unknown)
	if typeof(id) == "number" then
		finish(player, id)
	end
end)

-- Trigger partok: az érintés elindítja a Cutscene attribútumukban megadott átvezető jelenetet
if triggers then
	for _, trigger in triggers:GetChildren() do
		if not trigger:IsA("BasePart") then
			continue
		end
		if not trigger.CanTouch then
			-- A Touched hozzákapcsolása kikapcsolt CanTouch opciójú parthoz hibát dob, ezért csak figyelmeztetünk
			warn(`CutsceneService: tick CanTouch on {trigger:GetFullName()} so it can start a cutscene`)
			continue
		end
		trigger.Touched:Connect(function(otherPart: BasePart)
			local name = trigger:GetAttribute("Cutscene")
			local character = otherPart:FindFirstAncestorOfClass("Model")
			local player = character and Players:GetPlayerFromCharacter(character)
			if player and typeof(name) == "string" then
				playOnce(player, name)
			end
		end)
	end
end

local function onCharacterAdded(player: Player, character: Model)
	character:WaitForChild("HumanoidRootPart", 10)
	if playing[player] then
		setFrozen(player, true) -- respawn az átvezető jelenet alatt, az új karaktert is egy helyben tartjuk
	elseif INTRO_CUTSCENE ~= "" then
		playOnce(player, INTRO_CUTSCENE)
	end
end

local function onPlayerAdded(player: Player)
	if seen[player] then
		return -- már be van állítva
	end
	seen[player] = {}
	player.CharacterAdded:Connect(function(character: Model)
		onCharacterAdded(player, character)
	end)
	local character = player.Character
	if character then
		task.spawn(onCharacterAdded, player, character)
	end
end

Players.PlayerAdded:Connect(onPlayerAdded)
for _, player in Players:GetPlayers() do -- mindenki, aki belépett, amíg a script a Cutscenes mappára várt
	onPlayerAdded(player)
end

Players.PlayerRemoving:Connect(function(player: Player)
	seen[player] = nil
	playing[player] = nil
end)

A CutsceneService maga hozza létre a CutsceneEvent RemoteEventet, amint megjelenik a Workspace.Cutscenes, ezért a ReplicatedStorage-be kézzel semmit sem kell beszúrnod. Ha már készítettél ilyen nevű RemoteEventet, töröld: a LocalScript a tiédet is megtalálhatja, azt pedig a szerveren senki sem figyeli.

Beállítások a CutsceneService tetején
BeállításÉrték ittMit változtat meg
INTRO_CUTSCENE"Intro"A Workspace.Cutscenes mappája, amely a játékos első megjelenésekor fut a szerveren. Állítsd ""-ra, ha nem akarsz introt.
DEFAULT_MOVE_SECONDS3Meddig tart a repülés, ha a képnek nincs MoveSeconds attribútuma.
DEFAULT_HOLD_SECONDS1Meddig áll a kamera egy képen, ha annak nincs HoldSeconds attribútuma.
MAX_SHOTS30A legnagyobb képszám, amelyet a CutsceneService egy átvezető jelenetben keres.

Mit csinál a script többi része, sorban:

  • A szerveren olvassa ki a képeket. A readShots minden számozott part CFrame-jét és attribútumait egy listába gyűjti. A játékos eszköze ezt a listát kapja meg, így magukra a partokra nincs szüksége.
  • Egyszerre egy átvezető jelenet. A play semmit sem csinál, amíg a játékos már néz egy átvezető jelenetet, vagy ha a karakterének nincs Humanoidja, vagy halott.
  • Minden átvezető jelenetnek saját id-ja van. Az eszköz visszaküldi az id-t, amikor az átvezető jelenet véget ér vagy átugorják, és csak az egyező id oldja fel a játékost, így egy korábbi átvezető jelenet késve érkező üzenete nem fejezheti be az újat.
  • Egy helyben tartja a játékost úgy, hogy rögzíti a HumanoidRootPartját, és az új karaktert is rögzíti, ha a játékos az átvezető jelenet közepén respawnol. A Roblox dokumentációja szerint egy rögzített part soha nem változtatja a pozícióját a gravitáció, ütközések vagy más fizika miatt. A WalkSpeedhez nem nyúl, így nem ütközik a sprint scripttel vagy a sebesség passzal. A végén a script feloldja a root part rögzítését, akkor is, ha egy másik script rögzítette, ezért ne rögzítsd máshol a karaktereket, amíg átvezető jelenet futhat.
  • Biztosíték. A task.delay az átvezető jelenet teljes hossza plusz 2 másodperc után feloldja a játékost, akkor is, ha az eszköze sosem válaszolt.
  • Minden átvezető jelenet szerverenként egyszer. A seen táblázat minden játékosnál megjegyzi, mely átvezető jelenetek indultak már el, így az intro nem ismétlődik respawnkor, a triggeres átvezető jelenet pedig egyszer fut. A playOnce csak akkor ad vissza true értéket, ha az átvezető jelenet valóban elindult.
  • Minden játékost beállít. A végén a Players:GetPlayers() ciklus mindenkit elkap, aki akkor lépett be, amíg a script a Cutscenes mappára várt.

A képek egyetlen FireClient hívással mennek a játékoshoz, kis táblázatok listájaként. A Roblox remote eventekről szóló oldala szerint nem szabad olyan táblázatot küldeni, amelyben vegyesen vannak szám- és szövegkulcsok; ebben a listában csak számkulcsok vannak, a benne lévő minden képben pedig csak szövegkulcsok, ez az a forma, amelyet ott ajánlanak.

3. lépés: Add hozzá a LocalScriptet, amely lejátssza

  1. Az Explorerben nyisd ki a StarterPlayer mappát, vidd az egeret a StarterPlayerScripts fölé, és szúrj be egy CutscenePlayer nevű LocalScriptet.
  2. Cseréld le a tartalmát az alábbi kódra.
LocalScript helye: StarterPlayerScripts neve: CutscenePlayer
-- LocalScript a StarterPlayer > StarterPlayerScripts mappában, a neve CutscenePlayer.
-- Lejátssza a szervertől érkező átvezető jelenetet: fekete sávok, feliratok, Skip gomb és
-- képről képre repülő kamera. Aztán visszaadja a kamerát a játékosnak.

local GuiService = game:GetService("GuiService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local RunService = game:GetService("RunService")
local StarterGui = game:GetService("StarterGui")
local TweenService = game:GetService("TweenService")
local UserInputService = game:GetService("UserInputService")

local cutsceneEvent = ReplicatedStorage:WaitForChild("CutsceneEvent") :: RemoteEvent
local player = Players.LocalPlayer
local camera = workspace.CurrentCamera

local BAR_HEIGHT = 0.12 -- mindegyik fekete sáv, a képernyő magasságának hányadaként
local EASING_STYLE = Enum.EasingStyle.Sine
local FOCUS_DISTANCE = 30 -- hány studdal a kamera előtt rajzoljon a Roblox a legrészletesebben
local HIDDEN_CORE_GUIS = { Enum.CoreGuiType.PlayerList, Enum.CoreGuiType.Backpack, Enum.CoreGuiType.Health }
local REGULAR = Font.fromEnum(Enum.Font.BuilderSans)
local BOLD = Font.fromEnum(Enum.Font.BuilderSansBold)

type Shot = { cframe: CFrame, move: number, hold: number, caption: string }

-- Az átvezető jelenet képernyője: két fekete sáv és egy felirat, széltől szélig. A Roblox azt ajánlja,
-- hogy a None ScreenInsets csak olyasmihez kerüljön, amit senki sem nyom meg, ezért a lenti Skipnek saját ScreenGuija van.
local gui = Instance.new("ScreenGui")
gui.Name = "Cutscene"
gui.ResetOnSpawn = false
gui.ScreenInsets = Enum.ScreenInsets.None -- teljes képernyő
gui.DisplayOrder = 10
gui.Enabled = false

local topBar = Instance.new("Frame")
topBar.Size = UDim2.fromScale(1, BAR_HEIGHT)
topBar.BackgroundColor3 = Color3.new(0, 0, 0)
topBar.BorderSizePixel = 0
topBar.Parent = gui

local bottomBar = topBar:Clone()
bottomBar.Position = UDim2.fromScale(0, 1 - BAR_HEIGHT)
bottomBar.Parent = gui

local caption = Instance.new("TextLabel")
caption.Size = UDim2.fromScale(0.7, 0.5)
caption.Position = UDim2.fromScale(0.15, 0.25)
caption.BackgroundTransparency = 1
caption.TextColor3 = Color3.new(1, 1, 1)
caption.TextScaled = true
caption.FontFace = REGULAR
caption.Text = ""
caption.Parent = bottomBar

-- A Skip gombnak alapértelmezett margói vannak, ezért a kamerakivágás nem takarja el
local controls = Instance.new("ScreenGui")
controls.Name = "CutsceneControls"
controls.ResetOnSpawn = false
controls.DisplayOrder = 11
controls.Enabled = false

local skipButton = Instance.new("TextButton")
skipButton.AnchorPoint = Vector2.new(1, 0.5)
skipButton.Size = UDim2.fromScale(0.1, BAR_HEIGHT * 0.5)
skipButton.Position = UDim2.new(1, -16, 1 - BAR_HEIGHT / 2, 0) -- az alsó sávon, jobbra
skipButton.BackgroundColor3 = Color3.fromRGB(60, 60, 60)
skipButton.TextColor3 = Color3.new(1, 1, 1)
skipButton.TextScaled = true
skipButton.FontFace = BOLD
skipButton.Text = "Skip"
skipButton.Parent = controls

-- a Skip elég nagy marad ahhoz, hogy egy kis telefonon is el lehessen találni
local skipMinSize = Instance.new("UISizeConstraint")
skipMinSize.MinSize = Vector2.new(64, 32)
skipMinSize.Parent = skipButton

local playerGui = player:WaitForChild("PlayerGui")
gui.Parent = playerGui
controls.Parent = playerGui

-- Jelenlegi repülés: az egyik kamera CFrame-től a következőig, megadott számú másodperc alatt
local moveFrom = CFrame.identity
local moveTo = CFrame.identity
local moveStart = 0
local moveSeconds = 0
local skipRequested = false
local busy = false

-- Az átvezető jelenet alatt minden képkockában fut. A Scriptable kamera Focusa magától semmit
-- sem követ, ezért azt is itt állítjuk be.
local function updateCamera()
	if camera.CameraType ~= Enum.CameraType.Scriptable then
		camera.CameraType = Enum.CameraType.Scriptable -- valami visszaállította, például egy respawn
	end
	local alpha = if moveSeconds > 0 then (os.clock() - moveStart) / moveSeconds else 1
	local eased = TweenService:GetValue(alpha, EASING_STYLE, Enum.EasingDirection.InOut)
	camera.CFrame = moveFrom:Lerp(moveTo, eased)
	camera.Focus = camera.CFrame * CFrame.new(0, 0, -FOCUS_DISTANCE)
end

local function waitOrSkip(seconds: number)
	local endTime = os.clock() + seconds
	while os.clock() < endTime and not skipRequested do
		task.wait()
	end
end

local function play(id: number, shots: { Shot })
	if busy then
		-- Már fut egy, ezért a szerver ennél azonnal oldja fel a játékost
		cutsceneEvent:FireServer(id)
		return
	end
	busy = true
	skipRequested = false

	-- Elrejtjük a játékoslistát, a hátizsákot és az életerőcsíkot, és megjegyezzük, mi látszott
	local wasEnabled: { [Enum.CoreGuiType]: boolean } = {}
	for _, coreGui in HIDDEN_CORE_GUIS do
		wasEnabled[coreGui] = StarterGui:GetCoreGuiEnabled(coreGui)
		StarterGui:SetCoreGuiEnabled(coreGui, false)
	end
	-- Telefonon elrejtjük a joysticket és az ugrás gombot, amelyek az alsó sarkokban vannak
	local touchControlsWere = GuiService.TouchControlsEnabled
	GuiService.TouchControlsEnabled = false
	gui.Enabled = true
	controls.Enabled = true
	-- A kontroller csak a kiválasztott gombot nyomhatja meg, ezért a kontrolleres játékosoknál a Skipet választjuk ki
	if UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
		GuiService.SelectedObject = skipButton
	end
	camera = workspace.CurrentCamera
	camera.CameraType = Enum.CameraType.Scriptable
	moveTo = camera.CFrame
	-- Egy lépéssel a Roblox saját kamerafrissítése után, mint a Roblox kamera oktatóanyagában
	RunService:BindToRenderStep("Cutscene", Enum.RenderPriority.Camera.Value + 1, updateCamera)

	for _, shot in shots do
		moveFrom = camera.CFrame -- minden repülést onnan kezdünk, ahol a kamera most van
		moveTo = shot.cframe
		moveStart = os.clock()
		moveSeconds = shot.move
		caption.Text = shot.caption
		waitOrSkip(shot.move + shot.hold)
		if skipRequested then
			break
		end
	end

	-- Visszaadjuk a kamerát a játékos karakterének
	RunService:UnbindFromRenderStep("Cutscene")
	camera.CameraType = Enum.CameraType.Custom
	local character = player.Character
	local humanoid = character and character:FindFirstChildOfClass("Humanoid")
	if humanoid then
		camera.CameraSubject = humanoid
	end
	if GuiService.SelectedObject == skipButton then
		GuiService.SelectedObject = nil
	end
	gui.Enabled = false
	controls.Enabled = false
	caption.Text = ""
	-- Csak azt kapcsoljuk vissza, amit ez az átvezető jelenet kapcsolt ki, a többihez nem nyúlunk
	for coreGui, enabled in wasEnabled do
		if enabled then
			StarterGui:SetCoreGuiEnabled(coreGui, true)
		end
	end
	if touchControlsWere then
		GuiService.TouchControlsEnabled = true
	end
	cutsceneEvent:FireServer(id) -- a szerver azonnal feloldja a játékost
	busy = false
end

skipButton.Activated:Connect(function()
	skipRequested = true
end)

cutsceneEvent.OnClientEvent:Connect(function(id: number, shots: { Shot })
	play(id, shots)
end)

A StarterPlayerScripts LocalScriptje egyszer, belépéskor másolódik át a játékoshoz, és a karakter respawnja után is tovább fut. Ezért mindkét ScreenGui ResetOnSpawn opciója ki van kapcsolva: ha bekapcsolod, a Roblox az első respawnkor törli őket, ez a script pedig nem hozza létre őket újra. A remote üzenetei, amelyek azelőtt érkeznek, hogy a script csatlakozott volna az OnClientEvent eseményhez, sorba kerülnek, és a csatlakozás után kézbesítődnek, így az a játékos is látja az introt, aki gyorsan megjelent.

Mit csinál a CutscenePlayer egyes része
RészMit csinál
ScreenGui CutsceneKét fekete sáv, mindegyik a képernyő magasságának 12%-a (BAR_HEIGHT), és felirat az alsó sávon. A None ScreenInsets a képernyő legszéléig nyújtja a sávokat, a 10-es DisplayOrder pedig a kisebb DisplayOrderű ScreenGuik fölé rajzolja őket.
ScreenGui CutsceneControlsCsak a Skip gomb van benne, jobbra az alsó sávon, egy UISizeConstraint-tel, amely legalább 64 x 32 pixelen tartja, hogy telefonon is könnyű legyen eltalálni. Alapértelmezett ScreenInsets értéke van, így a tartalma nem csúszik a Roblox felső sávjának gombjai és a kamerakivágások alá. A Roblox a None értéket csak olyan tartalomhoz ajánlja, amelyen nincs mit megnyomni, ezért a Skip nem lehet a sávok ScreenGuijában.
HIDDEN_CORE_GUISElrejti a játékoslistát, a hátizsákot és az életerőcsíkot a SetCoreGuiEnabled segítségével, előtte a GetCoreGuiEnabled segítségével megjegyzi, melyek voltak bekapcsolva, a végén pedig csak azokat kapcsolja vissza, amelyeket ő kapcsolt ki. Ha a játék máshol rejti el a hátizsákot, az rejtve marad, és egy scriptet, amely az átvezető jelenet alatt kapcsolja be őket, például a főmenüt, senki sem írja felül.
TouchControlsEnabledTelefonon és tableten a play az átvezető jelenet idejére false-ra állítja a GuiService.TouchControlsEnabled értéket. Ez elrejti a joysticket és az ugrás gombot, amelyek az alsó sarkokban vannak, ugyanott, ahol a Skip, a végén pedig visszatérnek, ha be voltak kapcsolva.
updateCameraMinden képkockában fut, amíg az átvezető jelenet tart. Kiszámolja, a jelenlegi repülés mekkora része telt el, a TweenService:GetValue segítségével simítja, a CFrame:Lerp segítségével a két kép közé teszi a kamerát, és a Focus értéket 30 studdal a kamera elé állítja.
waitOrSkipKivárja a repülés és a kép szünetének idejét, minden képkockában ellenőrizve a Skip jelzőt.
playScriptable-re állítja a kamerát, sorban lejátssza a képeket, aztán visszaadja a kamerát (CameraType Custom, a CameraSubject a Humanoid), visszakapcsolja a core GUI-t és az érintéses vezérlőket, és elküldi a szervernek az átvezető jelenet id-ját. Ha egy második átvezető jelenet érkezik, amíg az első még fut, azonnal visszaküldi annak id-ját, hogy a szerver ne tartsa egy helyben a játékost egy olyan átvezető jelenet miatt, amelyet ez az eszköz nem mutatott meg.
Skip gombAz Activated egérkattintásra, koppintásra vagy a kontroller A gombjára sül el, amikor a gomb ki van választva. Annak a játékosnak, akinek a fő bemenete kontroller, a play az átvezető jelenet elején kiválasztja a Skip gombot, a végén pedig megszünteti a kiválasztást.

A BAR_HEIGHT módosításával vékonyabbra vagy vastagabbra veheted a sávokat, az EASING_STYLE módosításával pedig megváltoztathatod a repülések érzetét (lásd Mit csinál jól a kamerakód). A feliratnál és a Skip gombnál be van kapcsolva a TextScaled, így a szöveg a képernyővel együtt nő és zsugorodik.

4. lépés: Átvezető jelenet egy part érintésére

Az intro magától fut. Ha a pálya egy adott pontján szeretnél átvezető jelenetet, például amikor a játékos először ér a hídhoz, adj hozzá egy második átvezető jelenetet és egy trigger partot.

  1. A Workspace, Cutscenes mappába szúrj be egy Bridge nevű Foldert, és helyezd el a képeit az 1. lépés szerint, 1 és 2 néven. A Command Bar sorába Intro helyett Bridge-et írj.
  2. Vidd az egeret a Workspace fölé, és szúrj be egy CutsceneTriggers nevű Foldert.
  3. Szúrj bele egy BridgeTrigger nevű Partot. Legyen akkora, hogy a játékosok ne tudjanak elmenni mellette érintés nélkül, például egy magas, széles lap az úton keresztben. Jelöld be az Anchored opciót, vedd ki a pipát a CanCollide és a CanQuery elől, hagyd bejelölve a CanTouch opciót, és állítsd a Transparency értékét 1-re. A kikapcsolt CanQuery megakadályozza, hogy a láthatatlan lap kitakarja a raycastokat, például a fegyveres útmutató lövéseit. Az érintési eseményeket a CanTouch vezérli, nem a CanQuery, így a trigger továbbra is működik.
  4. Adj neki egy string típusú Cutscene attribútumot Bridge értékkel: ez a lejátszandó mappa neve.

A CutsceneService a szerver indulásakor a CutsceneTriggers közvetlen tartalmának minden partjához hozzákapcsolja a Touched eseményt, ezért a triggereket a Studióban add hozzá, ne scripttel játék közben. A kikapcsolt CanTouch opciójú triggert egy Output figyelmeztetéssel kihagyja, mert a Roblox hibát dob, ha egy script ilyen parthoz kapcsolja a Touched eseményt.

Amíg a karakter átmegy a parton, a Touched sokszor egymás után elsül. A seen táblázat és az "egyszerre egy átvezető jelenet" szabály ebből játékosonként és szerverenként egy átvezető jelenetet csinál. Azt a játékost, aki egy másik átvezető jelenet közben érinti meg a triggert, a rendszer figyelmen kívül hagyja, és a trigger készen marad számára.

Ne tegyél triggereket utakra. Az ülő játékos HumanoidRootPartja az üléshez van hegesztve, és amikor egy hegesztett csoport egyik partja rögzített, a Roblox vele együtt a többit is rögzíti. Ezért az a játékos, aki behajt egy triggerbe, az egész járművét egy helyben tartja, az utasokkal együtt, amíg az átvezető jelenet véget nem ér.

Mit csinál jól a kamerakód

Scriptable, aztán vissza Custom

A Roblox kamerascriptjei nem mozgatják és nem frissítik a kamerát, amíg a CameraType értéke Scriptable, és pontosan ez teszi lehetővé, hogy a CutscenePlayer beállítsa. A végén visszaállítja a CameraType értékét Customra, és a játékos Humanoidját teszi meg CameraSubject-nek, amelyet a Roblox kamerascriptjei alapból követnek. Ez Skip után is lefut, így a játékos sosem marad az utolsó képre bámulva.

Két kis ellenőrzés gondoskodik róla, hogy az átvezető jelenet maradjon a főnök, amíg fut. Ha valami az átvezető jelenet közepén más értékre állítja a CameraType-ot, a minden képkockában futó függvény a következő képkockában visszaállítja Scriptable-re. A workspace.CurrentCamera értéket pedig a script minden átvezető jelenet elején újra kiolvassa, mert a Roblox új Camerát hoz létre, ha a jelenlegit valaha törlik.

Focus, minden képkockában

A Camera.Focus megmondja a motornak, melyik terület élvezzen elsőbbséget az olyan munkákban, mint a világítás. A Roblox kamerascriptjei a CameraSubjecten tartják, de nem akkor, amikor a kamera Scriptable, és a Roblox dokumentációja szerint ilyenkor minden képkockában frissíteni kell: az olyan objektumok dinamikus fényei, mint a PointLight, a fókusztól távol nem biztos, hogy megjelennek. A CutscenePlayer 30 studdal a kamera elé állítja (FOCUS_DISTANCE). Növeld ezt a számot, ha a képeid valami távolabbira néznek.

A függvény a RunService:BindToRenderStep segítségével fut, minden képkockában a megjelenítés előtt, egy prioritási lépéssel a Roblox saját kamerafrissítése után (Enum.RenderPriority.Camera.Value + 1). Ezt a prioritást használja a Roblox kameráról szóló oktatóanyaga, így az átvezető jelenet azután állítja be a kamerát, hogy a Roblox saját kamerakódja lefutott.

Simítás a TweenService:GetValue segítségével

Egy tween a camera.CFrame értéken mozgatná a kamerát, de a Focust így is minden képkockában be kell állítani, ezért a CutscenePlayer ugyanabban a függvényben maga mozgatja a kamerát. Minden repülésnél kiszámolja, az idő mekkora hányada telt el (0 és 1 között), átengedi a TweenService:GetValue függvényen a simítás stílusával és irányával, és a két kép közötti út ennyiedik részére teszi a kamerát a CFrame:Lerp segítségével, amely egyenes vonalban mozgatja a pozíciót, és simán forgat. A GetValue a bemenetet 0 és 1 közé korlátozza, így a kamera pontosan a képen áll meg, amikor a repülés ideje lejár.

Simítási stílusok, amelyek illenek a kamera repüléséhez
EASING_STYLEMilyen érzés a repülés
Enum.EasingStyle.Sine (itt)A sebesség szinuszgörbét követ, lágy indulás és lágy megállás.
Enum.EasingStyle.QuadMint a Sine, de a görbe kicsit élesebb.
Enum.EasingStyle.LinearÁllandó sebesség, így minden repülés teljes sebességgel indul és ér véget.

Az InOut irány: a simítás a repülés első felében előre, a másodikban visszafelé érvényesül, így a kamera felgyorsul az egyik képtől, és lelassul a következő felé.

Streaming

Az új place-ekben be van kapcsolva az instance streaming: alapból a játékos eszköze a karaktere körüli területet tartja meg, így egy kép, amely a pálya túlsó végére néz, üres világot mutathat. A CutsceneService a Player:RequestStreamAroundAsync segítségével megkéri a Robloxot, hogy töltse be ennek a játékosnak minden kép területét: az első képét az esemény elküldése előtt, legfeljebb 2 másodperc várakozással, minden további képét pedig 2 másodperccel azelőtt, hogy a kamera elindulna hozzá.

A Roblox azt írja, hogy így a terület valószínűleg, de nem biztosan töltődik be, és hogy a hatás ideiglenes. A fontos képeket tartsd a streaming sugarán belül, vagy használd a szerveren a Player:AddReplicationFocus függvényt arra a területre, amelynek betöltve kell maradnia, amíg el nem távolítod a fókuszt. Kikapcsolt streaming mellett az eszköznek amúgy is megvan az egész pálya, a pcall pedig minden kérés körül azt jelenti, hogy egy sikertelen kérés nem állíthatja le az átvezető jelenetet.

Mi a baj a régi átvezető jelenet oktatóanyagokkal

Ha ezt az útmutatót egy videóval vagy fórumbejegyzéssel hasonlítod össze, ezek a fontos különbségek, és az, hogy miért probléma mindegyik módszer.

Gyakori módszerek az átvezető jelenet oktatóanyagokban, és mit csinál helyettük ez az útmutató
OktatóanyagProblémaEz az útmutató
A kamerát a camera:Interpolate() segítségével mozgatjaA Roblox elavultnak jelölte az Interpolate függvényt, és azt ajánlja, hogy a kamerát TweenService-szel animáld.Minden repülést a TweenService:GetValue segítségével simít, és minden képkockában beállítja a kamerát.
A camera.CFrame értéket tweeneli, és semmi mástA Focus ott marad, ahol a kamerascriptek hagyták, a karakter közelében, így a tőle távoli dinamikus fények nem biztos, hogy megjelennek (a Roblox Camera.Focus dokumentációja).A Focus értéket minden képkockában beállítja a render stepben.
Nem adja vissza a kamerátA játékos beragad, és az utolsó képet bámulja.A végén a CameraType értékét Customra, a CameraSubject értékét a Humanoidra állítja, Skip után is.
Az átvezető jelenetet egy LocalScript Touched eseményéből indítjaSemmi sem akadályozza meg, hogy minden érintésnél ismétlődjön, és a döntés azon az eszközön születik, amelyet a játékos irányít.A szerver választja ki a játékost, és megjegyzi, ki látta már.
A kamerapartokat a kliensen olvassa kiBekapcsolt streaming mellett a karaktertől távoli partok még nem feltétlenül léteznek az eszközön.A szerver olvassa ki a partokat, elküldi a CFrame-jüket, és minden kép területét nem sokkal azelőtt kéri le, hogy oda érne a kamera.

Mit tud és mit nem tud megváltoztatni a játékos

Számolj azzal, hogy egy csaló mindent irányít a saját eszközén: módosíthatja vagy törölheti a CutscenePlayert, és bármilyen értékkel elküldheti a CutsceneEvent eseményt. Egy átvezető jelenetnél ez szinte semmit sem jelent, ha semmi valódi nem függ tőle.

Mit próbálhat meg egy csaló, és mi lesz belőle
A csaló megpróbáljaEredmény
Átugrani az átvezető jelenetet, vagy egyáltalán le sem játszaniMegteheti: ez a saját képernyője. Soha ne adj jutalmat azért, hogy "végignézte az átvezető jelenetet".
Bármilyen értékkel elküldeni a CutsceneEvent eseménytCsak a jelenlegi átvezető jelenetével egyező szám csinál bármit, és annyit tesz, hogy hamarabb feloldja.
Megérinteni a triggert a pálya bármely pontjárólLehetséges: minden eszköz a saját karakterét irányítja, és a Roblox biztonsági dokumentációja a Touched események hamisítását is felsorolja azok között, amit megtehet. Egyszer látni fogja ezt az átvezető jelenetet, és semmi más nem történik.
Mégis mozogni az átvezető jelenet alattNincs mit nyerni vele. A rögzítés a becsületes játékosokat tartja vissza attól, hogy az átvezető jelenet közepén elsétáljanak; ez nem biztonsági ellenőrzés.
Remote segítségével elindítani egy átvezető jelenetet valaki másnakLehetetlen. CutsceneEventet egy játékosnak csak a szerver küldhet, és az eszköz egyedül azt küldheti vissza, hogy "ez az átvezető jelenet véget ért".

Ha az átvezető jelenet valami valódihoz vezet, például egy ajtóhoz, amely utána kinyílik, vagy egy főellenség megjelenéséhez, ezt a szerver a saját időzítője szerint tegye, ne akkor, amikor az eszköz jelzi, hogy az átvezető jelenet véget ért.

5. lépés: Teszteld

  1. Helyezd el az Intro három képét a Command Bar sorával. Az 1. képnek adj Caption "Welcome to the village" attribútumot, a 2. képnek MoveSeconds 2.5 és Caption "Find the bridge" attribútumot, a 3. képet pedig hagyd attribútumok nélkül.
  2. Nyomd meg a Play gombot (F5). Megjelennek a fekete sávok, a kamera az 1. képre vált a feliratával, 2,5 másodperc alatt a 2. képhez repül, aztán 3 másodperc alatt a felirat nélküli 3. képhez. Ezután a kamera visszatér a karakter háta mögé, és a játékoslista újra megjelenik. Amíg fut, nem lehet járni.
  3. Állítsd le a tesztet, nyomd meg újra a Play gombot, és nyomd meg a Skip gombot, miközben a kamera a 2. képhez repül. A kamera azonnal visszatér, és azonnal lehet járni.
  4. Sétálj bele a BridgeTriggerbe: lefut a Bridge átvezető jelenet. Menj át rajta még egyszer: semmi sem történik.
  5. Válaszd a Server & Clients lehetőséget a tesztmód legördülő listájában, állíts be 2 klienst, és nyomd meg a Play gombot. Amikor a Client 1 belép a triggerbe, a Bridge átvezető jelenet csak a Client 1-nél fut, a Client 2 pedig tud járni.
  6. Hagyd bekapcsolva a Workspace.StreamingEnabled opciót, és vigyél egy képet messze a megjelenési ponttól. Amikor a kamera odaér, a környezetnek a helyén kell lennie (valószínűleg, de nem garantáltan: lásd Streaming).
  7. Kontrollerhez állítsd le a tesztet, nyomd meg a Play gombot, nyisd meg a Controller Emulatort (Emulation fül, majd Controller), és sétálj bele a BridgeTriggerbe az emulált kontrollerrel: a Skipnek kiválasztva kell lennie, így az A átugorja az átvezető jelenetet. Ha a Studio Device Simulatorát használod (a 2026. október 15-i ellenőrzésünkkor ez béta volt: kapcsold be a File, Beta Features, New Device Simulator menüben, és indítsd újra a Studiót), válassz egy telefont, fordítsd vízszintesbe, és ellenőrizd, hogy a Skip nem csúszik a kamerakivágás alá, és könnyű eltalálni, a joystick és az ugrás gomb pedig rejtve van, amíg az átvezető jelenet fut.
  8. Ha főmenüt is készítettél, nyomd meg a Play gombot, aztán a menü Play gombját, és hagyd, hogy az intro végigfusson: utána a játékoslistának újra a képernyőn kell lennie.

Tartsd végig nyitva az Output ablakot (Window menü, majd Output). Amikor minden működik, ezek a scriptek semmit sem írnak ki, így a CutsceneService vagy a CutscenePlayer bármilyen figyelmeztetése vagy piros hibája valódi probléma. Lásd Gyakori hibák.

Hogyan bővítsd a rendszert

Intro csak a játékos első belépésekor

A seen táblázat egy szerver élettartamáig él, ezért az a játékos, aki újra belép, ismét látja az introt. Ha csak az első belépéskor akarod mutatni, ments egy jelzőt, például SeenIntro, a játékos többi adatával együtt a DataStore útmutató PlayerData moduljával. Hagyd az INTRO_CUTSCENE értéket úgy, ahogy van, és módosítsd a CutsceneService onCharacterAdded részének azt a darabját, amely az introért felel: várd meg, amíg a PlayerData.Get(player) visszaadja a játékos adatait, hagyd ki az introt, ha a data.SeenIntro értéke true, és a data.SeenIntro = true értéket csak akkor állítsd be, amikor a playOnce(player, INTRO_CUTSCENE) true értéket adott vissza. Ne az adatokat betöltő kódból indítsd az introt: az adatok előbb betöltődhetnek, mint ahogy a karakter megjelenik, karakter nélkül pedig a play semmit sem csinál, és a jelző egy olyan introhoz mentődik, amelyet senki sem látott.

Szereplők az átvezető jelenetben

Készíts animációt a Studio Animation Editorában vagy egy külső animációs pluginnal, például a Moon Animatorral, amelyet a Roblox dokumentációja is említ, és játszd le egy NPC rigen a képen, amikor odaér a kamera. A Roblox Animator dokumentációja szerint az NPC-k animációi csak akkor replikálódnak, ha a szerver tölti be és indítja el őket, ezért szerveroldali Scriptből játszd le, ha minden játékosnak látnia kell, ahogy az NPC játszik. Ha a CutscenePlayerben töltöd be és indítod el, az animáció nem replikálódik, ez pedig megfelel egy olyan átvezető jelenethez, amelyet csak egy játékos néz. Az animációs script útmutató megmutatja, hogyan játssz le animációt egy NPC-n szerveroldali Scriptből.

Párbeszédek

A feliratok rövid, maguktól haladó mondatokhoz valók. Olyan beszélgetéshez, ahol a játékos válaszol és lehetőségek közül választ, lásd az NPC párbeszéd útmutatót.

Intro a főmenü után

A főmenü útmutató kikapcsolja a CharacterAutoLoads opciót, így senki sem jelenik meg, amíg meg nem nyomja a Play gombot. A CutsceneService a játékos első megjelenésekor játssza le az introt, így a két rendszerrel együtt az intro a Play utáni első megjelenéskor fut. A menü visszakapcsolja a core GUI-t, amikor megjelenik a karakter, ez pedig történhet akkor is, amikor az intro már fut, ezért az intro alatt látszhat a játékoslista. A CutscenePlayer csak azt kapcsolja vissza, amit maga rejtett el, így a menü módosításához nem nyúl, és az intro után bekapcsolva maradnak. A főmenü útmutató Command Bar trükkje a kamera part beállításához ugyanaz, mint az 1. lépésben.

Körrepülés a pálya fölött a kör elején

Ha egy másik szerverscriptből szeretnél átvezető jelenetet indítani, például egy körrepülést a pálya fölött a kör elején a körrendszer útmutatóból, adj hozzá a ServerStorage-hez egy PlayCutscene nevű BindableEventet. A CutsceneService végén kapcsold az Event eseményét a play függvényhez, a körök scriptje pedig minden játékossal és az átvezető jelenet nevével hívja meg. A play kihagyja a "szerverenként egyszer" ellenőrzést, így a körrepülés minden körben lefut.

Átvezető jelenet pluginok

Pluginokat is használhatsz ezzel az útmutatóval együtt. Ha egy átvezető jelenet plugin saját kamerascriptet ír, ellenőrizd, hogy visszaadja-e a kamerát (CameraType Custom és CameraSubject), és beállítja-e a Focus értéket, amíg a kamera Scriptable, a döntést pedig arról, hogy ki látja az átvezető jelenetet, hagyd a szerverre, ahogy ebben az útmutatóban.

Gyakori hibák és megoldásaik

Nyisd meg az Output ablakot (Window menü, majd Output), mielőtt megnyomod a Play gombot. Az átvezető jelenetek problémáinak többsége vagy figyelmeztetést ír ki ott, vagy egy nem egyező névből adódik.

Infinite yield possible on 'Workspace:WaitForChild("Cutscenes")'

A CutsceneService egy Cutscenes nevű mappára vár közvetlenül a Workspace-ben. Hozd létre az 1. lépés szerint, és ellenőrizd az írásmódot és a nagy C-t. Amíg nincs meg, a CutsceneService nem hozza létre a CutsceneEventet, ezért a CutscenePlayer is vár.

Infinite yield possible on 'ReplicatedStorage:WaitForChild("CutsceneEvent")'

A CutscenePlayer arra a remote-ra vár, amelyet a CutsceneService hoz létre. Ellenőrizd, hogy a CutsceneService Script-e, nem LocalScript, közvetlenül a ServerScriptService-ben van-e, nincs-e kikapcsolva, és hogy az Outputban nincs-e tőle hiba vagy figyelmeztetés a Cutscenes mappáról.

CutsceneService: no folder named Intro in Workspace.Cutscenes

Az INTRO_CUTSCENE értékében vagy a trigger Cutscene attribútumában lévő név egyetlen Workspace.Cutscenes alatti mappáéval sem egyezik. A nevekben számít a kis- és nagybetű.

Semmi sem fut, és az Output üres

A mappában nincs 1 nevű part, vagy a partjai nem közvetlenül benne vannak (például egy Modelben). A CutsceneService sorban olvassa az 1, 2, 3 partokat, és az első hiányzó számnál megáll. És ne feledd, hogy minden átvezető jelenet játékosonként és szerverenként egyszer fut: állítsd le a tesztet, és nyomd meg újra a Play gombot.

A kamera rossz irányba néz

A kamera arra néz, amerre a kép part elülső lapja. Vidd a Studio kameráját a kívánt nézethez, és futtasd újra az 1. lépés Command Bar sorát ehhez a képhez.

A trigger semmit sem csinál

Ellenőrizd, hogy a trigger part közvetlenül a Workspace.CutsceneTriggers mappában van-e, amikor a játék elindul, hogy a CanTouch be van-e jelölve (különben figyelmeztetés lesz az Outputban), és hogy a Cutscene attribútuma egy Workspace.Cutscenes alatti mappa nevét tartalmazó string-e. Ha újra átmész a triggeren, semmi sem történik, ez így van tervezve.

Az átvezető jelenet után a kamera az utolsó képen marad

A CutscenePlayer hibával leállt, mielőtt visszaadta volna a kamerát, ezért keresd a piros hibáját az Outputban. A kamerát egy másik script is fogva tarthatja, amely folyamatosan Scriptable-re állítja a CameraType értéket, például egy menükamera, amely még mindig hozzá van kötve.

Elkészítés a RoCode-dal

Ha nincs kedved mindezt kézzel összerakni, a RoCode megcsinálhatja a nálad nyitott place-ben. A RoCode egy független AI-ügynök a Roblox Studióhoz, nem a Robloxtól: a webes chatben leírod a funkciót, a Studio pluginja pedig létrehozza a partot és a scripteket az Explorerben, így semmit sem kell kimásolnod a chatablakból.

Te írod

Adj hozzá egy bevezető átvezető jelenetet: egy Cutscenes mappát egy Intro mappával és 1-től 3-ig számozott képekkel, feliratokat a Caption attribútumból, fekete sávokat és egy Skip gombot, egyszer fusson a játékos első megjelenésekor, a szerver tartsa egy helyben a játékost, a végén pedig a kamera térjen vissza.

A RoCode elvégzi
  • Először átnézheti a place-edet a Search Scripts segítségével, például olyan menü- vagy kamerascriptet keresve, amely már beállítja a CameraType értéket, hogy ne ütközzenek
  • A Create Instance segítségével létrehozza a mappákat és a trigger partot, és beállítja a partokon az olyan attribútumokat, mint a Caption és a MoveSeconds
  • A Create Script segítségével megírja a CutsceneService és a CutscenePlayer scriptet
  • Utasítása szerint minden megírt scriptet ellenőriz a Check Scripttel, amely futtatás nélkül lefordítja a Studióban, és minden módosításcsomag előtt és után visszavonási pontot állít be

A kép partokat te helyezd el úgy, hogy a Studio kameráját minden nézethez odaviszed, és csak utána kérd a scripteket. 3.9-es vagy újabb pluginnal a RoCode rövid playtestet indíthat, és elolvashatja a hibákat, 3.9.11-es vagy újabb pluginnal pedig egy tesztkaraktert is irányíthat, hogy ellenőrizze, működik-e a játék, de játék közben nem készít képernyőképeket, ezért az átvezető jelenetet magadnak kell megnézned. Azt, hogy milyen sorrendben építs fel egy egész játékot, a hogyan készíts játékot Robloxban AI-val, rendszerről rendszerre oldalon találod. Hogyan csatlakozik a RoCode a Studióhoz.

Gyakori kérdések

Hogyan érhetem el, hogy az átvezető jelenet a játékba lépéskor fusson?

Nevezd el a képek mappáját Intro-nak a Workspace.Cutscenes alatt, vagy írd át az INTRO_CUTSCENE értéket a saját mappád nevére. A CutsceneService minden játékos első megjelenésekor lejátssza a szerveren. Ha csak a legelső belépéskor akarod mutatni, ments egy jelzőt egy data store-ba, és csak azután állítsd be, hogy az intro elindult, ahogy a Hogyan bővítsd a rendszert részben le van írva.

Készíthetek átvezető jelenetet pluginok nélkül?

Igen. Ebben az útmutatóban csak partok, attribútumok és két script van, a Command Bar sora pedig minden képet pontosan oda tesz, ahol a Studio kamerája áll. Az olyan pluginok, mint a Moon Animator, így is jól jönnek az átvezető jelenetben szereplő karakterek animálásához.

Miért nem mozog a kamera az átvezető jelenetben?

Általában azért, mert a kamerakód egy szerveroldali Scriptben van, a játékos kameráját viszont csak egy LocalScript mozgathatja, mert minden eszköznek saját kamerája van. A másik gyakori ok: a CameraType nem Scriptable, és a Roblox alap kamerascriptjei folyton visszaviszik a kamerát a karakterhez.

Hogyan akadályozhatom meg, hogy a játékos mozogjon az átvezető jelenet alatt?

Rögzítsd a HumanoidRootPartját a szerveren, amíg fut, utána pedig oldd fel, ahogy a CutsceneService teszi. Egy rögzített part soha nem mozdul el a fizikától. A WalkSpeedhez közben nem nyúlsz, így nem ütközik a sprint scripttel vagy a sebesség passzal.

Hogyan adhatok Skip gombot az átvezető jelenethez?

Tegyél egy TextButtont az átvezető jelenet képernyőjére, és kapcsold az Activated eseményét, amely kattintásra, koppintásra vagy a kontroller A gombjára sül el, amikor a gomb ki van választva. A CutscenePlayer Skip gombja egy jelzőt állít be, amelyet a képek ciklusa minden képkockában ellenőriz, a kontrolleres játékosoknál magától kiválasztódik, és saját ScreenGuiban van alapértelmezett margókkal, hogy a telefon kamerakivágása ne takarja el. A joystick és az ugrás gomb rejtve van, amíg az átvezető jelenet fut, így nincsenek mellette.

Miért üres a világ az átvezető jelenetben?

Bekapcsolt instance streaming mellett a játékos eszközén csak a karaktere közelében lévő terület van meg. A szerver hívja meg a player:RequestStreamAroundAsync függvényt minden képre nem sokkal azelőtt, hogy odaérne a kamera, ahogy a CutsceneService teszi. A Roblox azt írja, hogy így a terület valószínűleg, de nem biztosan töltődik be, ezért a fontos képeket tartsd a streaming sugarán belül, vagy használd a Player:AddReplicationFocus függvényt arra a területre, amelynek betöltve kell maradnia.

Források és további olvasnivaló

Hogyan ellenőriztük a kódot: az oldalon minden script átmegy a Luau szigorú típusellenőrzésén a Roblox API definícióival (luau-lsp, 2026. november 20.). A típusellenőrzés kiszűri az elírt API-neveket és a rossz típusokat, de a játéklogikai hibákat nem, ezért publikálás előtt mindent tesztelj a Studióban.

Próbáld ki a RoCode-ot a saját játékodban.

Ingyenes kreditek minden nap, bankkártya nélkül. Telepítsd a plugint, írd le a funkciót, és nézd meg, mi jelenik meg a Studióban.