Poradnik · Systemy gry

Jak odtworzyć animację w Roblox Studio przez skrypt

Animację w Roblox odtwarza Animator postaci, a nie sama animacja. W tym poradniku odtwarzamy animację, gdy gracz naciska klawisz, włączamy i wyłączamy taniec, zapętlamy animację na NPC i zadajemy cios dokładnie w tej klatce, w której pięść trafia w cel.

Zaktualizowano 20 listopada 20266 min czytaniaAutor:

W skrócie

Włóż LocalScript do StarterPlayer > StarterCharacterScripts. W nim znajdź Humanoid postaci i jego Animator, utwórz Animation ze swoim AnimationId, wczytaj ją przez animator:LoadAnimation(animation) i wywołaj :Play() na otrzymanym tracku, gdy UserInputService.InputBegan zgłosi twój klawisz. Animację, którą gracz w ten sposób odtwarza na swojej postaci, widzą wszyscy na serwerze.

  • Animacja musi należeć do właściciela gry (ciebie albo twojej grupy) albo do Roblox. Animacja, którą wgrał ktoś inny, w twojej grze się nie odtworzy.
  • Ustaw trackowi Priority na Action, inaczej animacje chodzenia i stania mogą ją przykryć.
  • Wczytuj animacje przez Animator:LoadAnimation. Humanoid:LoadAnimation jest przestarzały.
Na tej stronie
  1. Jak to działa
  2. 1. ID animacji
  3. 2. Pod klawisz
  4. 3. Zapętlony taniec
  5. 4. Na NPC
  6. 5. Eventy animacji
  7. Common errors
  8. Z RoCode
  9. Najczęstsze pytania
  10. Źródła i dalsza lektura

Jak odtwarzają się animacje w Roblox

Biorą w tym udział cztery obiekty. Ręcznie tworzysz tylko jeden z nich, resztę robi skrypt.

Obiekty, które odtwarzają animację
ObiektGdzie jestCo robi
AnimationTworzy go twój skryptPrzechowuje AnimationId, adres assetu animacji. Sam z siebie nic nie odtwarza.
AnimatorWewnątrz Humanoid postaci (dodaje go Roblox)Wczytuje animacje i odtwarza je na stawach riga.
AnimationTrackZwracany przez Animator:LoadAnimation()Kopia, którą można odtworzyć: Play(), Stop(), Looped, Priority, Speed i eventy.
Asset animacjiNa Roblox, opublikowany z Animation EditorSame klatki kluczowe. Jego ID wpisuje się w AnimationId.

Wczytuj każdą animację raz i przechowuj track. Jeśli wywołujesz LoadAnimation przy każdym naciśnięciu klawisza, za każdym razem powstaje nowy track i one się gromadzą.

Priorytety animacji, od najniższego do najwyższego
PriorytetDo czego
CoreNajniższy. Wszystko inne go przykrywa.
IdleStanie w miejscu.
MovementChodzenie, bieganie, skoki.
ActionEmotki, ataki, narzędzia. Zwykły wybór dla animacji, którą odtwarzasz ze skryptu.
Action2 do Action4Akcja, która ma przykryć inną akcję, na przykład ogłuszenie nad atakiem.

Gdy dwa grające tracki poruszają tym samym stawem, na tym stawie wygrywa track z wyższym priorytetem. Machnięcie ręką na Action, które porusza tylko ręką, pozwala nogom dalej iść.

Krok 1: znajdź ID animacji, którego możesz użyć

Roblox odtwarza animację w twojej grze tylko wtedy, gdy należy ona do właściciela gry albo do Roblox. Dlatego większość ID skopiowanych z Creator Store albo z filmów nie pasuje: należą do kogoś innego i się nie wczytują. Są dwa dobre źródła.

  1. Zrób własną. W Studio otwórz kartę Avatar i wybierz Animation Editor, zaznacz rig (Rig Builder na tej samej karcie go wstawia), ustaw pozy na osi czasu, potem w menu edytora wybierz Publish to Roblox. Publikuj na to samo konto albo tę samą grupę, do której należy gra. Skopiuj ID, które dostaniesz.
  2. Weź animacje Roblox. Standardowe emotki ze skryptu Animate od Roblox, na przykład machanie ręką R15 (507770239) i taniec (507771019), należą do Roblox, więc działają w każdej grze. W tym poradniku używamy właśnie ich, żebyś mógł od razu wszystko sprawdzić.

Zapisuj ID jako "rbxassetid://" i numer po nim, na przykład "rbxassetid://507770239".

Krok 2: odtwórz animację po naciśnięciu klawisza

  1. W Explorerze otwórz StarterPlayer, najedź kursorem na StarterCharacterScripts, kliknij + i wstaw LocalScript.
  2. Zmień jego nazwę na EmoteOnKey i wklej kod poniżej.
  3. Kliknij Play i naciśnij E. Twoja postać pomacha ręką.
