Tutoriaali · Pelijärjestelmät

Miten tehdä välikohtaus Roblox Studiossa

Robloxin välikohtaus (cutscene) on kamera, joka ottaa ohjauksen muutamaksi sekunniksi: vaihtaa tai lentää pehmeästi kuvien välillä, näyttää tekstin ja palauttaa ohjauksen pelaajalle. Tässä oppaassa kokoamme välikohtauksen, jonka määrität sijoittamalla näkymättömiä partteja sinne, missä kameran pitää olla, ilman lisäosia. Palvelin päättää, milloin pelaaja näkee sen (ensimmäisellä syntymällä tai triggeriin koskiessa), ja pelaajan laite liikuttaa kameraa, näyttää mustat palkit ja Skip-painikkeen ja palauttaa kameran.

Päivitetty 20. marraskuuta 202617 min lukuaikaKirjoittaja:

Lyhyesti

Sijoita näkymättömiä ankkuroituja partteja nimiltään 1, 2, 3 kansioon Workspace.Cutscenes-kansion sisällä, kukin kasvot sinne, minne kameran pitää katsoa. Script ServerScriptServicessä lukee niiden CFramet, pitää pelaajan paikallaan ja lähettää kuvat tälle pelaajalle RemoteEventillä. LocalScript StarterPlayerScriptsissä asettaa workspace.CurrentCamera.CameraType-arvoksi Scriptable, liikuttaa kameraa joka ruudussa kuvasta toiseen (pehmentäen TweenService:GetValue-kutsulla) ja palauttaa sitten CameraType-arvoksi Custom ja CameraSubject-arvoksi pelaajan Humanoidin.

  • Kameraa voi ohjata vain pelaajan laite, joten kamerakoodi on LocalScript. Palvelin vain päättää, kuka näkee minkä välikohtauksen ja milloin.
  • Kun kamera on Scriptable, Roblox lakkaa päivittämästä Camera.Focus-arvoa. Ohjeessa käsketään päivittää Focus joka ruudussa, muuten dynaaminen valaistus kaukana vanhasta fokuksesta ei välttämättä piirry.
  • Camera:Interpolate on vanhentunut. Robloxin ohjeessa käsketään animoida kameraa TweenServicellä.
Tällä sivulla
  1. Miten se toimii
  2. 1. Kuvat
  3. 2. Palvelinskripti
  4. 3. LocalScript
  5. 4. Triggeri
  6. Kameran yksityiskohdat
  7. Vanhat tutoriaalit
  8. Suojaus huijauksilta
  9. 5. Testaus
  10. Laajentaminen
  11. Common errors
  12. RoCodella
  13. Usein kysytyt kysymykset
  14. Lähteet ja lisälukemista

Miten välikohtaus toimii

HavainnollistusKahden kuvan intro oikeassa nopeudessa: vaihto ensimmäiseen kuvaan, 1 sekunnin tauko, lento sillalle 2.5 sekunnissa, 1 sekunnin tauko, sitten kamera palaa pelaajalle.

Jokaisella pelaajan laitteella on oma Camera-objektinsa kohteessa workspace.CurrentCamera, joten pelaajan näkemää voi liikuttaa vain LocalScript. Se, kuka näkee minkä välikohtauksen ja milloin, on palvelimen tehtävä. Opas jakaa työn juuri näin. Yksi välikohtaus kulkee näin:

  1. Palvelin päättää, että pelaajan pitää nähdä välikohtaus: Intro ensimmäisellä syntymällä palvelimella tai toinen, kun hän koskee triggeripartia.
  2. CutsceneService lukee kuvapartien CFramet ja asetukset, pyytää Robloxia lataamaan tälle pelaajalle ensimmäisen kuvan alueen, ankkuroi pelaajan HumanoidRootPartin, jotta hän pysyy paikallaan, ja lähettää CutsceneEventin vain tälle pelaajalle id:n ja kuvaluettelon kanssa.
  3. Pelaajan laitteen CutscenePlayer näyttää mustat palkit ja Skip-painikkeen, piilottaa pelaajaluettelon, repun, terveyspalkin ja kosketusohjaimet, tekee kamerasta Scriptablen ja liikuttaa sitä joka ruudussa.
  4. Kun viimeinen kuva päättyy tai pelaaja painaa Skip, se palauttaa kameran hahmolle ja lähettää palvelimelle CutsceneEventin samalla id:llä.
  5. Palvelin poistaa pelaajan ankkuroinnin. Jos tätä viestiä ei koskaan tule, se poistaa ankkuroinnin silti, kun välikohtauksen pituus plus 2 sekuntia on kulunut. Ajastin käynnistyy, kun palvelin lähettää välikohtauksen, ja hitaassa liittymisessä laite voi aloittaa intron muutaman sekunnin myöhemmin, koska ReplicatedFirstin ulkopuolinen LocalScript ei käynnisty ennen kuin peli on latautunut. Silloin pelaaja voi liikkua taas ennen kuin intro päättyy hänen näytöllään.
Mistä välikohtausjärjestelmä koostuu
OsaMissä se onMitä se tekee
Script CutsceneServiceServerScriptServicePäättää, kuka näkee minkä välikohtauksen ja milloin, lukee kuvat, pitää pelaajan paikallaan ja muistaa, kuka on jo nähnyt mitä.
LocalScript CutscenePlayerStarterPlayer, StarterPlayerScriptsToistaa välikohtauksen pelaajan näytöllä: palkit, tekstit, Skip ja kameran liike. Lopuksi palauttaa kameran.
RemoteEvent CutsceneEventReplicatedStorage (CutsceneService luo sen)Kuljettaa kuvat palvelimelta yhdelle pelaajalle ja takaisin viestin "välikohtaus päättyi".
Folder CutscenesWorkspaceYksi kansio välikohtausta kohden, esimerkiksi Intro, jossa on kuvapartit 1, 2, 3.
Folder CutsceneTriggersWorkspace (valinnainen)Partit, jotka käynnistävät välikohtauksen, kun pelaaja koskee niihin.
Explorer, kun välikohtausjärjestelmä on valmis. Bridge- ja CutsceneTriggers-kansiot tulevat vaiheessa 4. Kun peli käynnistyy, CutsceneService lisää ReplicatedStorageen RemoteEventin nimeltä CutsceneEvent.
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

Vaihe 1: sijoita kamerakuvat

