Eğitim · Oyun sistemleri

Roblox Studio'da cutscene nasıl yapılır

Roblox'ta cutscene, kontrolü birkaç saniyeliğine alan bir kameradır: kareler arasında geçiş yapar ya da yumuşakça uçar, bir altyazı gösterir ve kontrolü oyuncuya geri verir. Bu rehberde, kameranın durması gereken yerlere görünmez part'lar koyarak ayarladığın, plugin gerektirmeyen bir cutscene kuruyoruz. Oyuncunun onu ne zaman göreceğine sunucu karar verir (ilk doğuşta ya da bir tetikleyiciye dokununca), oyuncunun cihazı da kamerayı hareket ettirir, siyah şeritleri ve Skip düğmesini gösterir ve kamerayı geri verir.

Güncellendi: 20 Kasım 202618 dk okumaYazan:

Kısaca

Workspace.Cutscenes içindeki bir klasöre 1, 2, 3 adlı görünmez, anchor'lanmış part'lar koy, her birinin ön yüzü kameranın bakması gereken yöne dönük olsun. ServerScriptService'teki bir Script bunların CFrame'lerini okur, oyuncuyu yerinde tutar ve kareleri bir RemoteEvent ile o oyuncuya gönderir. StarterPlayerScripts'teki bir LocalScript workspace.CurrentCamera.CameraType'ı Scriptable yapar, kamerayı her frame bir kareden diğerine taşır (TweenService:GetValue ile yumuşatarak), sonra CameraType'ı Custom'a ve CameraSubject'i oyuncunun Humanoid'ına geri döndürür.

  • Kamerayı sadece oyuncunun cihazı kontrol edebilir, bu yüzden kamera kodu bir LocalScript. Sunucu sadece kimin hangi cutscene'i ne zaman göreceğine karar verir.
  • Kamera Scriptable olduğunda Roblox Camera.Focus'u güncellemeyi bırakır. Referans, Focus'u her frame güncellemeni söylüyor, yoksa eski odaktan uzaktaki dinamik ışıklandırma çizilmeyebilir.
  • Camera:Interpolate kullanımdan kalktı. Roblox referansı kamerayı TweenService ile animasyonlamanı söylüyor.
Bu sayfada
  1. Nasıl çalışır
  2. 1. Kareler
  3. 2. Sunucu scripti
  4. 3. LocalScript
  5. 4. Tetikleyici
  6. Kamera ayrıntıları
  7. Eski eğitimler
  8. Hile koruması
  9. 5. Test
  10. Genişletme
  11. Common errors
  12. RoCode ile
  13. Sık sorulan sorular
  14. Kaynaklar ve ek okumalar

Bir cutscene nasıl çalışır

İllüstrasyonGerçek hızda iki kareli bir giriş: ilk kareye geçiş, 1 saniye bekleme, 2.5 saniyede köprüye uçuş, 1 saniye bekleme, sonra kamera oyuncuya döner.

Her oyuncunun cihazında kendi Camera nesnesi var, workspace.CurrentCamera'da; bu yüzden oyuncunun gördüğünü sadece bir LocalScript hareket ettirebilir. Kimin hangi cutscene'i ne zaman göreceğine karar vermek sunucunun işi. Rehber işi tam olarak böyle bölüyor. Bir cutscene şöyle ilerler:

  1. Sunucu oyuncunun bir cutscene görmesi gerektiğine karar verir: sunucudaki ilk doğuşta Intro, ya da bir tetikleyici part'a dokunduğunda başka biri.
  2. CutsceneService kare part'larının CFrame'lerini ve ayarlarını okur, Roblox'tan bu oyuncu için ilk karenin alanını yüklemesini ister, oyuncunun HumanoidRootPart'ını anchor'layarak onu yerinde tutar ve CutsceneEvent'i sadece bu oyuncuya bir id ve kare listesiyle gönderir.
  3. Oyuncunun cihazındaki CutscenePlayer siyah şeritleri ve Skip düğmesini gösterir, oyuncu listesini, sırt çantasını, can çubuğunu ve dokunmatik kontrolleri gizler, kamerayı Scriptable yapar ve onu her frame hareket ettirir.
  4. Son kare bittiğinde ya da oyuncu Skip'e bastığında kamerayı karaktere geri verir ve sunucuya aynı id ile CutsceneEvent gönderir.
  5. Sunucu oyuncunun anchor'ını kaldırır. Bu mesaj hiç gelmezse, cutscene'in uzunluğu artı 2 saniye geçtiğinde yine de kaldırır. Zamanlayıcı sunucu cutscene'i gönderdiğinde başlar; yavaş bir girişte cihaz girişi birkaç saniye geç başlatabilir, çünkü ReplicatedFirst dışındaki bir LocalScript oyun yüklenene kadar çalışmaz. O zaman oyuncu, giriş kendi ekranında bitmeden yeniden hareket edebilir.
Cutscene sistemi nelerden oluşur
ParçaNerede dururNe yapar
CutsceneService Script'iServerScriptServiceKimin hangi cutscene'i ne zaman göreceğine karar verir, kareleri okur, oyuncuyu yerinde tutar ve kimin neyi zaten gördüğünü hatırlar.
CutscenePlayer LocalScript'iStarterPlayer, StarterPlayerScriptsCutscene'i oyuncunun ekranında oynatır: şeritler, altyazılar, Skip ve kamera hareketi. Sonunda kamerayı geri verir.
CutsceneEvent RemoteEvent'iReplicatedStorage (bunu CutsceneService oluşturur)Kareleri sunucudan tek bir oyuncuya taşır, geri dönüşte de "cutscene bitti" mesajını.
Cutscenes Folder'ıWorkspaceHer cutscene için bir klasör, örneğin 1, 2, 3 kare part'larıyla Intro.
CutsceneTriggers Folder'ıWorkspace (isteğe bağlı)Bir oyuncu dokunduğunda cutscene başlatan part'lar.
Cutscene sistemi hazır olduğunda Explorer. Bridge ve CutsceneTriggers klasörleri 4. adımda geliyor. Oyun başladığında CutsceneService, ReplicatedStorage'a CutsceneEvent adlı bir RemoteEvent ekler.
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

Adım 1: Kamera karelerini yerleştir

