Útmutató · Játékrendszerek

Hogyan játssz le animációt scripttel a Roblox Studióban

A Robloxban az animációt a karakter Animator objektuma játssza le, nem maga az animáció. Ebben az útmutatóban lejátszunk egy animációt, amikor a játékos megnyom egy gombot, be- és kikapcsolunk egy táncot, ismétlődő animációt futtatunk egy NPC-n, és pontosan abban a képkockában sebzünk, amikor az ököl eltalálja a célt.

Frissítve 2026. november 20.6 perc olvasásSzerző:

Röviden

Tegyél egy LocalScriptet a StarterPlayer > StarterCharacterScripts mappába. Ebben keresd meg a karakter Humanoid objektumát és annak Animator objektumát, hozz létre egy Animation objektumot a saját AnimationId értékeddel, töltsd be az animator:LoadAnimation(animation) hívással, és hívd meg a kapott track :Play() metódusát, amikor a UserInputService.InputBegan jelzi a gombodat. Az animációt, amelyet a játékos így a saját karakterén játszik le, a szerveren mindenki látja.

  • Az animáció a játék tulajdonosáé (a tiéd vagy a csoportodé) vagy a Robloxé legyen. Egy animáció, amelyet valaki más töltött fel, a játékodban nem fog lejátszódni.
  • Állítsd a track Priority értékét Action-re, különben a járás és az állás animációi felülírhatják.
  • Az animációkat az Animator:LoadAnimation segítségével töltsd be. A Humanoid:LoadAnimation elavult.
Ezen az oldalon
  1. Hogyan működik
  2. 1. Animáció ID
  3. 2. Gombra
  4. 3. Ismétlődő tánc
  5. 4. NPC-n
  6. 5. Animációs események
  7. Common errors
  8. RoCode-dal
  9. Gyakori kérdések
  10. Források és további olvasnivaló

Hogyan játszódnak le az animációk a Robloxban

Négy objektum vesz részt benne. Kézzel ezek közül csak egyet hozol létre, a többit a script végzi.

Az objektumok, amelyek lejátsszák az animációt
ObjektumHol találhatóMit csinál
AnimationA scripted hozza létreTárolja az AnimationId értéket, az animációs asset címét. Önmagában semmit sem játszik le.
AnimatorA karakter Humanoid objektumában (a Roblox adja hozzá)Betölti az animációkat, és lejátssza őket a rig ízületein.
AnimationTrackAz Animator:LoadAnimation() adja visszaLejátszható példány: Play(), Stop(), Looped, Priority, Speed és események.
Animációs assetA Robloxon, az Animation Editorból publikálvaMaguk a kulcskockák. Ennek az ID-ja kerül az AnimationId értékbe.

Minden animációt egyszer tölts be, és tárold a tracket. Ha minden gombnyomásra meghívod a LoadAnimation függvényt, minden alkalommal új track jön létre, és ezek felhalmozódnak.

Animációs prioritások, a legalacsonyabbtól a legmagasabbig
PrioritásMire való
CoreA legalacsonyabb. Minden más felülírja.
IdleEgy helyben állás.
MovementJárás, futás, ugrás.
ActionEmote-ok, támadások, eszközök. A szokásos választás egy scriptből lejátszott animációhoz.
Action2-től Action4-igOlyan cselekvés, amelynek felül kell írnia egy másikat, például kábítás egy támadás fölött.

Ha két futó track ugyanazt az ízületet mozgatja, azon az ízületen a magasabb prioritású track nyer. Egy Action prioritású integetés, amely csak a kart mozgatja, hagyja, hogy a lábak tovább járjanak.

1. lépés: Keress egy használható animáció ID-t

A Roblox csak akkor játszik le egy animációt a játékodban, ha az a játék tulajdonosáé vagy a Robloxé. Ezért a Creator Store-ból vagy videókból kimásolt ID-k többsége nem jó: valaki másé, és nem töltődik be. Két jó forrás van.

  1. Készítsd el a sajátodat. A Studióban nyisd meg az Avatar fület, és válaszd az Animation Editort, jelölj ki egy riget (ugyanezen a fülön a Rig Builder beszúr egyet), állítsd be a pózokat az idővonalon, aztán a szerkesztő menüjében válaszd a Publish to Roblox pontot. Ugyanarra a fiókra vagy csoportra publikáld, amelyé a játék. Másold ki a kapott ID-t.
  2. Használd a Roblox animációit. A Roblox Animate scriptjének alap emote-jai, például az R15 integetés (507770239) és a tánc (507771019), a Robloxéi, ezért bármelyik játékban működnek. Ez az útmutató ezeket használja, hogy mindent azonnal kipróbálhass.

Az ID-t "rbxassetid://" formában írd, utána a számmal, például "rbxassetid://507770239".

2. lépés: Játssz le egy animációt gombnyomásra

  1. Az Explorerben nyisd meg a StarterPlayer mappát, vidd az egeret a StarterCharacterScripts fölé, kattints a + gombra, és szúrj be egy LocalScriptet.
  2. Nevezd át EmoteOnKey-ra, és illeszd be az alábbi kódot.
  3. Nyomd meg a Play gombot, majd az E billentyűt. A karaktered integetni fog.