Jokainen kuva on näkymätön part. Kamera ottaa partin sijainnin ja katsoo samaan suuntaan kuin sen etupinta, joten kuvan sijoittaminen on kameran sijoittamista.

  1. Vie Explorerissa osoitin Workspacen päälle, paina +-painiketta ja lisää Folder nimeltä Cutscenes. Lisää sen sisään Folder nimeltä Intro. Nimien kirjainkoolla on väliä.
  2. Vie Studion kamera ensimmäiseen haluamaasi näkymään, kuin rajaisit valokuvaa.
  3. Lisää Part Introon ja nimeä se uudelleen 1.
  4. Avaa Command Bar (Script-välilehdellä tai Window ja sitten Script) ja aja workspace.Cutscenes.Intro["1"].CFrame = workspace.CurrentCamera.CFrame. Muokkaustilassa CurrentCamera on näkymä, jonka läpi katsot, joten part asettuu täsmälleen tähän kuvaan. Hakasulkeet ja lainausmerkit tarvitaan, koska numerolla alkavaa nimeä ei voi kirjoittaa pisteen jälkeen.
  5. Rastita partin Propertiesissä Anchored, poista CanCollide, CanTouch ja CanQuery ja aseta Transparency arvoon 1. Anchored estää sitä putoamasta kartan läpi; muut estävät sitä haittaamasta pelaajia, laukaisemasta kosketustapahtumia ja peittämästä raycasteja.
  6. Toista seuraaville näkymille nimeäen partit 2, 3 ja niin edelleen ja muuttaen numeroa Command Barin rivillä. CutsceneService toistaa kuvat numerojärjestyksessä ja pysähtyy ensimmäiseen puuttuvaan numeroon, joten aukko numeroinnissa katkaisee välikohtauksen ennen aikojaan.

Muuttaaksesi kuvaa myöhemmin vie kamera uuteen näkymään ja aja sama rivi kyseisen kuvan numerolla. Transparency 1:llä partit ovat näkymättömiä myös Studiossa, joten valitse ne Explorerista, kun tarvitset niitä.

Jokaisella kuvalla voi olla vielä kolme valinnaista attribuuttia. Lisätäksesi attribuutin valitse part, vieritä Properties-ikkunaa Attributes-osioon, paina +, kirjoita nimi, valitse tyyppi ja paina Save.

Valinnaiset attribuutit jokaisessa kuvapartissa
AttribuuttiTyyppiOletusMitä se tekee
MoveSecondsnumber3Montako sekuntia kamera lentää edellisestä kuvasta tähän. 0 tekee jyrkän vaihdon. Kuva 1 on aina vaihto, joten siinä attribuutti ei vaikuta.
HoldSecondsnumber1Montako sekuntia kamera pysyy tässä kuvassa saavuttuaan.
CaptionstringeiTeksti alapalkissa siitä hetkestä, kun kamera alkaa lentää tähän kuvaan. Kuva ilman Captionia tyhjentää tekstin.

Alle 0:n tai yli 60:n luku sekä väärän tyyppinen attribuutti korvataan oletusarvolla.

Vaihe 2: lisää palvelinskripti

Vie osoitin ServerScriptServicen päälle, lisää Script nimeltä CutsceneService ja liitä siihen alla oleva koodi. Yläosan asetukset ovat rivejä, joita voit muuttaa.

Script kohteessa ServerScriptService nimeltä CutsceneService
-- Script ServerScriptServicessä nimeltä CutsceneService.
-- Päättää, kuka näkee minkä välikohtauksen ja milloin. Lukee kamerakuvat numeroiduista
-- parteista kohteessa Workspace.Cutscenes, pitää pelaajan paikallaan ja käskee tämän
-- pelaajan laitetta toistamaan kuvat. Itse kameraa voi liikuttaa vain laitteella.

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

-- Asetukset
local INTRO_CUTSCENE = "Intro" -- toistuu kerran pelaajan ensimmäisellä syntymällä; "" poistaa käytöstä
local DEFAULT_MOVE_SECONDS = 3 -- lentoaika kuvaan, jos sillä ei ole MoveSecondsia
local DEFAULT_HOLD_SECONDS = 1 -- aika kuvassa, jos sillä ei ole HoldSecondsia
local MAX_SHOTS = 30

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

-- Tämä skripti luo CutsceneEventin itse, joten älä lisää sitä käsin
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 } = {} -- sen välikohtauksen id, jota pelaaja katsoo
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

-- Kuvat ovat partit 1, 2, 3 ... välikohtauksen nimisessä kansiossa
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,
			-- ensimmäinen kuva on vaihto, joten kamera hyppää siihen heti
			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 -- tämä välikohtaus on jo päättynyt
	end
	playing[player] = nil
	setFrozen(player, false)
end

local function play(player: Player, name: string): boolean
	if playing[player] then
		return false -- yksi välikohtaus kerrallaan
	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

	-- Kun instance streaming on päällä, pelaajan laitteella ei välttämättä ole aluetta,
	-- johon kuva katsoo, ja pyyntö lataa alueen vain hetkeksi. Ladataan ensimmäisen
	-- kuvan alue nyt (odotetaan enintään 2 sekuntia) ja jokaisen seuraavan alue
	-- 2 sekuntia ennen kuin kamera lentää siihen.
	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 -- pelaaja poistui alueen latautuessa
	end

	setFrozen(player, true)
	cutsceneEvent:FireClient(player, id, shots)
	local startsAt = 0 -- sekuntia nykyhetkestä tämän kuvan lennon alkuun
	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
	-- Varmistus: vapautetaan pelaaja, vaikka hänen laitteensa ei koskaan vastaisi
	task.delay(startsAt + 2, finish, player, id)
	return true
end

-- Palauttaa true vain, jos välikohtaus käynnistyi tälle pelaajalle
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

-- Pelaajan laite ilmoittaa, että välikohtaus päättyi tai ohitettiin
cutsceneEvent.OnServerEvent:Connect(function(player: Player, id: unknown)
	if typeof(id) == "number" then
		finish(player, id)
	end
end)

-- Triggeripartit: kosketus käynnistää välikohtauksen niiden Cutscene-attribuutista
if triggers then
	for _, trigger in triggers:GetChildren() do
		if not trigger:IsA("BasePart") then
			continue
		end
		if not trigger.CanTouch then
			-- Touchedin kytkeminen partiin, jonka CanTouch on pois, antaa virheen, joten vain varoitetaan
			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) -- uudelleensyntyminen välikohtauksen aikana, pidetään uusikin hahmo paikallaan
	elseif INTRO_CUTSCENE ~= "" then
		playOnce(player, INTRO_CUTSCENE)
	end
