Tutorial · Sistem permainan

Cara main animasi dalam Roblox Studio dengan skrip

Dalam Roblox, animasi dimainkan oleh Animator watak, bukan oleh animasi itu sendiri. Dalam panduan ini kita memainkan animasi apabila pemain menekan kekunci, menghidupkan dan mematikan tarian, menggelungkan animasi pada NPC dan memberi tumbukan tepat pada bingkai ketika penumbuk mengena sasaran.

Dikemas kini 20 November 20266 minit bacaanDitulis oleh

Ringkasnya

Letakkan LocalScript dalam StarterPlayer > StarterCharacterScripts. Di dalamnya, cari Humanoid watak dan Animatornya, cipta Animation dengan AnimationId anda sendiri, muatkannya melalui animator:LoadAnimation(animation) dan panggil :Play() pada trek yang dihasilkan apabila UserInputService.InputBegan melaporkan kekunci anda. Animasi yang dimainkan pemain pada wataknya sendiri dengan cara ini dilihat oleh semua orang di pelayan.

  • Animasi mesti dimiliki oleh pemilik game (anda atau kumpulan anda) atau oleh Roblox. Animasi yang dimuat naik oleh orang lain tidak akan dimainkan dalam game anda.
  • Tetapkan Priority trek kepada Action, jika tidak animasi berjalan dan berdiri boleh menindihnya.
  • Muatkan animasi melalui Animator:LoadAnimation. Humanoid:LoadAnimation sudah lapuk.
Di halaman ini
  1. Cara ia berfungsi
  2. 1. ID animasi
  3. 2. Dengan kekunci
  4. 3. Tarian bergelung
  5. 4. Pada NPC
  6. 5. Event animasi
  7. Common errors
  8. Dengan RoCode
  9. Soalan lazim
  10. Sumber dan bacaan lanjut

Cara animasi dimainkan dalam Roblox

Empat objek terlibat. Anda hanya mencipta satu daripadanya secara manual, selebihnya dibuat oleh skrip.

Objek yang memainkan animasi
ObjekDi mana ia beradaApa yang dibuat
AnimationDicipta oleh skrip andaMenyimpan AnimationId, alamat aset animasi. Ia sendiri tidak memainkan apa-apa.
AnimatorDi dalam Humanoid watak (ditambah oleh Roblox)Memuatkan animasi dan memainkannya pada sendi rig.
AnimationTrackDipulangkan oleh Animator:LoadAnimation()Salinan yang boleh dimainkan: Play(), Stop(), Looped, Priority, Speed dan event.
Aset animasiDi Roblox, diterbitkan daripada Animation EditorBingkai utama itu sendiri. ID-nya yang ditulis dalam AnimationId.

Muatkan setiap animasi sekali dan simpan treknya. Jika anda memanggil LoadAnimation pada setiap tekanan kekunci, trek baharu dicipta setiap kali dan ia terus bertimbun.

Keutamaan animasi, dari terendah ke tertinggi
KeutamaanUntuk apa
CorePaling rendah. Semua yang lain menindihnya.
IdleBerdiri diam.
MovementBerjalan, berlari, melompat.
ActionEmote, serangan, alat. Pilihan biasa untuk animasi yang anda mainkan daripada skrip.
Action2 hingga Action4Tindakan yang perlu menindih tindakan lain, contohnya pengsan di atas serangan.

Apabila dua trek yang sedang dimainkan menggerakkan sendi yang sama, trek dengan keutamaan lebih tinggi menang pada sendi itu. Lambaian tangan pada Action yang hanya menggerakkan lengan membolehkan kaki terus berjalan.

Langkah 1: Cari ID animasi yang boleh digunakan

Roblox hanya memainkan animasi dalam game anda jika ia dimiliki oleh pemilik game atau oleh Roblox. Sebab itu kebanyakan ID yang disalin daripada Creator Store atau daripada video tidak berfungsi: ia dimiliki orang lain dan tidak dimuatkan. Ada dua sumber yang baik.

  1. Buat sendiri. Dalam Studio, buka tab Avatar dan pilih Animation Editor, pilih rig (Rig Builder pada tab yang sama memasukkannya), susun pose pada garis masa, kemudian dalam menu editor pilih Publish to Roblox. Terbitkan pada akaun atau kumpulan yang sama yang memiliki game. Salin ID yang anda dapat.
  2. Ambil animasi Roblox. Emote standard daripada skrip Animate milik Roblox, contohnya lambaian tangan R15 (507770239) dan tarian (507771019), dimiliki oleh Roblox, jadi ia berfungsi dalam mana-mana game. Panduan ini menggunakannya supaya anda boleh terus menguji semuanya.

Tulis ID sebagai "rbxassetid://" diikuti nombornya, contohnya "rbxassetid://507770239".