LocalScript helye: StarterCharacterScripts neve: EmoteOnKey
-- LocalScript a StarterPlayer > StarterCharacterScripts mappában, a neve EmoteOnKey.
-- Nyomd meg az E-t, hogy lejátszd az animációt a karaktereden. A szerveren mindenki látja.
local UserInputService = game:GetService("UserInputService")

local ANIMATION_ID = "rbxassetid://507770239" -- R15 integetés magától a Robloxtól; ide írd a saját animációd ID-ját
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 -- a járás és az állás fölött, így a lábak tovább járnak, a karok pedig integetnek

local lastPlayed = -math.huge

UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	-- a gameProcessed értéke true, amíg a játékos a chatbe vagy egy szövegmezőbe ír
	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) -- finom beúszás 0,1 másodperc alatt
end)

A StarterCharacterScripts scriptjei minden megjelenéskor átmásolódnak a karakterbe, ezért a script.Parent maga a karakter, és a track minden respawn után újra betöltődik.

A gameProcessed értéke true, ha a gombnyomást először a Roblox dolgozta fel, például amíg a játékos a chatbe ír. Ez az ellenőrzés megakadályozza, hogy az emote minden alkalommal elinduljon, amikor valaki leüt egy E betűt.

Az integetést mindenki látja, nem csak te. A Roblox replikálja az animációkat, amelyeket a játékos a saját karakterén játszik le, ha az Animator objektumot a szerver hozta létre, és amelyet a Roblox minden karakterbe tesz, pontosan így jön létre. Ezért ennek a scriptnek nincs szüksége RemoteEventre.

3. lépés: Kapcsolj be és ki egy ismétlődő animációt

Egy táncnak vagy ülésnek addig kell tartania, amíg a játékos le nem állítja. Állítsd a Looped értékét true-ra, és minden gombnyomásra indítsd el vagy állítsd le ugyanazt a tracket. Ez a változat ráadásul leállítja a táncot, amikor a játékos elindul.

LocalScript helye: StarterCharacterScripts neve: DanceToggle
-- LocalScript a StarterPlayer > StarterCharacterScripts mappában, a neve DanceToggle.
-- Nyomd meg a G-t az ismétlődő tánc indításához, nyomd meg újra a G-t (vagy indulj el) a leállításához.
local UserInputService = game:GetService("UserInputService")

local DANCE_ID = "rbxassetid://507771019" -- R15 tánc magától a Robloxtól; ide írd a saját animációd ID-ját
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)

-- Leállítjuk a táncot, amikor a játékos elindul
humanoid.Running:Connect(function(speed: number)
	if speed > 0.5 and track.IsPlaying then
		track:Stop(0.2)
	end
end)

A Play és a Stop függvénynek átadott szám az átmenet ideje másodpercben. Egy rövid átmenet finoman kapcsolja be és ki a táncot, ahelyett hogy a karaktert egyik pózból a másikba rántaná.

4. lépés: Játssz le egy animációt egy NPC-n

Az NPC egyetlen játékosé sem, ezért az animációit a szerver játssza le. Tegyél egy Scriptet (nem LocalScriptet) az NPC modelljébe. A Rig Builderrel készült rignek már van Humanoid, HumanoidRootPart és Animator objektuma.

Script helye: NPC modell neve: NpcAnimation
-- Script az NPC modelljében, a neve NpcAnimation. Az NPC-nek kell Humanoid és HumanoidRootPart.
-- Ismétlődő animációt játszik le az NPC-n a szerverről, ezért minden játékos látja.
local ANIMATION_ID = "rbxassetid://507771019" -- R15 tánc magától a Robloxtól; ide írd a saját animációd ID-ját

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

-- A rigből készült NPC-nek általában már van Animatora; ha nincs, létrehozzuk
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. lépés: Köss egy cselekvést az animáció egy pillanatához

Az ütésnek akkor kell sebeznie, amikor az ököl eltalálja a célt, nem amikor megnyomod a gombot. Az Animation Editorban kattints jobb gombbal az idővonalra ennél a pillanatnál, adj hozzá egy Hit nevű animation eventet, aztán publikáld újra az animációt. A kódban a track:GetMarkerReachedSignal("Hit") ennél a képkockánál sül el.

LocalScript helye: StarterCharacterScripts neve: PunchOnClick
-- LocalScript a StarterPlayer > StarterCharacterScripts mappában, a neve PunchOnClick.
-- Kattintásra lejátssza az ütésanimációdat, és jelzi a szervernek a pillanatot, amikor az ököl eltalálja a célt,
-- a "Hit" animációs eseményen keresztül, amelyet az Animation Editorban adsz hozzá.
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local UserInputService = game:GetService("UserInputService")

local PUNCH_ID = "rbxassetid://0" -- a saját ütésanimációd egy "Hit" eseménnyel a találat pillanatában
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() -- a szerver ellenőrzi a távolságot és a cooldownt, mielőtt sebez
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)