end

local function onPlayerAdded(player: Player)
	if seen[player] then
		return -- jo määritetty
	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 -- kaikki, jotka liittyivät skriptin odottaessa Cutscenesia
	onPlayerAdded(player)
end

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

CutsceneService luo RemoteEventin CutsceneEvent itse heti, kun Workspace.Cutscenes ilmestyy, joten ReplicatedStorageen ei tarvitse lisätä mitään käsin. Jos olet jo tehnyt samannimisen RemoteEventin, poista se: LocalScript voi löytää sinun versiosi, eikä kukaan kuuntele sitä palvelimella.

Asetukset CutsceneServicen yläosassa
AsetusArvo tässäMitä se muuttaa
INTRO_CUTSCENE"Intro"Workspace.Cutscenesin kansio, joka toistuu pelaajan ensimmäisellä syntymällä palvelimella. Aseta "", jos introa ei haluta.
DEFAULT_MOVE_SECONDS3Kuinka kauan lento kestää, jos kuvalla ei ole MoveSeconds-attribuuttia.
DEFAULT_HOLD_SECONDS1Kuinka kauan kamera pysyy kuvassa, jos sillä ei ole HoldSeconds-attribuuttia.
MAX_SHOTS30Suurin kuvanumero, jota CutsceneService etsii yhdestä välikohtauksesta.

Mitä skriptin loppuosa tekee, järjestyksessä:

  • Lukee kuvat palvelimella. readShots kokoaa jokaisen numeroidun partin CFramen ja attribuutit luetteloksi. Pelaajan laite saa tämän luettelon, joten se ei tarvitse itse partteja.
  • Yksi välikohtaus kerrallaan. play ei tee mitään, jos pelaaja jo katsoo välikohtausta tai jos hänen hahmollaan ei ole Humanoidia tai se on kuollut.
  • Jokaisella välikohtauksella on oma id. Laite lähettää id:n takaisin, kun välikohtaus päättyy tai ohitetaan, ja vain täsmäävä id vapauttaa pelaajan, joten edellisen välikohtauksen myöhästynyt viesti ei voi päättää uutta.
  • Pitää pelaajan paikallaan ankkuroimalla hänen HumanoidRootPartinsa, ja ankkuroi uuden hahmon, jos pelaaja syntyy uudelleen kesken välikohtauksen. Robloxin ohjeen mukaan ankkuroitu part ei koskaan muuta sijaintiaan painovoiman, törmäysten tai muun fysiikan vuoksi. WalkSpeediin ei kosketa, joten tämä ei ole ristiriidassa juoksuskriptin tai nopeuspassin kanssa. Lopuksi skripti poistaa root partin ankkuroinnin, vaikka sen olisi ankkuroinut toinen skripti, joten älä ankkuroi hahmoja muualla, kun välikohtaus voi olla käynnissä.
  • Varmistus. task.delay vapauttaa pelaajan välikohtauksen koko pituuden plus 2 sekunnin jälkeen, vaikka hänen laitteensa ei koskaan vastaisi.
  • Jokainen välikohtaus kerran palvelinta kohden. seen-taulukko muistaa jokaisen pelaajan kohdalla, mitkä välikohtaukset ovat jo alkaneet, joten intro ei toistu uudelleensyntymässä ja triggerin välikohtaus toistuu kerran. playOnce palauttaa true vain, jos välikohtaus todella käynnistyi.
  • Määrittää jokaisen pelaajan. Lopun silmukka Players:GetPlayers()-luettelon yli ottaa mukaan kaikki, jotka liittyivät skriptin odottaessa Cutscenes-kansiota.

Kuvat lähtevät pelaajalle yhdellä FireClient-kutsulla pienten taulukoiden luettelona. Robloxin remote events -sivulla kehotetaan olemaan lähettämättä taulukkoa, jossa on sekaisin numero- ja merkkijonoavaimia; tässä luettelossa on vain numeroavaimia, ja jokaisessa sen sisäisessä kuvassa vain merkkijonoavaimia, mikä on siellä suositeltu muoto.

Vaihe 3: lisää LocalScript, joka toistaa sen

  1. Avaa Explorerissa StarterPlayer, vie osoitin kohdan StarterPlayerScripts päälle ja lisää LocalScript nimeltä CutscenePlayer.
  2. Korvaa sen sisältö alla olevalla koodilla.
LocalScript kohteessa StarterPlayerScripts nimeltä CutscenePlayer
-- LocalScript kohteessa StarterPlayer > StarterPlayerScripts nimeltä CutscenePlayer.
-- Toistaa välikohtauksen, jonka palvelin lähettää: mustat palkit, tekstit, Skip-painike ja
-- kuvasta toiseen lentävä kamera. Palauttaa sitten kameran pelaajalle.

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 -- kumpikin musta palkki osuutena näytön korkeudesta
local EASING_STYLE = Enum.EasingStyle.Sine
local FOCUS_DISTANCE = 30 -- montako studia kameran edessä Robloxin pitää piirtää tarkimmin
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 }

-- Välikohtauksen näkymä: kaksi mustaa palkkia ja teksti reunasta reunaan. Roblox neuvoo
-- asettamaan ScreenInsets Nonen vain sille, mitä kukaan ei paina, joten alla Skipillä on oma ScreenGui.
local gui = Instance.new("ScreenGui")
gui.Name = "Cutscene"
gui.ResetOnSpawn = false
gui.ScreenInsets = Enum.ScreenInsets.None -- koko näytölle
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

-- Skip-painikkeella on oletusreunukset, joten kameran lovi ei peitä sitä
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) -- alapalkissa, oikealla
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

-- Skip pysyy tarpeeksi isona, jotta siihen osuu pienelläkin puhelimella
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

-- Nykyinen lento: kameran CFramesta seuraavaan annetussa sekuntimäärässä
local moveFrom = CFrame.identity
local moveTo = CFrame.identity
local moveStart = 0
local moveSeconds = 0
local skipRequested = false
local busy = false

