מדריך · מערכות משחק

איך מפעילים אנימציה ב-Roblox Studio עם סקריפט

ב-Roblox את האנימציה מפעיל ה-Animator של הדמות, לא האנימציה עצמה. במדריך הזה נפעיל אנימציה כששחקן לוחץ על מקש, נדליק ונכבה ריקוד, נריץ אנימציה בלולאה על NPC ונגרום נזק בדיוק בפריים שבו האגרוף פוגע במטרה.

עודכן 20 בנובמבר 20265 דק׳ קריאהמאת:

בקצרה

שימו LocalScript ב-StarterPlayer > StarterCharacterScripts. בתוכו מצאו את ה-Humanoid של הדמות ואת ה-Animator שלו, צרו Animation עם ה-AnimationId שלכם, טענו אותה עם animator:LoadAnimation(animation) וקראו ל-:Play() על הטראק שהתקבל כש-UserInputService.InputBegan מדווח על המקש שלכם. אנימציה ששחקן מפעיל כך על הדמות שלו, כולם בשרת רואים.

  • האנימציה חייבת להיות בבעלות הבעלים של המשחק (אתם או הקבוצה שלכם) או של Roblox. אנימציה שמישהו אחר העלה לא תופעל במשחק שלכם.
  • קבעו לטראק Priority ששווה ל-Action, אחרת אנימציות ההליכה והעמידה עלולות לכסות אותה.
  • טענו אנימציות דרך Animator:LoadAnimation. Humanoid:LoadAnimation מיושן.
בעמוד הזה
  1. איך זה עובד
  2. 1. ID של אנימציה
  3. 2. בלחיצת מקש
  4. 3. ריקוד בלולאה
  5. 4. על NPC
  6. 5. אירועי אנימציה
  7. Common errors
  8. עם RoCode
  9. שאלות נפוצות
  10. מקורות וקריאה נוספת

איך אנימציות מופעלות ב-Roblox

משתתפים ארבעה אובייקטים. ביד אתם יוצרים רק אחד מהם, את השאר עושה הסקריפט.

האובייקטים שמפעילים אנימציה
אובייקטאיפה הוא נמצאמה הוא עושה
Animationנוצר על ידי הסקריפט שלכםמחזיק את ה-AnimationId, הכתובת של Asset האנימציה. לבד הוא לא מפעיל כלום.
Animatorבתוך ה-Humanoid של הדמות (Roblox מוסיפה אותו)טוען אנימציות ומפעיל אותן על המפרקים של ה-Rig.
AnimationTrackמוחזר מ-Animator:LoadAnimation()עותק שאפשר להפעיל: Play(), Stop(), Looped, Priority, Speed ואירועים.
Asset של אנימציהב-Roblox, פורסם מ-Animation Editorפריימי המפתח עצמם. ה-ID שלו הוא מה שנכתב ב-AnimationId.

טענו כל אנימציה פעם אחת ושמרו את הטראק. אם קוראים ל-LoadAnimation בכל לחיצה על מקש, נוצר כל פעם טראק חדש, והם מצטברים.

עדיפויות אנימציה, מהנמוכה לגבוהה
עדיפותבשביל מה
Coreהנמוכה ביותר. כל השאר מכסה אותה.
Idleעמידה במקום.
Movementהליכה, ריצה, קפיצות.
Actionאימוטים, התקפות, כלים. הבחירה הרגילה לאנימציה שמפעילים מסקריפט.
Action2 עד Action4פעולה שצריכה לכסות פעולה אחרת, למשל הלם מעל התקפה.

כששני טראקים שרצים מזיזים את אותו מפרק, במפרק הזה מנצח הטראק עם העדיפות הגבוהה יותר. נפנוף יד ב-Action שמזיז רק את היד משאיר לרגליים אפשרות להמשיך ללכת.

שלב 1: מצאו ID של אנימציה שאפשר להשתמש בו

Roblox מפעילה אנימציה במשחק שלכם רק אם היא בבעלות הבעלים של המשחק או של Roblox. לכן רוב ה-ID שמועתקים מה-Creator Store או מסרטונים לא מתאימים: הם בבעלות מישהו אחר ולא נטענים. יש שני מקורות טובים.

  1. צרו אחת משלכם. ב-Studio פתחו את הלשונית Avatar ובחרו Animation Editor, סמנו Rig (Rig Builder באותה לשונית מכניס אחד), סדרו תנוחות על ציר הזמן, ואז בתפריט העורך בחרו Publish to Roblox. פרסמו לאותו חשבון או לאותה קבוצה שהמשחק בבעלותה. העתיקו את ה-ID שתקבלו.
  2. קחו אנימציות של Roblox. האימוטים הרגילים מסקריפט Animate של Roblox, למשל נפנוף היד של R15 (507770239) והריקוד (507771019), בבעלות Roblox, ולכן עובדים בכל משחק. המדריך הזה משתמש בהם, כדי שתוכלו לבדוק הכול מיד.

כתבו את ה-ID כ-"rbxassetid://" והמספר אחריו, למשל "rbxassetid://507770239".

שלב 2: הפעילו אנימציה בלחיצת מקש

  1. ב-Explorer פתחו את StarterPlayer, רחפו עם הסמן מעל StarterCharacterScripts, לחצו על + והכניסו LocalScript.
  2. שנו את השם שלו ל-EmoteOnKey והדביקו את הקוד שלמטה.
  3. לחצו על Play ועל E. הדמות שלכם תנופף ביד.