Her kare görünmez bir part. Kamera part'ın pozisyonunu alır ve onun ön yüzünün baktığı yöne bakar, yani bir kare yerleştirmek kamerayı yerleştirmek demek.

  1. Explorer'da fareyle Workspace üzerine gel, + düğmesine tıkla ve Cutscenes adlı bir Folder ekle. İçine Intro adlı bir Folder ekle. Adlarda büyük küçük harf önemli.
  2. Studio kamerasını, bir fotoğraf karesi kurar gibi, istediğin ilk görüntüye getir.
  3. Intro'ya bir Part ekle ve adını 1 yap.
  4. Command Bar'ı aç (Script sekmesinde ya da Window, sonra Script ile) ve workspace.Cutscenes.Intro["1"].CFrame = workspace.CurrentCamera.CFrame çalıştır. Düzenleme modunda CurrentCamera içinden baktığın görüntüdür, bu yüzden part tam olarak bu kareye oturur. Köşeli parantezler ve tırnaklar gerekli, çünkü rakamla başlayan bir ad noktadan sonra yazılamaz.
  5. Part'ın Properties'inde Anchored'ı işaretle, CanCollide, CanTouch ve CanQuery'nin işaretini kaldır ve Transparency'yi 1 yap. Anchored onun haritanın içinden düşmesini engeller; geri kalanı oyunculara engel olmasını, temas event'leri tetiklemesini ve raycast'leri kesmesini engeller.
  6. Sonraki görüntüler için tekrarla; part'lara 2, 3 ve böyle devam eden adlar ver ve Command Bar satırındaki numarayı değiştir. CutsceneService kareleri numara sırasıyla oynatır ve ilk eksik numarada durur, bu yüzden numaralandırmadaki bir boşluk cutscene'i erken bitirir.

Bir kareyi sonra değiştirmek için kamerayı yeni görüntüye getir ve aynı satırı o karenin numarasıyla çalıştır. Transparency 1 iken part'lar Studio'da da görünmez, bu yüzden onlara ihtiyacın olduğunda Explorer'dan seç.

Her karenin üç isteğe bağlı attribute'u daha olabilir. Bir attribute eklemek için part'ı seç, Properties penceresini Attributes bölümüne kadar kaydır, +'ya tıkla, adı yaz, tipi seç ve Save'e tıkla.

Her kare part'ındaki isteğe bağlı attribute'lar
AttributeTipVarsayılanNe yapar
MoveSecondsnumber3Kameranın önceki kareden bu kareye kaç saniyede uçtuğu. 0 ani bir geçiş yapar. 1. kare her zaman ani geçiştir, bu yüzden onda bu attribute etkisizdir.
HoldSecondsnumber1Kameranın vardıktan sonra bu karede kaç saniye durduğu.
CaptionstringyokKamera bu kareye uçmaya başladığı andan itibaren alt şeritteki metin. Caption'ı olmayan bir kare metni temizler.

0'dan küçük ya da 60'tan büyük bir sayı, ayrıca yanlış tipteki bir attribute varsayılan değerle değiştirilir.

Adım 2: Sunucu scriptini ekle

Fareyle ServerScriptService üzerine gel, CutsceneService adlı bir Script ekle ve aşağıdaki kodu yapıştır. Baştaki ayarlar, değiştirebileceğin satırlar.

Script konum: ServerScriptService adı: CutsceneService
-- ServerScriptService içinde CutsceneService adlı Script.
-- Kimin hangi cutscene'i ne zaman göreceğine karar verir. Kamera karelerini
-- Workspace.Cutscenes içindeki numaralı part'lardan okur, oyuncuyu yerinde tutar ve
-- o oyuncunun cihazına kareleri oynatmasını söyler. Kameranın kendisi sadece cihazda hareket ettirilebilir.

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

-- Ayarlar
local INTRO_CUTSCENE = "Intro" -- oyuncunun ilk doğuşunda bir kez oynar; kapatmak için ""
local DEFAULT_MOVE_SECONDS = 3 -- karede MoveSeconds yoksa ona uçuş süresi
local DEFAULT_HOLD_SECONDS = 1 -- karede HoldSeconds yoksa onda bekleme süresi
local MAX_SHOTS = 30

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

-- Bu script CutsceneEvent'i kendisi oluşturur, bu yüzden onu elle ekleme
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 } = {} -- oyuncunun izlediği cutscene'in id'si
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

-- Kareler, cutscene'in adını taşıyan klasördeki 1, 2, 3 ... part'larıdır
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,
			-- ilk kare ani bir geçiştir, bu yüzden kamera hemen ona atlar
			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 -- bu cutscene zaten bitti
	end
	playing[player] = nil
	setFrozen(player, false)
end

local function play(player: Player, name: string): boolean
	if playing[player] then
		return false -- aynı anda tek cutscene
	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

	-- Instance streaming açıkken oyuncunun cihazında karenin baktığı alan olmayabilir,
	-- istek de alanı sadece geçici olarak yükler. İlk karenin alanını şimdi yüklüyoruz
	-- (2 saniyeye kadar bekleyerek), sonraki her karenin alanını da
	-- kamera ona uçmadan 2 saniye önce.
	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 -- alan yüklenirken oyuncu çıktı
	end

	setFrozen(player, true)
	cutsceneEvent:FireClient(player, id, shots)
	local startsAt = 0 -- şu andan bu kareye uçuşun başlamasına kadar geçen saniye
	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
	-- Güvence: cihazı hiç cevap vermese bile oyuncunun anchor'ını kaldır
	task.delay(startsAt + 2, finish, player, id)
	return true
end

-- Sadece cutscene bu oyuncu için başladıysa true döndürür
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

-- Oyuncunun cihazı cutscene'in bittiğini ya da atlandığını bildirir
cutsceneEvent.OnServerEvent:Connect(function(player: Player, id: unknown)
	if typeof(id) == "number" then
		finish(player, id)
	end
end)

-- Tetikleyici part'lar: temas, Cutscene attribute'undaki cutscene'i başlatır
if triggers then
	for _, trigger in triggers:GetChildren() do
		if not trigger:IsA("BasePart") then
			continue
		end
		if not trigger.CanTouch then
			-- CanTouch kapalı bir part'a Touched bağlamak hata verir, bu yüzden sadece uyarıyoruz
			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) -- cutscene sırasında respawn, yeni karakteri de yerinde tut
	elseif INTRO_CUTSCENE ~= "" then
		playOnce(player, INTRO_CUTSCENE)
	end
