요약
StarterPlayer > StarterCharacterScripts 안에 LocalScript를 넣으세요. 그 안에서 캐릭터의 Humanoid와 그 Animator를 찾고, 내 AnimationId로 Animation을 만든 뒤 animator:LoadAnimation(animation)으로 불러오고, UserInputService.InputBegan이 내 키를 알려 줄 때 받은 트랙에서 :Play()를 호출합니다. 플레이어가 이렇게 자기 캐릭터에서 재생한 애니메이션은 서버의 모든 사람에게 보입니다.
- 애니메이션은 게임 소유자(나 또는 내 그룹)나 Roblox의 소유여야 합니다. 다른 사람이 업로드한 애니메이션은 내 게임에서 재생되지 않습니다.
- 트랙의
Priority를Action으로 설정하세요. 그렇지 않으면 걷기와 서 있기 애니메이션이 덮어쓸 수 있습니다. - 애니메이션은
Animator:LoadAnimation으로 불러오세요.Humanoid:LoadAnimation은 더 이상 권장되지 않습니다(deprecated).
이 페이지의 내용
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가 소유한 애니메이션만 내 게임에서 재생합니다. 그래서 Creator Store나 영상에서 복사한 ID는 대부분 맞지 않습니다. 다른 사람의 소유라 불러와지지 않습니다. 좋은 출처가 두 가지 있습니다.
- 직접 만드세요. Studio에서 Avatar 탭을 열고 Animation Editor를 선택한 뒤 리그를 선택하고(같은 탭의 Rig Builder로 리그를 넣을 수 있습니다), 타임라인에 포즈를 잡은 다음 에디터 메뉴에서 Publish to Roblox를 고르세요. 게임을 소유한 계정이나 그룹으로 게시하세요. 받은 ID를 복사합니다.
- Roblox의 애니메이션을 쓰세요. Roblox의 Animate 스크립트에 있는 기본 이모트, 예를 들어 R15 손 흔들기(
507770239)와 춤(507771019)은 Roblox 소유라 어떤 게임에서도 작동합니다. 이 가이드는 바로 확인해 볼 수 있도록 이 애니메이션들을 사용합니다.
ID는 "rbxassetid://" 뒤에 번호를 붙여 쓰세요. 예: "rbxassetid://507770239".
2단계: 키를 누르면 애니메이션 재생하기
- Explorer에서 StarterPlayer를 펼치고 StarterCharacterScripts에 마우스를 올린 뒤 +를 눌러 LocalScript를 넣으세요.
- 이름을
EmoteOnKey로 바꾸고 아래 코드를 붙여 넣으세요. - Play를 누르고 E를 누르세요. 캐릭터가 손을 흔듭니다.
-- StarterPlayer > StarterCharacterScripts 안의 LocalScript, 이름은 EmoteOnKey.
-- E를 누르면 내 캐릭터에서 애니메이션을 재생합니다. 서버의 모든 사람에게 보입니다.
local UserInputService = game:GetService("UserInputService")
local ANIMATION_ID = "rbxassetid://507770239" -- Roblox가 직접 만든 R15 손 흔들기; 여기에 내 애니메이션 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는 Roblox가 키 입력을 먼저 처리했을 때, 예를 들어 플레이어가 채팅을 입력하는 동안 true입니다. 이 확인 덕분에 누군가 글자 E를 칠 때마다 이모트가 실행되지 않습니다.
손 흔들기는 나만이 아니라 모두에게 보입니다. Roblox는 Animator를 서버가 만든 경우 플레이어가 자기 캐릭터에서 재생하는 애니메이션을 복제하며, Roblox가 모든 캐릭터에 넣어 주는 Animator가 바로 그렇게 만들어진 것입니다. 그래서 이 스크립트에는 RemoteEvent가 필요 없습니다.
3단계: 반복 애니메이션 켜고 끄기
춤이나 앉기는 플레이어가 멈출 때까지 계속되어야 합니다. Looped를 true로 설정하고, 키를 누를 때마다 같은 트랙을 시작하거나 멈추세요. 이 버전은 플레이어가 걷기 시작하면 춤도 멈춥니다.
-- StarterPlayer > StarterCharacterScripts 안의 LocalScript, 이름은 DanceToggle.
-- G를 누르면 반복되는 춤이 시작되고, G를 다시 누르면(또는 걸으면) 멈춥니다.
local UserInputService = game:GetService("UserInputService")
local DANCE_ID = "rbxassetid://507771019" -- Roblox가 직접 만든 R15 춤; 여기에 내 애니메이션 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는 어떤 플레이어의 소유도 아니므로 NPC의 애니메이션은 서버가 재생합니다. NPC 모델 안에 Script(LocalScript가 아님)를 넣으세요. Rig Builder로 만든 리그에는 이미 Humanoid, HumanoidRootPart, Animator가 있습니다.
-- NPC 모델 안의 Script, 이름은 NpcAnimation. NPC에는 Humanoid와 HumanoidRootPart가 필요합니다.
-- 서버에서 NPC에 반복 애니메이션을 재생하므로 모든 플레이어에게 보입니다.
local ANIMATION_ID = "rbxassetid://507771019" -- Roblox가 직접 만든 R15 춤; 여기에 내 애니메이션 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에서 그 순간의 타임라인을 마우스 오른쪽 버튼으로 클릭해 이름이 Hit인 animation event를 추가한 뒤 애니메이션을 다시 게시하세요. 코드에서는 track:GetMarkerReachedSignal("Hit")가 그 프레임에서 실행됩니다.
-- StarterPlayer > StarterCharacterScripts 안의 LocalScript, 이름은 PunchOnClick.
-- 클릭하면 내 펀치 애니메이션을 재생하고, 주먹이 목표에 닿는 순간을 서버에 알립니다.
-- Animation Editor에서 추가한 애니메이션 이벤트 "Hit"을 사용합니다.
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)
이 스크립트에는 ReplicatedStorage 안에 이름이 PunchHit인 RemoteEvent와, rbxassetid://0 대신 Hit 이벤트가 있는 내 펀치 애니메이션이 필요합니다.
클라이언트는 "내 펀치가 맞았다"고 알리기만 합니다. PunchHit.OnServerEvent를 듣는 서버 Script가 근처에 누가 있었는지, 피해를 얼마나 줄지 자체 쿨다운과 함께 결정하므로, 이벤트를 직접 호출하는 플레이어가 맵 반대편에서 때릴 수 없습니다. RemoteEvent 가이드에서 이런 요청을 서버에서 확인하는 방법을 볼 수 있습니다.
자주 발생하는 오류와 해결 방법
먼저 Output 창을 여세요(Window 메뉴, 그다음 Output). 애니메이션 문제는 대부분 그곳에 한 줄을 남깁니다.
아무 일도 일어나지 않고 Output에 애니메이션을 불러오지 못했다고 나옴
애니메이션이 게임 소유자가 아닌 다른 사람의 소유입니다. Animation Editor에서 게임을 소유한 계정이나 그룹으로 내 사본을 게시하고 그 ID를 쓰세요.
애니메이션이 재생되지만 팔만 움직이거나 덜 끝난 것처럼 보임
우선순위가 더 높은 다른 트랙이 같은 관절을 움직이고 있습니다. 내 트랙의 Priority를 Action(또는 그 이상)으로 설정하거나, Animation Editor에서 그 우선순위로 애니메이션을 게시하세요.
아무 일도 일어나지 않고 오류도 없음
리그 종류를 확인하세요. R15 애니메이션은 R6 캐릭터에서 아무것도 하지 않습니다. 스크립트가 StarterCharacterScripts 안의 LocalScript인지도 확인하세요. Workspace 안의 LocalScript는 실행되지 않습니다.
NPC가 움직이지 않음
파트가 고정되어 있거나 Humanoid 안에 Animator가 없습니다. HumanoidRootPart만 고정하세요. 4단계의 스크립트는 Animator가 없으면 만들어 줍니다.
다른 플레이어에게 내 애니메이션이 보이지 않음
플레이어가 소유하지 않은 캐릭터에서 애니메이션을 재생했거나, LocalScript에서 만든 Animator에서 재생했습니다. 내 캐릭터의 애니메이션은 LocalScript에서, 나머지(NPC, 다른 플레이어)는 서버 Script에서 재생하세요.
RoCode로 만들기
RoCode는 플러그인을 통해 Roblox Studio 안에서 작동하는 AI 에이전트입니다. 동작을 설명하면 지금 열려 있는 플레이스에 스크립트를 작성합니다.
E를 누르면 손을 흔드는 이모트와 G로 켜고 끌 수 있는 춤을 추가하고, 상인 NPC가 다가오는 플레이어에게 손을 흔들게 해 줘.
- LocalScript와 NPC용 Script를 작성하고 있어야 할 곳에 넣습니다
- 손 흔들기, 펀치, 춤 같은 간단한 동작은 코드로 직접 만들 수 있어서 애니메이션을 업로드할 필요가 없습니다
- 작업을 마치기 전에 작성한 스크립트를 Studio 안에서 확인합니다
그래도 Play를 눌러 동작이 원하는 대로 보이는지 직접 확인해야 합니다. RoCode가 Studio에 연결되는 방법.
자주 묻는 질문
찾은 애니메이션 ID는 아무거나 쓸 수 있나요?
아니요. 애니메이션은 그 애니메이션을 소유한 사람이 소유한 게임이거나 Roblox가 소유한 경우에만 재생됩니다. 내 애니메이션이나 Roblox 기본 애니메이션을 쓰세요.
LocalScript에서 재생한 애니메이션이 다른 플레이어에게도 보이나요?
네, 플레이어가 Roblox가 캐릭터에 넣어 준 Animator로 자기 캐릭터에서 재생한다면 보입니다. NPC의 애니메이션은 서버 Script에서 재생해야 합니다.
Roblox에서 애니메이션을 반복하려면 어떻게 하나요?
재생하기 전에 track.Looped = true로 설정하거나, 게시하기 전에 Animation Editor에서 Loop를 켜세요.
애니메이션을 멈추려면 어떻게 하나요?
시작한 트랙에서 track:Stop()을 호출하세요. track:Stop(0.2)처럼 숫자를 넘기면 그 초만큼 부드럽게 사라집니다.
왜 Humanoid:LoadAnimation이 아니라 Animator인가요?
Humanoid:LoadAnimation은 더 이상 권장되지 않습니다(deprecated). Animator:LoadAnimation은 같은 일을 하며, Roblox 문서가 설명하는 것도 이것입니다.
출처와 더 읽을거리
- Roblox Creator Docs: Use animations (영어). 스크립트에서 애니메이션 불러오기와 재생, 애니메이션 소유권
- Roblox Creator Docs: Animator (영어). LoadAnimation과 복제
- Roblox Creator Docs: AnimationTrack (영어). Play, Stop, Looped, Priority, GetMarkerReachedSignal
- Roblox Creator Docs: Animation Editor (영어). 애니메이션 만들기, 게시, 애니메이션 이벤트
코드 검증 방법: 이 페이지의 모든 스크립트는 Roblox API 정의를 적용한 Luau의 엄격한 타입 검사기(luau-lsp, 2026년 11월 20일)를 통과합니다. 타입 검사는 잘못 쓴 API 이름과 잘못된 타입을 찾아내지만 게임 로직의 오류는 찾지 못하므로, 게시하기 전에 Studio에서 직접 테스트하세요.