Langkah 2: Main animasi apabila kekunci ditekan

  1. Dalam Explorer, buka StarterPlayer, halakan tetikus pada StarterCharacterScripts, tekan + dan masukkan LocalScript.
  2. Namakan semula kepada EmoteOnKey dan tampal kod di bawah.
  3. Tekan Play dan tekan E. Watak anda akan melambai.
LocalScript dalam StarterCharacterScripts bernama EmoteOnKey
-- LocalScript dalam StarterPlayer > StarterCharacterScripts bernama EmoteOnKey.
-- Tekan E untuk main animasi pada watak anda sendiri. Semua orang di pelayan melihatnya.
local UserInputService = game:GetService("UserInputService")

local ANIMATION_ID = "rbxassetid://507770239" -- lambaian tangan R15 milik Roblox sendiri; tampal ID animasi anda di sini
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 -- di atas berjalan dan berdiri, jadi kaki terus berjalan dan tangan melambai

local lastPlayed = -math.huge

UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	-- gameProcessed bernilai true semasa pemain menaip dalam chat atau kotak teks
	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) -- muncul dengan lancar dalam 0.1 saat
end)

Skrip dalam StarterCharacterScripts disalin ke dalam watak setiap kali ia muncul, jadi script.Parent ialah watak, dan trek dimuatkan semula selepas setiap respawn.

gameProcessed bernilai true apabila tekanan kekunci diproses dahulu oleh Roblox, contohnya semasa pemain menaip dalam chat. Semakan ini menghalang emote daripada tercetus setiap kali seseorang menaip huruf E.

Lambaian dilihat oleh semua orang, bukan anda sahaja. Roblox mereplikasi animasi yang dimainkan pemain pada wataknya sendiri jika Animator dicipta oleh pelayan, dan yang diletakkan Roblox dalam setiap watak memang dicipta begitu. Sebab itu skrip ini tidak memerlukan RemoteEvent.

Langkah 3: Hidupkan dan matikan animasi bergelung

Tarian atau duduk perlu berterusan sehingga pemain menghentikannya. Tetapkan Looped kepada true dan pada setiap tekanan kekunci mulakan atau hentikan trek yang sama. Versi ini juga menghentikan tarian apabila pemain mula berjalan.

LocalScript dalam StarterCharacterScripts bernama DanceToggle
-- LocalScript dalam StarterPlayer > StarterCharacterScripts bernama DanceToggle.
-- Tekan G untuk mula tarian bergelung, tekan G sekali lagi (atau berjalan) untuk menghentikannya.
local UserInputService = game:GetService("UserInputService")

local DANCE_ID = "rbxassetid://507771019" -- tarian R15 milik Roblox sendiri; tampal ID animasi anda di sini
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)

-- Hentikan tarian apabila pemain mula berjalan
humanoid.Running:Connect(function(speed: number)
	if speed > 0.5 and track.IsPlaying then
		track:Stop(0.2)
	end
end)

Nombor yang diberikan kepada Play dan Stop ialah masa peralihan lancar dalam saat. Peralihan pendek menghidupkan dan mematikan tarian dengan lancar, bukannya menyentak watak dari satu pose ke pose lain.

Langkah 4: Main animasi pada NPC

NPC tidak dimiliki oleh mana-mana pemain, jadi animasinya dimainkan oleh pelayan. Letakkan Script (bukan LocalScript) di dalam model NPC. Rig yang dibuat melalui Rig Builder sudah ada Humanoid, HumanoidRootPart dan Animator.

Script dalam model NPC bernama NpcAnimation
-- Script di dalam model NPC bernama NpcAnimation. NPC memerlukan Humanoid dan HumanoidRootPart.
-- Memainkan animasi bergelung pada NPC daripada pelayan, jadi setiap pemain melihatnya.
local ANIMATION_ID = "rbxassetid://507771019" -- tarian R15 milik Roblox sendiri; tampal ID animasi anda di sini

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

-- NPC daripada rig biasanya sudah ada Animator; jika tiada, kita ciptanya
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()

Langkah 5: Kaitkan tindakan dengan detik dalam animasi

Tumbukan patut memberi kerosakan apabila penumbuk mengena sasaran, bukan apabila kekunci ditekan. Dalam Animation Editor, klik kanan pada garis masa pada detik itu dan tambah animation event bernama Hit, kemudian terbitkan semula animasi. Dalam kod, track:GetMarkerReachedSignal("Hit") tercetus pada bingkai itu.

LocalScript dalam StarterCharacterScripts bernama PunchOnClick
-- LocalScript dalam StarterPlayer > StarterCharacterScripts bernama PunchOnClick.
-- Memainkan animasi tumbukan anda apabila diklik dan memberitahu pelayan detik penumbuk mengena sasaran,
-- melalui event animasi "Hit" yang anda tambah dalam Animation Editor.
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local UserInputService = game:GetService("UserInputService")

local PUNCH_ID = "rbxassetid://0" -- animasi tumbukan anda dengan event "Hit" pada detik mengena
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() -- pelayan menyemak jarak dan cooldown sebelum memberi kerosakan
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)

