باختصار
ضع LocalScript واحدًا في StarterPlayerScripts يربط الفعل Sprint عبر ContextActionService:BindAction("Sprint", onSprint, true, Enum.KeyCode.LeftShift, Enum.KeyCode.ButtonL3). ما دام Shift مضغوطًا أضف 10 إلى Humanoid.WalkSpeed (يصبح 16 هو 26)، وعند الإفلات أعد القيمة السابقة. الوسيط true يضيف زر Sprint على شاشات اللمس، وفي سكربت هذا الدليل يعمل هذا الزر وL3 في يد التحكم بالتبديل لتشغيل الجري وإيقافه، لا بالضغط المستمر.
- أضف إلى WalkSpeed الحالية بدل أن تضبطها على 26، حتى يبقى التسريع القادم من Game Pass.
- الجري يعمل على جهاز اللاعب. لا يستطيع الخادم فرض WalkSpeed؛ كل ما يستطيعه هو قياس المسافة التي تقطعها الشخصيات ورصد السرعة التي لا يفسرها الجري.
- تضيف الخطوات من 2 إلى 4 شريط التحمّل والاندفاع والقفزة المزدوجة على الفكرة نفسها. وكم يجب أن تكون سرعة الجري ومدته، تقترحه الإعدادات الجاهزة حسب نوع اللعبة مع أرقام للرعب والقتال والعالم المفتوح.
في هذه الصفحة
كيف يعمل الجري في Roblox
جهاز كل لاعب يحرّك شخصيته هو. لوحة المفاتيح أو يد التحكم أو شاشة اللمس تقرر إلى أين تتجه الشخصية، وRoblox تنقل النتيجة إلى الخادم وإلى الجميع. لذلك الجري هو LocalScript يرفع Humanoid.WalkSpeed ما دام الزر مضغوطًا، وهذا كل ما تفعله الخطوة 1. أما بقية الدليل فهي ما تحتاجه لعبة كبيرة حوله: شريط تحمّل، واندفاع، وقفزة مزدوجة، وفحص على الخادم للغشاشين.
| العنصر | أين يوجد | ماذا يفعل |
|---|---|---|
LocalScript ShiftToSprint | StarterPlayerScripts | الخطوة 1 وحدها: الجري على لوحة المفاتيح والهاتف ويد التحكم، دون تحمّل. عندما تضيف التحمّل والاندفاع يحل محله MovementClient. |
ModuleScript MovementConfig | ReplicatedStorage | الأرقام: مكافأة الجري والتحمّل والاندفاع. يقرؤها LocalScript والفحص على الخادم كلاهما. |
LocalScript MovementClient | StarterPlayerScripts | يربط Sprint وDash بزر في لوحة المفاتيح وزر في يد التحكم وزر لمس، ويدير حلقة التحمّل، ويرسم الشريط، وينفّذ الاندفاع. |
LocalScript DoubleJump | StarterCharacterScripts | يمنح قفزة إضافية واحدة في الهواء. تعمل نسخة جديدة منه في كل شخصية جديدة. |
Script MovementCheck | ServerScriptService | يقيس المسافة التي تقطعها كل شخصية فعلًا، ويكتب تحذيرًا في Output عندما يتحرك أحدهم لفترة طويلة أسرع مما يسمح به الجري والاندفاع. |
ReplicatedStorage
MovementConfig ModuleScript new
ServerScriptService
MovementCheck Script new
StarterPlayer
StarterCharacterScripts
DoubleJump LocalScript new
StarterPlayerScripts
MovementClient LocalScript new
إذا كان الفرق بين Script وLocalScript جديدًا عليك، فإن Script وLocalScript وModuleScript يشرح أين يعمل كل نوع ولماذا.
الخطوة 1: الجري بزر Shift في LocalScript واحد
إذا كنت تحتاج فقط إلى جري أسرع ما دام Shift مضغوطًا، فيكفيك هذا السكربت وحده. وهو يمنح الهواتف أيضًا زر Sprint على الشاشة، ويتيح على يد التحكم الجري بالعصا اليسرى.
- في Explorer وسّع StarterPlayer، ومرّر المؤشر فوق StarterPlayerScripts، واضغط زر + وأدرج LocalScript باسم
ShiftToSprint. - استبدل محتواه بالكود أدناه واضغط Play.
-- LocalScript في StarterPlayer > StarterPlayerScripts باسم ShiftToSprint.
-- اضغط Left Shift باستمرار لتجري. في يد التحكم اضغط على العصا اليسرى (L3)
-- لتشغيل الجري أو إيقافه. على الهاتف اضغط زر Sprint لتشغيله أو إيقافه.
local ContextActionService = game:GetService("ContextActionService")
local Players = game:GetService("Players")
-- الإعدادات
local SPRINT_BONUS = 10 -- تُضاف إلى WalkSpeed أثناء الجري (16 تصبح 26)
local TOGGLE_ON_TOUCH_AND_GAMEPAD = true -- false: يجب إبقاء الزر مضغوطًا
local player = Players.LocalPlayer
local sprinting = false
local normalSpeed = 16 -- قيمة WalkSpeed التي نعود إليها
local function getHumanoid(): Humanoid?
local character = player.Character
return character and character:FindFirstChildOfClass("Humanoid")
end
local function setSprinting(on: boolean)
local humanoid = getHumanoid()
if not humanoid or on == sprinting then
return
end
sprinting = on
if on then
-- نحفظ السرعة الحالية ونضيف إليها، حتى يبقى التسريع القادم من سكربت آخر
normalSpeed = humanoid.WalkSpeed
humanoid.WalkSpeed = normalSpeed + SPRINT_BONUS
else
humanoid.WalkSpeed = normalSpeed
end
end
local function onSprint(_name: string, state: Enum.UserInputState, input: InputObject): Enum.ContextActionResult
local isKeyboard = input.UserInputType == Enum.UserInputType.Keyboard
if isKeyboard or not TOGGLE_ON_TOUCH_AND_GAMEPAD then
-- الضغط المستمر: جري ما دام الزر مضغوطًا
if state == Enum.UserInputState.Begin then
setSprinting(true)
elseif state == Enum.UserInputState.End or state == Enum.UserInputState.Cancel then
setSprinting(false)
end
elseif state == Enum.UserInputState.Begin then
-- التبديل: كل ضغطة تشغّل الجري أو توقفه
setSprinting(not sprinting)
end
return Enum.ContextActionResult.Pass
end
-- استدعاء واحد يربط زر لوحة المفاتيح وزر يد التحكم، وعلى شاشات اللمس زرًا على الشاشة
ContextActionService:BindAction("Sprint", onSprint, true, Enum.KeyCode.LeftShift, Enum.KeyCode.ButtonL3)
ContextActionService:SetTitle("Sprint", "Sprint")
-- الشخصية الجديدة تبدأ بالمشي: Humanoid الخاص بها لديه WalkSpeed العادية أصلًا
player.CharacterAdded:Connect(function()
sprinting = false
end)
غيّر SPRINT_BONUS ليصبح الجري أسرع أو أبطأ. اضبط TOGGLE_ON_TOUCH_AND_GAMEPAD على false ليعمل زر الهاتف وL3 مثل Shift: جري فقط ما دام الزر مضغوطًا.
BindAction يربط فعلًا واحدًا بـ Left Shift وبزر L3 في يد التحكم، ووسيطه الثالث، true، يضيف زرًا على شاشات اللمس؛ وSetTitle يكتب عليه "Sprint". يتلقى المعالج الإدخال نفسه أيضًا، لذلك يميّز الضغط على لوحة المفاتيح من يد التحكم أو زر اللمس. عندما يبدأ الجري يحفظ السكربت WalkSpeed الحالية ويضيف SPRINT_BONUS؛ وعندما ينتهي يعيد القيمة المحفوظة. السرعة التي ضبطها سكربت آخر، مثل ميزة Speed من دليل Game Pass، تبقى كما هي. الشخصية الجديدة تبدأ بـ WalkSpeed العادية، لذلك معالج CharacterAdded يعيد ضبط العلامة فقط.
ضغط مستمر أم تبديل؟
| الجهاز والإدخال | يعمل بطريقة | لماذا |
|---|---|---|
| لوحة المفاتيح: Left Shift | الضغط المستمر | إبقاء الزر مضغوطًا أثناء الحركة سهل، والإفلات يوقف الجري فورًا. |
| يد التحكم: الضغط على العصا اليسرى (L3) | التبديل | إبقاء العصا مضغوطة والتوجيه بها في الوقت نفسه أمر متعب. |
| الهاتف أو الجهاز اللوحي: زر Sprint على الشاشة | التبديل | الإبهام الذي يضغط الزر لا يستطيع في الوقت نفسه ضغط Jump. |
للتحقق، اضغط Play وأبقِ Shift مضغوطًا أثناء المشي: ترتفع السرعة من 16 إلى 26 ستاد في الثانية، وإذا أفلته تتباطأ. للهاتف اختر هاتفًا في Device Simulator داخل Studio، واضغط Play، ثم اضغط Sprint مرة لتبدأ ومرة أخرى لتتوقف. ليد التحكم افتح Controller Emulator أثناء اختبار اللعب واضغط L3. القائمة الكاملة للفحوص حسب الأجهزة موجودة في الخطوة 6.
تستبدل الخطوتان 2 و3 هذا السكربت بآخر فيه شريط تحمّل واندفاع. وتضيف الخطوتان 4 و5 القفزة المزدوجة والفحص على الخادم، وتعملان مع أي من السكربتين.
الخطوة 2: أرقام التحمّل والاندفاع في وحدة واحدة
لجري ينفد، تستبدل الخطوتان 2 و3 السكربت ShiftToSprint بـ LocalScript أكبر فيه شريط تحمّل واندفاع. احذف ShiftToSprint أولًا: فكلا السكربتين يربطان الفعل Sprint.
كل الأرقام موجودة في ModuleScript واحد، لذلك يُضبط إحساس الحركة في مكان واحد. يقرؤها MovementClient على جهاز كل لاعب، ويقرأ MovementCheck الوحدة نفسها على الخادم ليعرف كم يجب أن تكون سرعة الجري والاندفاع.
- في Explorer مرّر المؤشر فوق ReplicatedStorage، واضغط زر + وأدرج ModuleScript.
- أعد تسميته إلى
MovementConfigواستبدل محتواه بالكود أدناه.
-- مجموعة واحدة من الأرقام لـ LocalScript الحركة ولفحص السرعة على الخادم.
local MovementConfig = {
SPRINT_BONUS = 10, -- تُضاف إلى WalkSpeed الحالية: 16 (القيمة الافتراضية في Roblox) تصبح 26
MAX_STAMINA = 100,
DRAIN_PER_SECOND = 20, -- 5 ثوانٍ من الجري بشريط ممتلئ
REGEN_PER_SECOND = 15,
REGEN_DELAY = 1, -- الثواني بعد انتهاء الجري قبل أن يبدأ التحمّل بالتعافي
MIN_TO_START = 20, -- التحمّل اللازم لبدء الجري، حتى لا يومض الشريط الفارغ
DASH_SPEED = 60, -- ستاد في الثانية أثناء الاندفاع
DASH_SECONDS = 0.2, -- هكذا يقطع الاندفاع نحو 12 ستاد
DASH_COST = 25, -- التحمّل
DASH_COOLDOWN = 1,
}
return MovementConfig
| الإعداد | القيمة | الأثر |
|---|---|---|
SPRINT_BONUS | 10 | تُضاف إلى WalkSpeed أثناء الجري. قيمة WalkSpeed الافتراضية في Roblox هي 16، لذلك يكون الجري بسرعة 26 ستاد في الثانية. |
MAX_STAMINA | 100 | الشريط الممتلئ. |
DRAIN_PER_SECOND | 20 | الشريط الممتلئ يكفي لـ 5 ثوانٍ من الجري. |
REGEN_PER_SECOND | 15 | الشريط الفارغ يمتلئ في نحو 6.7 ثانية. |
REGEN_DELAY | 1 | ثواني الراحة قبل بدء التعافي. |
MIN_TO_START | 20 | التحمّل اللازم لبدء الجري. |
DASH_SPEED | 60 | ستاد في الثانية أثناء الاندفاع. |
DASH_SECONDS | 0.2 | مدة الاندفاع: نحو 12 ستاد بسرعة 60 ستاد في الثانية. |
DASH_COST | 25 | التحمّل لكل اندفاع. |
DASH_COOLDOWN | 1 | الثواني بين اندفاع وآخر. |
كل جانب يشغّل نسخته الخاصة من الوحدة (تُنفَّذ الوحدة مرة واحدة على كل جانب)، لذلك اللاعب الذي يغيّر هذه الأرقام على جهازه يغيّر نسخته فقط. لكن هذا لا يحمي شيئًا هنا: جهازه يحرّك شخصيته على أي حال، لذلك يستطيع أن يمنح نفسه تحمّلًا لا ينفد مهما كان في الوحدة. والفحص على الخادم في الخطوة 5 مبني مع أخذ ذلك في الحسبان.
الخطوة 3: جري بالتحمّل واندفاع
هذا الـ LocalScript يصنع ما يشعر به اللاعبون. يربط Sprint وDash، ويرسم شريط التحمّل، ويدير حلقة التحمّل في كل إطار، وينفّذ الاندفاع.
- في Explorer وسّع StarterPlayer، ومرّر المؤشر فوق StarterPlayerScripts وأدرج LocalScript باسم
MovementClient. - استبدل محتواه بالكود أدناه.
-- اضغط Shift باستمرار (أو L3، أو زر Sprint على الهاتف) لتجري ما دام هناك تحمّل.
-- اضغط Q (أو B، أو زر Dash) لتندفع في اتجاه الحركة.
local ContextActionService = game:GetService("ContextActionService")
local Debris = game:GetService("Debris")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local RunService = game:GetService("RunService")
type Config = {
SPRINT_BONUS: number,
MAX_STAMINA: number,
DRAIN_PER_SECOND: number,
REGEN_PER_SECOND: number,
REGEN_DELAY: number,
MIN_TO_START: number,
DASH_SPEED: number,
DASH_SECONDS: number,
DASH_COST: number,
DASH_COOLDOWN: number,
}
local Config = require(ReplicatedStorage:WaitForChild("MovementConfig")) :: Config
local player = Players.LocalPlayer
local stamina = Config.MAX_STAMINA
local sprintHeld = false
local sprinting = false
local normalSpeed = 16 -- قيمة WalkSpeed التي نعود إليها عندما ينتهي الجري
local lastSprintTime = 0
local lastDashTime = -math.huge
-- شريط التحمّل: إطار فيه تعبئة عرضها يساوي التحمّل المتبقي
local gui = Instance.new("ScreenGui")
gui.Name = "StaminaGui"
gui.ResetOnSpawn = false
local bar = Instance.new("Frame")
bar.AnchorPoint = Vector2.new(0.5, 1)
bar.Position = UDim2.new(0.5, 0, 1, -24)
bar.Size = UDim2.fromOffset(240, 14)
bar.BackgroundColor3 = Color3.fromRGB(30, 26, 40)
bar.Parent = gui
local fill = Instance.new("Frame")
fill.Size = UDim2.fromScale(1, 1)
fill.BackgroundColor3 = Color3.fromRGB(80, 220, 150)
fill.BorderSizePixel = 0
fill.Parent = bar
for _, frame in { bar, fill } do
local corner = Instance.new("UICorner")
corner.CornerRadius = UDim.new(1, 0)
corner.Parent = frame
end
gui.Parent = player:WaitForChild("PlayerGui")
local function getHumanoid(): Humanoid?
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
if humanoid and humanoid.Health > 0 then
return humanoid
end
return nil
end
-- الجري: هنا علامة فقط؛ وحلقة Heartbeat أدناه تقرر في كل إطار هل نجري
local function onSprint(_name: string, state: Enum.UserInputState, _input: InputObject): Enum.ContextActionResult
-- لا يغيّرها إلا الضغط والإفلات: الإصبع الذي ينزلق على زر اللمس يرسل Change
if state == Enum.UserInputState.Begin then
sprintHeld = true
elseif state == Enum.UserInputState.End or state == Enum.UserInputState.Cancel then
sprintHeld = false
end
return Enum.ContextActionResult.Pass
end
local function dash()
local humanoid = getHumanoid()
local rootPart = humanoid and humanoid.RootPart
local now = os.clock()
-- لا اندفاع أثناء الجلوس: الشخصية الجالسة ملحومة بالمقعد، فستدفع المركبة كلها
if not (humanoid and rootPart) or humanoid.Sit or now - lastDashTime < Config.DASH_COOLDOWN or stamina < Config.DASH_COST then
return
end
local attachment = rootPart:FindFirstChild("RootAttachment")
if not (attachment and attachment:IsA("Attachment")) then
return
end
lastDashTime = now
stamina -= Config.DASH_COST
lastSprintTime = now -- نوقف التعافي مؤقتًا، كما يفعل الجري
-- الاندفاع إلى حيث يتحرك اللاعب، أو إلى حيث ينظر إذا كان واقفًا في مكانه
local direction = humanoid.MoveDirection
if direction.Magnitude < 0.1 then
direction = rootPart.CFrame.LookVector
end
direction = Vector3.new(direction.X, 0, direction.Z).Unit
-- LinearVelocity في وضع Plane يحافظ على السرعة الأفقية ولا يعيق الجاذبية
local velocity = Instance.new("LinearVelocity")
velocity.Attachment0 = attachment
velocity.RelativeTo = Enum.ActuatorRelativeTo.World
velocity.VelocityConstraintMode = Enum.VelocityConstraintMode.Plane
velocity.PrimaryTangentAxis = Vector3.xAxis
velocity.SecondaryTangentAxis = Vector3.zAxis
velocity.PlaneVelocity = Vector2.new(direction.X, direction.Z) * Config.DASH_SPEED
velocity.MaxForce = math.huge
velocity.Parent = rootPart
Debris:AddItem(velocity, Config.DASH_SECONDS)
end
local function onDash(_name: string, state: Enum.UserInputState, _input: InputObject): Enum.ContextActionResult
if state == Enum.UserInputState.Begin then
dash()
end
return Enum.ContextActionResult.Pass
end
-- كل استدعاء يربط زر لوحة المفاتيح وزر يد التحكم، وعلى أجهزة اللمس زرًا على الشاشة
ContextActionService:BindAction("Sprint", onSprint, true, Enum.KeyCode.LeftShift, Enum.KeyCode.ButtonL3)
ContextActionService:BindAction("Dash", onDash, true, Enum.KeyCode.Q, Enum.KeyCode.ButtonB)
ContextActionService:SetTitle("Sprint", "Sprint")
ContextActionService:SetTitle("Dash", "Dash")
-- في كل إطار: نستهلك التحمّل أثناء الجري والحركة، ونستعيده بعد راحة قصيرة
RunService.Heartbeat:Connect(function(deltaTime: number)
local humanoid = getHumanoid()
if not humanoid then
return
end
local moving = humanoid.MoveDirection.Magnitude > 0
local now = os.clock()
local enoughStamina = if sprinting then stamina > 0 else stamina >= Config.MIN_TO_START
local shouldSprint = sprintHeld and moving and enoughStamina
-- نغيّر WalkSpeed فقط عند بدء الجري ونهايته، حتى تبقى السرعة التي ضبطها
-- سكربت آخر (مثل Game Pass للسرعة)، ويُضاف الجري إليها
if shouldSprint and not sprinting then
sprinting = true
normalSpeed = humanoid.WalkSpeed
humanoid.WalkSpeed = normalSpeed + Config.SPRINT_BONUS
elseif not shouldSprint and sprinting then
sprinting = false
humanoid.WalkSpeed = normalSpeed
end
if sprinting then
stamina = math.max(0, stamina - Config.DRAIN_PER_SECOND * deltaTime)
lastSprintTime = now
elseif now - lastSprintTime >= Config.REGEN_DELAY then
stamina = math.min(Config.MAX_STAMINA, stamina + Config.REGEN_PER_SECOND * deltaTime)
end
fill.Size = UDim2.fromScale(stamina / Config.MAX_STAMINA, 1)
end)
-- الشخصية الجديدة تبدأ بتحمّل كامل ودون أي زر مضغوط
player.CharacterAdded:Connect(function()
stamina = Config.MAX_STAMINA
sprintHeld = false
sprinting = false -- Humanoid الجديد يبدأ بـ WalkSpeed العادية
end)
يُنشأ شريط التحمّل في الكود مع ResetOnSpawn مساوية لـ false، لذلك يبقى على الشاشة بعد إعادة الظهور، ومعالج CharacterAdded في الأسفل يملؤه من جديد لكل شخصية جديدة. أسطر type Config تصف ما تعيده الوحدة، حتى يكشف فحص الأنواع الصارم أي خطأ إملائي في اسم إعداد؛ ولا تغيّر شيئًا أثناء اللعب.
لوحة المفاتيح ويد التحكم وزر الهاتف باستدعاء واحد
يأخذ ContextActionService:BindAction اسم الفعل، ودالة المعالج، وهل يجب إنشاء زر لمس، ثم المدخلات. إذا مرّرت true وسيطًا ثالثًا، فسيضيف ContextActionService زرًا على الشاشة في أجهزة اللمس، داخل ScreenGui باسم ContextActionGui في PlayerGui الخاص باللاعب. ويكتب SetTitle على هذين الزرين "Sprint" و"Dash". يستطيع BindAction إنشاء 7 أزرار لمس كحد أقصى، لذلك راقب العدد إذا كانت سكربتات أخرى في اللعبة تستخدمها أيضًا.
يتلقى المعالج حالة الإدخال: Begin عند الضغط وEnd عند الإفلات. لا يفعل onSprint سوى تذكّر هل Sprint مضغوط. ويعدّ إفلاتًا أيضًا Cancel الذي يرسله ContextActionService عندما يستولي ربط آخر على الإدخال، ويتجاهل Change الذي قد يرسله إصبع يتحرك على زر اللمس. كلا المعالجين يعيدان Pass، لذلك يتلقى الربط التالي على الزر نفسه الإدخال أيضًا.
ينصح مرجع Roblox عن ContextActionService باستخدامه بدل UserInputService.InputBegan في معظم الحالات. ومثاله: بوق سيارة على H يجب ألا يُطلق ما دام اللاعب يكتب في الدردشة. لا يعمل الربط إلا ما دام هو الأخير لهذا الإدخال، لذلك عندما تأخذ الدردشة لوحة المفاتيح لا تحتاج إلى فحص أي شيء. مدخلات يد التحكم: ButtonL3 (الضغط على العصا اليسرى، التي تُمسك أثناء الحركة) وButtonB. في مثال الجري الخاص بـ Roblox يُستخدم ButtonY، فغيّر KeyCode في BindAction إذا كان ذلك أنسب للعبتك.
حلقة التحمّل
ينطلق RunService.Heartbeat في كل إطار بعد خطوة الفيزياء ويمرّر deltaTime، أي عدد الثواني منذ الإطار السابق. إذا ضربت فيه سرعة الاستهلاك والتعافي، فسيكفي الشريط الممتلئ لـ 5 ثوانٍ سواء كانت اللعبة تعمل بـ 30 أو 240 إطارًا في الثانية.
في كل إطار تقرر الحلقة هل يجب أن تجري الشخصية: Sprint مضغوط، والشخصية تمشي (Humanoid.MoveDirection يساوي المتجه الصفري عندما تقف)، وما زال هناك تحمّل. لبدء الجري يلزم MIN_TO_START (20) على الأقل؛ وللاستمرار يكفي أي شيء أكبر من 0. دون هذه الفجوة، فإن الشريط الفارغ الذي يمتلئ قليلًا في كل إطار سيشغّل الجري ويوقفه في كل إطار. يبدأ التعافي بعد REGEN_DELAY (ثانية واحدة) من آخر جري أو اندفاع، لذلك بعد أن يفرغ اللاعب الشريط ينتظر نحو 2.3 ثانية قبل أن يستطيع الجري مجددًا.
لا تتغير WalkSpeed إلا في الإطار الذي يبدأ فيه الجري أو ينتهي. عند البدء يحفظ السكربت WalkSpeed الحالية ويضيف SPRINT_BONUS؛ وعند النهاية يعيد القيمة المحفوظة. لذلك تبقى السرعة التي ضبطها سكربت آخر: ميزة Speed من دليل Game Pass تضبط WalkSpeed على 24، ومع هذا السكربت يجري مالكوها بسرعة 34. أما السكربت الذي يكتب WalkSpeed = 16 في كل إطار أو عند كل إفلات فسيلغي هذه الميزة دون أن تلاحظ.
الاندفاع
يدفع الاندفاع الشخصية إلى حيث تتحرك، أو إلى حيث تنظر إذا كانت واقفة في مكانها، مع تسوية الاتجاه بحيث لا يتجه أبدًا إلى الأعلى أو الأسفل. يكلّف 25 من التحمّل، ويوقف التعافي مؤقتًا مثل الجري، وفترة انتظاره ثانية واحدة. لا يتحقق من الأرض، لذلك يعمل في الهواء أيضًا، وهذا ينسجم جيدًا مع القفزة المزدوجة. ما دامت الشخصية جالسة لا يفعل الاندفاع شيئًا: الشخصية الجالسة ملحومة بالمقعد، وفي المركبة قد تحرّك الدفعة المركبة كلها.
الدفعة هي قيد LinearVelocity على RootAttachment في القطعة الجذرية. في وضع Plane مع المحورين X وZ يحافظ على سرعة أفقية قدرها 60 ستاد في الثانية ولا يلمس المحور العمودي، لذلك تعمل الجاذبية، والاندفاع من فوق حافة يسقط كالمعتاد. MaxForce يساوي math.huge، لذلك لا شيء يحدّ الدفعة. يدمّر Debris:AddItem القيد بعد DASH_SECONDS دون أن يجعل السكربت ينتظر، لذلك يستمر الاندفاع 0.2 ثانية، أي نحو 12 ستاد بهذه السرعة.
الدروس القديمة تستخدم BodyVelocity الذي وسمته Roblox بأنه قديم مع توصية باستخدام LinearVelocity بدلًا منه. وحيلته بجعل MaxForce صفرًا على محور واحد تحل محلها أوضاع Line وPlane وVector في LinearVelocity. ولأن جهاز اللاعب نفسه يحاكي شخصيته، فإن القيد الذي ينشئه LocalScript يحرّكها، ويرى اللاعبون الآخرون الاندفاع مثل أي حركة أخرى.
درس Roblox نفسه عن الواجهة يثبّت القيد على humanoid.RootPart.RootAttachment بالطريقة نفسها تمامًا. إذا كانت في لعبتك شخصية مخصصة لا تحتوي قطعتها الجذرية على Attachment باسم RootAttachment، فلن يفعل الاندفاع شيئًا: أضفه إلى HumanoidRootPart في StarterCharacter الخاص بك.
الخطوة 4: القفزة المزدوجة
تعيش القفزة المزدوجة في LocalScript خاص بها داخل StarterCharacterScripts. تضع Roblox نسخة من سكربتات هذه الحاوية في كل شخصية عند ظهورها، وهذه النسخ لا تبقى بعد إعادة الظهور، لذلك تبدأ كل حياة بسكربت جديد، ولا ينتقل شيء من الحياة السابقة.
- في Explorer وسّع StarterPlayer، ومرّر المؤشر فوق StarterCharacterScripts وأدرج LocalScript باسم
DoubleJump. - استبدل محتواه بالكود أدناه.
-- يمنح قفزة إضافية واحدة في الهواء. يعمل من جديد لكل شخصية جديدة،
-- لذلك لا ينتقل شيء بعد إعادة الظهور.
local UserInputService = game:GetService("UserInputService")
local character = script.Parent :: Model
local humanoid = character:WaitForChild("Humanoid") :: Humanoid
local EXTRA_JUMPS = 1
local MIN_SECONDS_BETWEEN_JUMPS = 0.25 -- ينطلق JumpRequest عدة مرات لضغطة واحدة
local NEW_PRESS_GAP = 0.1 -- زر القفز المضغوط يواصل إرسال JumpRequest؛ وتوقف بهذا الطول يعني أنه أُفلت
local jumpsLeft = 0
local lastJump = 0
local lastRequest = 0
humanoid.StateChanged:Connect(function(oldState: Enum.HumanoidStateType, newState: Enum.HumanoidStateType)
if newState == Enum.HumanoidStateType.Jumping and oldState ~= Enum.HumanoidStateType.Freefall then
-- القفز من الأرض (وليس إحدى قفزاتنا في الهواء) يعيد القفزات في الهواء
jumpsLeft = EXTRA_JUMPS
lastJump = os.clock()
elseif newState == Enum.HumanoidStateType.Landed then
jumpsLeft = 0
end
end)
-- ينطلق JumpRequest عندما يطلب اللاعب القفز، مثلًا عبر Space أو زر القفز على الهاتف
UserInputService.JumpRequest:Connect(function()
local now = os.clock()
local newPress = now - lastRequest > NEW_PRESS_GAP
lastRequest = now
-- لا يقفز مجددًا إلا ضغطة جديدة، حتى لا يستهلك الزر المضغوط القفزة في الهواء
if not newPress or jumpsLeft <= 0 or now - lastJump < MIN_SECONDS_BETWEEN_JUMPS then
return
end
if humanoid:GetState() == Enum.HumanoidStateType.Freefall then
jumpsLeft -= 1
lastJump = now
humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
end
end)
اضبط EXTRA_JUMPS على 2 لقفزة ثلاثية.
يراقب السكربت حالة الشخصية عبر Humanoid.StateChanged. الانتقال إلى Jumping الذي لم يأتِ من Freefall هو قفزة من الأرض، لذلك يمنح قفزة في الهواء، وLanded يسحبها مرة أخرى. إذا نزلت عن حافة، تدخل الشخصية Freefall دون قفز، لذلك لا تحصل على قفزة في الهواء. إذا أردتها هناك أيضًا، فاضبط jumpsLeft كذلك عند الانتقال إلى Freefall من أي حالة غير Jumping.
ينطلق UserInputService.JumpRequest عندما يطلب اللاعب القفز، مثلًا عبر Space أو زر القفز على الهاتف. يحذّر مرجع Roblox من أنه ينطلق عدة مرات لطلب قفز واحد وينصح بـ debounce، لذلك يتجاهل السكربت الطلبات خلال 0.25 ثانية بعد آخر قفزة. كما أن زر القفز المضغوط قد يواصل طلب القفزات، فيستهلك القفزة في الهواء في اللحظة نفسها التي تنفصل فيها الشخصية عن الأرض، لذلك لا يُعدّ الطلب ضغطة جديدة إلا بعد 0.1 ثانية دون طلبات.
القفزة في الهواء نفسها هي Humanoid:ChangeState(Enum.HumanoidStateType.Jumping). يقول مرجع Roblox إنه يجب استدعاؤها من LocalScript على الجهاز الذي يملك الملكية الشبكية للشخصية، وهو افتراضيًا جهاز اللاعب نفسه، لا الخادم. ومثال الكود الخاص بـ ChangeState في المرجع هو قفزة مزدوجة بالضبط.
الخطوة 5: كشف غش السرعة على الخادم
دروس الجري تتوقف غالبًا عند العميل. لا يستطيع Script على الخادم أن يثق بـ WalkSpeed الخاصة باللاعب، لأن المستغلين يغيّرونها على أجهزتهم، لكنه يرى أين تنتهي شخصياتهم. يقيس MovementCheck ذلك مرتين في الثانية ويكتب تحذيرًا في Output عندما يتحرك أحدهم لفترة طويلة أسرع مما يسمح به الجري والاندفاع. ويقرأ أرقام الجري والاندفاع من MovementConfig، فأضف هذه الوحدة من الخطوة 2 حتى لو أبقيت ShiftToSprint.
- مرّر المؤشر فوق ServerScriptService وأدرج Script باسم
MovementCheck. - استبدل محتواه بالكود أدناه.
-- أجهزة اللاعبين تحرّك شخصياتهم، لذلك يستطيع المستغل أن يضبط أي WalkSpeed.
-- هذا الفحص يقيس المسافة التي تقطعها كل شخصية فعلًا، ويكتب في Output
-- عندما يتحرك أحدهم لفترة طويلة أسرع مما يسمح به الجري والاندفاع. هو يحذّر فقط:
-- التأخير (lag) والانتقالات الفورية والسيور الناقلة قد تبدو تجاوزًا للسرعة، فاضبطه قبل معاقبة أحد.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local StarterPlayer = game:GetService("StarterPlayer")
type Config = { SPRINT_BONUS: number, DASH_SPEED: number, DASH_SECONDS: number }
local Config = require(ReplicatedStorage:WaitForChild("MovementConfig")) :: Config
local CHECK_EVERY = 0.5 -- ثوانٍ
-- سرعة الجري مع هامش للتأخير. زِده إذا كنت تبيع تسريعات.
local SPEED_ALLOWANCE = (StarterPlayer.CharacterWalkSpeed + Config.SPRINT_BONUS) * 1.25
local BURST_ALLOWANCE = Config.DASH_SPEED * Config.DASH_SECONDS * 2 -- هامش لاندفاع أو اثنين
local DRAIN_PER_CHECK = BURST_ALLOWANCE / 8 -- مدى سرعة مسامحة الاندفاعات السابقة
local lastPosition: { [Player]: Vector3 } = {}
local lastRoot: { [Player]: BasePart } = {} -- القطعة الجذرية التي قيست عليها lastPosition
local excess: { [Player]: number } = {} -- الستادات الزائدة عن الهامش، تُسامَح تدريجيًا
Players.PlayerRemoving:Connect(function(player: Player)
lastPosition[player] = nil
lastRoot[player] = nil
excess[player] = nil
end)
while true do
task.wait(CHECK_EVERY)
for _, player in Players:GetPlayers() do
local character = player.Character
local rootPart = character and character:FindFirstChild("HumanoidRootPart")
if rootPart and rootPart:IsA("BasePart") then
local position = rootPart.Position
-- إعادة الظهور قطعة جذرية جديدة، والانتقال الفوري من الخادم (بدء الجولة، نقطة الحفظ)
-- يضبط السمة أدناه: نبدأ القياس من جديد بدل أن نرصد قفزة
local previous = if lastRoot[player] == rootPart then lastPosition[player] else nil
if player:GetAttribute("MovementCheckSkip") then
player:SetAttribute("MovementCheckSkip", nil)
previous = nil
end
lastPosition[player] = position
lastRoot[player] = rootPart
if previous then
-- الحركة الأفقية فقط: السقوط السريع ليس غشًا
local moved = Vector3.new(position.X - previous.X, 0, position.Z - previous.Z).Magnitude
local extra = moved - SPEED_ALLOWANCE * CHECK_EVERY
local total = math.max(0, (excess[player] or 0) + extra - DRAIN_PER_CHECK)
excess[player] = total
if total > BURST_ALLOWANCE then
warn(`MovementCheck: {player.Name} moved {math.round(moved / CHECK_EVERY)} studs/s`)
excess[player] = 0
end
end
else
lastPosition[player] = nil
lastRoot[player] = nil
end
end
end
يظهر التحذير في Output داخل Studio. وفي اللعبة الحية يصل إلى سجل الخادم في Developer Console، الذي تستطيع قراءته بصفتك مالك اللعبة: راجع المخرجات في اللعبة الحية.
ماذا يقيس
كل نصف ثانية يقرأ السكربت موضع القطعة الجذرية لكل شخصية ويقيس كم تحركت أفقيًا منذ الفحص السابق. يُتجاهل الارتفاع، لذلك لا يُحتسب السقوط والقفز أبدًا؛ ونصيحة Roblox عن فحص الحركة تقترح الإسقاط نفسه على المستوى XZ للألعاب التي يُمشى فيها على الأرض. الهامش هو سرعة المشي الافتراضية مع مكافأة الجري وربع إضافي للتأخير: 32.5 ستاد في الثانية. المسافة الزائدة على ذلك تذهب إلى «دلو مثقوب» (leaky bucket)، وهو مُراكِم يقول عنه توثيق Roblox إنه يناسب كثيرًا من المطورين للاندفاعات القصيرة. يخسر الدلو 3 ستادات في كل فحص، ويحذّر السكربت عندما يحتوي على أكثر من 24 ستاد، وهو هامش لاندفاعين تقريبًا.
| الغشاش | ماذا يفعل MovementCheck |
|---|---|
| يضبط WalkSpeed على 100 | يحذّر بعد نحو ثانية من الجري |
| يضبط WalkSpeed على 50 | يحذّر بعد نحو 2.5 ثانية من الجري |
| يندفع مرارًا دون فترة انتظار (60 ستاد في الثانية) | يحذّر بعد نحو 1.5 ثانية |
| ينتقل فوريًا أكثر من 43 ستاد دفعة واحدة | يحذّر في الفحص التالي |
| يجري بسرعة تصل إلى 38 ستاد في الثانية، أي نحو مرة ونصف أسرع من الجري | لا شيء: تحت 38.5 ستاد في الثانية يفرغ الدلو بسرعة امتلائه نفسها |
| يغيّر MovementConfig لديه ليحصل على تحمّل لا ينفد | لا شيء: الجري بسرعة 26 ستاد في الثانية مسموح مهما طال |
| يطير، أو يقفز دون حدود، أو يمر عبر الجدران | لا شيء: الفحص يتجاهل الارتفاع ولا ينظر إلى التصادمات |
إذن يكشف الفحص الغش الفج الذي يجعل اللاعب أسرع بوضوح من الجميع، ويفوّت الغش الحذر. هذا هو الحد الصادق لفحص يعتمد على المسافة، وهو السبب في أن Roblox تصنع شيئًا أقوى (راجع server authority أدناه).
لماذا يحذّر فقط
يشير توثيق Roblox إلى أن فحوص السرعة البسيطة قد ترصد لاعبين صادقين باتصال غير مستقر، وتتعطل في الألعاب التي فيها مركبات أو حركة معقدة أخرى. قفزات التأخير، والسيور الناقلة، والمركبات، والانفجارات التي تقذف الشخصيات، وانتقالاتك الفورية أنت، قد تبدو تجاوزًا للسرعة، لذلك يطبع السكربت تحذيرًا فقط. راقب Output بينما تلعب أنت ومختبروك كالمعتاد، وزِد SPEED_ALLOWANCE إذا تعثّر به لاعبون صادقون، ولا تضف عقوبة، مثل إعادة اللاعب إلى الخلف، إلا عندما يبقى الفحص صامتًا في اللعب العادي. إذا كانت الانفجارات في لعبتك تقذف الشخصيات، فتخطَّ أيضًا اللاعبين الذين لم يبقَ في Humanoid الخاص بهم أي صحة.
إعادة الظهور والانتقال الفوري
تُنشئ إعادة الظهور قطعة جذرية جديدة، ويبدأ السكربت القياس من جديد عندما يراها، لذلك لا يُحتسب الموت بعيدًا عن نقطة الظهور تجاوزًا للسرعة أبدًا. أما الانتقالات الفورية التي تُجريها سكربتات الخادم الخاصة بك فتحتاج إلى استثناء، كما يقول توثيق Roblox لأي لعبة فيها انتقال فوري. بعد الانتقال أضف player:SetAttribute("MovementCheckSkip", true)، فيبدأ الفحص التالي القياس من الموضع الجديد بدل أن يرصد قفزة:
- في نظام الجولات مباشرة بعد
character:PivotTo(...)فيstartRound. - في سكربت نقاط الحفظ للأوبي مباشرة بعد كل
character:PivotTo(...)ينقل اللاعب إلى نقطة حفظه.
منصات الانتقال وقوائمه من دليل الانتقال الفوري ومنصة Finish من دليل اللعبة الأولى تضبطها بالفعل بعد كل انتقال.
لا تُحتسب إلا القيمة القادمة من الخادم. السمة التي يضبطها اللاعب على جهازه تبقى على ذلك الجهاز (راجع ما يُنسخ وما لا يُنسخ)، لذلك لا يستطيع الغشاش تعطيل الفحص بها.
حل للمستقبل: server authority
يصف توثيق Roblox عن الأمان نموذج server authority، وهو في مرحلة تجريبية (beta) وقت الكتابة، بأنه الطريقة الأوثق لإيقاف استغلال الحركة. يصبح الخادم مصدر الحقيقة، وأجهزة اللاعبين لا تبلّغ إلا عن مدخلاتها، وهذا بحسب التوثيق يمنع غش السرعة من العمل، لأن الجهاز لا يُؤتمن أبدًا على الإبلاغ عن موضعه.
الانتقال إليه إعادة كتابة، لا ضبط إعدادات. في هذا النموذج يحسب الخادم الحركة، لذلك تُلغى WalkSpeed أو LinearVelocity اللتان يضبطهما LocalScript وحده عندما تصل الحالة من الخادم. يقول توثيق Roblox إن المنطق الأساسي يجب أن يعمل في دوال RunService:BindToSimulation() داخل ModuleScript يشغّله العميل والخادم كلاهما. ويحتاج النموذج أيضًا إلى عدة إعدادات في Workspace، منها PlayerScriptsUseInputActionSystem، لذلك سينتقل التحكم عندك أيضًا إلى Input Action System. أبقِ نسخة هذا الدليل إلى أن تنقل الجري والتحمّل والاندفاع إلى هذا المخطط. وحتى ذلك الحين، فإن فحصًا بالمسافة مثل هذا هو بالضبط ما يصفه قسم Roblox عن فحص الحركة.
الخطوة 6: اختبر على كل جهاز
- اضغط Play وأبقِ Shift مضغوطًا أثناء المشي. ترتفع السرعة من 16 إلى 26 ستاد في الثانية، ويتقلص الشريط الأخضر أسفل الشاشة. بعد نحو 5 ثوانٍ يفرغ، وتعود إلى المشي.
- أفلت Shift. بعد ثانية واحدة يبدأ الشريط بالامتلاء. وإلى أن يمتلئ خُمسه، لا يفعل Shift شيئًا.
- اضغط Q أثناء المشي: تندفع قليلًا إلى الأمام، ويختفي ربع الشريط. اضغط Q مرة أخرى فورًا، ولن يحدث شيء حتى تمر ثانية. إذا بدا الاندفاع قصيرًا جدًا أو طويلًا جدًا، فغيّر
DASH_SPEEDأوDASH_SECONDSفي MovementConfig. - اقفز، ثم اضغط القفز مرة أخرى في الهواء لقفزة ثانية. اهبط وجرّب مجددًا: كل قفزة من الأرض تعيد القفزة في الهواء.
- أبقِ Space مضغوطًا طوال القفزة. يجب أن تحصل على قفزة واحدة لا اثنتين، لأن القفزة في الهواء تحتاج إلى ضغطة جديدة.
- فعّل Device Simulator في Studio (وهو تجريبي وقت الكتابة: File ثم Beta Features ثم New Device Simulator، ثم أعد تشغيل Studio)، أو فعّل Device Emulator القديم من قائمة Test. اختر هاتفًا واضغط Play. سيظهر زرا Sprint وDash. أبقِ Sprint مضغوطًا وأنت توجّه، ثم أبقِ زر القفز مضغوطًا طوال القفزة وتحقق من أنها قفزة واحدة فقط.
- افتح Controller Emulator (Controller في تبويب Emulation أو Virtual controller في لوحة Device Simulator). أبقِ L3 مضغوطًا أثناء الحركة لتجري، واضغط B للاندفاع وA مرتين للقفزة المزدوجة.
- أعد ضبط الشخصية من قائمة اللعبة. يعود الشريط ممتلئًا، ولا يوجد تحذير MovementCheck في Output، وإذا كنت ما زلت تحاكي هاتفًا فزرا Sprint وDash في مكانهما.
- والآن العب دور الغشاش. اضغط مفتاح Client/Server حتى يعرض Explorer العميل، وحدّد Humanoid شخصيتك في Workspace واضبط WalkSpeed على 60 في نافذة Properties. تجوّل بضع ثوانٍ: سيظهر في Output تحذير مثل
MovementCheck: YourName moved 60 studs/s. أعدها إلى 16، ثم اجرِ واندفع كالمعتاد دقيقة كاملة وتحقق من أن Output صامت. - إذا كانت
Workspace.PlayerScriptsUseInputActionSystemمضبوطة على Enabled في مكانك، فاختبر القفزة المزدوجة مرة أخرى: توثيق Roblox لا يقول هل يتصرفJumpRequestمعها بالطريقة نفسها.
إذا لم يحدث أي شيء على الإطلاق، فافتح نافذة Output من قائمة Window في Studio وابحث عن خطأ أحمر من MovementClient، أو راجع الأخطاء الشائعة.
كم يجب أن يكون الجري سريعًا وطويلًا: إعدادات جاهزة حسب نوع اللعبة
الجري المناسب يعتمد على اللعبة. مطاردة في لعبة رعب تحتاج إلى جري قصير وبطيء ينتهي في أسوأ لحظة؛ وخريطة مفتوحة كبيرة تحتاج إلى جري طويل حتى لا يملّ اللاعبون من عبورها. تستخدم هذه الإعدادات السكربتات نفسها ولا تغيّر إلا سرعة المشي وMovementConfig. إنها نقاط بداية من عندنا، محسوبة من الإعدادات، لا مقيسة على اللاعبين.
| نوع اللعبة | CharacterWalkSpeed | SPRINT_BONUS (سرعة الجري) | DRAIN_PER_SECOND | REGEN_PER_SECOND | الجري الكامل | من فارغ إلى ممتلئ | المسافة بشريط واحد |
|---|---|---|---|---|---|---|---|
| هذا الدليل | 16 | 10 (26) | 20 | 15 | 5 ث | 7.7 ث | 130 ستاد |
| مطاردة في لعبة رعب | 12 | 8 (20) | 25 | 10 | 4 ث | 11 ث | 80 ستاد |
| ألعاب Battlegrounds والقتال | 16 | 12 (28) | 15 | 20 | 6.7 ث | 6 ث | نحو 187 ستاد |
| عالم مفتوح أو لعبة محاكاة | 16 | 16 (32) | 10 | 25 | 10 ث | 5 ث | 320 ستاد |
| أوبي أو باركور | 16 | 8 (24) | دون تحمّل: استخدم ShiftToSprint |
- سرعة المشي تُضبط في StarterPlayer. حدّد StarterPlayer واضبط
CharacterWalkSpeed(الافتراضية 16). كل شخصية جديدة تبدأ بهذه السرعة، والجري يضيف إليهاSPRINT_BONUS، وMovementCheck يقرؤها أيضًا، لذلك يتبع الفحص على الخادم اختيارك. - MovementCheck يتكيّف. يسمح بسرعة المشي مع مكافأة الجري وربع إضافي للتأخير: 25 ستاد في الثانية لإعداد الرعب، و40 للعالم المفتوح. لا حاجة لتغيير أي شيء آخر.
- في الأوبي يغيّر الجري المسار. مع جري أسرع يمكن القفز فوق فجوات أطول. ابنِ القفزات، ثم اختبر كل واحدة بسرعة الجري، وإلا فسيجعل الجري المراحل سهلة جدًا. دليل نقاط الحفظ للأوبي ينسجم جيدًا مع ShiftToSprint.
- في الرعب المرجع هو القاتل. اجعل المطارِد أسرع قليلًا من سرعة المشي وأبطأ قليلًا من الجري، حتى يعتمد الهروب على متى ينفد الشريط. دليل لعبة الرعب يشرح بقية حلقة اللعب.
ما مشكلة سكربتات الجري القديمة
كثيرًا ما تظل الدروس القديمة للجري والاندفاع والقفزة المزدوجة تعمل، لكن كثيرًا منها يستخدم أساليب استبدلتها Roblox منذ ذلك الحين، أو يكسر أنظمة أخرى في لعبتك. إذا كنت تصلح سكربتًا منسوخًا، فقارنه بهذه القائمة.
| الأسلوب | ما المشكلة | هذا الدليل |
|---|---|---|
BodyVelocity للاندفاع | قديم: تقول Roblox أن تستخدم LinearVelocity بدلًا منه | LinearVelocity في وضع Plane |
حلقة على RunService.RenderStepped | حلّ محله PreRender للأعمال الجديدة. ومنطق اللعب مثل التحمّل مكانه Heartbeat، الذي تصفه Roblox للمهام الدورية مثل تجدد الصحة | Heartbeat مع deltaTime |
حلقة تحمّل على wait() | wait() قديمة وحلّت محلها task.wait()، وهي تتباطأ، لذلك قد تنتظر أطول مما طُلب، والاستهلاك الثابت عند كل wait يستهلك التحمّل بشكل غير متساوٍ | الاستهلاك والتعافي في كل إطار مع مراعاة deltaTime |
UserInputService.InputBegan دون فحص الدردشة | الضغط على Shift أثناء كتابة رسالة في الدردشة يشغّل الجري | ContextActionService، الذي يضيف أيضًا زرًا على الهاتف |
WalkSpeed = 16 عند الإفلات أو في كل إطار | يكتب فوق أي سرعة أخرى، مثل ميزة Game Pass | يغيّر WalkSpeed فقط عند بدء الجري ونهايته، بالإضافة إلى القيمة الحالية |
| الجري عبر RemoteEvent ليضبط الخادم WalkSpeed | المستغلون يضبطون WalkSpeed لأنفسهم على أي حال، والجري يبدأ متأخرًا بسبب رحلة الذهاب والإياب | الجري على العميل مع فحص المسافة على الخادم |
قفزة مزدوجة عند كل JumpRequest | ينطلق JumpRequest عدة مرات لطلب قفز واحد، والزر المضغوط قد يواصل طلب القفزات | توقف 0.25 ثانية وفحص الضغطة الجديدة |
UserInputService.TouchEnabled كفحص «هذا هاتف» | تكون true على الحواسيب المحمولة ذات شاشات اللمس | يضيف ContextActionService أزرارًا على الشاشة في أجهزة اللمس دون فحص للجهاز من عندك |
Humanoid:LoadAnimation لأنيميشن الجري | قديم وحلّ محله Animator:LoadAnimation | أنيميشن الجري أدناه يستخدم Animator |
الطريقة الجديدة من Roblox: Input Action System
صفحة Roblox عن Input Action System تأخذ جري الشخصية كأول مثال. بدل استدعاءات BindAction يُضبط التحكم في Studio: InputAction باسم CharacterSprint داخل input context في ReplicatedStorage، مع InputBinding واحد لـ Left Shift، وآخر لزر Y في يد التحكم، وآخر مرتبط بزر على الشاشة ترسمه في StarterGui. ثم يستمع سكربت العميل إلى حدثي الفعل Pressed وReleased، فيضاعف WalkSpeed عند الضغط ويعيدها عند الإفلات.
يستحق الانتقال إليه إذا أردت ترتيب التحكم في Studio لا في الكود، أو زر لمس خاصًا بك بدل زر ContextActionService، أو سياقات تبدّل مجموعات كاملة من التحكم، مثلًا للقوائم أو المركبات. وتنصح الصفحة أيضًا بضبط Workspace.PlayerScriptsUseInputActionSystem على Enabled، وserver authority يتطلب ذلك.
حلقة التحمّل والاندفاع من هذا الدليل يعملان بالطريقة نفسها مع Input Action System وحدها (دون server authority). أبقِ MovementConfig وحلقة Heartbeat وdash()، واحذف استدعاءي BindAction ومعالجيهما، واربط الأفعال بدلًا منهما: Pressed لفعل الجري يضبط sprintHeld على true، وReleased يضبطها على false، وPressed لفعل الاندفاع يستدعي dash(). استمر في البحث عن Humanoid في كل إطار كما يفعل MovementClient، لأن المثال في التوثيق يحفظ Humanoid الشخصية الأولى، وبعد إعادة الظهور لا يعود موجودًا.
تختبر Roblox أيضًا Character Controller Library، وهي نسخة تجريبية تُفعَّل من Beta Features وAvatar Settings في Studio. وصفحتها عن القدرات تبني كمثال اندفاعًا بنافذة نشطة مدتها 0.2 ثانية وفترة انتظار ثانية واحدة، أي بالتوقيت نفسه لاندفاع هذا الدليل.
كيف توسّعه: الأنيميشن والكاميرا وGame Pass للجري
أنيميشن الجري
اصنع أنيميشن جري في Animation Editor، واجعل أولويته Movement (توصي بها Roblox لأنيميشنات المشي والجري)، وانشره وانسخ معرّف الأصل. في MovementClient أنشئ Animation بهذا الـ AnimationId، وحمّله عبر Animator:LoadAnimation باستخدام Animator الموجود داخل Humanoid الشخصية، وشغّل المسار حيث يبدأ الجري وأوقفه حيث ينتهي. حمّله من جديد لكل شخصية جديدة.
الأنيميشنات التي يشغّلها جهازك على شخصيتك يراها الجميع إذا استخدمت Animator الذي وضعته Roblox هناك: المسارات المحمّلة على Animator أنشأه LocalScript لا تُنسخ إلى الآخرين. وHumanoid:LoadAnimation الذي تستخدمه دروس قديمة كثيرة قديم وغير مستحسن.
كاميرا أوسع أثناء الجري
زاوية رؤية أوسع قليلًا تجعل الجري يبدو أسرع. في الموضعين نفسيهما حرّك (tween) workspace.CurrentCamera.FieldOfView من القيمة الافتراضية 70 إلى نحو 80 عندما يبدأ الجري، وأعده عندما ينتهي، مثلًا عبر TweenService:Create(workspace.CurrentCamera, TweenInfo.new(0.25), { FieldOfView = 80 }):Play(). تحصر Roblox القيمة بين 1 و120 وتحذّر من أن القيم المنخفضة جدًا أو المرتفعة جدًا قد تربك اللاعبين. إذا كان سكربت آخر في اللعبة يغيّر زاوية الرؤية، فأعدها إلى القيمة التي وجدتها، لا إلى 70.
جري سريع كـ Game Pass
دليل Game Pass يعمل مع هذا السكربت بالفعل: ميزة Speed فيه تضبط على الخادم WalkSpeed على 24 لكل شخصية جديدة، ويضيف MovementClient مكافأة الجري فوقها، و34 ستاد في الثانية تبقى ضمن ما يسمح به MovementCheck.
لـ Game Pass يسرّع الجري نفسه، أضف الـ pass المسمى FastSprint إلى PassConfig.ids من ذلك الدليل. عندها يضبط سكربت الخادم الخاص به السمة OwnsPass_FastSprint للاعب فور تأكيد الشراء. في MovementClient استخدم مكافأة أكبر من Config.SPRINT_BONUS عندما يكون player:GetAttribute("OwnsPass_FastSprint") == true. وفي MovementCheck امنح هؤلاء اللاعبين هامشًا أكبر بقراءة السمة نفسها على الخادم، حيث لا يستطيع اللاعب تغييرها، وتحقق من أن السرعة القصوى الجديدة تبقى أقل مما يرصده الفحص.
قيد واحد يجدر معرفته: إذا غيّر سكربت آخر WalkSpeed في منتصف الجري، فإن نهاية هذا الجري ستعيد السرعة التي كانت قبله. وإعادة الظهور التالية ستضبط سرعة الـ pass من جديد، لأن سكربت Game Pass يطبّقها على كل شخصية جديدة.
الأخطاء الشائعة وحلولها
افتح نافذة Output (قائمة Window ثم Output) قبل الضغط على Play. معظم مشكلات هذه السكربتات تطبع هناك خطأ أو تحذيرًا مع اسم السكربت ورقم السطر.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("MovementConfig")'
ينتظر MovementClient أو MovementCheck وحدة غير موجودة بهذا الاسم بالضبط. يجب أن تكون ModuleScript باسم MovementConfig داخل ReplicatedStorage مباشرة. دليل أخطاء السكربتات يشرح هذا التحذير بالتفصيل.
Shift لا يفعل شيئًا
تحقق من أن ShiftToSprint أو MovementClient هو LocalScript لا Script، وأنه موجود في StarterPlayerScripts. ومع MovementClient، لبدء الجري يجب أيضًا أن تكون الشخصية تمشي ولديها 20 من التحمّل على الأقل، لذلك أبقِ Shift مضغوطًا أثناء الحركة. إذا كان Shift Lock هو الذي يتبدّل بدل الجري، فراجع السؤال عن Shift Lock أدناه.
يتوقف الجري بعد بضع ثوانٍ
هذا نفاد التحمّل: 100 من التحمّل بمعدل 20 في الثانية تكفي لـ 5 ثوانٍ. زِد MAX_STAMINA أو قلّل DRAIN_PER_SECOND في MovementConfig.
الاندفاع لا يفعل شيئًا
يحتاج الاندفاع إلى 25 من التحمّل، وينتظر ثانية واحدة بعد السابق، ولا يفعل شيئًا ما دمت جالسًا. إذا لم يكن هذا السبب، فقد لا تحتوي القطعة الجذرية لشخصيتك على Attachment باسم RootAttachment، وهذا يحدث مع بعض الشخصيات المخصصة: أضفه إلى HumanoidRootPart في StarterCharacter الخاص بك.
القفزة المزدوجة لا تعمل
يجب أن يكون DoubleJump سكربت LocalScript في StarterCharacterScripts، لا في StarterPlayerScripts، لأنه يقرأ script.Parent على أنه الشخصية. اضغط القفز مرة ثانية بعد الانفصال عن الأرض: الزر المضغوط لا يُعدّ ضغطة جديدة، والنزول عن حافة لا يمنح قفزة في الهواء.
لا يوجد زر Sprint أو Dash على الهاتف
يضيف ContextActionService أزراره على أجهزة اللمس فقط، لذلك لا تظهر أبدًا على كمبيوتر دون شاشة لمس. اختبر بهاتف في Device Simulator داخل Studio (وهو تجريبي: فعّل New Device Simulator من File ثم Beta Features وأعد تشغيل Studio). يستطيع BindAction إنشاء 7 أزرار لمس كحد أقصى، لذلك احسب كم زرًا تنشئه السكربتات الأخرى في اللعبة.
MovementCheck يحذّر من لاعبين صادقين
الأسباب المعتادة: انتقال فوري من سكربت خادم آخر، أو سير ناقل أو مركبة، أو التأخير. اضبط السمة MovementCheckSkip بعد انتقالاتك الفورية (راجع إعادة الظهور والانتقال الفوري) وزِد SPEED_ALLOWANCE إذا ظل الفحص ينطلق في اللعب العادي.
يختفي التسريع بعد الجري
غيّر سكربت آخر WalkSpeed أثناء الجري، والجري عند انتهائه أعاد السرعة التي رآها عند البدء. امنح التسريعات عند ظهور الشخصية، كما يفعل دليل Game Pass، حتى تضبط إعادة الظهور السرعة الصحيحة من جديد.
اصنعه مع RoCode
إذا لم ترغب في إعداد كل هذا يدويًا، فيستطيع RoCode بناءه في المكان المفتوح عندك. RoCode وكيل ذكاء اصطناعي مستقل لـ Roblox Studio، وليس من Roblox: تصف التغيير في دردشة الويب، وتنشئ إضافته لـ Studio السكربتات في Explorer عندك، فلا حاجة للصق الكود.
أضف الجري بزر Shift مع شريط تحمّل: سرعة المشي زائد 10 ما دام Shift مضغوطًا، و100 من التحمّل، واستهلاك 20 في الثانية، وتعافٍ 15 في الثانية بعد ثانية راحة، وزر Sprint على الهواتف، واندفاع على Q، وقفزة مزدوجة.
- يستطيع أولًا تصفح مكانك عبر Search Scripts وRead Script ليجد سكربتات أخرى تغيّر WalkSpeed (مثل ميزة Game Pass)، حتى يُضاف الجري إليها
- يكتب ModuleScript وسكربتات LocalScript والفحص على الخادم عبر Create Script
- هو موجَّه لفحص ترجمة كل سكربت يكتبه عبر Check Script، الذي يترجمه في Studio دون تشغيله
- يضع نقطة تراجع قبل كل دفعة تغييرات وبعدها، لذلك يتراجع Ctrl+Z دفعة واحدة في كل مرة
لا يستطيع RoCode صنع أنيميشن الجري: أنشئه في Animation Editor والصق معرّفه. مع الإضافة 3.9.11 أو أحدث يستطيع RoCode تشغيل اختبار لعب للعبتك في Studio والتحكم بشخصية اختبار ليتحقق من أن كل شيء يعمل، ومع الإضافة 3.9.15 أو أحدث تستطيع شخصية الاختبار ضغط المفاتيح، مثل إبقاء Shift مضغوطًا والتحقق من أن WalkSpeed ارتفعت. يقرر بنفسه متى يشغّل اختبار اللعب، حتى 2 لكل بناء إضافة إلى 1 للتحقق من إصلاحه، ولا يتحقق إلا مما قرر اختباره بنفسه، لذلك جرّب الجري والاندفاع والقفزة المزدوجة بنفسك، وتحقق من أزرار الهاتف في Device Simulator داخل Studio. الحركة نظام واحد من أنظمة كثيرة في اللعبة؛ وصنع لعبة كاملة مع RoCode يسير بنظام واحد لكل طلب، كما هنا. كيف يتصل RoCode بـ Studio.
الأسئلة الشائعة
لماذا لا يعمل سكربت الجري على الهاتف؟
الهاتف ليس فيه زر Shift. اربط الجري عبر ContextActionService:BindAction ومرّر true وسيطًا ثالثًا: هذا يضيف زرًا على الشاشة في أجهزة اللمس، كما يفعل ShiftToSprint وMovementClient كلاهما.
هل يجب أن يكون الجري على الخادم؟
لا. كل جهاز يحرّك شخصيته، لذلك فإن WalkSpeed التي يضبطها الخادم لن توقف غشاشًا يستطيع ضبط قيمته الخاصة، والسرعة الجديدة لا تصل إلا بعد رحلة ذهاب وإياب، فيبدأ الجري متأخرًا. اجعل الجري على العميل، وتحقق على الخادم من المسافة التي تقطعها الشخصيات فعلًا، كما في الخطوة 5. النسخة التجريبية server authority من Roblox مبنية بطريقة مختلفة، وسيتعين إعادة كتابة كود الحركة لها.
لماذا تواصل الشخصية الجري بعد أن أفلتّ Shift؟
فات السكربتَ الإفلاتُ، عادةً لأنه يستمع إلى الضغط فقط. يرسل ContextActionService الحالة End عند إفلات الزر، وCancel عندما يستولي عليه ربط آخر؛ ويتوقف MovementClient عند كليهما، وكذلك عندما ينفد التحمّل أو تتوقف الشخصية عن الحركة.
كيف أضيف أنيميشن للجري؟
حمّل أنيميشن الجري عبر Animator في Humanoid الشخصية داخل الـ LocalScript نفسه، وشغّله عندما يبدأ الجري وأوقفه عندما ينتهي. اجعل أولويته Movement. الأنيميشنات التي تُشغَّل على شخصيتك أنت يراها الجميع.
لماذا تنطلق القفزة المزدوجة وحدها على الهاتف؟
زر القفز المضغوط على الهاتف يواصل طلب القفزات. لا تعدّ القفزة جديدة إلا إذا توقفت الطلبات للحظة، كما يفعل سكربت DoubleJump.
ما سرعة المشي الافتراضية في Roblox؟
16 ستاد في الثانية. تأتي من StarterPlayer.CharacterWalkSpeed الذي يضبط Humanoid.WalkSpeed لكل شخصية جديدة. الجري في هذا الدليل يضيف 10، لذلك يكون الجري بسرعة 26.
كم يجب أن تكون سرعة الجري في Roblox؟
معظم الألعاب تضيف ما بين نصف سرعة المشي وضعفها كاملة: تصبح 16 شيئًا بين 24 و32. الجري القصير البطيء يناسب الرعب، والطويل السريع يناسب الخرائط الكبيرة. الإعدادات الجاهزة حسب نوع اللعبة تعطي لكل نوع سرعة المشي ومكافأة الجري وأرقام التحمّل.
كيف أصنع جريًا بالتحمّل؟
احفظ رقم التحمّل على جهاز اللاعب، واستهلكه في كل إطار أثناء الجري واستعده بعد راحة قصيرة، مع مراعاة زمن الإطار في الحالتين، وأوقف الجري عندما يصل إلى 0. يفعل MovementClient من الخطوة 3 هذا مع شريط على الشاشة؛ والأرقام في MovementConfig.
كيف أجري بيد التحكم في Roblox؟
اربط ButtonL3 في يد التحكم (الضغط على العصا اليسرى) عبر ContextActionService مع Left Shift، كما يفعل كلا السكربتين هنا. يجعل ShiftToSprint الزر L3 مفتاح تبديل، لأن إبقاء العصا مضغوطة والتوجيه بها في الوقت نفسه أمر متعب.
هل يتعارض الجري بزر Shift مع Shift Lock؟
قد يحدث ذلك. اللاعبون الذين فعّلوا Shift Lock في إعدادات Roblox يبدّلونه بزر Shift، فيفعل الزر نفسه شيئين. يقول توثيق Roblox إن واجهات Shift Lock البرمجية في طريقها إلى الإيقاف. إذا كان التعارض يزعج لاعبيك، فعطّل StarterPlayer.EnableMouseLockOption أو اربط الجري في MovementClient بزر آخر، مثل Left Ctrl.
المصادر والقراءات
- Roblox Creator Docs: ContextActionService (بالإنجليزية). BindAction، وأزرار اللمس، وحد الأزرار السبعة، ولماذا هو أفضل من InputBegan في معظم الحالات
- Roblox Creator Docs: Humanoid (بالإنجليزية). WalkSpeed وملاحظة الأمان، وMoveDirection، وStateChanged، وChangeState مع مثال القفزة المزدوجة
- Roblox Creator Docs: LinearVelocity (بالإنجليزية). وضع Plane، والمحاور المماسية، وMaxForce
- Roblox Creator Docs: Mover constraints (بالإنجليزية). الانتقال من BodyVelocity القديم إلى LinearVelocity
- Roblox Creator Docs: UserInputService (بالإنجليزية). JumpRequest ولماذا يحتاج إلى debounce
- Roblox Creator Docs: Network ownership, movement validation, and physics (بالإنجليزية). ما الذي يتحكم به العميل، وفحوص المسافة، والدلاء المثقوبة، واستثناءات الانتقال الفوري
- Roblox Creator Docs: Server authority model (بالإنجليزية). نموذج الحركة على الخادم، وBindToSimulation، وإعدادات Workspace التي يحتاجها
- Roblox Creator Docs: Input Action System (بالإنجليزية). مثال Character Sprint مع InputAction وInputBinding
- Roblox Creator Docs: Custom abilities (بالإنجليزية). قدرة الاندفاع في Character Controller Library
- Roblox Creator Docs: Studio testing modes (بالإنجليزية). Device Simulator وController Emulator
كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.