-- Toimii joka ruudussa välikohtauksen aikana. Scriptable-kameran Focus ei itse seuraa
-- mitään, joten sekin asetetaan tässä.
local function updateCamera()
	if camera.CameraType ~= Enum.CameraType.Scriptable then
		camera.CameraType = Enum.CameraType.Scriptable -- jokin nollasi sen, esimerkiksi uudelleensyntyminen
	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
		-- Yksi toistuu jo, joten anna palvelimen vapauttaa pelaaja heti tämän osalta
		cutsceneEvent:FireServer(id)
		return
	end
	busy = true
	skipRequested = false

	-- Piilotetaan pelaajaluettelo, reppu ja terveyspalkki muistaen, mikä oli näkyvissä
	local wasEnabled: { [Enum.CoreGuiType]: boolean } = {}
	for _, coreGui in HIDDEN_CORE_GUIS do
		wasEnabled[coreGui] = StarterGui:GetCoreGuiEnabled(coreGui)
		StarterGui:SetCoreGuiEnabled(coreGui, false)
	end
	-- Puhelimissa piilotetaan alakulmissa olevat tikku ja hyppypainike
	local touchControlsWere = GuiService.TouchControlsEnabled
	GuiService.TouchControlsEnabled = false
	gui.Enabled = true
	controls.Enabled = true
	-- Peliohjain voi painaa vain valittua painiketta, joten peliohjaimen pelaajille valitaan Skip
	if UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
		GuiService.SelectedObject = skipButton
	end
	camera = workspace.CurrentCamera
	camera.CameraType = Enum.CameraType.Scriptable
	moveTo = camera.CFrame
	-- Yksi askel Robloxin oman kamerapäivityksen jälkeen, kuten Robloxin kameratutoriaalissa
	RunService:BindToRenderStep("Cutscene", Enum.RenderPriority.Camera.Value + 1, updateCamera)

	for _, shot in shots do
		moveFrom = camera.CFrame -- jokainen lento alkaa siitä, missä kamera nyt on
		moveTo = shot.cframe
		moveStart = os.clock()
		moveSeconds = shot.move
		caption.Text = shot.caption
		waitOrSkip(shot.move + shot.hold)
		if skipRequested then
			break
		end
	end

	-- Palautetaan kamera pelaajan hahmolle
	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 = ""
	-- Otetaan takaisin käyttöön vain se, minkä tämä välikohtaus poisti, muuhun ei kosketa
	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) -- palvelin vapauttaa pelaajan heti
	busy = false
end

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

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

StarterPlayerScriptsin LocalScript kopioidaan pelaajalle kerran, liittymisen yhteydessä, ja se jatkaa toimintaansa hahmon uudelleensyntymisen jälkeen. Siksi molempien ScreenGuiden ResetOnSpawn on pois päältä: jos se olisi päällä, Roblox poistaisi ne ensimmäisessä uudelleensyntymisessä, eikä tämä skripti loisi niitä uudelleen. Remoten viestit, jotka saapuvat ennen kuin skripti kytkeytyy OnClientEvent-tapahtumaan, laitetaan jonoon ja toimitetaan kytkennän jälkeen, joten nopeasti syntynyt pelaaja näkee silti intron.

Mitä CutscenePlayerin kukin osa tekee
OsaMitä se tekee
ScreenGui CutsceneKaksi mustaa palkkia, kumpikin 12 % näytön korkeudesta (BAR_HEIGHT), ja teksti alapalkissa. ScreenInsets None venyttää palkit näytön reunoihin asti, ja DisplayOrder 10 piirtää ne pienemmän DisplayOrderin ScreenGuiden päälle.
ScreenGui CutsceneControlsSiinä on vain Skip-painike oikealla alapalkissa UISizeConstraintilla, joka pitää sen vähintään 64 x 32 pikselin kokoisena, jotta siihen on helppo osua puhelimella. Sillä on oletusarvoinen ScreenInsets, eikä sisältö mene Robloxin yläpalkin painikkeiden ja kameran lovien alle. Roblox neuvoo Nonea vain sisällölle, jossa ei ole painettavaa, joten Skip ei voi olla palkkien ScreenGuissa.
HIDDEN_CORE_GUISPiilottaa pelaajaluettelon, repun ja terveyspalkin SetCoreGuiEnabled-kutsulla, muistettuaan ensin GetCoreGuiEnabled-kutsulla, mitkä olivat päällä, ja ottaa lopuksi takaisin käyttöön vain ne, jotka se itse poisti. Jos peli piilottaa repun muualla, se pysyy piilotettuna, eikä mikään ohita skriptiä, joka ottaa ne käyttöön välikohtauksen aikana, kuten päävalikkoa.
TouchControlsEnabledPuhelimissa ja tableteissa play asettaa GuiService.TouchControlsEnabled-arvoksi false välikohtauksen ajaksi. Tämä piilottaa alakulmissa, samassa paikassa kuin Skip, olevat tikun ja hyppypainikkeen, ja lopuksi ne palaavat, jos ne olivat päällä.
updateCameraToimii joka ruudussa välikohtauksen aikana. Laskee, mikä osa nykyisestä lennosta on kuljettu, pehmentää sen TweenService:GetValue-kutsulla, asettaa kameran kahden kuvan väliin CFrame:Lerp-kutsulla ja asettaa Focusin 30 studin päähän kameran eteen.
waitOrSkipOdottaa lennon ja kuvan tauon ajan tarkistaen Skip-lipun joka ruudussa.
playTekee kamerasta Scriptablen, toistaa kuvat järjestyksessä, palauttaa sitten kameran (CameraType Custom, CameraSubject on Humanoid), ottaa core GUI:n ja kosketusohjaimet takaisin käyttöön ja lähettää palvelimelle välikohtauksen id:n. Jos toinen välikohtaus saapuu ensimmäisen vielä toistuessa, se lähettää sen id:n heti takaisin, jottei palvelin pidä pelaajaa paikallaan välikohtauksen vuoksi, jota tämä laite ei näyttänyt.
Skip-painikeActivated laukeaa hiiren klikkauksesta, napautuksesta tai peliohjaimen A-painikkeesta, kun painike on valittu. Pelaajalle, jonka pääsyöte on peliohjain, play valitsee Skipin välikohtauksen alussa ja poistaa valinnan lopussa.

Muuta BAR_HEIGHT-arvoa tehdäksesi palkeista ohuempia tai paksumpia ja EASING_STYLE-arvoa muuttaaksesi lentojen tuntumaa (katso Mitä kamerakoodi tekee oikein). Tekstissä ja Skip-painikkeessa on TextScaled päällä, joten teksti kasvaa ja pienenee näytön mukana.

Vaihe 4: välikohtaus partin kosketuksesta