end

local function onPlayerAdded(player: Player)
	if seen[player] then
		return -- zaten ayarlandı
	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 -- script Cutscenes'i beklerken giren herkes
	onPlayerAdded(player)
end

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

CutsceneService, Workspace.Cutscenes ortaya çıkar çıkmaz CutsceneEvent RemoteEvent'ini kendisi oluşturur, bu yüzden ReplicatedStorage'a elle bir şey eklemen gerekmez. Bu adda bir RemoteEvent'i zaten yaptıysan sil: LocalScript seninkini bulabilir, onu da sunucuda kimse dinlemiyor.

CutsceneService'in başındaki ayarlar
AyarBuradaki değerNeyi değiştirir
INTRO_CUTSCENE"Intro"Oyuncunun sunucudaki ilk doğuşunda oynayan, Workspace.Cutscenes içindeki klasör. Giriş olmasın diye "" yap.
DEFAULT_MOVE_SECONDS3Karede MoveSeconds attribute'u yoksa uçuşun ne kadar sürdüğü.
DEFAULT_HOLD_SECONDS1Karede HoldSeconds attribute'u yoksa kameranın onda ne kadar durduğu.
MAX_SHOTS30CutsceneService'in tek bir cutscene'de aradığı en büyük kare numarası.

Scriptin geri kalanı sırasıyla şunları yapıyor:

  • Kareleri sunucuda okur. readShots her numaralı part'ın CFrame'ini ve attribute'larını bir listede toplar. Oyuncunun cihazı bu listeyi alır, bu yüzden part'ların kendisine ihtiyacı yok.
  • Aynı anda tek cutscene. Oyuncu zaten bir cutscene izliyorsa ya da karakterinde Humanoid yoksa veya ölüyse play hiçbir şey yapmaz.
  • Her cutscene'in kendi id'si var. Cutscene bittiğinde ya da atlandığında cihaz id'yi geri gönderir ve oyuncunun anchor'ını sadece eşleşen id kaldırır, bu yüzden önceki bir cutscene'den gecikmiş bir mesaj yenisini bitiremez.
  • Oyuncuyu yerinde tutar; bunu HumanoidRootPart'ını anchor'layarak yapar, oyuncu cutscene ortasında respawn olursa yeni karakteri de anchor'lar. Roblox referansına göre anchor'lanmış bir part yerçekimi, çarpışmalar ya da başka bir fizik yüzünden pozisyonunu asla değiştirmez. WalkSpeed'e dokunulmaz, bu yüzden bir sprint scriptiyle ya da hız pass'iyle çakışmaz. Sonunda script root part'ın anchor'ını, onu başka bir script anchor'lamış olsa bile kaldırır, bu yüzden bir cutscene oynuyor olabilecekken karakterleri başka bir yerde anchor'lama.
  • Güvence. task.delay, cihazı hiç cevap vermemiş olsa bile oyuncunun anchor'ını cutscene'in tam uzunluğu artı 2 saniye sonra kaldırır.
  • Her cutscene sunucu başına bir kez. seen tablosu her oyuncu için hangi cutscene'lerin zaten başladığını hatırlar, bu yüzden giriş respawn'da tekrarlanmaz ve tetikleyiciyle başlayan bir cutscene bir kez oynar. playOnce sadece cutscene gerçekten başladıysa true döndürür.
  • Her oyuncuyu ayarlar. Sondaki Players:GetPlayers() döngüsü, script Cutscenes klasörünü beklerken giren herkesi yakalar.

Kareler oyuncuya tek bir FireClient çağrısıyla, küçük tablolardan oluşan bir liste olarak gider. Roblox'un remote event sayfası, sayısal ve string anahtarların karıştığı bir tablo göndermemeyi söylüyor; bu listede sadece sayısal anahtarlar var, içindeki her karede de sadece string anahtarlar; bu orada önerilen biçim.

Adım 3: Onu oynatan LocalScript'i ekle

  1. Explorer'da StarterPlayer'ı genişlet, fareyle StarterPlayerScripts üzerine gel ve CutscenePlayer adlı bir LocalScript ekle.
  2. İçeriğini aşağıdaki kodla değiştir.
LocalScript konum: StarterPlayerScripts adı: CutscenePlayer
-- StarterPlayer > StarterPlayerScripts içinde CutscenePlayer adlı LocalScript.
-- Sunucunun gönderdiği cutscene'i oynatır: siyah şeritler, altyazılar, bir Skip düğmesi ve
-- kareden kareye uçan kamera. Sonra kamerayı oyuncuya geri verir.

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 -- her siyah şerit, ekran yüksekliğinin bir oranı olarak
local EASING_STYLE = Enum.EasingStyle.Sine
local FOCUS_DISTANCE = 30 -- Roblox'un en ayrıntılı çizmesi gereken yer kameranın kaç stud önünde
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 }

-- Cutscene ekranı: iki siyah şerit ve bir altyazı, kenardan kenara. Roblox ScreenInsets
-- None'ı sadece kimsenin basmadığı şeyler için öneriyor, bu yüzden aşağıdaki Skip'in kendi ScreenGui'si var.
local gui = Instance.new("ScreenGui")
gui.Name = "Cutscene"
gui.ResetOnSpawn = false
gui.ScreenInsets = Enum.ScreenInsets.None -- tam ekran
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 düğmesinde varsayılan boşluklar var, bu yüzden kamera çentiği onu kapatmaz
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) -- alt şeritte, sağda
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, küçük bir telefonda da basılabilecek kadar büyük kalır
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

-- Mevcut uçuş: bir kamera CFrame'inden sonrakine, verilen saniye içinde
local moveFrom = CFrame.identity
local moveTo = CFrame.identity
local moveStart = 0
local moveSeconds = 0
local skipRequested = false
local busy = false