Ehhez a scripthez kell egy PunchHit nevű RemoteEvent a ReplicatedStorage-ben, és a saját ütésanimációd egy Hit eseménnyel az rbxassetid://0 helyett.

A kliens csak annyit jelez, hogy "az ütésem talált". Egy szerveroldali Script, amely a PunchHit.OnServerEvent eseményt figyeli, eldönti, volt-e valaki a közelben, és mekkora sebzést okozzon, saját újratöltési idővel (cooldown), hogy egy játékos, aki kézzel váltja ki az eseményt, ne üthessen át az egész pályán. A RemoteEvent útmutató megmutatja, hogyan ellenőrizz egy ilyen kérést a szerveren.

Gyakori hibák és megoldásaik

Először nyisd meg az Output ablakot (Window menü, majd Output). Az animációs problémák többsége oda ír ki egy sort.

Semmi sem történik, és az Output szerint az animáció nem töltődött be

Az animáció nem a játék tulajdonosáé, hanem valaki másé. Publikáld a saját példányodat az Animation Editorból arra a fiókra vagy csoportra, amelyé a játék, és azt az ID-t használd.

Az animáció fut, de csak a karok mozognak, vagy befejezetlennek tűnik

Egy másik, magasabb prioritású track mozgatja ugyanazokat az ízületeket. Állítsd a trackedet Priority = Action (vagy magasabb) értékre, vagy ezzel a prioritással publikáld az animációt az Animation Editorból.

Semmi sem történik, és hiba sincs

Nézd meg a rig típusát: egy R15 animáció semmit sem csinál egy R6 karakteren. Azt is ellenőrizd, hogy a script LocalScript-e a StarterCharacterScripts mappában; a Workspace-ben lévő LocalScript nem fut le.

Az NPC nem animálódik

A partjai rögzítettek (Anchored), vagy a Humanoidjában nincs Animator. Csak a HumanoidRootPartot rögzítsd; a 4. lépés scriptje létrehozza az Animatort, ha nincs.

A többi játékos nem látja az animációmat

Az animációt olyan karakteren játszották le, amely nem a játékosé, vagy egy LocalScriptből létrehozott Animatoron. A saját karaktered animációit LocalScriptből játszd le, minden mást (NPC-ket, más játékosokat) szerveroldali Scriptből.

Elkészítés a RoCode-dal

A RoCode egy AI-ügynök, amely egy pluginon keresztül a Roblox Studióban dolgozik. Leírod a mozdulatot, ő pedig megírja a scripteket a nálad nyitott place-ben.

Te írod

Adj hozzá egy integető emote-ot az E gombra és egy táncot, amelyet a G gombbal be- és kikapcsolhatok, és csináld meg, hogy az árus NPC integessen a hozzá közeledő játékosoknak.

A RoCode elvégzi
  • Megírja a LocalScriptet és az NPC Scriptjét, és oda teszi őket, ahol lenniük kell
  • Egyszerű mozdulatokat, például integetést, ütést vagy táncot közvetlenül kódban is össze tud rakni, így animációt sem kell feltöltened
  • A megírt scripteket a Studióban ellenőrzi, mielőtt befejezi

A Play gombot továbbra is neked kell megnyomnod, és ellenőrizned, hogy a mozdulat úgy néz-e ki, ahogy szeretnéd. Hogyan csatlakozik a RoCode a Studióhoz.

Gyakori kérdések

Bármelyik animáció ID-t használhatom, amit találtam?

Nem. Egy animáció csak abban a játékban fut, amelynek tulajdonosa birtokolja, vagy ha a Robloxé. Használd a saját animációidat vagy a Roblox alap animációit.

Látja a többi játékos a LocalScriptből lejátszott animációt?

Igen, ha a játékos a saját karakterén játssza le azzal az Animatorral, amelyet a Roblox ad a karakternek. Az NPC-k animációit szerveroldali Scriptből kell lejátszani.

Hogyan ismételhetek egy animációt a Robloxban?

Állítsd be a track.Looped = true értéket indítás előtt, vagy kapcsold be a Loop opciót az Animation Editorban publikálás előtt.

Hogyan állíthatok le egy animációt?

Hívd meg a track:Stop() metódust azon a trecken, amelyet elindítottál. Adj át egy számot, például track:Stop(0.2), hogy ennyi másodperc alatt finoman elhalványuljon.

Miért Animator, és miért nem Humanoid:LoadAnimation?

A Humanoid:LoadAnimation elavult. Az Animator:LoadAnimation ugyanezt csinálja, és a Roblox dokumentációja ezt írja le.

Források és további olvasnivaló

Hogyan ellenőriztük a kódot: az oldalon minden script átmegy a Luau szigorú típusellenőrzésén a Roblox API definícióival (luau-lsp, 2026. november 20.). A típusellenőrzés kiszűri az elírt API-neveket és a rossz típusokat, de a játéklogikai hibákat nem, ezért publikálás előtt mindent tesztelj a Studióban.

Próbáld ki a RoCode-ot a saját játékodban.

Ingyenes kreditek minden nap, bankkártya nélkül. Telepítsd a plugint, írd le a funkciót, és nézd meg, mi jelenik meg a Studióban.