Tutoriál · Herné systémy

Ako prehrať animáciu v Roblox Studiu cez skript

Animáciu v Robloxe prehráva Animator postavy, nie animácia samotná. V tomto návode prehráme animáciu, keď hráč stlačí kláves, zapneme a vypneme tanec, pustíme animáciu v slučke na NPC a spôsobíme úder presne v tej snímke, keď päsť zasiahne cieľ.

Aktualizované 20. novembra 20265 min čítaniaAutor:

V skratke

Dajte LocalScript do StarterPlayer > StarterCharacterScripts. V ňom nájdite Humanoid postavy a jeho Animator, vytvorte Animation so svojím AnimationId, načítajte ju cez animator:LoadAnimation(animation) a zavolajte :Play() na získanej stope, keď UserInputService.InputBegan ohlási váš kláves. Animáciu, ktorú hráč takto prehrá na svojej postave, vidia na serveri všetci.

  • Animácia musí patriť majiteľovi hry (vám alebo vašej skupine) alebo Robloxu. Animácia, ktorú nahral niekto iný, sa vo vašej hre neprehrá.
  • Nastavte stope Priority na Action, inak ju animácie chôdze a státia môžu prebiť.
  • Animácie načítavajte cez Animator:LoadAnimation. Humanoid:LoadAnimation je zastaraný.
Na tejto stránke
  1. Ako to funguje
  2. 1. ID animácie
  3. 2. Na kláves
  4. 3. Tanec v slučke
  5. 4. Na NPC
  6. 5. Udalosti animácie
  7. Common errors
  8. S RoCode
  9. Časté otázky
  10. Zdroje a ďalšie čítanie

Ako sa animácie v Robloxe prehrávajú

Zúčastňujú sa štyri objekty. Ručne vytvárate len jeden z nich, zvyšok urobí skript.

Objekty, ktoré prehrávajú animáciu
ObjektKde jeČo robí
AnimationVytvorí ho váš skriptUchováva AnimationId, adresu assetu animácie. Sám nič neprehráva.
AnimatorVnútri Humanoid postavy (pridáva ho Roblox)Načítava animácie a prehráva ich na kĺboch rigu.
AnimationTrackVracia ho Animator:LoadAnimation()Kópia, ktorú možno prehrať: Play(), Stop(), Looped, Priority, Speed a udalosti.
Asset animácieNa Robloxe, publikovaný z Animation EditoraSamotné kľúčové snímky. Jeho ID sa píše do AnimationId.

Každú animáciu načítajte raz a stopu si uložte. Ak voláte LoadAnimation pri každom stlačení klávesu, zakaždým vznikne nová stopa a hromadia sa.

Priority animácií, od najnižšej po najvyššiu
PrioritaNa čo
CoreNajnižšia. Všetko ostatné ju prebije.
IdleStátie na mieste.
MovementChôdza, beh, skoky.
ActionEmoty, útoky, nástroje. Bežná voľba pre animáciu, ktorú prehrávate zo skriptu.
Action2 až Action4Akcia, ktorá má prebiť inú akciu, napríklad omráčenie cez útok.

Keď dve hrajúce stopy hýbu tým istým kĺbom, na tomto kĺbe vyhrá stopa s vyššou prioritou. Mávnutie rukou na Action, ktoré hýbe len rukou, nechá nohy ísť ďalej.

Krok 1: Nájdite ID animácie, ktoré môžete použiť

Roblox prehrá animáciu vo vašej hre, len ak patrí majiteľovi hry alebo Robloxu. Preto väčšina ID skopírovaných z Creator Store alebo z videí nefunguje: patria niekomu inému a nenačítajú sa. Sú dva dobré zdroje.

  1. Urobte si vlastnú. V Studiu otvorte kartu Avatar a vyberte Animation Editor, vyberte rig (Rig Builder na tej istej karte ho vloží), nastavte pózy na časovej osi a potom v menu editora vyberte Publish to Roblox. Publikujte na ten istý účet alebo tú istú skupinu, ktorým patrí hra. Skopírujte ID, ktoré dostanete.
  2. Vezmite animácie Robloxu. Štandardné emoty zo skriptu Animate od Robloxu, napríklad mávnutie rukou R15 (507770239) a tanec (507771019), patria Robloxu, takže fungujú v každej hre. Tento návod ich používa, aby ste si všetko mohli hneď vyskúšať.

ID píšte ako "rbxassetid://" a číslo za tým, napríklad "rbxassetid://507770239".

Krok 2: Prehrajte animáciu po stlačení klávesu

  1. V Exploreri otvorte StarterPlayer, prejdite myšou na StarterCharacterScripts, kliknite na + a vložte LocalScript.
  2. Premenujte ho na EmoteOnKey a vložte kód nižšie.
  3. Kliknite na Play a stlačte E. Vaša postava zamáva.
