Накратко
Сложи 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, преди да публикуваш.