Intro toistuu itsestään. Välikohtaukseen tietyssä paikassa kartalla, esimerkiksi kun pelaaja ensimmäisen kerran saapuu sillalle, lisää toinen välikohtaus ja triggeripart.

  1. Lisää Workspace, Cutscenes -kohtaan Folder nimeltä Bridge ja sijoita sen kuvat kuten vaiheessa 1, nimillä 1 ja 2. Kirjoita Command Barin rivillä Bridge eikä Intro.
  2. Vie osoitin Workspacen päälle ja lisää Folder nimeltä CutsceneTriggers.
  3. Lisää siihen Part nimeltä BridgeTrigger. Tee siitä niin iso, etteivät pelaajat voi kulkea ohi koskematta siihen, esimerkiksi korkea ja leveä laatta tien poikki. Rastita Anchored, poista CanCollide ja CanQuery, jätä CanTouch rastitetuksi ja aseta Transparency arvoon 1. Pois päältä oleva CanQuery estää näkymätöntä laattaa peittämästä raycasteja, kuten aseoppaan laukauksia. Kosketustapahtumia ohjataan CanTouchilla eikä CanQuerylla, joten triggeri toimii silti.
  4. Lisää sille string-tyyppinen attribuutti Cutscene ja anna arvoksi Bridge: toistettavan kansion nimi.

CutsceneService kytkee Touched-tapahtuman jokaiseen suoraan CutsceneTriggersin sisällä olevaan partiin palvelimen käynnistyessä, joten lisää triggerit Studiossa äläkä skriptillä pelin aikana. Triggeri, jonka CanTouch on pois päältä, ohitetaan varoituksella Outputissa, koska Roblox antaa virheen, kun skripti kytkee Touchedin tällaiseen partiin.

Kun hahmo kävelee partin läpi, Touched laukeaa monta kertaa peräkkäin. seen-taulukko ja sääntö "yksi välikohtaus kerrallaan" tekevät tästä yhden välikohtauksen pelaajaa kohden palvelimella. Pelaaja, joka koskee triggeriin toisen välikohtauksen aikana, ohitetaan, ja triggeri pysyy hänelle valmiina.

Älä sijoita triggereitä teille. Istuvan pelaajan HumanoidRootPart on hitsattu istuimeen, ja kun hitsatun ryhmän yksi part ankkuroidaan, Roblox ankkuroi myös muut sen mukana. Siksi triggeriin ajava pelaaja pitää koko ajoneuvonsa matkustajineen paikallaan, kunnes välikohtaus päättyy.

Mitä kamerakoodi tekee oikein

Scriptable, sitten takaisin Custom

Robloxin kameraskriptit eivät liikuta eivätkä päivitä kameraa, kun CameraType on Scriptable, ja juuri tämä antaa CutscenePlayerin asettaa sen. Lopuksi se palauttaa CameraType-arvoksi Customin ja tekee pelaajan Humanoidista CameraSubjectin, jota Robloxin kameraskriptit seuraavat oletuksena. Tämä suoritetaan myös Skipin jälkeen, joten pelaaja ei koskaan jää katsomaan viimeistä kuvaa.

Kaksi pientä tarkistusta pitää välikohtauksen hallinnassa sen toistuessa. Jos jokin asettaa CameraType-arvon toiseksi kesken välikohtauksen, joka ruudussa toimiva funktio palauttaa seuraavassa ruudussa Scriptablen. Ja workspace.CurrentCamera luetaan uudelleen jokaisen välikohtauksen alussa, koska Roblox luo uuden Cameran, jos nykyinen joskus poistetaan.

Focus joka ruudussa

Camera.Focus kertoo moottorille, mille alueelle antaa etusija esimerkiksi valaistustyössä. Robloxin kameraskriptit pitävät sen CameraSubjectissa, mutta eivät silloin, kun kamera on Scriptable, ja Robloxin ohjeessa käsketään tällöin päivittämään se joka ruudussa: PointLightin kaltaisten objektien dynaaminen valo ei välttämättä piirry kaukana fokuksesta. CutscenePlayer asettaa sen 30 studin päähän kameran eteen (FOCUS_DISTANCE). Kasvata tätä lukua, jos kuvasi katsovat jotain kauempana olevaa.

Funktio toimii RunService:BindToRenderStep-kutsulla joka ruudussa ennen piirtämistä, yhden prioriteettiaskeleen Robloxin oman kamerapäivityksen jälkeen (Enum.RenderPriority.Camera.Value + 1). Tätä prioriteettia käyttää Robloxin kameratutoriaali, joten välikohtaus asettaa kameran sen jälkeen, kun Robloxin oma kamerakoodi on suoritettu.

Pehmennys TweenService:GetValuella

Tween camera.CFrame-arvoon liikuttaisi kameraa, mutta Focus pitää silti asettaa joka ruudussa, joten CutscenePlayer liikuttaa kameraa itse samassa funktiossa. Jokaiselle lennolle se laskee, mikä osuus ajasta on kulunut (0-1), ajaa sen TweenService:GetValue-kutsun läpi pehmennystyylillä ja -suunnalla ja asettaa kameran tähän osuuteen kahden kuvan välisestä matkasta CFrame:Lerp-kutsulla, joka liikuttaa sijaintia suoraan ja kääntää pehmeästi. GetValue rajaa syötteen välille 0-1, joten kamera pysähtyy täsmälleen kuvaan, kun lentoaika päättyy.

Kameran lentoon sopivat pehmennystyylit
EASING_STYLEMiltä lento tuntuu
Enum.EasingStyle.Sine (tässä)Nopeus seuraa sinikäyrää, pehmeä alku ja pehmeä pysähdys.
Enum.EasingStyle.QuadKuten Sine, mutta käyrä on hieman jyrkempi.
Enum.EasingStyle.LinearTasainen nopeus, joten jokainen lento alkaa ja päättyy täydellä nopeudella.

Suunta InOut: pehmennys käytetään eteenpäin lennon ensimmäisellä puoliskolla ja käänteisenä toisella, joten kamera kiihtyy yhdestä kuvasta ja hidastuu seuraavaan.

Streaming

Uusissa paikoissa instance streaming on päällä: oletuksena pelaajan laite pitää hahmon ympärillä olevaa aluetta, joten kuva, joka katsoo kartan toiseen reunaan, voi näyttää tyhjän maailman. CutsceneService pyytää Robloxia lataamaan tälle pelaajalle jokaisen kuvan alueen Player:RequestStreamAroundAsync-kutsulla: ensimmäisen kuvan alueen ennen tapahtuman lähettämistä, enintään 2 sekunnin odotuksella, ja jokaisen seuraavan 2 sekuntia ennen kuin kamera lentää siihen.

