باختصار
ضع LocalScript في StarterPlayer > StarterCharacterScripts. ابحث فيه عن Humanoid الخاص بالشخصية وعن Animator التابع له، وأنشئ Animation بقيمة AnimationId الخاصة بك، وحمّلها عبر animator:LoadAnimation(animation) واستدعِ :Play() على المسار الناتج عندما يبلّغ UserInputService.InputBegan عن زرك. الأنيميشن الذي يشغّله اللاعب بهذه الطريقة على شخصيته يراه الجميع على الخادم.
- يجب أن يكون الأنيميشن ملكًا لمالك اللعبة (أنت أو مجموعتك) أو لـ Roblox. الأنيميشن الذي رفعه شخص آخر لن يعمل في لعبتك.
- اجعل
PriorityللمسارAction، وإلا فقد تغطي عليه أنيميشنات المشي والوقوف. - حمّل الأنيميشنات عبر
Animator:LoadAnimation. أماHumanoid:LoadAnimationفقديم وغير مستحسن.
في هذه الصفحة
كيف تعمل الأنيميشنات في Roblox
هناك أربعة كائنات. لا تنشئ يدويًا إلا واحدًا منها، والباقي يتولاه السكربت.
| الكائن | أين يوجد | ماذا يفعل |
|---|---|---|
Animation | ينشئه سكربتك | يحفظ AnimationId، أي عنوان أصل الأنيميشن. لا يشغّل شيئًا بنفسه. |
Animator | داخل Humanoid الخاص بالشخصية (تضيفه Roblox) | يحمّل الأنيميشنات ويشغّلها على مفاصل الهيكل (rig). |
AnimationTrack | يُعاد من Animator:LoadAnimation() | نسخة قابلة للتشغيل: Play() وStop() وLooped وPriority وSpeed والأحداث. |
| أصل الأنيميشن | على Roblox، منشور من Animation Editor | الإطارات المفتاحية نفسها. ومعرّفه هو ما يُكتب في AnimationId. |
حمّل كل أنيميشن مرة واحدة واحتفظ بالمسار. إذا استدعيت LoadAnimation عند كل ضغطة زر، فسيُنشأ مسار جديد في كل مرة وتتراكم المسارات.
| الأولوية | لماذا تُستخدم |
|---|---|
Core | الأدنى. كل ما عداها يغطي عليها. |
Idle | الوقوف في المكان. |
Movement | المشي والجري والقفز. |
Action | الإيموتات والهجمات والأدوات. الخيار المعتاد لأنيميشن تشغّله من سكربت. |
من Action2 إلى Action4 | حركة يجب أن تغطي على حركة أخرى، مثل الصعق فوق الهجوم. |
عندما يحرّك مساران يعملان معًا المفصل نفسه، يفوز على ذلك المفصل المسار ذو الأولوية الأعلى. التلويح باليد بأولوية Action الذي يحرّك اليد فقط يترك للساقين أن تواصلا المشي.
الخطوة 1: اعثر على معرّف أنيميشن يمكنك استخدامه
تشغّل Roblox الأنيميشن في لعبتك فقط إذا كان ملكًا لمالك اللعبة أو لـ Roblox. لذلك معظم المعرّفات المنسوخة من Creator Store أو من الفيديوهات لا تصلح: إنها ملك لشخص آخر ولا تُحمَّل. هناك مصدران جيدان.
- اصنع أنيميشنك. في Studio افتح تبويب Avatar واختر Animation Editor، وحدّد هيكلًا (rig) (يُدرجه Rig Builder في التبويب نفسه)، ورتّب الوضعيات على الخط الزمني، ثم اختر من قائمة المحرر Publish to Roblox. انشر على الحساب نفسه أو المجموعة نفسها التي تملك اللعبة. انسخ المعرّف الذي ستحصل عليه.
- استخدم أنيميشنات Roblox. الإيموتات القياسية من سكربت Animate التابع لـ Roblox، مثل تلويح اليد في R15 (
507770239) والرقصة (507771019)، ملك لـ Roblox، لذلك تعمل في أي لعبة. يستخدمها هذا الدليل لتتمكن من تجربة كل شيء فورًا.
اكتب المعرّف بصيغة "rbxassetid://" يليها الرقم، مثل "rbxassetid://507770239".
الخطوة 2: شغّل الأنيميشن عند ضغط زر
- في Explorer افتح StarterPlayer، ومرّر المؤشر فوق StarterCharacterScripts، واضغط + وأدرج LocalScript.
- أعد تسميته إلى
EmoteOnKeyوالصق الكود أدناه. - اضغط Play ثم اضغط E. ستلوّح شخصيتك بيدها.
-- LocalScript في StarterPlayer > StarterCharacterScripts باسم EmoteOnKey.
-- اضغط E لتشغيل الأنيميشن على شخصيتك. يراه الجميع على الخادم.
local UserInputService = game:GetService("UserInputService")
local ANIMATION_ID = "rbxassetid://507770239" -- تلويح اليد R15 من Roblox نفسها؛ ضع هنا معرّف أنيميشنك
local KEY = Enum.KeyCode.E
local COOLDOWN_SECONDS = 1
local character = script.Parent :: Model
local humanoid = character:WaitForChild("Humanoid") :: Humanoid
local animator = humanoid:WaitForChild("Animator") :: Animator
local animation = Instance.new("Animation")
animation.AnimationId = ANIMATION_ID
local track = animator:LoadAnimation(animation)
track.Priority = Enum.AnimationPriority.Action -- أعلى من المشي والوقوف، لذلك تواصل الساقان المشي واليدان تلوّحان
local lastPlayed = -math.huge
UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
-- تكون gameProcessed مساوية لـ true ما دام اللاعب يكتب في الدردشة أو في حقل نصي
if gameProcessed or input.KeyCode ~= KEY then
return
end
if humanoid.Health <= 0 or os.clock() - lastPlayed < COOLDOWN_SECONDS then
return
end
lastPlayed = os.clock()
track:Play(0.1) -- ظهور سلس خلال 0.1 ثانية
end)
السكربتات في StarterCharacterScripts تُنسخ إلى الشخصية في كل مرة تظهر فيها، لذلك script.Parent هو الشخصية، ويُحمَّل المسار من جديد بعد كل إعادة ظهور.
تكون gameProcessed مساوية لـ true عندما تعالج Roblox ضغطة الزر أولًا، كأن يكون اللاعب يكتب في الدردشة. هذا الفحص يمنع الإيموت من الانطلاق كلما كتب أحدهم الحرف E.
التلويح يراه الجميع، وليس أنت فقط. تنسخ Roblox الأنيميشنات التي يشغّلها اللاعب على شخصيته إلى الجميع إذا كان Animator قد أنشأه الخادم، والـ Animator الذي تضعه Roblox في كل شخصية منشأ بهذه الطريقة بالضبط. لذلك لا يحتاج هذا السكربت إلى RemoteEvent.
الخطوة 3: شغّل أنيميشنًا متكررًا وأوقفه
الرقصة أو الجلوس يجب أن يستمرا حتى يوقفهما اللاعب. اجعل Looped مساوية لـ true، ومع كل ضغطة زر شغّل المسار نفسه أو أوقفه. وهذه النسخة توقف الرقصة أيضًا عندما يبدأ اللاعب بالمشي.
-- LocalScript في StarterPlayer > StarterCharacterScripts باسم DanceToggle.
-- اضغط G لبدء رقصة متكررة، واضغط G مرة أخرى (أو امشِ) لإيقافها.
local UserInputService = game:GetService("UserInputService")
local DANCE_ID = "rbxassetid://507771019" -- رقصة R15 من Roblox نفسها؛ ضع هنا معرّف أنيميشنك
local KEY = Enum.KeyCode.G
local character = script.Parent :: Model
local humanoid = character:WaitForChild("Humanoid") :: Humanoid
local animator = humanoid:WaitForChild("Animator") :: Animator
local animation = Instance.new("Animation")
animation.AnimationId = DANCE_ID
local track = animator:LoadAnimation(animation)
track.Priority = Enum.AnimationPriority.Action
track.Looped = true
UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
if gameProcessed or input.KeyCode ~= KEY then
return
end
if track.IsPlaying then
track:Stop(0.2)
else
track:Play(0.2)
end
end)
-- نوقف الرقصة عندما يبدأ اللاعب بالمشي
humanoid.Running:Connect(function(speed: number)
if speed > 0.5 and track.IsPlaying then
track:Stop(0.2)
end
end)
الرقم الذي يُمرَّر إلى Play وStop هو مدة الانتقال السلس بالثواني. الانتقال القصير يشغّل الرقصة ويوقفها بسلاسة بدل أن يقفز بالشخصية من وضعية إلى أخرى.
الخطوة 4: شغّل أنيميشن على NPC
الـ NPC لا يملكه أي لاعب، لذلك يشغّل الخادم أنيميشناته. ضع Script (وليس LocalScript) داخل نموذج الـ NPC. الهيكل المصنوع عبر Rig Builder فيه بالفعل Humanoid وHumanoidRootPart وAnimator.
-- Script داخل نموذج NPC باسم NpcAnimation. يحتاج الـ NPC إلى Humanoid وHumanoidRootPart.
-- يشغّل أنيميشنًا متكررًا على الـ NPC من الخادم، لذلك يراه كل لاعب.
local ANIMATION_ID = "rbxassetid://507771019" -- رقصة R15 من Roblox نفسها؛ ضع هنا معرّف أنيميشنك
local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid
-- الـ NPC المصنوع من هيكل يكون فيه Animator عادةً؛ وإن لم يوجد ننشئه
local animator = humanoid:FindFirstChildOfClass("Animator")
if not animator then
local newAnimator = Instance.new("Animator")
newAnimator.Parent = humanoid
animator = newAnimator
end
assert(animator, "the NPC has no Animator")
local animation = Instance.new("Animation")
animation.AnimationId = ANIMATION_ID
local track = animator:LoadAnimation(animation)
track.Looped = true
track:Play()
الخطوة 5: اربط فعلًا بلحظة داخل الأنيميشن
يجب أن تُحدث الضربة ضررًا عندما تصيب القبضة الهدف، لا عند ضغط الزر. في Animation Editor انقر بالزر الأيمن على الخط الزمني في تلك اللحظة وأضف animation event باسم Hit، ثم انشر الأنيميشن من جديد. في الكود ينطلق track:GetMarkerReachedSignal("Hit") عند هذا الإطار.
-- LocalScript في StarterPlayer > StarterCharacterScripts باسم PunchOnClick.
-- يشغّل أنيميشن الضربة عند النقر ويبلّغ الخادم بلحظة إصابة القبضة للهدف،
-- عبر حدث الأنيميشن "Hit" الذي تضيفه في Animation Editor.
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local UserInputService = game:GetService("UserInputService")
local PUNCH_ID = "rbxassetid://0" -- أنيميشن ضربتك مع الحدث "Hit" في لحظة الإصابة
local COOLDOWN_SECONDS = 0.6
local punchHit = ReplicatedStorage:WaitForChild("PunchHit") :: RemoteEvent
local character = script.Parent :: Model
local humanoid = character:WaitForChild("Humanoid") :: Humanoid
local animator = humanoid:WaitForChild("Animator") :: Animator
local animation = Instance.new("Animation")
animation.AnimationId = PUNCH_ID
local track = animator:LoadAnimation(animation)
track.Priority = Enum.AnimationPriority.Action
track:GetMarkerReachedSignal("Hit"):Connect(function()
punchHit:FireServer() -- يتحقق الخادم من المسافة وفترة الانتظار قبل إحداث الضرر
end)
local lastPunch = -math.huge
UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
if gameProcessed or input.UserInputType ~= Enum.UserInputType.MouseButton1 then
return
end
if os.clock() - lastPunch < COOLDOWN_SECONDS then
return
end
lastPunch = os.clock()
track:Play(0.05)
end)
يحتاج هذا السكربت إلى RemoteEvent باسم PunchHit في ReplicatedStorage، وإلى أنيميشن ضربة خاص بك فيه الحدث Hit بدل rbxassetid://0.
العميل يبلّغ فقط بأن "ضربتي أصابت". أما Script الخادم الذي يستمع إلى PunchHit.OnServerEvent فيقرر هل كان أحد قريبًا وكم من الضرر يُحدث، مع فترة انتظار خاصة به، حتى لا يستطيع لاعب يطلق الحدث يدويًا أن يضرب عبر الخريطة كلها. دليل RemoteEvent يوضح كيف تتحقق من مثل هذا الطلب على الخادم.
الأخطاء الشائعة وحلولها
افتح نافذة Output أولًا (قائمة Window ثم Output). معظم مشكلات الأنيميشن تكتب سطرًا هناك.
لا يحدث شيء، وفي Output مكتوب أن الأنيميشن لم يُحمَّل
الأنيميشن ليس ملكًا لمالك اللعبة بل لشخص آخر. انشر نسختك الخاصة من Animation Editor على الحساب أو المجموعة التي تملك اللعبة، واستخدم ذلك المعرّف.
الأنيميشن يعمل لكن اليدين فقط تتحركان، أو يبدو ناقصًا
مسار آخر بأولوية أعلى يحرّك المفاصل نفسها. اجعل Priority لمسارك Action (أو أعلى)، أو انشر الأنيميشن بهذه الأولوية من Animation Editor.
لا يحدث شيء ولا يوجد خطأ
تحقّق من نوع الهيكل: أنيميشن R15 لا يفعل شيئًا على شخصية R6. وتحقّق أيضًا من أن السكربت LocalScript في StarterCharacterScripts؛ فالـ LocalScript في Workspace لا يعمل.
الـ NPC لا يتحرك بالأنيميشن
قطعه مثبّتة، أو لا يوجد Animator في Humanoid الخاص به. ثبّت HumanoidRootPart فقط؛ وسكربت الخطوة 4 ينشئ Animator إن لم يكن موجودًا.
اللاعبون الآخرون لا يرون أنيميشني
شُغّل الأنيميشن على شخصية لا يملكها اللاعب، أو على Animator أُنشئ من LocalScript. شغّل أنيميشنات شخصيتك من LocalScript، وكل ما عدا ذلك (الـ NPC واللاعبين الآخرين) من Script على الخادم.
اصنعه مع RoCode
RoCode وكيل ذكاء اصطناعي يعمل داخل Roblox Studio عبر إضافة. تصف الحركة، فيكتب السكربتات في المكان المفتوح عندك.
أضف إيموت تلويح باليد على E ورقصة أستطيع تشغيلها وإيقافها على G، واجعل NPC البائع يلوّح للاعبين الذين يقتربون منه.
- يكتب LocalScript وScript للـ NPC ويضعهما حيث يجب أن يكونا
- يستطيع بناء حركات بسيطة مثل التلويح أو الضربة أو الرقصة مباشرة في الكود، فلا حاجة لرفع أنيميشن
- يفحص السكربتات التي كتبها داخل Studio قبل أن ينتهي
ما زال عليك أن تضغط Play وتتحقق من أن الحركة تبدو كما تريد. كيف يتصل RoCode بـ Studio.
الأسئلة الشائعة
هل يمكنني استخدام أي معرّف أنيميشن وجدته؟
لا. يعمل الأنيميشن فقط في لعبة يملكه مالكها، أو إذا كانت Roblox تملكه. استخدم أنيميشناتك الخاصة أو أنيميشنات Roblox القياسية.
هل يرى اللاعبون الآخرون الأنيميشن الذي يشغّله LocalScript؟
نعم، إذا شغّله اللاعب على شخصيته عبر Animator الذي تمنحه Roblox للشخصية. أما أنيميشنات الـ NPC فيجب تشغيلها من Script على الخادم.
كيف أكرر أنيميشن في Roblox؟
اكتب track.Looped = true قبل التشغيل، أو فعّل Loop في Animation Editor قبل النشر.
كيف أوقف الأنيميشن؟
استدعِ track:Stop() على المسار الذي شغّلته. مرّر رقمًا، مثل track:Stop(0.2)، ليتلاشى بسلاسة خلال هذا العدد من الثواني.
لماذا Animator وليس Humanoid:LoadAnimation؟
Humanoid:LoadAnimation قديم وغير مستحسن. Animator:LoadAnimation يفعل الشيء نفسه، وهو ما يشرحه توثيق Roblox.
المصادر والقراءات
- Roblox Creator Docs: Use animations (بالإنجليزية). تحميل الأنيميشنات وتشغيلها من السكربتات، وملكية الأنيميشن
- Roblox Creator Docs: Animator (بالإنجليزية). LoadAnimation والنسخ المتزامن (replication)
- Roblox Creator Docs: AnimationTrack (بالإنجليزية). Play وStop وLooped وPriority وGetMarkerReachedSignal
- Roblox Creator Docs: Animation Editor (بالإنجليزية). إنشاء الأنيميشن ونشره وأحداثه
كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.