LocalScript w StarterCharacterScripts o nazwie EmoteOnKey
-- LocalScript w StarterPlayer > StarterCharacterScripts o nazwie EmoteOnKey.
-- Naciśnij E, żeby odtworzyć animację na swojej postaci. Widzą ją wszyscy na serwerze.
local UserInputService = game:GetService("UserInputService")

local ANIMATION_ID = "rbxassetid://507770239" -- machanie ręką R15 od samego Roblox; wstaw tu ID swojej animacji
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 -- wyżej niż chodzenie i stanie, więc nogi idą dalej, a ręce machają

local lastPlayed = -math.huge

UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	-- gameProcessed jest true, gdy gracz pisze na czacie albo w polu tekstowym
	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) -- płynne wejście w 0.1 sekundy
end)

Skrypty ze StarterCharacterScripts kopiują się do postaci przy każdym jej pojawieniu się, więc script.Parent to postać, a track wczytuje się na nowo po każdym respawnie.

gameProcessed jest true, gdy naciśnięcie klawisza najpierw obsłużył Roblox, na przykład gdy gracz pisze na czacie. To sprawdzenie nie pozwala emotce odpalać się za każdym razem, gdy ktoś wpisuje literę E.

Machanie widzą wszyscy, nie tylko ty. Roblox replikuje animacje, które gracz odtwarza na swojej postaci, jeśli Animator utworzył serwer, a ten, który Roblox wkłada do każdej postaci, jest utworzony właśnie tak. Dlatego ten skrypt nie potrzebuje RemoteEvent.

Krok 3: włączaj i wyłączaj zapętloną animację

Taniec albo siedzenie powinny trwać, dopóki gracz ich nie zatrzyma. Ustaw Looped na true i przy każdym naciśnięciu klawisza uruchamiaj albo zatrzymuj ten sam track. Ta wersja dodatkowo zatrzymuje taniec, gdy gracz zaczyna iść.

LocalScript w StarterCharacterScripts o nazwie DanceToggle
-- LocalScript w StarterPlayer > StarterCharacterScripts o nazwie DanceToggle.
-- Naciśnij G, żeby zacząć zapętlony taniec, naciśnij G jeszcze raz (albo idź), żeby go zatrzymać.
local UserInputService = game:GetService("UserInputService")

local DANCE_ID = "rbxassetid://507771019" -- taniec R15 od samego Roblox; wstaw tu ID swojej animacji
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)

-- Zatrzymujemy taniec, gdy gracz zaczyna iść
humanoid.Running:Connect(function(speed: number)
	if speed > 0.5 and track.IsPlaying then
		track:Stop(0.2)
	end
end)

Liczba przekazywana do Play i Stop to czas płynnego przejścia w sekundach. Krótkie przejście płynnie włącza i wyłącza taniec, zamiast szarpać postacią z pozy w pozę.

Krok 4: odtwórz animację na NPC

NPC nie należy do żadnego gracza, więc jego animacje odtwarza serwer. Włóż Script (nie LocalScript) do modelu NPC. Rig zrobiony przez Rig Builder ma już Humanoid, HumanoidRootPart i Animator.

Script w modelu NPC o nazwie NpcAnimation
-- Script wewnątrz modelu NPC o nazwie NpcAnimation. NPC potrzebuje Humanoid i HumanoidRootPart.
-- Odtwarza zapętloną animację na NPC z serwera, więc widzi ją każdy gracz.
local ANIMATION_ID = "rbxassetid://507771019" -- taniec R15 od samego Roblox; wstaw tu ID swojej animacji

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

-- NPC z riga zwykle ma już Animator; jeśli nie, tworzymy go
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()

Krok 5: powiąż akcję z momentem w animacji

Cios powinien zadawać obrażenia, gdy pięść trafia w cel, a nie gdy naciśnięto klawisz. W Animation Editor kliknij prawym przyciskiem na osi czasu w tym momencie i dodaj animation event o nazwie Hit, potem opublikuj animację ponownie. W kodzie track:GetMarkerReachedSignal("Hit") odpala się w tej klatce.

LocalScript w StarterCharacterScripts o nazwie PunchOnClick
-- LocalScript w StarterPlayer > StarterCharacterScripts o nazwie PunchOnClick.
-- Odtwarza twoją animację ciosu po kliknięciu i zgłasza serwerowi moment, gdy pięść trafia w cel,
-- przez event animacji "Hit", który dodajesz w Animation Editor.
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local UserInputService = game:GetService("UserInputService")