LocalScript v StarterCharacterScripts s názvom EmoteOnKey
-- LocalScript v StarterPlayer > StarterCharacterScripts s názvom EmoteOnKey.
-- Stlačte E a prehráte animáciu na svojej postave. Na serveri ju vidia všetci.
local UserInputService = game:GetService("UserInputService")

local ANIMATION_ID = "rbxassetid://507770239" -- mávnutie rukou R15 priamo od Robloxu; sem vložte ID svojej animácie
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 -- nad chôdzou a státím, takže nohy idú ďalej a ruky mávajú

local lastPlayed = -math.huge

UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	-- gameProcessed je true, kým hráč píše do chatu alebo do textového poľa
	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) -- plynulý nábeh za 0.1 sekundy
end)

Skripty zo StarterCharacterScripts sa kopírujú do postavy pri každom jej objavení, takže script.Parent je postava a stopa sa po každom respawne načíta znova.

gameProcessed je true, keď stlačenie klávesu najprv spracoval Roblox, napríklad keď hráč píše do chatu. Táto kontrola zabráni tomu, aby sa emote spustil zakaždým, keď niekto napíše písmeno E.

Mávnutie vidia všetci, nie len vy. Roblox replikuje animácie, ktoré hráč prehráva na svojej postave, ak Animator vytvoril server, a ten, ktorý Roblox dáva do každej postavy, je vytvorený práve tak. Preto tento skript nepotrebuje RemoteEvent.

Krok 3: Zapínajte a vypínajte animáciu v slučke

Tanec alebo sedenie má pokračovať, kým ho hráč nezastaví. Nastavte Looped na true a pri každom stlačení klávesu spustite alebo zastavte tú istú stopu. Táto verzia navyše zastaví tanec, keď hráč začne chodiť.

LocalScript v StarterCharacterScripts s názvom DanceToggle
-- LocalScript v StarterPlayer > StarterCharacterScripts s názvom DanceToggle.
-- Stlačte G a spustíte tanec v slučke, stlačte G znova (alebo sa rozíďte) a zastavíte ho.
local UserInputService = game:GetService("UserInputService")

local DANCE_ID = "rbxassetid://507771019" -- tanec R15 priamo od Robloxu; sem vložte ID svojej animácie
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)

-- Zastavíme tanec, keď hráč začne chodiť
humanoid.Running:Connect(function(speed: number)
	if speed > 0.5 and track.IsPlaying then
		track:Stop(0.2)
	end
end)

Číslo odovzdávané do Play a Stop je doba plynulého prechodu v sekundách. Krátky prechod tanec plynulo zapne a vypne, namiesto toho, aby postavou trhol z pózy do pózy.

Krok 4: Prehrajte animáciu na NPC

NPC nepatrí žiadnemu hráčovi, takže jeho animácie prehráva server. Dajte Script (nie LocalScript) dovnútra modelu NPC. Rig vytvorený cez Rig Builder už má Humanoid, HumanoidRootPart a Animator.

Script v modeli NPC s názvom NpcAnimation
-- Script vnútri modelu NPC s názvom NpcAnimation. NPC potrebuje Humanoid a HumanoidRootPart.
-- Prehráva animáciu v slučke na NPC zo servera, takže ju vidí každý hráč.
local ANIMATION_ID = "rbxassetid://507771019" -- tanec R15 priamo od Robloxu; sem vložte ID svojej animácie

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

-- NPC z rigu zvyčajne už Animator má; ak nie, vytvoríme ho
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: Naviažte akciu na okamih v animácii

Úder má spôsobiť poškodenie, keď päsť zasiahne cieľ, nie keď sa stlačí kláves. V Animation Editore kliknite pravým tlačidlom na časovú os v tom okamihu a pridajte animation event s názvom Hit, potom animáciu publikujte znova. V kóde sa track:GetMarkerReachedSignal("Hit") spustí na tejto snímke.

LocalScript v StarterCharacterScripts s názvom PunchOnClick
-- LocalScript v StarterPlayer > StarterCharacterScripts s názvom PunchOnClick.
-- Po kliknutí prehrá vašu animáciu úderu a oznámi serveru okamih, keď päsť zasiahne cieľ,
-- cez udalosť animácie "Hit", ktorú pridáte v Animation Editore.
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local UserInputService = game:GetService("UserInputService")

local PUNCH_ID = "rbxassetid://0" -- vaša animácia úderu s udalosťou "Hit" v okamihu zásahu
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() -- server overí vzdialenosť a cooldown, skôr než spôsobí poškodenie
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)

