Урок · Системи в играта

Как да пуснеш анимация в Roblox Studio със скрипт

В Roblox анимацията се пуска от Animator на персонажа, а не от самата анимация. В това ръководство пускаме анимация, когато играчът натисне клавиш, включваме и изключваме танц, въртим анимация в цикъл на NPC и нанасяме удар точно в кадъра, в който юмрукът улучва целта.

Обновено 20 ноември 2026 г.6 мин четенеАвтор:

Накратко

Сложи 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, адреса на асета с анимацията. Сам по себе си не пуска нищо.
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 или от видео, не стават: те принадлежат на някой друг и не се зареждат. Има два добри източника.

  1. Направи своя. В Studio отвори раздела Avatar и избери Animation Editor, избери риг (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 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 от риг обикновено вече има 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.

Нищо не става и няма грешка

Провери типа на рига: анимация R15 не прави нищо на персонаж R6. Провери също дали скриптът е LocalScript в StarterCharacterScripts; LocalScript в Workspace не се стартира.

NPC не се анимира

Партовете му са закотвени или в неговия Humanoid няма Animator. Закотвяй само HumanoidRootPart; скриптът от стъпка 4 създава Animator, ако липсва.

Другите играчи не виждат моята анимация

Анимацията е пусната на персонаж, който не е на играча, или на Animator, създаден от LocalScript. Анимациите на своя персонаж пускай от LocalScript, а всичко останало (NPC, други играчи) от сървърен Script.

Направи го с RoCode

RoCode е ИИ агент, който работи в 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 с дефинициите на Roblox API (luau-lsp, 20 ноември 2026 г.). Проверката на типовете хваща грешки в имената на API и грешни типове, но не и грешки в логиката на играта, затова тествай всичко в Studio, преди да публикуваш.

Пробвай RoCode в своята игра.

Безплатни кредити всеки ден, без карта. Инсталирай плъгина, опиши функцията и виж какво се е появило в Studio.