Robloxin mukaan alue näin todennäköisesti, mutta ei varmasti, latautuu, ja vaikutus on väliaikainen. Pidä tärkeät kuvat streaming-säteen sisällä tai käytä palvelimella Player:AddReplicationFocus-kutsua alueelle, jonka pitää pysyä ladattuna, kunnes poistat fokuksen. Kun streaming on pois päältä, laitteella on joka tapauksessa koko kartta, ja jokaisen pyynnön ympärillä oleva pcall tarkoittaa, ettei epäonnistunut pyyntö voi pysäyttää välikohtausta.

Mikä vanhoissa välikohtaustutoriaaleissa on vialla

Jos vertaat tätä opasta videoon tai foorumiviestiin, tässä ovat tärkeät erot ja miksi kukin kikka on ongelma.

Yleiset kikat välikohtaustutoriaaleissa ja mitä tämä opas tekee niiden sijaan
TutoriaaliOngelmaTämä opas
Liikuttaa kameraa camera:Interpolate()-kutsullaRoblox on merkinnyt Interpolaten vanhentuneeksi ja neuvoo animoimaan kameraa TweenServicellä.Pehmentää jokaisen lennon TweenService:GetValue-kutsulla ja asettaa kameran joka ruudussa.
Tweenaa camera.CFrame-arvoa eikä mitään muutaFocus jää sinne, mihin kameraskriptit sen jättivät, hahmon lähelle, joten dynaaminen valo kaukana siitä ei välttämättä piirry (Robloxin Camera.Focus-ohje).Asettaa Focusin joka ruudussa render stepissä.
Ei palauta kameraaPelaaja jää jumiin katsomaan viimeistä kuvaa.Asettaa lopuksi CameraType-arvoksi Customin ja CameraSubject-arvoksi Humanoidin, myös Skipin jälkeen.
Käynnistää välikohtauksen LocalScriptin Touched-tapahtumastaMikään ei estä sitä toistumasta jokaisella kosketuksella, ja päätös tehdään laitteella, jota pelaaja hallitsee.Palvelin valitsee pelaajan ja muistaa, kuka on jo nähnyt sen.
Lukee kamerapartit asiakkaallaKun streaming on päällä, kaukana hahmosta olevia partteja ei välttämättä vielä ole laitteella.Palvelin lukee partit, lähettää niiden CFramet ja pyytää jokaisen kuvan alueen vähän ennen kuin kamera lentää sinne.

Mitä pelaaja voi ja ei voi muuttaa

Oleta, että huijari hallitsee kaikkea laitteellaan: hän voi muuttaa tai poistaa CutscenePlayerin ja lähettää CutsceneEventin millä tahansa arvolla. Välikohtauksen kannalta tällä ei ole juuri merkitystä, jos siitä ei riipu mitään todellista.

Mitä huijari voi yrittää ja mitä siitä seuraa
Huijari yrittääTulos
Ohittaa välikohtauksen tai jättää sen kokonaan toistamattaOnnistuu: se on hänen oma näyttönsä. Älä koskaan anna palkintoa "katsoi välikohtauksen loppuun".
Lähettää CutsceneEventin millä tahansa arvollaVain hänen nykyiseen välikohtaukseensa täsmäävä luku tekee mitään, ja ainoa, mitä se tekee, on vapauttaa hänet aiemmin.
Koskea triggeriin mistä tahansa kartallaMahdollista: jokainen laite ohjaa omaa hahmoaan, ja Robloxin turvallisuusdokumentaatio mainitsee Touched-tapahtumien väärentämisen sen kykyjen joukossa. Hän näkee tämän välikohtauksen kerran, eikä mitään muuta tapahdu.
Liikkua silti välikohtauksen aikanaEi ole mitään voitettavaa. Jäädytys estää rehellisiä pelaajia lähtemästä kesken välikohtauksen; se ei ole turvallisuustarkistus.
Käynnistää remotella välikohtauksen jollekulle toiselleMahdotonta. Vain palvelin voi lähettää CutsceneEventin pelaajalle, ja ainoa, mitä laite voi lähettää takaisin, on "tämä välikohtaus päättyi".

Jos välikohtaus johtaa johonkin todelliseen, kuten oveen, joka sitten aukeaa, tai pomon ilmestymiseen, anna palvelimen tehdä se oman ajastimensa mukaan eikä silloin, kun laite ilmoittaa välikohtauksen päättyneen.

Vaihe 5: testaa

  1. Sijoita Intron kolme kuvaa Command Barin rivillä. Anna kuvalle 1 Caption "Welcome to the village", kuvalle 2 MoveSeconds 2.5 ja Caption "Find the bridge", ja jätä kuva 3 ilman attribuutteja.
  2. Paina Play (F5). Mustat palkit ilmestyvät, kamera vaihtaa kuvaan 1 tekstineen, lentää 2.5 sekunnissa kuvaan 2 ja sitten 3 sekunnissa kuvaan 3 ilman tekstiä. Sitten kamera palaa hahmon taakse, ja pelaajaluettelo ilmestyy uudelleen. Toiston aikana ei voi kävellä.
  3. Pysäytä testi, paina taas Play ja paina Skip, kun kamera lentää kuvaan 2. Kamera palaa heti, ja voit kävellä heti.
  4. Kävele BridgeTriggeriin: Bridge-välikohtaus toistuu. Kulje sen läpi uudelleen: mitään ei tapahdu.
  5. Valitse testitilan pudotusvalikosta Server & Clients, aseta 2 asiakasta ja paina Play. Kun Client 1 kävelee triggeriin, Bridge-välikohtaus toistuu vain Client 1:llä, ja Client 2 voi kävellä.
  6. Jätä Workspace.StreamingEnabled päälle ja siirrä yksi kuva kauas syntypaikasta. Kun kamera saapuu, ympäristön pitäisi olla paikallaan (todennäköisesti, mutta ei taatusti: katso Streaming).
  7. Peliohjainta varten pysäytä testi, paina Play, avaa Controller Emulator (Emulation-välilehti, sitten Controller) ja kävele BridgeTriggeriin emuloidulla peliohjaimella: Skipin pitäisi olla valittuna, joten A ohittaa välikohtauksen. Jos käytät Studion Device Simulatoria (tarkistushetkellämme 15. lokakuuta 2026 se on beta: ota se käyttöön kohdassa File, Beta Features, New Device Simulator ja käynnistä Studio uudelleen), valitse puhelin, käännä se vaakatasoon ja tarkista, ettei Skip mene kameran loven alle ja että siihen on helppo osua, ja että tikku ja hyppypainike ovat piilossa välikohtauksen aikana.
  8. Jos teit myös päävalikon, paina Play, sitten valikon Play-painiketta ja anna intron toistua loppuun: sen jälkeen pelaajaluettelon pitäisi olla taas näytöllä.

