باختصار
ضع قطعًا غير مرئية مثبّتة (Anchored) بأسماء 1 و2 و3 في مجلد داخل Workspace.Cutscenes، كلٌّ منها متجهة إلى حيث يجب أن تنظر الكاميرا. Script في ServerScriptService يقرأ قيم CFrame الخاصة بها، ويُبقي اللاعب في مكانه، ويرسل اللقطات إلى هذا اللاعب عبر RemoteEvent. وLocalScript في StarterPlayerScripts يضبط workspace.CurrentCamera.CameraType على Scriptable، ويحرّك الكاميرا كل إطار من لقطة إلى أخرى (مع التنعيم عبر TweenService:GetValue)، ثم يعيد CameraType إلى Custom وCameraSubject إلى Humanoid اللاعب.
- لا يتحكم في الكاميرا إلا جهاز اللاعب، لذا فكود الكاميرا LocalScript. أما الخادم فيقرر فقط من يرى أي مشهد ومتى.
- عندما تكون الكاميرا Scriptable تتوقف Roblox عن تحديث
Camera.Focus. ويقول المرجع إن عليك تحديث Focus كل إطار، وإلا فقد لا تُرسم الإضاءة الديناميكية البعيدة عن التركيز القديم. Camera:Interpolateمهجورة. ويقول مرجع Roblox إن عليك تحريك الكاميرا عبر TweenService.
في هذه الصفحة
كيف يعمل المشهد السينمائي
لكل جهاز لاعب كائن Camera خاص به، في workspace.CurrentCamera، لذا لا يستطيع تحريك ما يراه اللاعب إلا LocalScript. أما تحديد من يرى أي مشهد ومتى فهو عمل الخادم. ويقسّم الدليل العمل بهذه الطريقة بالضبط. هكذا يجري المشهد الواحد:
- يقرر الخادم أن على اللاعب رؤية المشهد:
Introعند ظهوره الأول على الخادم، أو مشهدًا آخر عندما يلمس قطعة محفّزة. - يقرأ CutsceneService قيم CFrame وإعدادات قطع اللقطات، ويطلب من Roblox تحميل منطقة اللقطة الأولى لهذا اللاعب، ويثبّت HumanoidRootPart الخاص باللاعب ليبقى في مكانه، ويرسل
CutsceneEventإلى هذا اللاعب فقط مع المعرّف id وقائمة اللقطات. - يعرض CutscenePlayer على جهاز اللاعب الأشرطة السوداء وزر Skip، ويخفي قائمة اللاعبين والحقيبة وشريط الصحة وأزرار اللمس، ويجعل الكاميرا Scriptable ويحرّكها كل إطار.
- عندما تنتهي آخر لقطة أو يضغط اللاعب Skip، يعيد الكاميرا إلى الشخصية ويرسل إلى الخادم
CutsceneEventبالمعرّف id نفسه. - يفك الخادم تثبيت اللاعب. وإذا لم تصل هذه الرسالة أبدًا فإنه يفك التثبيت على أي حال بعد مرور طول المشهد زائد ثانيتين. يبدأ المؤقت عندما يرسل الخادم المشهد، ومع الدخول البطيء قد يبدأ الجهاز المشهد التمهيدي متأخرًا بضع ثوانٍ، لأن LocalScript خارج ReplicatedFirst لا يعمل حتى تكتمل اللعبة تحميلًا. عندها قد يستطيع اللاعب الحركة مجددًا قبل أن ينتهي المشهد التمهيدي على شاشته.
| العنصر | أين يوجد | ماذا يفعل |
|---|---|---|
Script CutsceneService | ServerScriptService | يقرر من يرى أي مشهد ومتى، ويقرأ اللقطات، ويُبقي اللاعب في مكانه، ويتذكر من رأى ماذا. |
LocalScript CutscenePlayer | StarterPlayer، StarterPlayerScripts | يشغّل المشهد على شاشة اللاعب: الأشرطة والنصوص وSkip وحركة الكاميرا. وفي النهاية يعيد الكاميرا. |
RemoteEvent CutsceneEvent | ReplicatedStorage (ينشئه CutsceneService) | يحمل اللقطات من الخادم إلى لاعب واحد، ويعيد في الاتجاه المعاكس رسالة "انتهى المشهد". |
Folder Cutscenes | Workspace | مجلد لكل مشهد، مثل Intro، فيه قطع اللقطات 1 و2 و3. |
Folder CutsceneTriggers | Workspace (اختياري) | قطع تبدأ مشهدًا عندما يلمسها اللاعب. |
Workspace
Cutscenes Folder new
Intro Folder new
1 Part new
2 Part new
3 Part new
Bridge Folder new
1 Part new
2 Part new
CutsceneTriggers Folder new
BridgeTrigger Part new
ServerScriptService
CutsceneService Script new
StarterPlayer
StarterPlayerScripts
CutscenePlayer LocalScript new
الخطوة 1: ضع لقطات الكاميرا
كل لقطة قطعة غير مرئية. تأخذ الكاميرا موضع القطعة وتنظر في اتجاه وجهها الأمامي، لذا فوضع لقطة يعني وضع الكاميرا.
- في Explorer مرّر المؤشر على Workspace، واضغط زر +، وأدرج Folder باسم
Cutscenes. وداخله أدرج Folder باسمIntro. حالة الأحرف في الأسماء مهمة. - حرّك كاميرا Studio إلى أول منظر تريده، كأنك تضبط لقطة لصورة.
- أدرج Part في Intro وأعد تسميته إلى
1. - افتح Command Bar (في تبويب Script أو عبر Window ثم Script) ونفّذ
workspace.Cutscenes.Intro["1"].CFrame = workspace.CurrentCamera.CFrame. في وضع التحرير تكونCurrentCameraهي المنظر الذي ترى من خلاله، لذا توضع القطعة تمامًا في هذه اللقطة. الأقواس وعلامات الاقتباس لازمة لأن الاسم الذي يبدأ برقم لا يمكن كتابته بعد النقطة. - في Properties الخاصة بالقطعة فعّل Anchored، وألغِ CanCollide وCanTouch وCanQuery، واضبط Transparency على 1. يمنعها Anchored من السقوط عبر الخريطة؛ والباقي يمنعها من إعاقة اللاعبين وتشغيل أحداث اللمس وحجب أشعة raycast.
- كرّر للمناظر التالية، مسمّيًا القطع
2و3وهكذا، ومغيّرًا الرقم في سطر Command Bar. يشغّل CutsceneService اللقطات بترتيب الأرقام ويتوقف عند أول رقم مفقود، لذا فالفجوة في الترقيم تقطع المشهد قبل أوانه.
لتغيير لقطة لاحقًا، حرّك الكاميرا إلى المنظر الجديد ونفّذ السطر نفسه برقم تلك اللقطة. ومع Transparency بقيمة 1 تكون القطع غير مرئية في Studio أيضًا، لذا اخترها من Explorer عندما تحتاج إليها.
يمكن أن تكون لكل لقطة ثلاث سمات اختيارية أخرى. لإضافة سمة، اختر القطعة، ومرّر نافذة Properties إلى قسم Attributes، واضغط +، وأدخل الاسم، واختر النوع، واضغط Save.
| السمة | النوع | الافتراضي | ماذا تفعل |
|---|---|---|---|
MoveSeconds | number | 3 | عدد الثواني التي تطير فيها الكاميرا من اللقطة السابقة إلى هذه. القيمة 0 تجعلها انتقالًا مفاجئًا. اللقطة 1 دائمًا انتقال، لذا لا تؤثر فيها هذه السمة. |
HoldSeconds | number | 1 | عدد الثواني التي تبقى فيها الكاميرا على هذه اللقطة بعد وصولها. |
Caption | string | لا يوجد | نص على الشريط السفلي من لحظة بدء طيران الكاميرا نحو هذه اللقطة. اللقطة دون Caption تمسح النص. |
الرقم الأقل من 0 أو الأكبر من 60، وكذلك السمة ذات النوع الخاطئ، يُستبدل بالقيمة الافتراضية.
الخطوة 2: أضف سكربت الخادم
مرّر المؤشر على ServerScriptService، وأدرج Script باسم CutsceneService، والصق فيه الكود أدناه. الإعدادات في الأعلى هي الأسطر التي يمكنك تغييرها.
-- Script في ServerScriptService باسم CutsceneService.
-- يقرر من يرى أي مشهد ومتى. يقرأ لقطات الكاميرا من القطع المرقّمة
-- في Workspace.Cutscenes، ويُبقي اللاعب في مكانه، ويطلب من جهاز
-- هذا اللاعب تشغيل اللقطات. أما الكاميرا نفسها فلا يمكن تحريكها إلا على الجهاز.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- الإعدادات
local INTRO_CUTSCENE = "Intro" -- يعمل مرة واحدة عند أول ظهور للاعب؛ "" لتعطيله
local DEFAULT_MOVE_SECONDS = 3 -- مدة الطيران إلى اللقطة إذا لم تكن لها MoveSeconds
local DEFAULT_HOLD_SECONDS = 1 -- مدة البقاء على اللقطة إذا لم تكن لها HoldSeconds
local MAX_SHOTS = 30
local cutscenes = workspace:WaitForChild("Cutscenes")
local triggers = workspace:FindFirstChild("CutsceneTriggers")
-- هذا السكربت ينشئ CutsceneEvent بنفسه، لذا لا تضفه يدويًا
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 } = {} -- id المشهد الذي يشاهده اللاعب
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
-- اللقطات هي القطع 1 و2 و3 ... في مجلد يحمل اسم المشهد
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,
-- اللقطة الأولى انتقال، لذا تقفز الكاميرا إليها فورًا
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 -- هذا المشهد انتهى بالفعل
end
playing[player] = nil
setFrozen(player, false)
end
local function play(player: Player, name: string): boolean
if playing[player] then
return false -- مشهد واحد في كل مرة
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 قد لا تكون على جهاز اللاعب المنطقة
-- التي تنظر إليها اللقطة، والطلب يحمّل المنطقة مؤقتًا فقط. نحمّل
-- منطقة اللقطة الأولى الآن (ننتظر حتى ثانيتين)، ومنطقة كل لقطة تالية
-- قبل ثانيتين من طيران الكاميرا إليها.
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 -- خرج اللاعب أثناء تحميل المنطقة
end
setFrozen(player, true)
cutsceneEvent:FireClient(player, id, shots)
local startsAt = 0 -- الثواني من الآن حتى بدء الطيران إلى هذه اللقطة
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
-- احتياط: نفك تجميد اللاعب حتى لو لم يردّ جهازه أبدًا
task.delay(startsAt + 2, finish, player, id)
return true
end
-- تعيد true فقط إذا بدأ المشهد لهذا اللاعب
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
-- جهاز اللاعب يبلّغ بأن المشهد انتهى أو تم تخطيه
cutsceneEvent.OnServerEvent:Connect(function(player: Player, id: unknown)
if typeof(id) == "number" then
finish(player, id)
end
end)
-- القطع المحفّزة: اللمس يبدأ المشهد المذكور في سمتها Cutscene
if triggers then
for _, trigger in triggers:GetChildren() do
if not trigger:IsA("BasePart") then
continue
end
if not trigger.CanTouch then
-- ربط Touched بقطعة CanTouch فيها معطّل يعطي خطأ، لذا نكتفي بالتحذير
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) -- ظهور جديد أثناء المشهد، نُبقي الشخصية الجديدة في مكانها أيضًا
elseif INTRO_CUTSCENE ~= "" then
playOnce(player, INTRO_CUTSCENE)
end
end
local function onPlayerAdded(player: Player)
if seen[player] then
return -- تم إعداده بالفعل
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 -- كل من دخل بينما كان السكربت ينتظر Cutscenes
onPlayerAdded(player)
end
Players.PlayerRemoving:Connect(function(player: Player)
seen[player] = nil
playing[player] = nil
end)
ينشئ CutsceneService كائن RemoteEvent باسم CutsceneEvent بنفسه فور ظهور Workspace.Cutscenes، لذا لا تحتاج إلى إدراج أي شيء يدويًا في ReplicatedStorage. وإذا كنت قد صنعت RemoteEvent بهذا الاسم فاحذفه: فقد يجد LocalScript كائنك، ولا أحد على الخادم يستمع إليه.
| الإعداد | القيمة هنا | ماذا يغيّر |
|---|---|---|
INTRO_CUTSCENE | "Intro" | المجلد في Workspace.Cutscenes الذي يعمل عند أول ظهور للاعب على الخادم. اضبطه على "" لإلغاء المشهد التمهيدي. |
DEFAULT_MOVE_SECONDS | 3 | مدة الطيران إذا لم تكن للقطة سمة MoveSeconds. |
DEFAULT_HOLD_SECONDS | 1 | مدة بقاء الكاميرا على اللقطة إذا لم تكن لها سمة HoldSeconds. |
MAX_SHOTS | 30 | أكبر رقم لقطة يبحث عنه CutsceneService في المشهد الواحد. |
ما يفعله باقي السكربت، بالترتيب:
- يقرأ اللقطات على الخادم. تجمع
readShotsقيمة CFrame وسمات كل قطعة مرقّمة في قائمة. يتلقى جهاز اللاعب هذه القائمة، لذا لا يحتاج إلى القطع نفسها. - مشهد واحد في كل مرة. لا تفعل
playشيئًا ما دام اللاعب يشاهد مشهدًا بالفعل، أو إذا لم يكن لشخصيته Humanoid أو كانت ميتة. - لكل مشهد معرّف id خاص به. يعيد الجهاز المعرّف عندما ينتهي المشهد أو يُتخطى، ولا يفك تجميد اللاعب إلا المعرّف المطابق، لذا لا تستطيع رسالة متأخرة من مشهد سابق إنهاء مشهد جديد.
- يُبقي اللاعب في مكانه بتثبيت HumanoidRootPart الخاص به، ويثبّت الشخصية الجديدة إذا ظهر اللاعب من جديد في منتصف المشهد. يقول مرجع Roblox إن القطعة المثبّتة لا يتغير موضعها أبدًا بسبب الجاذبية أو التصادمات أو أي فيزياء أخرى. ولا يُمس WalkSpeed، لذا لا يتعارض هذا مع سكربت الركض أو مع pass للسرعة. في النهاية يفك السكربت تثبيت root part حتى لو ثبّتها سكربت آخر، لذا لا تثبّت الشخصيات في مكان آخر ما دام مشهد قد يكون جاريًا.
- الاحتياط. يفك
task.delayتجميد اللاعب بعد الطول الكامل للمشهد زائد ثانيتين، حتى لو لم يردّ جهازه أبدًا. - كل مشهد مرة واحدة لكل خادم. يتذكر الجدول
seenلكل لاعب أي المشاهد بدأت بالفعل، لذا لا يتكرر المشهد التمهيدي عند الظهور من جديد، ويعمل مشهد المحفّز مرة واحدة. تعيدplayOnceالقيمة true فقط إذا بدأ المشهد فعلًا. - يُعدّ كل لاعب. الحلقة على
Players:GetPlayers()في النهاية تلتقط كل من دخل بينما كان السكربت ينتظر مجلد Cutscenes.
تذهب اللقطات إلى اللاعب باستدعاء واحد لـ FireClient، كقائمة من جداول صغيرة. تقول صفحة Roblox عن remote events إن عليك ألا ترسل جدولًا يختلط فيه مفاتيح رقمية ونصية؛ وفي هذه القائمة مفاتيح رقمية فقط، وفي كل لقطة داخلها مفاتيح نصية فقط، وهذا هو الشكل الذي تنصح به تلك الصفحة.
الخطوة 3: أضف LocalScript الذي يشغّله
- في Explorer وسّع StarterPlayer، ومرّر المؤشر على StarterPlayerScripts، وأدرج LocalScript باسم
CutscenePlayer. - استبدل محتواه بالكود أدناه.
-- LocalScript في StarterPlayer > StarterPlayerScripts باسم CutscenePlayer.
-- يشغّل المشهد الذي يرسله الخادم: أشرطة سوداء، ونصوص، وزر Skip، و
-- كاميرا تطير من لقطة إلى لقطة. ثم يعيد الكاميرا إلى اللاعب.
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 -- كل شريط أسود، كنسبة من ارتفاع الشاشة
local EASING_STYLE = Enum.EasingStyle.Sine
local FOCUS_DISTANCE = 30 -- كم وحدة أمام الكاميرا يجب أن ترسمها Roblox بأعلى تفصيل
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 }
-- شاشة المشهد: شريطان أسودان ونص، من حافة إلى حافة. تنصح Roblox بضبط
-- ScreenInsets على None فقط لما لا يضغطه أحد، لذا لزر Skip أدناه ScreenGui خاص به.
local gui = Instance.new("ScreenGui")
gui.Name = "Cutscene"
gui.ResetOnSpawn = false
gui.ScreenInsets = Enum.ScreenInsets.None -- على كامل الشاشة
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 الهوامش الافتراضية، لذا لا تغطيه فتحة الكاميرا
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) -- على الشريط السفلي، يمينًا
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 كبيرًا بما يكفي لإصابته على هاتف صغير
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
-- الطيران الحالي: من CFrame للكاميرا إلى التالي خلال عدد معيّن من الثواني
local moveFrom = CFrame.identity
local moveTo = CFrame.identity
local moveStart = 0
local moveSeconds = 0
local skipRequested = false
local busy = false
-- تعمل كل إطار أثناء المشهد. لا يتبع Focus في كاميرا Scriptable أي شيء
-- من تلقاء نفسه، لذا يُضبط هنا أيضًا.
local function updateCamera()
if camera.CameraType ~= Enum.CameraType.Scriptable then
camera.CameraType = Enum.CameraType.Scriptable -- شيء ما أعاد ضبطه، كالظهور من جديد
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
-- هناك مشهد يعمل بالفعل، لذا ليفك الخادم تجميد اللاعب فورًا لهذا المشهد
cutsceneEvent:FireServer(id)
return
end
busy = true
skipRequested = false
-- نخفي قائمة اللاعبين والحقيبة وشريط الصحة، مع تذكّر ما كان ظاهرًا
local wasEnabled: { [Enum.CoreGuiType]: boolean } = {}
for _, coreGui in HIDDEN_CORE_GUIS do
wasEnabled[coreGui] = StarterGui:GetCoreGuiEnabled(coreGui)
StarterGui:SetCoreGuiEnabled(coreGui, false)
end
-- على الهواتف نخفي عصا التحكم وزر القفز الموجودين في الزاويتين السفليتين
local touchControlsWere = GuiService.TouchControlsEnabled
GuiService.TouchControlsEnabled = false
gui.Enabled = true
controls.Enabled = true
-- يد التحكم لا تضغط إلا الزر المحدد، لذا نحدد Skip للاعبين بيد التحكم
if UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
GuiService.SelectedObject = skipButton
end
camera = workspace.CurrentCamera
camera.CameraType = Enum.CameraType.Scriptable
moveTo = camera.CFrame
-- خطوة واحدة بعد تحديث كاميرا Roblox نفسها، كما في درس Roblox عن الكاميرا
RunService:BindToRenderStep("Cutscene", Enum.RenderPriority.Camera.Value + 1, updateCamera)
for _, shot in shots do
moveFrom = camera.CFrame -- نبدأ كل طيران من حيث الكاميرا الآن
moveTo = shot.cframe
moveStart = os.clock()
moveSeconds = shot.move
caption.Text = shot.caption
waitOrSkip(shot.move + shot.hold)
if skipRequested then
break
end
end
-- نعيد الكاميرا إلى شخصية اللاعب
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 = ""
-- نعيد تفعيل ما عطّله هذا المشهد فقط، ولا نمس الباقي
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) -- الخادم يفك تجميد اللاعب فورًا
busy = false
end
skipButton.Activated:Connect(function()
skipRequested = true
end)
cutsceneEvent.OnClientEvent:Connect(function(id: number, shots: { Shot })
play(id, shots)
end)
يُنسخ LocalScript الموجود في StarterPlayerScripts إلى اللاعب مرة واحدة عند الدخول، ويستمر في العمل بعد ظهور الشخصية من جديد. لهذا يكون ResetOnSpawn معطّلًا في كلا الـ ScreenGui: لو فعّلته لحذفتهما Roblox عند أول ظهور جديد، ولن يعيد هذا السكربت إنشاءهما. والرسائل التي تصل عبر remote قبل أن يتصل السكربت بـ OnClientEvent توضع في طابور وتُسلَّم بعد الاتصال، لذا سيرى المشهد التمهيدي حتى اللاعب الذي ظهر بسرعة.
| الجزء | ماذا يفعل |
|---|---|
ScreenGui Cutscene | شريطان أسودان، كل منهما 12% من ارتفاع الشاشة (BAR_HEIGHT)، ونص على الشريط السفلي. تمدّ ScreenInsets بقيمة None الشريطين حتى حواف الشاشة تمامًا، وDisplayOrder بقيمة 10 يرسمهما فوق كل ScreenGui ذي DisplayOrder أصغر. |
ScreenGui CutsceneControls | فيه زر Skip فقط، يمين الشريط السفلي، مع UISizeConstraint يُبقيه بحجم لا يقل عن 64 في 32 بكسل، ليسهل إصابته على الهاتف. له ScreenInsets الافتراضية، فلا يدخل محتواه تحت أزرار الشريط العلوي في Roblox ولا تحت فتحات الكاميرا. تنصح Roblox بقيمة None فقط للمحتوى الذي لا يُضغط، لذا لا يمكن أن يكون Skip في ScreenGui الأشرطة. |
HIDDEN_CORE_GUIS | يخفي قائمة اللاعبين والحقيبة وشريط الصحة عبر SetCoreGuiEnabled، بعد أن يتذكر عبر GetCoreGuiEnabled أيها كان مفعّلًا، وفي النهاية يعيد تفعيل ما عطّله بنفسه فقط. إذا كانت اللعبة تخفي الحقيبة في مكان آخر فستبقى مخفية، ولا شيء يتجاوز سكربتًا يفعّلها أثناء المشهد، مثل القائمة الرئيسية. |
TouchControlsEnabled | على الهواتف والأجهزة اللوحية تضبط play القيمة GuiService.TouchControlsEnabled على false طوال المشهد. هذا يخفي عصا التحكم وزر القفز الموجودين في الزاويتين السفليتين، حيث يوجد Skip أيضًا، ويعودان في النهاية إن كانا مفعّلين. |
updateCamera | تعمل كل إطار ما دام المشهد جاريًا. تحسب الجزء المقطوع من الطيران الحالي، وتنعّمه عبر TweenService:GetValue، وتضع الكاميرا بين لقطتين عبر CFrame:Lerp، وتضبط Focus على بعد 30 وحدة أمام الكاميرا. |
waitOrSkip | تنتظر وقت الطيران والتوقف على اللقطة، وتفحص علامة Skip كل إطار. |
play | تجعل الكاميرا Scriptable، وتشغّل اللقطات بالترتيب، ثم تعيد الكاميرا (CameraType بقيمة Custom، وCameraSubject هو Humanoid)، وتعيد تفعيل core GUI وأزرار اللمس، وترسل إلى الخادم معرّف المشهد. وإذا وصل مشهد ثانٍ والأول ما زال يعمل فإنها تعيد معرّفه فورًا، كي لا يُبقي الخادم اللاعب في مكانه من أجل مشهد لم يعرضه هذا الجهاز. |
| زر Skip | يعمل Activated عند النقر بالفأرة أو اللمس أو زر A في يد التحكم عندما يكون الزر محددًا. وللاعب الذي إدخاله الأساسي يد تحكم تحدد play الزر Skip في بداية المشهد وتلغي التحديد في نهايته. |
غيّر BAR_HEIGHT لتجعل الأشرطة أنحف أو أعرض، وEASING_STYLE لتغيير الإحساس بالطيران (انظر ما يفعله كود الكاميرا بشكل صحيح). للنص وزر Skip خاصية TextScaled مفعّلة، لذا يكبر النص ويصغر مع الشاشة.
الخطوة 4: مشهد عند لمس قطعة
المشهد التمهيدي يعمل وحده. ولمشهد في مكان معيّن من الخريطة، كأن يصل اللاعب إلى الجسر أول مرة، أضف مشهدًا ثانيًا وقطعة محفّزة.
- في Workspace، داخل Cutscenes، أدرج Folder باسم
Bridgeوضع لقطاته كما في الخطوة 1، بالاسمين1و2. وفي سطر Command Bar اكتبBridgeبدلIntro. - مرّر المؤشر على Workspace وأدرج Folder باسم
CutsceneTriggers. - أدرج فيه Part باسم
BridgeTrigger. اجعله كبيرًا بحيث لا يستطيع اللاعبون المرور دون لمسه، مثل لوح عالٍ وعريض بعرض الطريق. فعّل Anchored، وألغِ CanCollide وCanQuery، وأبقِ CanTouch مفعّلًا، واضبط Transparency على 1. تعطيل CanQuery يمنع اللوح غير المرئي من حجب أشعة raycast، مثل الطلقات من دليل الأسلحة. أحداث اللمس يتحكم فيها CanTouch لا CanQuery، لذا يظل المحفّز يعمل. - أضف إليه سمة
Cutsceneمن نوع string واضبط قيمتها علىBridge: اسم المجلد الذي يجب تشغيله.
يربط CutsceneService الحدث Touched بكل قطعة موجودة مباشرة داخل CutsceneTriggers عند بدء الخادم، لذا أضف المحفّزات في Studio لا بسكربت أثناء اللعب. والمحفّز الذي CanTouch فيه معطّل يُتخطى مع تحذير في Output، لأن Roblox تعطي خطأ عندما يربط سكربت الحدث Touched بقطعة كهذه.
بينما تمر الشخصية عبر القطعة يعمل Touched مرات كثيرة متتالية. الجدول seen وقاعدة "مشهد واحد في كل مرة" يحوّلان ذلك إلى مشهد واحد لكل لاعب في كل خادم. واللاعب الذي يلمس المحفّز أثناء مشهد آخر يُتجاهَل، ويبقى المحفّز جاهزًا له.
لا تضع المحفّزات على الطرق. HumanoidRootPart للاعب الجالس ملحوم بالمقعد، وعندما تُثبَّت قطعة واحدة من مجموعة ملحومة تثبّت Roblox معها البقية. لذا فاللاعب الذي يقود إلى داخل المحفّز يُبقي مركبته كلها في مكانها، مع الركاب، حتى ينتهي المشهد.
ما يفعله كود الكاميرا بشكل صحيح
Scriptable، ثم العودة إلى Custom
سكربتات الكاميرا في Roblox لا تحرّك الكاميرا ولا تحدّثها ما دامت CameraType مساوية لـ Scriptable، وهذا بالضبط ما يتيح لـ CutscenePlayer ضبطها. في النهاية يعيد CameraType إلى Custom ويجعل Humanoid اللاعب هو CameraSubject، الذي تتبعه سكربتات الكاميرا في Roblox افتراضيًا. ويُنفَّذ ذلك أيضًا بعد Skip، فلا يبقى اللاعب أبدًا عالقًا ينظر إلى آخر لقطة.
فحصان صغيران يُبقيان المشهد هو المسيطر أثناء عمله. إذا ضبط شيء ما CameraType على قيمة أخرى في منتصف المشهد، تعيد الدالة التي تعمل كل إطار القيمة Scriptable في الإطار التالي. ويعيد السكربت قراءة workspace.CurrentCamera في بداية كل مشهد، لأن Roblox تنشئ Camera جديدة إذا حُذفت الحالية في أي وقت.
Focus، كل إطار
يخبر Camera.Focus المحرّك بالمنطقة التي يعطيها الأولوية في أعمال مثل الإضاءة. تُبقيه سكربتات الكاميرا في Roblox على CameraSubject، لكن ليس عندما تكون الكاميرا Scriptable، ويقول مرجع Roblox إن عليك في هذه الحالة تحديثه كل إطار: فالضوء الديناميكي من كائنات مثل PointLight قد لا يُرسم بعيدًا عن التركيز. يضعه CutscenePlayer على بعد 30 وحدة أمام الكاميرا (FOCUS_DISTANCE). زد هذا الرقم إذا كانت لقطاتك تنظر إلى شيء أبعد.
تعمل الدالة عبر RunService:BindToRenderStep، كل إطار قبل الرسم، بخطوة أولوية واحدة بعد تحديث كاميرا Roblox نفسها (Enum.RenderPriority.Camera.Value + 1). هذه الأولوية يستخدمها درس Roblox عن الكاميرا، لذا يضبط المشهد الكاميرا بعد أن يعمل كود الكاميرا الخاص بـ Roblox.
التنعيم عبر TweenService:GetValue
كان Tween على camera.CFrame سيحرّك الكاميرا، لكن Focus يجب ضبطه كل إطار على أي حال، لذا يحرّك CutscenePlayer الكاميرا بنفسه في الدالة نفسها. لكل طيران يحسب نسبة الوقت الذي مضى (من 0 إلى 1)، ويمرّرها عبر TweenService:GetValue مع نمط التنعيم واتجاهه، ويضع الكاميرا عند تلك النسبة من المسافة بين لقطتين عبر CFrame:Lerp، الذي يحرّك الموضع في خط مستقيم ويدير بسلاسة. تحصر GetValue المدخل بين 0 و1، لذا تتوقف الكاميرا تمامًا على اللقطة عندما ينتهي وقت الطيران.
| EASING_STYLE | كيف يبدو الطيران |
|---|---|
Enum.EasingStyle.Sine (هنا) | تسير السرعة على منحنى جيبي، بداية ناعمة وتوقف ناعم. |
Enum.EasingStyle.Quad | مثل Sine، لكن المنحنى أحدّ قليلًا. |
Enum.EasingStyle.Linear | سرعة ثابتة، لذا يبدأ كل طيران وينتهي بالسرعة الكاملة. |
الاتجاه InOut: يُطبَّق التنعيم إلى الأمام في النصف الأول من الطيران وبالعكس في النصف الثاني، لذا تتسارع الكاميرا من لقطة وتتباطأ نحو التالية.
البث (Streaming)
في الأماكن الجديدة يكون instance streaming مفعّلًا: افتراضيًا يحتفظ جهاز اللاعب بالمنطقة المحيطة بشخصيته، لذا قد تُظهر لقطة تنظر إلى الطرف الآخر من الخريطة عالمًا فارغًا. يطلب CutsceneService من Roblox تحميل منطقة كل لقطة لهذا اللاعب عبر Player:RequestStreamAroundAsync: منطقة اللقطة الأولى قبل إرسال الحدث، مع انتظار حتى ثانيتين، ومنطقة كل لقطة تالية قبل ثانيتين من طيران الكاميرا إليها.
تكتب Roblox أن المنطقة بهذه الطريقة ستُحمَّل على الأرجح، لا بالتأكيد، وأن الأثر مؤقت. أبقِ اللقطات المهمة ضمن نصف قطر البث، أو استخدم على الخادم Player:AddReplicationFocus للمنطقة التي يجب أن تبقى محمّلة حتى تزيل التركيز. ومع تعطيل البث يملك الجهاز الخريطة كلها أصلًا، وpcall حول كل طلب تعني أن الطلب الفاشل لا يستطيع إيقاف المشهد.
ما الخطأ في دروس المشاهد السينمائية القديمة
إذا كنت تقارن هذا الدليل بفيديو أو بمنشور في المنتدى، فهذه الفروق المهمة، ولماذا يمثل كل أسلوب مشكلة.
| الدرس | المشكلة | هذا الدليل |
|---|---|---|
يحرّك الكاميرا عبر camera:Interpolate() | علّمت Roblox الدالة Interpolate كمهجورة وتنصح بتحريك الكاميرا عبر TweenService. | ينعّم كل طيران عبر TweenService:GetValue ويضبط الكاميرا كل إطار. |
يطبّق Tween على camera.CFrame ولا شيء غير ذلك | يبقى Focus حيث تركته سكربتات الكاميرا، قرب الشخصية، لذا قد لا يُرسم الضوء الديناميكي البعيد عنه (مرجع Roblox عن Camera.Focus). | يضبط Focus كل إطار في render step. |
| لا يعيد الكاميرا | يعلق اللاعب وهو ينظر إلى آخر لقطة. | في النهاية يضبط CameraType على Custom وCameraSubject على Humanoid، وبعد Skip أيضًا. |
يبدأ المشهد من Touched في LocalScript | لا شيء يمنعه من التكرار مع كل لمسة، والقرار يُتخذ على الجهاز الذي يتحكم فيه اللاعب. | يختار الخادم اللاعب ويتذكر من رآه بالفعل. |
| يقرأ قطع الكاميرا على العميل | مع تفعيل البث قد لا تكون القطع البعيدة عن الشخصية موجودة بعد على الجهاز. | يقرأ الخادم القطع، ويرسل قيم CFrame الخاصة بها، ويطلب منطقة كل لقطة قبيل وصول الكاميرا إليها. |
ما الذي يستطيع اللاعب تغييره وما لا يستطيع
افترض أن الغشاش يتحكم في كل شيء على جهازه: يستطيع تغيير CutscenePlayer أو حذفه، وإرسال CutsceneEvent بأي قيمة. وهذا لا يعني شيئًا تقريبًا بالنسبة إلى المشهد، ما دام لا يعتمد عليه شيء حقيقي.
| يحاول الغشاش | النتيجة |
|---|---|
| تخطي المشهد أو عدم تشغيله أصلًا | ممكن: إنها شاشته هو. لا تعطِ أبدًا مكافأة على "شاهد المشهد حتى النهاية". |
إرسال CutsceneEvent بأي قيمة | لا يفعل شيئًا إلا الرقم المطابق لمشهده الحالي، وكل ما يفعله أنه يفك تجميده أبكر. |
| لمس المحفّز من أي نقطة في الخريطة | ممكن: كل جهاز يتحكم في شخصيته، وتوثيق Roblox عن الأمان يذكر تزوير أحداث Touched ضمن ما يستطيع الجهاز فعله. سيرى هذا المشهد مرة واحدة، ولن يحدث شيء آخر. |
| الحركة على أي حال أثناء المشهد | لا شيء يُكسب. التجميد يمنع اللاعبين النزيهين من المغادرة في منتصف المشهد؛ وليس فحصًا أمنيًا. |
| تشغيل مشهد لشخص آخر عبر remote | مستحيل. لا يرسل CutsceneEvent إلى لاعب إلا الخادم، والشيء الوحيد الذي يستطيع الجهاز إعادته هو "انتهى هذا المشهد". |
إذا كان المشهد يقود إلى شيء حقيقي، كباب يُفتح بعده أو ظهور زعيم، فليفعل الخادم ذلك حسب مؤقته الخاص، لا عندما يبلّغ الجهاز بأن المشهد انتهى.
الخطوة 5: اختبره
- ضع ثلاث لقطات لـ Intro بسطر Command Bar. أعطِ اللقطة 1 قيمة
Captionهي "Welcome to the village"، واللقطة 2 قيمةMoveSecondsهي 2.5 وCaptionهي "Find the bridge"، واترك اللقطة 3 دون سمات. - اضغط Play (F5). تظهر الأشرطة السوداء، وتنتقل الكاميرا إلى اللقطة 1 مع نصها، وتطير خلال 2.5 ثانية إلى اللقطة 2، ثم خلال 3 ثوانٍ إلى اللقطة 3 دون نص. بعد ذلك تعود الكاميرا خلف الشخصية، وتظهر قائمة اللاعبين من جديد. لا يمكنك المشي أثناء عمله.
- أوقف الاختبار، واضغط Play مجددًا، واضغط Skip بينما تطير الكاميرا إلى اللقطة 2. تعود الكاميرا فورًا، ويمكنك المشي فورًا.
- ادخل إلى BridgeTrigger: يعمل مشهد Bridge. مُرّ عبره مرة أخرى: لا يحدث شيء.
- اختر Server & Clients من القائمة المنسدلة لوضع الاختبار، واضبط 2 من العملاء، واضغط Play. عندما يدخل Client 1 إلى المحفّز يعمل مشهد Bridge عند Client 1 فقط، ويستطيع Client 2 المشي.
- أبقِ
Workspace.StreamingEnabledمفعّلًا وانقل لقطة واحدة بعيدًا عن نقطة الظهور. عندما تصل الكاميرا يجب أن يكون المحيط في مكانه (على الأرجح، لا بالتأكيد: انظر البث). - ليد التحكم أوقف الاختبار، واضغط Play، وافتح Controller Emulator (تبويب Emulation، ثم Controller) وادخل إلى BridgeTrigger بيد التحكم المحاكاة: يجب أن يكون Skip محددًا، لذا يتخطى A المشهد. وإذا كنت تستخدم Device Simulator في Studio (وقت فحصنا في 15 أكتوبر 2026 كان نسخة تجريبية: فعّله من File، ثم Beta Features، ثم New Device Simulator وأعد تشغيل Studio)، فاختر هاتفًا، وأدره أفقيًا، وتحقق من أن Skip لا يدخل تحت فتحة الكاميرا وأنه سهل الإصابة، وأن عصا التحكم وزر القفز مخفيان أثناء المشهد.
- إذا كنت قد صنعت أيضًا قائمة رئيسية، فاضغط Play، ثم زر Play في القائمة، ودع المشهد التمهيدي يكتمل: بعده يجب أن تكون قائمة اللاعبين على الشاشة من جديد.
أبقِ نافذة Output مفتوحة (قائمة Window، ثم Output) طوال الوقت. عندما يعمل كل شيء لا تكتب هذه السكربتات شيئًا، لذا فأي تحذير أو خطأ أحمر من CutsceneService أو CutscenePlayer مشكلة حقيقية. انظر الأخطاء الشائعة.
كيف توسّع النظام
المشهد التمهيدي عند أول دخول للاعب فقط
يعيش الجدول seen خادمًا واحدًا فقط، لذا فاللاعب الذي يعيد الدخول يرى المشهد التمهيدي مرة أخرى. لعرضه عند أول دخول فقط، احفظ علامة، مثل SeenIntro، مع بقية بيانات اللاعب عبر الوحدة PlayerData من درس DataStore. اترك INTRO_CUTSCENE كما هي وغيّر الجزء من onCharacterAdded في CutsceneService المسؤول عن المشهد التمهيدي: انتظر حتى تعيد PlayerData.Get(player) بيانات اللاعب، وتخطَّ المشهد التمهيدي إذا كانت data.SeenIntro مساوية لـ true، واضبط data.SeenIntro = true فقط عندما تعيد playOnce(player, INTRO_CUTSCENE) القيمة true. لا تشغّل المشهد التمهيدي من الكود الذي يحمّل البيانات: فقد تُحمَّل البيانات قبل ظهور الشخصية، ودون شخصية لا تفعل play شيئًا، فتُحفظ العلامة لمشهد تمهيدي لم يره أحد.
شخصيات تمثّل في المشهد
اصنع رسمًا متحركًا في Animation Editor داخل Studio أو في إضافة رسوم متحركة من طرف ثالث، مثل Moon Animator المذكورة في توثيق Roblox، وشغّله على rig الخاص بـ NPC في اللقطة عندما تصل الكاميرا إليها. يقول مرجع Roblox عن Animator إن الرسوم المتحركة للـ NPC لا تتكرر إلا إذا حمّلها الخادم وشغّلها، لذا شغّلها من Script على الخادم إذا كان يجب أن يرى كل اللاعبين الـ NPC وهو يمثّل. وإذا حمّلتها وشغّلتها في CutscenePlayer فلن تتكرر، وهذا يناسب مشهدًا يشاهده لاعب واحد فقط. يُظهر دليل سكربتات الرسوم المتحركة كيف تشغّل رسمًا متحركًا على NPC من Script على الخادم.
الحوارات
النصوص على الشاشة تناسب الجمل القصيرة التي تمر وحدها. أما لمحادثة يرد فيها اللاعب ويختار من بين خيارات فانظر دليل الحوار مع NPC.
المشهد التمهيدي بعد القائمة الرئيسية
دليل القائمة الرئيسية يعطّل CharacterAutoLoads، لذا لا يظهر أحد حتى يضغط Play. ويشغّل CutsceneService المشهد التمهيدي عند أول ظهور للاعب، لذا مع النظامين معًا يعمل المشهد التمهيدي عند أول ظهور بعد Play. تعيد القائمة تفعيل core GUI عندما تظهر الشخصية، وقد يحدث ذلك والمشهد التمهيدي يعمل بالفعل، لذا قد تكون قائمة اللاعبين ظاهرة أثناء المشهد التمهيدي. لا يعيد CutscenePlayer تفعيل إلا ما أخفاه بنفسه، لذا لا يمس تغيير القائمة، وتبقى مفعّلة بعد المشهد التمهيدي. وحيلة Command Bar من دليل القائمة الرئيسية لتوجيه قطعة الكاميرا هي نفسها التي في الخطوة 1.
جولة حول الخريطة في بداية الجولة
لتشغيل مشهد من سكربت آخر على الخادم، مثل جولة حول الخريطة في بداية الجولة من دليل نظام الجولات، أضف إلى ServerStorage كائن BindableEvent باسم PlayCutscene. في نهاية CutsceneService اربط Event الخاص به بالدالة play، ودع سكربت الجولات يستدعيه مع كل لاعب واسم المشهد. تتخطى play فحص "مرة واحدة لكل خادم"، لذا تعمل الجولة حول الخريطة في كل جولة.
إضافات المشاهد السينمائية
يمكنك استخدام الإضافات مع هذا الدليل. إذا كانت إضافة المشاهد تكتب سكربت كاميرا خاصًا بها، فتحقق من أنها تعيد الكاميرا (CameraType بقيمة Custom وCameraSubject) وتضبط Focus ما دامت الكاميرا Scriptable، واترك قرار من يرى المشهد للخادم، كما في هذا الدليل.
الأخطاء الشائعة وحلولها
افتح نافذة Output (قائمة Window، ثم Output) قبل ضغط Play. معظم مشكلات المشاهد السينمائية إما تكتب هناك تحذيرًا، وإما تنشأ عن اسم غير مطابق.
Infinite yield possible on 'Workspace:WaitForChild("Cutscenes")'
ينتظر CutsceneService مجلدًا باسم Cutscenes مباشرة في Workspace. أنشئه كما في الخطوة 1 وتحقق من الكتابة ومن الحرف الكبير C. ما دام غير موجود لا ينشئ CutsceneService الكائن CutsceneEvent، لذا ينتظر CutscenePlayer أيضًا.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("CutsceneEvent")'
ينتظر CutscenePlayer الـ remote الذي ينشئه CutsceneService. تحقق من أن CutsceneService هو Script لا LocalScript، وأنه موجود مباشرة في ServerScriptService، وغير معطّل، وأنه لا يوجد منه في Output خطأ أو تحذير بخصوص Cutscenes.
CutsceneService: no folder named Intro in Workspace.Cutscenes
الاسم في INTRO_CUTSCENE أو في سمة Cutscene للمحفّز لا يطابق أي مجلد داخل Workspace.Cutscenes. حالة الأحرف في الأسماء مهمة.
لا يعمل شيء، وOutput فارغة
لا توجد في المجلد قطعة باسم 1، أو أن قطعه ليست فيه مباشرة (مثلًا داخل Model). يقرأ CutsceneService القطع 1 و2 و3 بالترتيب ويتوقف عند أول رقم مفقود. وتذكّر أن كل مشهد يعمل مرة واحدة لكل لاعب في كل خادم: أوقف الاختبار واضغط Play مجددًا.
الكاميرا تنظر إلى المكان الخطأ
تنظر الكاميرا في اتجاه الوجه الأمامي لقطعة اللقطة. حرّك كاميرا Studio إلى المنظر المطلوب ونفّذ مجددًا سطر Command Bar من الخطوة 1 لتلك اللقطة.
المحفّز لا يفعل شيئًا
تحقق من أن القطعة المحفّزة موجودة مباشرة داخل Workspace.CutsceneTriggers عند بدء اللعبة، وأن CanTouch مفعّل (وإلا سيظهر تحذير في Output)، وأن سمتها Cutscene نص يحمل اسم مجلد في Workspace.Cutscenes. المرور عبر المحفّز مرة ثانية لا يفعل شيئًا، وهذا مقصود.
بعد المشهد تبقى الكاميرا على آخر لقطة
توقف CutscenePlayer بخطأ قبل أن يعيد الكاميرا، لذا ابحث عن خطأ أحمر منه في Output. وقد يكون سكربت آخر يمسك الكاميرا ويضبط CameraType باستمرار على Scriptable، مثل كاميرا قائمة ما زالت مربوطة.
اصنعه مع RoCode
إذا لم ترغب في تجميع ذلك يدويًا، يستطيع RoCode فعله في المكان المفتوح عندك. RoCode وكيل ذكاء اصطناعي مستقل لـ Roblox Studio، لا يتبع Roblox: تصف الميزة في دردشة الويب الخاصة به، وتنشئ إضافته لـ Studio القطعة والسكربتات في Explorer عندك، فلا تحتاج إلى نسخ الكود من نافذة الدردشة.
أضف مشهدًا سينمائيًا تمهيديًا: مجلد Cutscenes فيه مجلد Intro ولقطات من 1 إلى 3، ونصوص من السمة Caption، وأشرطة سوداء وزر Skip، يعمل مرة واحدة عند أول ظهور للاعب، ويُبقي الخادم اللاعب في مكانه، وتعود الكاميرا في النهاية.
- قد يفحص مكانك أولًا عبر Search Scripts، مثلًا بحثًا عن سكربت قائمة أو كاميرا يضبط
CameraTypeبالفعل، كي لا يتعارضا - ينشئ المجلدات والقطعة المحفّزة عبر Create Instance ويضبط على القطع سمات مثل Caption وMoveSeconds
- يكتب CutsceneService وCutscenePlayer عبر Create Script
- تطلب منه التعليمات فحص كل سكربت يكتبه عبر Check Script، الذي يترجمه في Studio دون تشغيله، ويضع نقطة تراجع قبل كل دفعة تغييرات وبعدها
ضع قطع اللقطات بنفسك، بتوجيه كاميرا Studio إلى كل منظر، ثم اطلب السكربتات. مع الإضافة 3.9 أو أحدث يستطيع RoCode تشغيل اختبار لعب قصير وقراءة الأخطاء، ومع الإضافة 3.9.11 أو أحدث يستطيع التحكم في شخصية اختبار ليتأكد من أن اللعبة تعمل، لكنه لا يلتقط لقطات شاشة أثناء اللعب، لذا شاهد المشهد بنفسك. الترتيب الذي تبني به لعبة كاملة موجود في صفحة كيف تصنع لعبة في Roblox بالذكاء الاصطناعي، نظامًا بعد نظام. كيف يتصل RoCode بـ Studio.
الأسئلة الشائعة
كيف أجعل المشهد السينمائي يعمل عند الدخول إلى اللعبة؟
سمِّ مجلد اللقطات Intro في Workspace.Cutscenes أو غيّر INTRO_CUTSCENE إلى اسم مجلدك. يشغّله CutsceneService عند أول ظهور لكل لاعب على الخادم. ولعرضه عند أول دخول على الإطلاق فقط، احفظ علامة في data store ولا تضبطها إلا بعد أن يبدأ المشهد التمهيدي، كما هو موصوف في قسم كيف توسّع النظام.
هل يمكن صنع مشهد سينمائي دون إضافات؟
نعم. في هذا الدليل قطع وسمات وسكربتان فقط، وسطر Command Bar يضع كل لقطة تمامًا حيث تقف كاميرا Studio. وتبقى إضافات مثل Moon Animator مفيدة لتحريك الشخصيات التي تمثّل في المشهد.
لماذا لا تتحرك الكاميرا في المشهد السينمائي؟
عادة يكون كود الكاميرا في Script على الخادم، بينما لا يستطيع تحريك كاميرا اللاعب إلا LocalScript، لأن لكل جهاز كاميرته. وسبب شائع آخر: CameraType ليست Scriptable، فتعيد سكربتات الكاميرا القياسية في Roblox الكاميرا إلى الشخصية باستمرار.
كيف أمنع اللاعب من الحركة أثناء المشهد السينمائي؟
ثبّت HumanoidRootPart الخاص به على الخادم أثناء عمل المشهد، وفك التثبيت بعده، كما يفعل CutsceneService. القطعة المثبّتة لا تتحرك أبدًا بفعل الفيزياء. ولا يُمس WalkSpeed، لذا لا يتعارض هذا مع سكربت الركض أو مع pass للسرعة.
كيف أضيف زر Skip إلى المشهد السينمائي؟
ضع TextButton على شاشة المشهد واربط حدثه Activated، الذي يعمل عند النقر أو اللمس أو زر A في يد التحكم عندما يكون الزر محددًا. زر Skip في CutscenePlayer يضبط علامة تفحصها حلقة اللقطات كل إطار، ويُحدَّد تلقائيًا للاعبين بيد التحكم، ويوجد في ScreenGui خاص به بالهوامش الافتراضية كي لا تغطيه فتحة كاميرا الهاتف. وعصا التحكم وزر القفز مخفيان أثناء المشهد، لذا لا يقعان بجانبه.
لماذا يظهر عالم فارغ في المشهد السينمائي؟
مع تفعيل instance streaming لا يوجد على جهاز اللاعب إلا المنطقة القريبة من شخصيته. اجعل الخادم يستدعي player:RequestStreamAroundAsync لكل لقطة قبيل وصول الكاميرا إليها، كما يفعل CutsceneService. تكتب Roblox أن المنطقة بهذه الطريقة ستُحمَّل على الأرجح، لا بالتأكيد، لذا أبقِ اللقطات المهمة ضمن نصف قطر البث أو استخدم Player:AddReplicationFocus للمنطقة التي يجب أن تبقى محمّلة.
المصادر والقراءات
- Roblox Creator Docs: Customize the camera (بالإنجليزية). Camera خاصة بكل عميل، وScriptable وCFrame وFocus
- Roblox Engine API: Camera (بالإنجليزية). CameraType وCameraSubject وFocus كل إطار وInterpolate المهجورة
- Roblox Creator Docs: Control the user's camera (بالإنجليزية). BindToRenderStep بخطوة أولوية واحدة بعد الكاميرا
- Roblox Engine API: TweenService:GetValue (بالإنجليزية). قيمة alpha منعّمة ومحصورة بين 0 و1
- Roblox Engine API: ScreenGui.ScreenInsets (بالإنجليزية). لماذا None فقط للمحتوى الذي لا يُضغط
- Roblox Creator Docs: Instance streaming (بالإنجليزية). مفعّل افتراضيًا في الأماكن الجديدة، وreplication focus
- Roblox Creator Docs: Streaming techniques (بالإنجليزية). تحميل المنطقة مسبقًا قبل إرسال الحدث
- Roblox Engine API: Player:RequestStreamAroundAsync (بالإنجليزية). طلب مؤقت دون ضمان
- Roblox Creator Docs: Remote events and callbacks (بالإنجليزية). طابور الرسائل وأي الجداول يمكن إرسالها
- Roblox Creator Docs: Network ownership, movement validation, and physics (بالإنجليزية). ما يستطيع العميل فعله بشخصيته، بما في ذلك تزوير أحداث Touched
- Roblox Engine API: Animator:LoadAnimation (بالإنجليزية). أي الرسوم المتحركة تتكرر
كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.