Коротко
Покладіть 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) | Завантажує анімації та програє їх на суглобах ригу. |
AnimationTrack | Повертається з Animator:LoadAnimation() | Копія, яку можна програти: Play(), Stop(), Looped, Priority, Speed і події. |
| Ассет анімації | На Roblox, опублікований з Animation Editor | Самі ключові кадри. Саме його ID і пишеться в AnimationId. |
Завантажуйте кожну анімацію один раз і зберігайте трек. Якщо викликати LoadAnimation на кожне натискання клавіші, щоразу створюється новий трек, і вони накопичуються.
| Пріоритет | Для чого |
|---|---|
Core | Найнижчий. Усе інше його перекриває. |
Idle | Стояння на місці. |
Movement | Ходьба, біг, стрибки. |
Action | Емоції, атаки, інструменти. Звичайний вибір для анімації, яку ви програєте зі скрипту. |
Від Action2 до Action4 | Дія, яка має перекрити іншу дію, наприклад оглушення поверх атаки. |
Коли два треки, що грають, рухають той самий суглоб, на цьому суглобі перемагає трек із вищим пріоритетом. Помах рукою на Action, який рухає лише руку, дає ногам змогу йти далі.
Крок 1: Знайдіть ID анімації, який можна використати
Roblox програє анімацію у вашій грі, лише якщо вона належить власнику гри або Roblox. Тому більшість ID, скопійованих із Creator Store або з відео, не підходять: вони належать комусь іншому й не завантажуються. Є два добрі джерела.
- Зробіть свою. У Studio відкрийте вкладку Avatar і виберіть Animation Editor, виділіть риг (Rig Builder на тій самій вкладці вставляє його), розставте пози на таймлайні, потім у меню редактора виберіть Publish to Roblox. Публікуйте на той самий акаунт або ту саму групу, якій належить гра. Скопіюйте ID, який отримаєте.
- Візьміть анімації Roblox. Стандартні емоції зі скрипту Animate від Roblox, наприклад помах рукою R15 (
507770239) і танець (507771019), належать Roblox, тому працюють у будь-якій грі. У цьому гайді використано саме їх, щоб ви могли одразу все перевірити.
Пишіть ID як "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; вставте сюди 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 у 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 Builder, уже є Humanoid, HumanoidRootPart і Animator.
-- 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 з ригу зазвичай уже є 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 на акаунт або групу, якій належить гра, і використовуйте цей ID.
Анімація грає, але рухаються лише руки, або вона виглядає незавершеною
Інший трек із вищим пріоритетом рухає ті самі суглоби. Поставте своєму треку Priority рівним Action (або вище) або опублікуйте анімацію з цим пріоритетом з Animation Editor.
Нічого не відбувається, і помилки немає
Перевірте тип ригу: анімація R15 нічого не робить на персонажі R6. Перевірте також, що скрипт це LocalScript у StarterCharacterScripts; LocalScript у Workspace не запускається.
NPC не анімується
Його парти заякорені, або в його Humanoid немає Animator. Заякорюйте лише HumanoidRootPart; скрипт із кроку 4 створює Animator, якщо його немає.
Інші гравці не бачать моєї анімації
Анімацію програли на персонажі, яким гравець не володіє, або на Animator, створеному з LocalScript. Анімації свого персонажа програвайте з LocalScript, а все інше (NPC, інших гравців) із серверного Script.
Зробити з RoCode
RoCode це ШІ-агент, який працює всередині Roblox Studio через плагін. Ви описуєте рух, а він пише скрипти у відкритому у вас плейсі.
Додай емоцію з помахом рукою на E і танець, який я можу вмикати й вимикати на G, і зроби так, щоб NPC-продавець махав гравцям, які до нього підходять.
- Пише 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.
Джерела та що почитати
- Roblox Creator Docs: Use animations (англійською). завантаження й запуск анімацій зі скриптів, володіння анімацією
- Roblox Creator Docs: Animator (англійською). LoadAnimation і реплікація
- Roblox Creator Docs: AnimationTrack (англійською). Play, Stop, Looped, Priority, GetMarkerReachedSignal
- Roblox Creator Docs: Animation Editor (англійською). створення, публікація та події анімації
Як перевірявся код: кожен скрипт на цій сторінці проходить сувору перевірку типів Luau з визначеннями Roblox API (luau-lsp, 20 листопада 2026 р.). Перевірка типів ловить помилки в назвах API та неправильні типи, але не помилки ігрової логіки, тому протестуйте все в Studio перед публікацією.