Pidä Output-ikkuna auki (Window-valikko, sitten Output) koko ajan. Kun kaikki toimii, nämä skriptit eivät kirjoita mitään, joten mikä tahansa CutsceneServicen tai CutscenePlayerin varoitus tai punainen virhe on todellinen ongelma. Katso Yleiset virheet.

Miten järjestelmää laajennetaan

Intro vain pelaajan ensimmäisellä käynnillä

seen-taulukko elää yhden palvelimen ajan, joten uudelleen liittyvä pelaaja näkee intron taas. Näyttääksesi sen vain ensimmäisellä käynnillä tallenna lippu, esimerkiksi SeenIntro, muiden pelaajatietojen kanssa DataStore-tutoriaalin PlayerData-moduulilla. Jätä INTRO_CUTSCENE ennalleen ja muuta CutsceneServicen onCharacterAdded-funktion introa käsittelevää osaa: odota, kunnes PlayerData.Get(player) palauttaa pelaajan tiedot, ohita intro, jos data.SeenIntro on true, ja aseta data.SeenIntro = true vain, kun playOnce(player, INTRO_CUTSCENE) palautti true. Älä käynnistä introa tietoja lataavasta koodista: tiedot voivat latautua ennen kuin hahmo syntyy, ja ilman hahmoa play ei tee mitään, jolloin lippu tallentuisi introsta, jota kukaan ei nähnyt.

Välikohtauksessa näyttelevät hahmot

Tee animaatio Studion Animation Editorissa tai kolmannen osapuolen animaatiolisäosassa, kuten Robloxin dokumentaatiossa mainitussa Moon Animatorissa, ja toista se NPC:n rigillä kuvassa, kun kamera saapuu sinne. Robloxin Animator-ohjeen mukaan NPC:iden animaatiot replikoituvat vain, jos palvelin lataa ja käynnistää ne, joten toista se palvelimen Scriptistä, jos kaikkien pelaajien pitää nähdä NPC:n näyttelevän. Jos lataat ja käynnistät sen CutscenePlayerissä, animaatio ei replikoidu, mikä sopii välikohtaukseen, jota vain yksi pelaaja katsoo. Animaatioskriptioppaassa näytetään, miten animaatio toistetaan NPC:llä palvelimen Scriptistä.

Dialogit

Tekstit sopivat lyhyisiin repliikkeihin, jotka etenevät itsestään. Keskusteluun, jossa pelaaja vastaa ja valitsee vaihtoehtoja, katso NPC-dialogiopas.

Intro päävalikon jälkeen

Päävalikko-opas poistaa käytöstä CharacterAutoLoadsin, joten kukaan ei synny ennen kuin painaa Play. CutsceneService toistaa intron pelaajan ensimmäisellä syntymällä, joten molempien järjestelmien kanssa intro toistuu ensimmäisellä syntymällä Playn jälkeen. Valikko ottaa core GUI:n takaisin käyttöön hahmon ilmestyessä, mikä voi tapahtua intron jo toistuessa, joten intron aikana pelaajaluettelo voi näkyä. CutscenePlayer ottaa takaisin käyttöön vain sen, minkä se itse piilotti, joten se ei koske valikon muutokseen, ja ne pysyvät päällä intron jälkeen. Päävalikko-oppaan Command Bar -kikka kamerapartin suuntaamiseen on sama kuin vaiheessa 1.

Kartan ylilento kierroksen alussa

Käynnistääksesi välikohtauksen toisesta palvelinskriptistä, esimerkiksi kartan ylilennon kierroksen alussa kierrosjärjestelmäoppaasta, lisää ServerStorageen BindableEvent nimeltä PlayCutscene. Kytke CutsceneServicen lopussa sen Event play-funktioon, ja anna kierrosskriptin kutsua sitä jokaisella pelaajalla ja välikohtauksen nimellä. play ohittaa "kerran palvelinta kohden" -tarkistuksen, joten ylilento toistuu joka kierroksella.

Välikohtauslisäosat

Lisäosia voi käyttää tämän oppaan rinnalla. Jos välikohtauslisäosa kirjoittaa oman kameraskriptinsä, tarkista, että se palauttaa kameran (CameraType Custom ja CameraSubject) ja asettaa Focusin, kun kamera on Scriptable, ja jätä päätös siitä, kuka näkee välikohtauksen, palvelimelle kuten tässä oppaassa.

Yleiset virheet ja ratkaisut

Avaa Output-ikkuna (Window-valikko, sitten Output) ennen kuin painat Play. Useimmat välikohtausten ongelmat joko kirjoittavat sinne varoituksen tai johtuvat nimestä, joka ei täsmää.

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

CutsceneService odottaa kansiota nimeltä Cutscenes suoraan Workspacessa. Luo se kuten vaiheessa 1 ja tarkista kirjoitusasu ja iso C. Niin kauan kuin sitä ei ole, CutsceneService ei luo CutsceneEventiä, joten CutscenePlayer myös odottaa.

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

CutscenePlayer odottaa remotea, jonka CutsceneService luo. Tarkista, että CutsceneService on Script eikä LocalScript, on suoraan ServerScriptServicessä, ei ole pois käytöstä ja ettei Outputissa ole siltä virhettä tai varoitusta Cutscenesista.

CutsceneService: no folder named Intro in Workspace.Cutscenes

Nimi INTRO_CUTSCENE-asetuksessa tai triggerin Cutscene-attribuutissa ei vastaa yhtään Workspace.Cutscenesin sisällä olevaa kansiota. Nimien kirjainkoolla on väliä.

Mitään ei toistu, eikä Outputissa ole mitään

Kansiossa ei ole partia nimeltä 1, tai sen partit eivät ole suoraan siinä (esimerkiksi Modelin sisällä). CutsceneService lukee partit 1, 2, 3 järjestyksessä ja pysähtyy ensimmäiseen puuttuvaan numeroon. Ja muista, että jokainen välikohtaus toistuu kerran pelaajaa kohden palvelimella: pysäytä testi ja paina taas Play.

Kamera katsoo väärään suuntaan

Kamera katsoo samaan suuntaan kuin kuvapartin etupinta. Vie Studion kamera haluamaasi näkymään ja aja vaiheen 1 Command Bar -rivi uudelleen tälle kuvalle.

Triggeri ei tee mitään