local PUNCH_ID = "rbxassetid://0" -- twoja animacja ciosu z eventem "Hit" w chwili trafienia
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() -- serwer sprawdza dystans i cooldown, zanim zada obrażenia
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)

Ten skrypt potrzebuje RemoteEvent o nazwie PunchHit w ReplicatedStorage i twojej własnej animacji ciosu z eventem Hit zamiast rbxassetid://0.

Klient tylko zgłasza "mój cios trafił". Serwerowy Script, który nasłuchuje PunchHit.OnServerEvent, decyduje, czy ktoś był blisko i ile obrażeń zadać, z własnym cooldownem, żeby gracz, który wywołuje event ręcznie, nie mógł bić przez całą mapę. Poradnik o RemoteEvent pokazuje, jak sprawdzać takie żądanie na serwerze.

Częste błędy i rozwiązania

Najpierw otwórz okno Output (menu Window, potem Output). Większość problemów z animacjami wpisuje tam linię.

Nic się nie dzieje, a w Output jest napisane, że animacja się nie wczytała

Animacja nie należy do właściciela gry, tylko do kogoś innego. Opublikuj swoją kopię z Animation Editor na konto albo grupę, do której należy gra, i użyj tego ID.

Animacja gra, ale ruszają się tylko ręce albo wygląda na niedokończoną

Inny track z wyższym priorytetem porusza tymi samymi stawami. Ustaw swojemu trackowi Priority na Action (albo wyżej) albo opublikuj animację z tym priorytetem z Animation Editor.

Nic się nie dzieje i nie ma błędu

Sprawdź typ riga: animacja R15 nic nie robi na postaci R6. Sprawdź też, czy skrypt to LocalScript w StarterCharacterScripts; LocalScript w Workspace się nie uruchamia.

NPC się nie animuje

Jego party są zakotwiczone albo w jego Humanoid nie ma Animator. Kotwicz tylko HumanoidRootPart; skrypt z kroku 4 tworzy Animator, jeśli go nie ma.

Inni gracze nie widzą mojej animacji

Animację odtworzono na postaci, której gracz nie posiada, albo na Animatorze utworzonym z LocalScript. Animacje swojej postaci odtwarzaj z LocalScript, a wszystko inne (NPC, innych graczy) z serwerowego Script.

Zrób to z RoCode

RoCode to agent AI, który działa wewnątrz Roblox Studio przez plugin. Opisujesz ruch, a on pisze skrypty w grze, którą masz otwartą.

Ty piszesz

Dodaj emotkę z machaniem ręką pod E i taniec, który mogę włączać i wyłączać pod G, i spraw, żeby NPC-sprzedawca machał graczom, którzy do niego podchodzą.

RoCode robi
  • Pisze LocalScript i Script dla NPC i wkłada je tam, gdzie powinny leżeć
  • Może zbudować proste ruchy, takie jak machanie ręką, cios albo taniec, prosto w kodzie, więc nie trzeba wgrywać animacji
  • Sprawdza napisane skrypty wewnątrz Studio, zanim skończy

I tak musisz kliknąć Play i sprawdzić, czy ruch wygląda tak, jak chcesz. Jak RoCode łączy się ze Studio.

Najczęstsze pytania

Czy mogę użyć dowolnego ID animacji, które znalazłem?

Nie. Animacja gra tylko w grze, której właściciel ją posiada, albo jeśli należy do Roblox. Używaj swoich animacji albo standardowych animacji Roblox.

Czy inni gracze widzą animację z LocalScript?

Tak, jeśli gracz odtwarza ją na swojej postaci przez Animator, który Roblox daje postaci. Animacje na NPC trzeba odtwarzać z serwerowego Script.

Jak zapętlić animację w Roblox?

Ustaw track.Looped = true przed uruchomieniem albo włącz Loop w Animation Editor przed publikacją.

Jak zatrzymać animację?

Wywołaj track:Stop() na tracku, który uruchomiłeś. Przekaż liczbę, na przykład track:Stop(0.2), żeby płynnie wygasła w tyle sekund.

Dlaczego Animator, a nie Humanoid:LoadAnimation?

Humanoid:LoadAnimation jest przestarzały. Animator:LoadAnimation robi to samo i to właśnie go opisuje dokumentacja Roblox.

Źródła i dalsza lektura

Jak sprawdziliśmy kod: każdy skrypt na tej stronie przechodzi ścisłe sprawdzanie typów Luau z definicjami API Robloxa (luau-lsp, 20 listopada 2026). Sprawdzanie typów wyłapuje źle wpisane API i błędne typy, ale nie logikę gry, więc przetestuj go w Studio przed publikacją.

Wypróbuj RoCode we własnej grze.

Darmowe kredyty codziennie, bez karty. Zainstaluj plugin, opisz funkcję i sprawdź, co pojawi się w Studio.