Tento skript potrebuje RemoteEvent s názvom PunchHit v ReplicatedStorage a vašu vlastnú animáciu úderu s udalosťou Hit namiesto rbxassetid://0.

Klient len oznámi „môj úder zasiahol“. Serverový Script, ktorý počúva PunchHit.OnServerEvent, rozhodne, či bol niekto neďaleko a koľko poškodenia spôsobiť, s vlastným cooldownom, aby hráč, ktorý udalosť vyvoláva ručne, nemohol útočiť cez celú mapu. Návod k RemoteEvent ukazuje, ako takú požiadavku na serveri overiť.

Časté chyby a riešenia

Najprv otvorte okno Output (menu Window, potom Output). Väčšina problémov s animáciami tam vypíše riadok.

Nič sa nedeje a v Output stojí, že sa animácia nenačítala

Animácia nepatrí majiteľovi hry, ale niekomu inému. Publikujte vlastnú kópiu z Animation Editora na účet alebo skupinu, ktorým hra patrí, a použite toto ID.

Animácia hrá, ale hýbu sa len ruky, alebo vyzerá nedokončene

Iná stopa s vyššou prioritou hýbe tými istými kĺbmi. Nastavte svojej stope Priority na Action (alebo vyššie), alebo animáciu s touto prioritou publikujte z Animation Editora.

Nič sa nedeje a chyba nie je

Skontrolujte typ rigu: animácia R15 na postave R6 nič nerobí. Overte tiež, že skript je LocalScript v StarterCharacterScripts; LocalScript vo Workspace sa nespustí.

NPC sa neanimuje

Jeho party sú ukotvené, alebo jeho Humanoid nemá Animator. Ukotvite len HumanoidRootPart; skript z kroku 4 vytvorí Animator, ak chýba.

Ostatní hráči moju animáciu nevidia

Animácia sa prehrala na postave, ktorú hráč nevlastní, alebo na Animatore vytvorenom z LocalScriptu. Animácie svojej postavy prehrávajte z LocalScriptu a všetko ostatné (NPC, iných hráčov) zo serverového Scriptu.

Urobiť s RoCode

RoCode je AI agent, ktorý pracuje vnútri Roblox Studia cez plugin. Opíšete pohyb a on napíše skripty vo vašom otvorenom place.

Napíšete

Pridaj emote s mávnutím rukou na E a tanec, ktorý môžem zapínať a vypínať na G, a urob, aby NPC predavač mával hráčom, ktorí k nemu prídu.

RoCode urobí
  • Napíše LocalScript a Script pre NPC a dá ich tam, kam patria
  • Vie zložiť jednoduché pohyby ako mávnutie rukou, úder alebo tanec priamo v kóde, takže animáciu nahrávať nemusíte
  • Pred dokončením skontroluje napísané skripty vnútri Studia

Aj tak musíte kliknúť na Play a overiť, že pohyb vyzerá tak, ako chcete. Ako sa RoCode pripája k Studiu.

Časté otázky

Môžem použiť akékoľvek ID animácie, ktoré nájdem?

Nie. Animácia hrá len v hre, ktorej majiteľ ju vlastní, alebo ak ju vlastní Roblox. Používajte svoje animácie alebo štandardné animácie Robloxu.

Vidia ostatní hráči animáciu z LocalScriptu?

Áno, ak ju hráč prehrá na svojej postave cez Animator, ktorý Roblox postave dáva. Animácie na NPC treba prehrávať zo serverového Scriptu.

Ako v Robloxe pustiť animáciu v slučke?

Nastavte track.Looped = true pred spustením, alebo zapnite Loop v Animation Editore pred publikovaním.

Ako animáciu zastaviť?

Zavolajte track:Stop() na stope, ktorú ste spustili. Odovzdajte číslo, napríklad track:Stop(0.2), aby plynulo doznela za toľko sekúnd.

Prečo Animator, a nie Humanoid:LoadAnimation?

Humanoid:LoadAnimation je zastaraný. Animator:LoadAnimation robí to isté a práve ten opisuje dokumentácia Robloxu.

Zdroje a ďalšie čítanie

Ako bol kód overený: každý skript na tejto stránke prechádza prísnou kontrolou typov Luau s definíciami Roblox API (luau-lsp, 20. novembra 2026). Kontrola typov zachytí chyby v názvoch API a nesprávne typy, ale nie chyby v hernej logike, preto všetko pred publikovaním otestujte v Studiu.

Vyskúšajte RoCode vo svojej hre.

Kredity zadarmo každý deň, bez karty. Nainštalujte plugin, opíšte funkciu a pozrite sa, čo sa objaví v Studiu.