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:Interpolateelavult. A Roblox dokumentációja szerint a kamerát TweenService-szel kell animálni.
Ezen az oldalon
Hogyan működik az átvezető jelenet
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:
- 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. - 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
CutsceneEventeseményt egy id-val és a képek listájával. - 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.
- 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
CutsceneEventeseményt. - 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.
| Elem | Hol található | Mit csinál |
|---|---|---|
Script CutsceneService | ServerScriptService | Eldö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 CutscenePlayer | StarterPlayer, StarterPlayerScripts | Lejá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 CutsceneEvent | ReplicatedStorage (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 Cutscenes | Workspace | Átvezető jelenetenként egy mappa, például Intro, 1, 2, 3 kép partokkal. |
Folder CutsceneTriggers | Workspace (nem kötelező) | Partok, amelyek elindítanak egy átvezető jelenetet, amikor a játékos megérinti őket. |
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.
- Az Explorerben vidd az egeret a Workspace fölé, kattints a + gombra, és szúrj be egy
Cutscenesnevű Foldert. Ebbe szúrj be egyIntronevű Foldert. A nevekben számít a kis- és nagybetű. - Vidd a Studio kameráját az első kívánt nézethez, mintha egy fotót komponálnál.
- Szúrj be egy Partot az Introba, és nevezd át
1-re. - 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 aCurrentCameraaz 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. - 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.
- 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.
| Attribútum | Típus | Alapértelmezés | Mit csinál |
|---|---|---|---|
MoveSeconds | number | 3 | Há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. |
HoldSeconds | number | 1 | Hány másodpercig áll a kamera ezen a képen, miután megérkezett. |
Caption | string | nincs | Szö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 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ás | Érték itt | Mit 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_SECONDS | 3 | Meddig tart a repülés, ha a képnek nincs MoveSeconds attribútuma. |
DEFAULT_HOLD_SECONDS | 1 | Meddig áll a kamera egy képen, ha annak nincs HoldSeconds attribútuma. |
MAX_SHOTS | 30 | A 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
readShotsminden 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
playsemmit 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.delayaz á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
seentá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. AplayOncecsak 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
- Az Explorerben nyisd ki a StarterPlayer mappát, vidd az egeret a StarterPlayerScripts fölé, és szúrj be egy
CutscenePlayernevű LocalScriptet. - Cseréld le a tartalmát az alábbi kódra.
-- 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.
| Rész | Mit csinál |
|---|---|
ScreenGui Cutscene | Ké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 CutsceneControls | Csak 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_GUIS | Elrejti 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. |
TouchControlsEnabled | Telefonon é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. |
updateCamera | Minden 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. |
waitOrSkip | Kivárja a repülés és a kép szünetének idejét, minden képkockában ellenőrizve a Skip jelzőt. |
play | Scriptable-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 gomb | Az 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.
- A Workspace, Cutscenes mappába szúrj be egy
Bridgenevű Foldert, és helyezd el a képeit az 1. lépés szerint,1és2néven. A Command Bar sorábaIntrohelyettBridge-et írj. - Vidd az egeret a Workspace fölé, és szúrj be egy
CutsceneTriggersnevű Foldert. - Szúrj bele egy
BridgeTriggernevű 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. - Adj neki egy string típusú
CutsceneattribútumotBridgeé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.
| EASING_STYLE | Milyen é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.Quad | Mint 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.
| Oktatóanyag | Probléma | Ez az útmutató |
|---|---|---|
A kamerát a camera:Interpolate() segítségével mozgatja | A 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ást | A 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át | A 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ítja | Semmi 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 ki | Bekapcsolt 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.
| A csaló megpróbálja | Eredmény |
|---|---|
| Átugrani az átvezető jelenetet, vagy egyáltalán le sem játszani | Megteheti: 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ényt | Csak 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ól | Lehetsé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 alatt | Nincs 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ásnak | Lehetetlen. 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
- 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épnekMoveSeconds2.5 ésCaption"Find the bridge" attribútumot, a 3. képet pedig hagyd attribútumok nélkül. - 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.
- Á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.
- Sétálj bele a BridgeTriggerbe: lefut a Bridge átvezető jelenet. Menj át rajta még egyszer: semmi sem történik.
- 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.
- Hagyd bekapcsolva a
Workspace.StreamingEnabledopció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). - 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.
- 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.
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.
- 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ó
- Roblox Creator Docs: Customize the camera (angolul). minden kliensnek saját Camera, Scriptable, CFrame és Focus
- Roblox Engine API: Camera (angolul). CameraType, CameraSubject, Focus minden képkockában és az elavult Interpolate
- Roblox Creator Docs: Control the user's camera (angolul). BindToRenderStep egy prioritási lépéssel a kamera után
- Roblox Engine API: TweenService:GetValue (angolul). simított alpha, 0 és 1 közé korlátozva
- Roblox Engine API: ScreenGui.ScreenInsets (angolul). miért csak olyan tartalomhoz None, amelyen nincs mit megnyomni
- Roblox Creator Docs: Instance streaming (angolul). az új place-ekben alapból bekapcsolva, és a replication focus
- Roblox Creator Docs: Streaming techniques (angolul). a terület előtöltése az esemény elküldése előtt
- Roblox Engine API: Player:RequestStreamAroundAsync (angolul). ideiglenes kérés garancia nélkül
- Roblox Creator Docs: Remote events and callbacks (angolul). az üzenetek sora, és milyen táblázatokat lehet küldeni
- Roblox Creator Docs: Network ownership, movement validation, and physics (angolul). mit tehet a kliens a saját karakterével, a Touched események hamisítását is beleértve
- Roblox Engine API: Animator:LoadAnimation (angolul). mely animációk replikálódnak
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.