-- Cutscene sırasında her frame çalışır. Scriptable bir kameranın Focus'u kendiliğinden
-- hiçbir şeyi takip etmez, bu yüzden o da burada ayarlanır.
local function updateCamera()
	if camera.CameraType ~= Enum.CameraType.Scriptable then
		camera.CameraType = Enum.CameraType.Scriptable -- bir şey onu sıfırladı, örneğin bir 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
		-- Zaten biri oynuyor, bu yüzden sunucu bunun için oyuncunun anchor'ını hemen kaldırsın
		cutsceneEvent:FireServer(id)
		return
	end
	busy = true
	skipRequested = false

	-- Oyuncu listesini, sırt çantasını ve can çubuğunu gizle, neyin görünür olduğunu hatırlayarak
	local wasEnabled: { [Enum.CoreGuiType]: boolean } = {}
	for _, coreGui in HIDDEN_CORE_GUIS do
		wasEnabled[coreGui] = StarterGui:GetCoreGuiEnabled(coreGui)
		StarterGui:SetCoreGuiEnabled(coreGui, false)
	end
	-- Telefonlarda alt köşelerde duran joystick'i ve zıplama düğmesini gizle
	local touchControlsWere = GuiService.TouchControlsEnabled
	GuiService.TouchControlsEnabled = false
	gui.Enabled = true
	controls.Enabled = true
	-- Gamepad sadece seçili düğmeye basabilir, bu yüzden gamepad oyuncuları için Skip'i seç
	if UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
		GuiService.SelectedObject = skipButton
	end
	camera = workspace.CurrentCamera
	camera.CameraType = Enum.CameraType.Scriptable
	moveTo = camera.CFrame
	-- Roblox'un kendi kamera güncellemesinden bir adım sonra, Roblox'un kamera eğitimindeki gibi
	RunService:BindToRenderStep("Cutscene", Enum.RenderPriority.Camera.Value + 1, updateCamera)

	for _, shot in shots do
		moveFrom = camera.CFrame -- her uçuşu kameranın şu an olduğu yerden başlat
		moveTo = shot.cframe
		moveStart = os.clock()
		moveSeconds = shot.move
		caption.Text = shot.caption
		waitOrSkip(shot.move + shot.hold)
		if skipRequested then
			break
		end
	end

	-- Kamerayı oyuncunun karakterine geri ver
	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 = ""
	-- Sadece bu cutscene'in kapattıklarını geri aç, geri kalanına dokunma
	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) -- sunucu oyuncunun anchor'ını hemen kaldırır
	busy = false
end

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

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

StarterPlayerScripts'teki bir LocalScript oyuncuya girişte bir kez kopyalanır ve karakter respawn olduktan sonra da çalışmaya devam eder. Bu yüzden iki ScreenGui'de de ResetOnSpawn kapalı: açarsan Roblox onları ilk respawn'da siler ve bu script onları yeniden oluşturmaz. Script OnClientEvent'e bağlanmadan önce gelen remote mesajları kuyruğa alınır ve bağlandıktan sonra teslim edilir, yani hızlı doğan bir oyuncu da girişi görür.

CutscenePlayer'ın her parçası ne yapar
ParçaNe yapar
Cutscene ScreenGui'siHer biri ekran yüksekliğinin %12'si olan iki siyah şerit (BAR_HEIGHT) ve alt şeritte bir altyazı. ScreenInsets None şeritleri ekranın tam kenarlarına kadar uzatır, DisplayOrder 10 da onları DisplayOrder'ı daha düşük olan ScreenGui'lerin üstüne çizer.
CutsceneControls ScreenGui'siİçinde sadece alt şeridin sağındaki Skip düğmesi var; bir UISizeConstraint onu en az 64 x 32 piksel tutar ki telefonda kolay basılsın. ScreenInsets'i varsayılan, bu yüzden içeriği Roblox'un üst çubuk düğmelerinin ve kamera çentiklerinin altına girmez. Roblox None'ı sadece basılacak bir şey olmayan içerik için öneriyor, bu yüzden Skip şeritlerin ScreenGui'sinde duramaz.
HIDDEN_CORE_GUISOyuncu listesini, sırt çantasını ve can çubuğunu SetCoreGuiEnabled ile gizler; bundan önce GetCoreGuiEnabled ile hangilerinin açık olduğunu hatırlar ve sonunda sadece kendi kapattıklarını geri açar. Oyun sırt çantasını başka bir yerde gizliyorsa gizli kalır, cutscene sırasında onları açan bir scripti de, örneğin ana menüyü, hiçbir şey ezmez.
TouchControlsEnabledTelefonlarda ve tabletlerde play, cutscene boyunca GuiService.TouchControlsEnabled'ı false yapar. Bu, alt köşelerde, Skip ile aynı yerde duran joystick'i ve zıplama düğmesini gizler; açıklarsa sonunda geri gelirler.
updateCameraCutscene oynarken her frame çalışır. Mevcut uçuşun ne kadarının geçtiğini hesaplar, bunu TweenService:GetValue ile yumuşatır, kamerayı CFrame:Lerp ile iki kare arasına koyar ve Focus'u kameranın 30 stud önüne ayarlar.
waitOrSkipKarenin uçuş ve bekleme süresini bekler, her frame Skip işaretini kontrol eder.
playKamerayı Scriptable yapar, kareleri sırayla oynatır, sonra kamerayı geri verir (CameraType Custom, CameraSubject Humanoid), core GUI'leri ve dokunmatik kontrolleri geri açar ve sunucuya cutscene'in id'sini gönderir. İlki hâlâ oynarken ikinci bir cutscene gelirse onun id'sini hemen geri gönderir, böylece sunucu oyuncuyu bu cihazın göstermediği bir cutscene için yerinde tutmaz.
Skip düğmesiActivated fare tıklamasında, dokunmada ya da düğme seçiliyken gamepad'deki A düğmesinde tetiklenir. Ana girişi gamepad olan bir oyuncu için play cutscene başında Skip'i seçer ve sonunda seçimi kaldırır.

Şeritleri inceltmek ya da kalınlaştırmak için BAR_HEIGHT'ı, uçuşların hissini değiştirmek için EASING_STYLE'ı değiştir (bkz. Kamera kodu neyi doğru yapıyor). Altyazıda ve Skip düğmesinde TextScaled açık, bu yüzden metin ekranla birlikte büyür ve küçülür.

Adım 4: Bir part'a dokununca cutscene

