Туториал · Игровые системы

Как проиграть анимацию в Roblox Studio через скрипт

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

Обновлено 14 ноября 2026 г.5 мин чтенияАвтор:

Коротко

Положите 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, 14 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.

Попробуйте RoCode в своей игре.

Бесплатные кредиты каждый день, без карты. Установите плагин, опишите функцию и проверьте, что появилось в Studio.