LocalScript בתוך StarterCharacterScripts בשם EmoteOnKey
-- LocalScript ב-StarterPlayer > StarterCharacterScripts בשם EmoteOnKey.
-- לחצו על E כדי להפעיל אנימציה על הדמות שלכם. כולם בשרת רואים אותה.
local UserInputService = game:GetService("UserInputService")

local ANIMATION_ID = "rbxassetid://507770239" -- נפנוף יד R15 של Roblox עצמה; הדביקו כאן את ה-ID של האנימציה שלכם
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, וזה שבדיוק Roblox שמה בכל דמות נוצר כך. לכן הסקריפט הזה לא צריך RemoteEvent.

שלב 3: הדליקו וכבו אנימציה בלולאה

ריקוד או ישיבה צריכים להימשך עד שהשחקן עוצר אותם. קבעו את Looped ל-true, ובכל לחיצה על המקש הפעילו או עצרו את אותו טראק. הגרסה הזו גם עוצרת את הריקוד כשהשחקן מתחיל ללכת.

LocalScript בתוך StarterCharacterScripts בשם DanceToggle
-- LocalScript ב-StarterPlayer > StarterCharacterScripts בשם DanceToggle.
-- לחצו על G כדי להתחיל ריקוד בלולאה, לחצו שוב על G (או התחילו ללכת) כדי לעצור אותו.
local UserInputService = game:GetService("UserInputService")

local DANCE_ID = "rbxassetid://507771019" -- ריקוד R15 של Roblox עצמה; הדביקו כאן את ה-ID של האנימציה שלכם
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 שנוצר דרך Rig Builder כבר יש Humanoid, HumanoidRootPart ו-Animator.

Script בתוך מודל ה-NPC בשם NpcAnimation
-- Script בתוך מודל ה-NPC בשם NpcAnimation. ה-NPC צריך Humanoid ו-HumanoidRootPart.
-- מפעיל אנימציה בלולאה על ה-NPC מהשרת, ולכן כל שחקן רואה אותה.
local ANIMATION_ID = "rbxassetid://507771019" -- ריקוד R15 של Roblox עצמה; הדביקו כאן את ה-ID של האנימציה שלכם

local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid

-- ל-NPC מ-Rig בדרך כלל כבר יש 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 בתוך StarterCharacterScripts בשם PunchOnClick
-- 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 לחשבון או לקבוצה שהמשחק בבעלותם, והשתמשו ב-ID הזה.

האנימציה רצה, אבל רק הידיים זזות, או שהיא נראית לא גמורה

טראק אחר עם עדיפות גבוהה יותר מזיז את אותם מפרקים. קבעו לטראק שלכם Priority ששווה ל-Action (או גבוה יותר), או פרסמו את האנימציה עם העדיפות הזו מ-Animation Editor.

שום דבר לא קורה, ואין שגיאה

בדקו את סוג ה-Rig: אנימציית R15 לא עושה כלום על דמות R6. בדקו גם שהסקריפט הוא LocalScript ב-StarterCharacterScripts; LocalScript ב-Workspace לא רץ.

ה-NPC לא זז באנימציה

ה-Parts שלו מעוגנים, או שב-Humanoid שלו אין Animator. עגנו רק את ה-HumanoidRootPart; הסקריפט משלב 4 יוצר Animator אם אין.

שחקנים אחרים לא רואים את האנימציה שלי

האנימציה הופעלה על דמות שהשחקן לא הבעלים שלה, או על Animator שנוצר מ-LocalScript. אנימציות של הדמות שלכם הפעילו מ-LocalScript, וכל השאר (NPC, שחקנים אחרים) מ-Script של שרת.

לעשות עם RoCode

RoCode הוא סוכן AI שעובד בתוך Roblox Studio דרך פלאגין. אתם מתארים את התנועה, והוא כותב סקריפטים בפלייס שפתוח אצלכם.

אתם כותבים

תוסיף אימוט עם נפנוף יד על E וריקוד שאני יכול להדליק ולכבות על G, ותגרום ל-NPC המוכר לנופף לשחקנים שמתקרבים אליו.

RoCode עושה
  • כותב LocalScript ו-Script ל-NPC ושם אותם במקום שבו הם צריכים להיות
  • יכול להרכיב תנועות פשוטות כמו נפנוף יד, אגרוף או ריקוד ישירות בקוד, כך שלא צריך להעלות אנימציה
  • בודק את הסקריפטים שכתב בתוך Studio לפני שהוא מסיים

עדיין צריך שתלחצו על Play ותבדקו שהתנועה נראית כמו שאתם רוצים. איך RoCode מתחבר ל-Studio.

שאלות נפוצות

אפשר להשתמש בכל ID של אנימציה שמצאתי?

לא. אנימציה רצה רק במשחק שהבעלים שלו הוא הבעלים שלה, או אם היא בבעלות 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.

מקורות וקריאה נוספת

איך הקוד נבדק: כל סקריפט בעמוד הזה עובר את בודק הטיפוסים המחמיר של Luau עם הגדרות ה-API של Roblox (luau-lsp, 20 בנובמבר 2026). בדיקת טיפוסים תופסת שגיאות בשמות API וטיפוסים שגויים, אבל לא שגיאות בלוגיקת המשחק, אז בדקו הכול ב-Studio לפני הפרסום.

נסו את RoCode במשחק שלכם.

קרדיטים חינמיים בכל יום, בלי כרטיס אשראי. התקינו את הפלאגין, תארו פיצ'ר ובדקו מה מופיע ב-Studio.