Giriş kendiliğinden oynar. Haritanın belirli bir yerindeki bir cutscene için, örneğin oyuncu köprüye ilk kez vardığında, ikinci bir cutscene ve bir tetikleyici part ekle.

  1. Workspace, Cutscenes içine Bridge adlı bir Folder ekle ve karelerini 1. adımdaki gibi 1 ve 2 adlarıyla yerleştir. Command Bar satırında Intro yerine Bridge yaz.
  2. Fareyle Workspace üzerine gel ve CutsceneTriggers adlı bir Folder ekle.
  3. İçine BridgeTrigger adlı bir Part ekle. Onu, oyuncuların dokunmadan yanından geçemeyeceği kadar büyük yap, örneğin yolun karşısında uzun, geniş bir levha. Anchored'ı işaretle, CanCollide ve CanQuery'nin işaretini kaldır, CanTouch'ı işaretli bırak ve Transparency'yi 1 yap. Kapalı CanQuery, görünmez levhanın raycast'leri, örneğin silah rehberindeki atışları kesmesini engeller. Temas event'lerini CanQuery değil CanTouch yönetir, bu yüzden tetikleyici yine de çalışır.
  4. Ona string tipinde bir Cutscene attribute'u ekle ve değerini Bridge yap: oynatılacak klasörün adı.

CutsceneService sunucu başlarken doğrudan CutsceneTriggers içindeki her part'a Touched bağlar, bu yüzden tetikleyicileri oyun sırasında bir scriptle değil Studio'da ekle. CanTouch'ı kapalı bir tetikleyici Output'ta bir uyarıyla atlanır, çünkü bir script böyle bir part'a Touched bağladığında Roblox hata verir.

Karakter part'ın içinden geçerken Touched art arda birçok kez tetiklenir. seen tablosu ve "aynı anda tek cutscene" kuralı bunu sunucu başına oyuncu başına tek bir cutscene'e çevirir. Başka bir cutscene sırasında tetikleyiciye dokunan bir oyuncu yok sayılır ve tetikleyici onun için hazır kalır.

Tetikleyicileri yollara koyma. Oturan bir oyuncunun HumanoidRootPart'ı koltuğa kaynaklıdır, kaynaklı bir grubun bir part'ı anchor'landığında da Roblox geri kalanını da onunla birlikte anchor'lar. Bu yüzden bir tetikleyiciye araçla giren oyuncu, cutscene bitene kadar bütün aracını, yolcularıyla birlikte, yerinde tutar.

Kamera kodu neyi doğru yapıyor

Scriptable, sonra yine Custom

Roblox'un kamera scriptleri, CameraType Scriptable olduğu sürece kamerayı hareket ettirmez ve güncellemez; CutscenePlayer'ın onu yerleştirebilmesini sağlayan tam olarak bu. Sonunda CameraType'ı Custom'a döndürür ve oyuncunun Humanoid'ını, Roblox kamera scriptlerinin varsayılan olarak takip ettiği CameraSubject yapar. Bu Skip'ten sonra da çalışır, yani oyuncu asla son kareye bakarak kalmaz.

İki küçük kontrol, cutscene oynarken onu yönetici tutar. Bir şey cutscene ortasında CameraType'ı başka bir değere ayarlarsa, her frame çalışan fonksiyon bir sonraki frame'de onu Scriptable'a döndürür. workspace.CurrentCamera'yı da script her cutscene'in başında yeniden okur, çünkü mevcut Camera bir gün silinirse Roblox yeni bir tane oluşturur.

Focus, her frame

Camera.Focus motora ışıklandırma gibi işlerde hangi alana öncelik vereceğini söyler. Roblox'un kamera scriptleri onu CameraSubject'te tutar, ama kamera Scriptable olduğunda değil; Roblox referansı bu durumda onu her frame güncellemeni söylüyor: PointLight gibi nesnelerden gelen dinamik ışık odaktan uzakta çizilmeyebilir. CutscenePlayer onu kameranın 30 stud önüne koyar (FOCUS_DISTANCE). Kareler daha uzaktaki bir şeye bakıyorsa bu sayıyı artır.

Fonksiyon RunService:BindToRenderStep ile, her frame çizimden önce, Roblox'un kendi kamera güncellemesinden bir öncelik adımı sonra çalışır (Enum.RenderPriority.Camera.Value + 1). Bu önceliği Roblox'un kamera eğitimi kullanıyor, bu yüzden cutscene kamerayı Roblox'un kendi kamera kodu çalıştıktan sonra yerleştirir.

TweenService:GetValue ile yumuşatma

camera.CFrame üzerindeki bir tween kamerayı hareket ettirirdi, ama Focus'un yine de her frame ayarlanması gerekiyor, bu yüzden CutscenePlayer kamerayı aynı fonksiyonda kendisi hareket ettirir. Her uçuş için zamanın ne kadarının geçtiğini (0'dan 1'e) hesaplar, bunu bir easing stili ve yönüyle TweenService:GetValue'dan geçirir ve kamerayı CFrame:Lerp ile iki kare arasındaki yolun o kesrine koyar; Lerp pozisyonu düz bir çizgide taşır ve yumuşakça döndürür. GetValue girişi 0 ile 1 arasında sınırlar, bu yüzden uçuş süresi bittiğinde kamera tam olarak karede durur.

Kamera uçuşuna uyan easing stilleri
EASING_STYLEUçuş nasıl hissettirir
Enum.EasingStyle.Sine (burada)Hız bir sinüs eğrisini izler, yumuşak başlangıç ve yumuşak duruş.
Enum.EasingStyle.QuadSine gibi, ama eğri biraz daha keskin.
Enum.EasingStyle.LinearSabit hız, bu yüzden her uçuş tam hızda başlar ve biter.

InOut yönü: yumuşatma uçuşun ilk yarısında ileri, ikinci yarısında tersine uygulanır, bu yüzden kamera bir kareden hızlanarak çıkar ve bir sonrakine yavaşlayarak gelir.

Streaming

Yeni place'lerde instance streaming açık: varsayılan olarak oyuncunun cihazı karakterinin etrafındaki alanı tutar, bu yüzden haritanın öbür ucuna bakan bir kare boş bir dünya gösterebilir. CutsceneService, Roblox'tan bu oyuncu için her karenin alanını Player:RequestStreamAroundAsync ile yüklemesini ister: ilk karenin alanını event'i göndermeden önce, 2 saniyeye kadar bekleyerek, sonraki her karenin alanını da kamera ona uçmadan 2 saniye önce.