Tarkista, että triggeripart on suoraan Workspace.CutsceneTriggersin sisällä pelin käynnistyessä, että CanTouch on rastitettu (muuten Outputissa on varoitus) ja että sen Cutscene-attribuutti on merkkijono, joka on Workspace.Cutscenesin kansion nimi. Triggerin läpi kulkeminen uudelleen ei tee mitään, ja niin on tarkoitus.

Välikohtauksen jälkeen kamera jää viimeiseen kuvaan

CutscenePlayer pysähtyi virheeseen ennen kuin ehti palauttaa kameran, joten etsi siltä punaista virhettä Outputista. Kameraa voi myös pitää toinen skripti, joka asettaa jatkuvasti CameraType-arvoksi Scriptablen, esimerkiksi valikkokamera, joka on yhä sidottuna.

Tee se RoCodella

Jos et halua koota tätä käsin, RoCode voi tehdä sen paikkaan, joka sinulla on auki. RoCode on itsenäinen tekoälyagentti Roblox Studioon, ei Robloxin tekemä: kuvailet ominaisuuden sen verkkochatissa, ja sen Studio-lisäosa luo partin ja skriptit Exploreriisi, joten koodia ei tarvitse kopioida chat-ikkunasta.

Sinä kirjoitat

Lisää aloitusvälikohtaus: Cutscenes-kansio, jossa on Intro-kansio ja kuvat 1-3, tekstit Caption-attribuutista, mustat palkit ja Skip-painike, toistuu kerran pelaajan ensimmäisellä syntymällä, palvelin pitää pelaajan paikallaan, ja lopuksi kamera palaa.

RoCode tekee
  • Voi ensin tarkistaa paikkasi Search Scriptsillä esimerkiksi valikko- tai kameraskriptin varalta, joka jo asettaa CameraType-arvon, jotteivät ne ole ristiriidassa
  • Luo kansiot ja triggeripartin Create Instancella ja asettaa partteihin attribuutteja, kuten Caption ja MoveSeconds
  • Kirjoittaa CutsceneServicen ja CutscenePlayerin Create Scriptillä
  • Sitä on ohjeistettu tarkistamaan jokainen kirjoittamansa skripti Check Scriptillä, joka kääntää sen Studiossa ajamatta, ja se asettaa kumouspisteen ennen jokaista muutoserää ja sen jälkeen

Sijoita kuvapartit itse viemällä Studion kamera kuhunkin näkymään ja pyydä sitten skriptit. Lisäosalla 3.9 tai uudemmalla RoCode voi ajaa lyhyen pelitestin ja lukea virheet, ja lisäosalla 3.9.11 tai uudemmalla se voi ohjata testihahmoa tarkistaakseen, että peli toimii, mutta pelin aikana se ei ota kuvakaappauksia, joten välikohtauksen katsot itse. Järjestys, jossa kokonainen peli kootaan, on sivulla miten Roblox-peli tehdään tekoälyllä järjestelmä kerrallaan. Miten RoCode yhdistyy Studioon.

Usein kysytyt kysymykset

Miten välikohtaus saadaan toistumaan peliin tullessa?

Nimeä kuvien kansio Intro Workspace.Cutscenesissä tai muuta INTRO_CUTSCENE kansiosi nimeksi. CutsceneService toistaa sen jokaisen pelaajan ensimmäisellä syntymällä palvelimella. Näyttääksesi sen vain aivan ensimmäisellä käynnillä tallenna lippu data storeen ja aseta se vasta intron alettua, kuten osiossa Miten järjestelmää laajennetaan kuvataan.

Voiko välikohtauksen tehdä ilman lisäosia?

Kyllä. Tässä oppaassa on vain partteja, attribuutteja ja kaksi skriptiä, ja Command Barin rivi asettaa jokaisen kuvan täsmälleen sinne, missä Studion kamera on. Moon Animatorin kaltaiset lisäosat ovat silti käteviä välikohtauksessa näyttelevien hahmojen animointiin.

Miksi kamera ei liiku välikohtauksessa?

Yleensä kamerakoodi on palvelimen Scriptissä, mutta pelaajan kameraa voi liikuttaa vain LocalScript, koska jokaisella laitteella on oma kameransa. Toinen yleinen syy: CameraType ei ole Scriptable, ja Robloxin vakiokameraskriptit palauttavat kameran jatkuvasti hahmoon.

Miten estän pelaajaa liikkumasta välikohtauksen aikana?

Ankkuroi hänen HumanoidRootPartinsa palvelimella toiston ajaksi ja poista ankkurointi sen jälkeen, kuten CutsceneService tekee. Ankkuroitu part ei koskaan liiku fysiikan vuoksi. WalkSpeediin ei kosketa, joten tämä ei ole ristiriidassa juoksuskriptin tai nopeuspassin kanssa.

Miten välikohtaukseen lisätään Skip-painike?

Laita TextButton välikohtauksen näkymään ja kytke sen Activated-tapahtuma, joka laukeaa klikkauksesta, napautuksesta tai peliohjaimen A-painikkeesta, kun painike on valittu. CutscenePlayerin Skip asettaa lipun, jonka kuvasilmukka tarkistaa joka ruudussa, valitaan itsestään peliohjaimen pelaajille ja on omassa ScreenGuissaan oletusreunuksilla, jotta puhelimen kameran lovi ei peitä sitä. Tikku ja hyppypainike ovat piilossa välikohtauksen aikana, joten ne eivät ole sen vieressä.

Miksi välikohtauksessa on tyhjä maailma?

Kun instance streaming on päällä, pelaajan laitteella on vain hänen hahmonsa lähellä oleva alue. Anna palvelimen kutsua player:RequestStreamAroundAsync jokaiselle kuvalle vähän ennen kuin kamera lentää sinne, kuten CutsceneService tekee. Robloxin mukaan alue näin todennäköisesti, mutta ei varmasti, latautuu, joten pidä tärkeät kuvat streaming-säteen sisällä tai käytä Player:AddReplicationFocus-kutsua alueelle, jonka pitää pysyä ladattuna.

Lähteet ja lisälukemista

Miten koodi tarkistettiin: jokainen tämän sivun skripti läpäisee Luaun tiukan tyyppitarkistuksen Roblox API:n määrittelyillä (luau-lsp, 20. marraskuuta 2026). Tyyppitarkistus löytää virheet API-nimissä ja väärät tyypit, mutta ei pelilogiikan virheitä, joten testaa kaikki Studiossa ennen julkaisua.

Kokeile RoCodea omassa pelissäsi.

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