Skrip ini memerlukan RemoteEvent bernama PunchHit dalam ReplicatedStorage dan animasi tumbukan anda sendiri dengan event Hit sebagai ganti rbxassetid://0.

Client hanya melaporkan "tumbukan saya mengena". Script pelayan yang mendengar PunchHit.OnServerEvent menentukan sama ada ada sesiapa berdekatan dan berapa banyak kerosakan diberi, dengan cooldown sendiri, supaya pemain yang mencetuskan event secara manual tidak boleh menumbuk merentasi seluruh peta. Panduan RemoteEvent menunjukkan cara menyemak permintaan seperti ini pada pelayan.

Ralat biasa dan cara membaikinya

Buka tetingkap Output dahulu (menu Window, kemudian Output). Kebanyakan masalah animasi menulis satu baris di situ.

Tiada apa berlaku, dan Output menyatakan animasi gagal dimuatkan

Animasi itu dimiliki orang lain, bukan pemilik game. Terbitkan salinan anda sendiri daripada Animation Editor pada akaun atau kumpulan yang memiliki game, dan gunakan ID itu.

Animasi dimainkan tetapi hanya lengan bergerak, atau ia kelihatan tidak lengkap

Trek lain dengan keutamaan lebih tinggi menggerakkan sendi yang sama. Tetapkan Priority trek anda kepada Action (atau lebih tinggi) atau terbitkan animasi dengan keutamaan itu daripada Animation Editor.

Tiada apa berlaku, dan tiada ralat

Semak jenis rig: animasi R15 tidak membuat apa-apa pada watak R6. Semak juga bahawa skrip itu LocalScript dalam StarterCharacterScripts; LocalScript dalam Workspace tidak dijalankan.

NPC tidak beranimasi

Partnya Anchored, atau Humanoidnya tiada Animator. Tandakan Anchored pada HumanoidRootPart sahaja; skrip dalam langkah 4 mencipta Animator jika tiada.

Pemain lain tidak nampak animasi saya

Animasi dimainkan pada watak yang tidak dimiliki pemain itu, atau pada Animator yang dicipta daripada LocalScript. Mainkan animasi watak anda sendiri daripada LocalScript, dan semua yang lain (NPC, pemain lain) daripada Script pelayan.

Buat dengan RoCode

RoCode ialah ejen AI yang berfungsi di dalam Roblox Studio melalui plugin. Anda terangkan pergerakan itu, dan ia menulis skrip dalam place yang sedang anda buka.

Anda tulis

Tambah emote lambaian tangan pada E dan tarian yang boleh saya hidupkan dan matikan dengan G, dan buat NPC penjual melambai kepada pemain yang mendekatinya.

RoCode buat
  • Menulis LocalScript dan Script untuk NPC dan meletakkannya di tempat yang sepatutnya
  • Boleh membina pergerakan ringkas seperti lambaian tangan, tumbukan atau tarian terus dalam kod, jadi anda tidak perlu memuat naik animasi
  • Menyemak skrip yang ditulis di dalam Studio sebelum selesai

Anda masih perlu menekan Play dan menyemak bahawa pergerakan itu kelihatan seperti yang anda mahu. Cara RoCode bersambung ke Studio.

Soalan lazim

Bolehkah saya guna mana-mana ID animasi yang saya jumpa?

Tidak. Animasi hanya dimainkan dalam game yang pemiliknya memiliki animasi itu, atau jika ia dimiliki Roblox. Gunakan animasi anda sendiri atau animasi standard Roblox.

Adakah pemain lain nampak animasi daripada LocalScript?

Ya, jika pemain memainkannya pada wataknya sendiri melalui Animator yang diberi Roblox kepada watak. Animasi pada NPC perlu dimainkan daripada Script pelayan.

Bagaimana menggelungkan animasi dalam Roblox?

Tetapkan track.Looped = true sebelum memulakannya atau hidupkan Loop dalam Animation Editor sebelum menerbitkan.

Bagaimana menghentikan animasi?

Panggil track:Stop() pada trek yang anda mulakan. Berikan nombor, contohnya track:Stop(0.2), supaya ia pudar dengan lancar dalam tempoh saat itu.

Kenapa Animator dan bukan Humanoid:LoadAnimation?

Humanoid:LoadAnimation sudah lapuk. Animator:LoadAnimation membuat perkara yang sama, dan itulah yang diterangkan dalam dokumentasi Roblox.

Sumber dan bacaan lanjut

Cara kod disemak: setiap skrip di halaman ini lulus semakan jenis Luau yang ketat dengan definisi API Roblox (luau-lsp, 20 November 2026). Semakan jenis mengesan kesilapan nama API dan jenis yang salah, tetapi bukan kesilapan logik permainan, jadi uji semuanya dalam Studio sebelum anda menerbitkannya.

Cuba RoCode dalam permainan anda.

Kredit percuma setiap hari, tanpa kad. Pasang plugin, terangkan ciri yang anda mahu dan semak hasilnya dalam Studio.