Roblox, bu şekilde alanın muhtemelen ama kesin olmayarak yükleneceğini ve etkinin geçici olduğunu yazıyor. Önemli kareleri streaming yarıçapının içinde tut ya da sen odağı kaldırana kadar yüklü kalması gereken bir alan için sunucuda Player:AddReplicationFocus kullan. Streaming kapalıyken cihazda zaten bütün harita var, her isteğin etrafındaki pcall da başarısız bir isteğin cutscene'i durduramayacağı anlamına geliyor.

Eski cutscene eğitimlerinde ne yanlış

Bu rehberi bir videoyla ya da bir forum gönderisiyle karşılaştırıyorsan, önemli farklar ve her yöntemin neden sorun olduğu burada.

Cutscene eğitimlerinde sık görülen yöntemler ve bu rehberin yerine yaptığı
EğitimSorunBu rehber
Kamerayı camera:Interpolate() ile hareket ettiriyorRoblox, Interpolate'i kullanımdan kalkmış olarak işaretledi ve kamerayı TweenService ile animasyonlamayı öneriyor.Her uçuşu TweenService:GetValue ile yumuşatır ve kamerayı her frame yerleştirir.
camera.CFrame'i tween'liyor, başka bir şey yapmıyorFocus, kamera scriptlerinin bıraktığı yerde, karakterin yanında kalır, bu yüzden ondan uzaktaki dinamik ışık çizilmeyebilir (Roblox'un Camera.Focus referansı).Focus'u render step'te her frame ayarlar.
Kamerayı geri vermiyorOyuncu son kareye bakarak takılı kalır.Sonunda, Skip'ten sonra da, CameraType'ı Custom'a ve CameraSubject'i Humanoid'a ayarlar.
Cutscene'i bir LocalScript'teki Touched'dan başlatıyorOnun her temasta tekrarlanmasını hiçbir şey engellemez ve karar oyuncunun kontrol ettiği cihazda verilir.Oyuncuyu sunucu seçer ve onu kimin zaten gördüğünü hatırlar.
Kamera part'larını istemcide okuyorStreaming açıkken karakterden uzaktaki part'lar cihazda henüz var olmayabilir.Part'ları sunucu okur, CFrame'lerini gönderir ve kamera her kareye uçmadan kısa süre önce onun alanını ister.

Oyuncunun neyi değiştirip neyi değiştiremeyeceği

Bir hilecinin kendi cihazındaki her şeyi kontrol ettiğini varsay: CutscenePlayer'ı değiştirebilir ya da silebilir ve CutsceneEvent'i herhangi bir değerle gönderebilir. Bir cutscene için bu, ona gerçek bir şey bağlı değilse neredeyse hiçbir şey ifade etmez.

Bir hilecinin neyi deneyebileceği ve bundan ne çıkacağı
Hileci şunu denerSonuç
Cutscene'i atlamak ya da hiç oynatmamakYapabilir: bu onun kendi ekranı. "Cutscene'i izledi" diye asla ödül verme.
CutsceneEvent'i herhangi bir değerle göndermekSadece mevcut cutscene'iyle eşleşen sayı bir şey yapar, yaptığı tek şey de onun anchor'ını daha erken kaldırmak.
Tetikleyiciye haritanın herhangi bir yerinden dokunmakMümkün: her cihaz kendi karakterini kontrol eder, Roblox'un güvenlik dokümantasyonu da Touched event'lerini taklit etmeyi yapabileceği şeyler arasında sayıyor. O cutscene'i bir kez görür ve başka bir şey olmaz.
Cutscene sırasında yine de hareket etmekKazanacağı bir şey yok. Dondurma, dürüst oyuncuların cutscene ortasında uzaklaşmasını engeller; bir güvenlik kontrolü değil.
Remote ile başka birine cutscene başlatmakİmkansız. Bir oyuncuya CutsceneEvent'i sadece sunucu gönderebilir, cihazın geri gönderebildiği tek şey de "bu cutscene bitti".

Cutscene gerçek bir şeye yol açıyorsa, örneğin sonra açılan bir kapıya ya da bir boss'un ortaya çıkmasına, bunu sunucu kendi zamanlayıcısıyla yapsın, cihaz cutscene'in bittiğini bildirdiğinde değil.

Adım 5: Test et

  1. Üç Intro karesini Command Bar satırıyla yerleştir. 1. kareye "Welcome to the village" Caption'ı, 2. kareye 2.5 MoveSeconds ve "Find the bridge" Caption'ı ver, 3. kareyi attribute'suz bırak.
  2. Play'e bas (F5). Siyah şeritler belirir, kamera altyazısıyla 1. kareye geçer, 2.5 saniyede 2. kareye, sonra 3 saniyede altyazısız 3. kareye uçar. Sonra kamera karakterin arkasına döner ve oyuncu listesi yeniden görünür. Oynarken yürüyemezsin.
  3. Testi durdur, yine Play'e bas ve kamera 2. kareye uçarken Skip'e bas. Kamera hemen döner ve hemen yürüyebilirsin.
  4. BridgeTrigger'a gir: Bridge cutscene'i oynar. İçinden bir kez daha geç: hiçbir şey olmaz.
  5. Test modu açılır listesinden Server & Clients'ı seç, 2 client ayarla ve Play'e bas. Client 1 tetikleyiciye girdiğinde Bridge cutscene'i sadece Client 1'de oynar, Client 2 yürüyebilir.
  6. Workspace.StreamingEnabled'ı açık bırak ve bir kareyi spawn'dan uzağa taşı. Kamera vardığında çevre yerinde olmalı (muhtemelen, ama garanti değil: bkz. Streaming).
  7. Gamepad için testi durdur, Play'e bas, Controller Emulator'ı aç (Emulation sekmesi, sonra Controller) ve emüle edilen gamepad ile BridgeTrigger'a gir: Skip seçili olmalı, yani A cutscene'i atlar. Studio'nun Device Simulator'ını kullanıyorsan (15 Ekim 2026'daki kontrolümüzde bu bir beta: File, Beta Features, New Device Simulator'dan aç ve Studio'yu yeniden başlat), bir telefon seç, onu yatay çevir ve Skip'in kamera çentiğinin altına girmediğini ve kolay basıldığını, joystick ile zıplama düğmesinin de cutscene boyunca gizli olduğunu kontrol et.
  8. Bir ana menü de yaptıysan Play'e bas, sonra menüdeki Play düğmesine bas ve girişin sonuna kadar oynamasına izin ver: ondan sonra oyuncu listesi yine ekranda olmalı.

Output penceresini sürekli açık tut (Window menüsü, sonra Output). Her şey çalışırken bu scriptler hiçbir şey yazmaz, bu yüzden CutsceneService ya da CutscenePlayer'dan gelen her uyarı veya kırmızı hata gerçek bir sorundur. Bkz. Sık yapılan hatalar.

Sistemi nasıl genişletirsin

Sadece oyuncunun ilk girişinde giriş

seen tablosu bir sunucu boyunca yaşar, bu yüzden yeniden giren bir oyuncu girişi yine görür. Onu sadece ilk girişte göstermek için SeenIntro gibi bir işareti oyuncunun diğer verileriyle birlikte DataStore eğitimindeki PlayerData modülüyle kaydet. INTRO_CUTSCENE'ı olduğu gibi bırak ve CutsceneService'te onCharacterAdded'ın girişle ilgili kısmını değiştir: PlayerData.Get(player) oyuncunun verilerini döndürene kadar bekle, data.SeenIntro true ise girişi atla ve data.SeenIntro = true'yu sadece playOnce(player, INTRO_CUTSCENE) true döndürdüğünde ayarla. Girişi verileri yükleyen koddan başlatma: veriler karakter doğmadan önce yüklenebilir, karakter olmadan da play hiçbir şey yapmaz ve işaret kimsenin görmediği bir giriş için kaydedilir.

Cutscene'de oynayan karakterler

Studio'daki Animation Editor'da ya da Roblox dokümantasyonunda adı geçen Moon Animator gibi üçüncü taraf bir animasyon plugin'inde bir animasyon yap ve kamera o kareye vardığında onu bir NPC rig'inde oynat. Roblox'un Animator referansına göre NPC animasyonları sadece sunucu onları yükleyip başlatırsa replike olur, bu yüzden bütün oyuncuların NPC'nin oynadığını görmesi gerekiyorsa onu bir sunucu Script'inden oynat. CutscenePlayer'da yükleyip başlatırsan animasyon replike olmaz; bu, sadece tek bir oyuncunun izlediği bir cutscene için uygun. Animasyon scripti rehberi bir sunucu Script'inden NPC üzerinde animasyon oynatmayı gösteriyor.

Diyaloglar

Altyazılar kendiliğinden akan kısa replikler için uygun. Oyuncunun cevap verip seçenekler seçtiği bir konuşma için bkz. NPC diyalog rehberi.

Ana menüden sonra giriş

Ana menü rehberi CharacterAutoLoads'u kapatıyor, bu yüzden Play'e basana kadar kimse doğmuyor. CutsceneService girişi oyuncunun ilk doğuşunda oynatır, bu yüzden iki sistemle birlikte giriş Play'den sonraki ilk doğuşta oynar. Menü, karakter ortaya çıktığında core GUI'leri geri açar; bu giriş zaten oynarken olabilir, bu yüzden giriş sırasında oyuncu listesi görünebilir. CutscenePlayer sadece kendi gizlediğini geri açar, bu yüzden menünün değişikliğine dokunmaz ve girişten sonra bunlar açık kalır. Ana menü rehberindeki kamera part'ını hizalamak için Command Bar numarası, 1. adımdakiyle aynı.

Tur başında harita turu

Bir cutscene'i başka bir sunucu scriptinden, örneğin tur sistemi rehberindeki tur başı harita turunu başlatmak için ServerStorage'a PlayCutscene adlı bir BindableEvent ekle. CutsceneService'in sonunda onun Event'ini play fonksiyonuna bağla, tur scripti de onu her oyuncu ve cutscene adıyla çağırsın. play "sunucu başına bir kez" kontrolünü atlar, bu yüzden harita turu her turda oynar.

Cutscene plugin'leri

Plugin'leri bu rehberle birlikte kullanabilirsin. Bir cutscene plugin'i kendi kamera scriptini yazıyorsa, kamerayı geri verdiğini (CameraType Custom ve CameraSubject) ve kamera Scriptable iken Focus'u ayarladığını kontrol et; cutscene'i kimin göreceği kararını da bu rehberdeki gibi sunucuda bırak.

Sık yapılan hatalar ve çözümleri

Play'e basmadan önce Output penceresini aç (Window menüsü, sonra Output). Cutscene sorunlarının çoğu ya orada bir uyarı yazar ya da eşleşmeyen bir addan kaynaklanır.

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

CutsceneService, doğrudan Workspace içinde Cutscenes adlı bir klasör bekliyor. Onu 1. adımdaki gibi oluştur ve yazımı ve büyük C'yi kontrol et. O yokken CutsceneService CutsceneEvent'i oluşturmaz, bu yüzden CutscenePlayer da bekler.

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

CutscenePlayer, CutsceneService'in oluşturduğu remote'u bekliyor. CutsceneService'in LocalScript değil Script olduğunu, doğrudan ServerScriptService içinde durduğunu, kapalı olmadığını ve Output'ta ondan Cutscenes ile ilgili bir hata ya da uyarı olmadığını kontrol et.

CutsceneService: no folder named Intro in Workspace.Cutscenes

INTRO_CUTSCENE'daki ya da tetikleyicinin Cutscene attribute'undaki ad, Workspace.Cutscenes içindeki hiçbir klasörle eşleşmiyor. Adlarda büyük küçük harf önemli.

Hiçbir şey oynamıyor ve Output boş

Klasörde 1 adlı bir part yok ya da part'ları doğrudan onun içinde değil (örneğin bir Model içinde). CutsceneService 1, 2, 3 part'larını sırayla okur ve ilk eksik numarada durur. Bir de her cutscene'in sunucu başına oyuncu başına bir kez oynadığını unutma: testi durdur ve yine Play'e bas.

Kamera yanlış yere bakıyor

Kamera, kare part'ının ön yüzünün baktığı yöne bakar. Studio kamerasını istediğin görüntüye getir ve o kare için 1. adımdaki Command Bar satırını yeniden çalıştır.

Tetikleyici hiçbir şey yapmıyor

Oyun başladığında tetikleyici part'ın doğrudan Workspace.CutsceneTriggers içinde olduğunu, CanTouch'ın işaretli olduğunu (değilse Output'ta bir uyarı olur) ve Cutscene attribute'unun Workspace.Cutscenes içindeki bir klasörün adını taşıyan bir string olduğunu kontrol et. Tetikleyicinin içinden ikinci kez geçmek hiçbir şey yapmaz, bu bilerek böyle.

Cutscene'den sonra kamera son karede kalıyor

CutscenePlayer kamerayı geri veremeden bir hatayla durdu, bu yüzden Output'ta ondan gelen kırmızı bir hata ara. Kamerayı, CameraType'ı sürekli Scriptable yapan başka bir script de tutuyor olabilir, örneğin hâlâ bağlı olan bir menü kamerası.

RoCode ile yap

Bunu elle kurmak istemiyorsan RoCode bunu açık olan place'inde yapabilir. RoCode, Roblox'a ait olmayan, Roblox Studio için bağımsız bir yapay zeka ajanı: özelliği web sohbetinde anlatıyorsun, Studio plugin'i de part'ı ve scriptleri Explorer'ında oluşturuyor, yani sohbet penceresinden kod kopyalaman gerekmiyor.

Sen yazarsın

Bir giriş cutscene'i ekle: içinde Intro klasörü ve 1'den 3'e kadar kareler olan bir Cutscenes klasörü, Caption attribute'undan altyazılar, siyah şeritler ve bir Skip düğmesi; oyuncunun ilk doğuşunda bir kez oynasın, sunucu oyuncuyu yerinde tutsun, sonunda da kamera geri dönsün.

RoCode yapar
  • Önce place'ini Search Scripts ile kontrol edebilir, örneğin CameraType'ı zaten ayarlayan bir menü ya da kamera scripti var mı diye, böylece çakışmazlar
  • Klasörleri ve tetikleyici part'ı Create Instance ile oluşturur ve part'lara Caption ve MoveSeconds gibi attribute'lar ayarlar
  • CutsceneService'i ve CutscenePlayer'ı Create Script ile yazar
  • Yazdığı her scripti, onu çalıştırmadan Studio'da derleyen Check Script ile kontrol etmesi söylenmiştir ve her değişiklik grubundan önce ve sonra bir geri alma noktası koyar

Kare part'larını Studio kamerasını her görüntüye getirerek kendin yerleştir, sonra scriptleri iste. Plugin 3.9 ya da üstüyle RoCode kısa bir playtest başlatıp hataları okuyabilir, plugin 3.9.11 ya da üstüyle de oyunun çalıştığını kontrol etmek için bir test karakterini yönetebilir, ama oyun sırasında ekran görüntüsü almaz, bu yüzden cutscene'i kendin izliyorsun. Bütün bir oyunu hangi sırayla kuracağın yapay zeka ile Roblox oyunu yapma, sistem sistem sayfasında. RoCode Studio'ya nasıl bağlanır.

Sık sorulan sorular

Oyuna girişte bir cutscene nasıl oynatılır?

Kare klasörüne Workspace.Cutscenes içinde Intro adını ver ya da INTRO_CUTSCENE'ı kendi klasörünün adına değiştir. CutsceneService onu her oyuncunun sunucudaki ilk doğuşunda oynatır. Onu sadece en ilk girişte göstermek için bir data store'a bir işaret kaydet ve işareti sadece giriş başladıktan sonra ayarla; Sistemi nasıl genişletirsin bölümünde anlatıldığı gibi.

Plugin olmadan cutscene yapılabilir mi?

Evet. Bu rehberde sadece part'lar, attribute'lar ve iki script var, Command Bar satırı da her kareyi tam olarak Studio kamerasının durduğu yere koyuyor. Moon Animator gibi plugin'ler, cutscene'de oynayan karakterleri animasyonlamak için yine de kullanışlı.

Cutscene'de kamera neden hareket etmiyor?

Genelde kamera kodu bir sunucu Script'inde duruyor, oyuncunun kamerasını ise sadece bir LocalScript hareket ettirebilir, çünkü her cihazın kendi kamerası var. Diğer sık sebep: CameraType Scriptable değil ve Roblox'un standart kamera scriptleri kamerayı sürekli karaktere geri getiriyor.

Cutscene sırasında oyuncunun hareket etmesi nasıl engellenir?

Oynarken onun HumanoidRootPart'ını sunucuda anchor'la ve sonra anchor'ı kaldır, CutsceneService'in yaptığı gibi. Anchor'lanmış bir part fizikten asla hareket etmez. WalkSpeed'e dokunulmaz, bu yüzden bir sprint scriptiyle ya da hız pass'iyle çakışmaz.

Cutscene'e Skip düğmesi nasıl eklenir?

Cutscene ekranına bir TextButton koy ve onun, düğme seçiliyken tıklamada, dokunmada ya da gamepad'deki A düğmesinde tetiklenen Activated event'ini bağla. CutscenePlayer'daki Skip, kare döngüsünün her frame kontrol ettiği bir işaret koyar, gamepad oyuncuları için kendiliğinden seçilir ve telefonun kamera çentiği onu kapatmasın diye varsayılan boşluklu kendi ScreenGui'sinde durur. Joystick ve zıplama düğmesi cutscene boyunca gizlidir, bu yüzden onun yanında durmazlar.

Cutscene'de dünya neden boş?

Instance streaming açıkken oyuncunun cihazında sadece karakterinin yakınındaki alan var. CutsceneService'in yaptığı gibi, sunucu her kare için, kamera oraya uçmadan kısa süre önce player:RequestStreamAroundAsync çağırsın. Roblox, bu şekilde alanın muhtemelen ama kesin olmayarak yükleneceğini yazıyor, bu yüzden önemli kareleri streaming yarıçapının içinde tut ya da yüklü kalması gereken bir alan için Player:AddReplicationFocus kullan.

Kaynaklar ve ek okumalar

Kod nasıl kontrol edildi: bu sayfadaki her script, Roblox API tanımlarıyla Luau'nun katı tür denetleyicisinden geçiyor (luau-lsp, 20 Kasım 2026). Tür denetimi yanlış yazılmış API'leri ve hatalı türleri yakalar, oyun mantığını değil. Bu yüzden yayınlamadan önce Studio'da test et.

RoCode'u kendi oyununda dene.

Her gün ücretsiz kredi, kart gerekmez. Plugin'i kur, özelliği anlat ve Studio'da ne oluştuğunu kontrol et.