要点
StarterPlayer > StarterCharacterScripts に LocalScript を置きます。その中でキャラクターの Humanoid とその Animator を見つけ、自分の AnimationId を入れた Animation を作り、animator:LoadAnimation(animation) で読み込みます。そして UserInputService.InputBegan が指定のキーを知らせたら、返ってきたトラックの :Play() を呼びます。プレイヤーが自分のキャラクターでこの方法で再生したアニメーションは、サーバーにいる全員に見えます。
- アニメーションは、ゲームの所有者(あなたか、あなたのグループ)か Roblox のものである必要があります。他の人がアップロードしたアニメーションは、あなたのゲームでは再生されません。
- トラックの
PriorityをActionにしてください。そうしないと、歩きや待機のアニメーションに上書きされることがあります。 - アニメーションは
Animator:LoadAnimationで読み込みます。Humanoid:LoadAnimationは非推奨です。
このページの内容
Roblox でアニメーションが再生される仕組み
関わるオブジェクトは4つです。手で作るのはそのうち1つだけで、残りはスクリプトが用意します。
| オブジェクト | 場所 | 役割 |
|---|---|---|
Animation | スクリプトが作成 | アニメーションアセットのアドレスである AnimationId を保持します。それ自体は何も再生しません。 |
Animator | キャラクターの Humanoid の中(Roblox が追加) | アニメーションを読み込み、リグの関節で再生します。 |
AnimationTrack | Animator:LoadAnimation() の戻り値 | 再生できるコピーです。Play()、Stop()、Looped、Priority、Speed とイベントを持ちます。 |
| アニメーションアセット | Roblox 上、Animation Editor から公開 | キーフレームそのものです。その ID を AnimationId に書きます。 |
アニメーションはそれぞれ1回だけ読み込み、トラックを保存しておきます。キーを押すたびに LoadAnimation を呼ぶと、そのたびに新しいトラックが作られ、どんどん溜まっていきます。
| 優先度 | 用途 |
|---|---|
Core | 最も低い優先度です。ほかのすべてに上書きされます。 |
Idle | その場で立っている状態。 |
Movement | 歩く、走る、ジャンプ。 |
Action | エモート、攻撃、ツール。スクリプトから再生するアニメーションでは普通これを選びます。 |
Action2 から Action4 | 別のアクションを上書きする必要があるアクション。たとえば攻撃の上に重ねるスタン。 |
再生中の2つのトラックが同じ関節を動かすと、その関節では優先度の高いトラックが勝ちます。腕だけを動かす Action の手を振るアニメーションなら、足はそのまま歩き続けられます。
ステップ1:使えるアニメーション ID を用意する
Roblox がゲーム内でアニメーションを再生するのは、そのアニメーションがゲームの所有者か Roblox のものである場合だけです。そのため、Creator Store や動画からコピーした ID のほとんどは使えません。他の人のものなので読み込まれないのです。良い入手先は2つあります。
- 自分で作る。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 にある EmoteOnKey という名前の LocalScript。
-- 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 にある DanceToggle という名前の LocalScript。
-- 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 のモデルの中に Script(LocalScript ではありません)を置いてください。Rig Builder で作ったリグには、すでに Humanoid、HumanoidRootPart、Animator があります。
-- NPC のモデルの中にある NpcAnimation という名前の Script。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 にある PunchOnClick という名前の LocalScript。
-- クリックでパンチのアニメーションを再生し、こぶしが当たった瞬間をサーバーに知らせます。
-- そのために、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)。アニメーションの問題の多くは、そこに1行のメッセージを出します。
何も起きず、Output にアニメーションを読み込めなかったと表示される
アニメーションの所有者がゲームの所有者ではなく、他の人です。Animation Editor から、ゲームを所有しているアカウントかグループに自分のコピーを公開し、その ID を使ってください。
アニメーションは再生されるが、腕しか動かない、または途中までのように見える
優先度の高い別のトラックが同じ関節を動かしています。トラックの Priority を Action(またはそれ以上)にするか、Animation Editor からその優先度でアニメーションを公開してください。
何も起きず、エラーも出ない
リグの種類を確認してください。R15 のアニメーションは R6 のキャラクターでは何もしません。また、スクリプトが StarterCharacterScripts にある LocalScript かどうかも確認してください。Workspace にある LocalScript は実行されません。
NPC がアニメーションしない
パーツが Anchored になっているか、Humanoid に Animator がありません。Anchored にするのは 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 は非推奨です。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-lsp、2026年11月20日)を使った Luau の strict 型チェックを通っています。型チェックで見つかるのは API 名の誤りや型の不一致であり、ゲームロジックの誤りは見つかりません。公開する前に必ず Studio でテストしてください。