PROPSMITH

How to import an animated model into Roblox Studio

Published

In short

Roblox Studio only imports animation that moves the bones of a skinned mesh, so the model needs a rig. Import it with File › Import (Scale Unit to match the file, Rig Type Custom), find the clip in ServerStorage › AnimSaves, publish it from the Animation Editor to get an asset ID, then play it from a server Script through an AnimationController and Animator.

Why Roblox needs bones and skinning

In Roblox, an animation is a set of keyframes for joints. A plain mesh has no joints: as Roblox’s rigging docs put it, a normal model can only rotate on its pivot point. To move a lid, a door or a wheel on its own, the mesh needs a rig (a skeleton of bones) and skinning (data that ties each vertex to the bones that move it). Studio turns each imported bone into a Bone object, and animations drive those bones.

That’s why most animated GLBs arrive standing still: many exporters animate a lid by moving the lid object itself, and Roblox has no bone to attach that motion to.

Roblox’s specifications add a few rules for rigged meshes (checked November 2026):

  • Bones are frozen in the rest pose: rotation 0, 0, 0 and scale 1, 1, 1.
  • The root bone sits at 0, 0, 0 and has no vertices weighted to it.
  • A vertex can be influenced by at most 4 bones.
  • One animation track per file. For a second animation, import a second file.
  • Each mesh stays under 20,000 triangles. More in Roblox mesh limits explained.

How Propsmith’s animated Roblox download is built

Propsmith, an AI 3D prop generator for games, animates a prop from a sentence (“the lid swings open and stays open”), as a looping or a one-shot animation. An animated model has two animated downloads: an animated GLB for Blender and other engines, and a Roblox file, whose name ends in .roblox.glb. The Roblox file is built around the rules above:

Roblox needsWhat the Roblox file does
Animation on the bones of a skinned meshAll parts are merged into one skinned mesh. Each moving part gets its own bone, nested the way the parts are, so a handle on a lid swings with the lid.
A root bone at the origin with no influencesA root bone at 0, 0, 0 with nothing weighted to it, plus a body bone that holds every part that doesn’t move.
Bones at rotation 0 and scale 1Every bone is created with zero rest rotation and a scale of 1.
At most 4 influences per vertexEach vertex is weighted 100% to one bone, so parts move rigidly, like hinged pieces, without stretching.
Under 20,000 triangles per meshThe mesh is split into chunks of under 19,000 triangles. Most props stay in one chunk, a single MeshPart named ModelMesh; bigger ones become ModelMesh_1, ModelMesh_2 and so on, all on the same bones.
One animation per fileOne clip, named Loop for looping animations and Animation for one-shots, baked onto the bones at 30 frames a second, the same rate as Studio’s Animation Editor.
Simple materialsFlat colours, roughness and metalness are packed into a tiny palette texture (a 4 × 4-pixel cell per colour), so the whole prop uses one material.

There are also static Roblox downloads of single poses (the start and end of a one-shot, or a frame of a loop), handy when a chest only ever needs to sit open.

Models in the public prop library don’t ship with animations. Each one lists a suggested animation, which you can build after grabbing a copy: 1 credit for the grab and 3 for the animation. These props have an obvious motion to try:

Suggested, not yet built: the chest, crate and coffin lids open, the door and gate swing, the sci-fi door slides, the windmill’s sails turn and the coin spins. All free to download as static models.

The treasure chest is a good first test: 11,852 triangles, so one MeshPart, and a single hinged lid. More hinged and sliding pieces are in the building parts and treasure and collectibles hubs.

Import the model

  1. In Studio, choose File › Import and pick the file.
  2. Under File Geometry, set Scale Unit to Meter and leave Scale Factor at 1.0. The default unit is Studs; Propsmith files are in metres, and one stud is 28 cm, so a file left at Studs comes in 3.57 times too small. More in Roblox studs to metres.
  3. Under Rig General, check that Rig Type is Custom. The Importer picks it from the skinning data. R15 is for humanoid characters, and No Rig imports the mesh without its bones.
  4. Click Import. The Explorer shows a Model holding the MeshPart (or one per chunk). To see the bones, turn on Show Constraint Details in the View menu. The Anchored setting doesn’t apply to rigged meshes, so anchor the prop yourself afterwards.

For the rest of the Importer, from collisions to Merge Meshes, see how to import a GLB into Roblox Studio.

Find the animation and publish it

Since Roblox’s August 2026 importer update, Studio saves a model’s animation into AnimSaves, a folder in ServerStorage. Roblox staff say it lands there when the Animation Editor is open, so if the folder is empty, open the editor and import again. AnimSaves is local working data that doesn’t replicate to players; a game should play a published animation. To publish it:

  1. Open the Animation Editor from the Avatar tab (the button is labelled Clip Editor in current Studio).
  2. Select the imported model. If the editor doesn’t accept it as a rig, insert an AnimationController with an Animator inside it into the model first. You need them to play the animation anyway.
  3. Click ⋯ › Load and pick the saved animation.
  4. For a looping animation, turn on the Looping button. It sets the default for the track’s Looped property.
  5. Click ⋯ › Publish to Roblox and name it. If the game belongs to a group, pick the group in the Creator field, as Roblox’s docs instruct. Click Submit.
  6. Copy the animation’s asset ID from your inventory in the Toolbox.

Play the animation on a prop

A prop has no Humanoid, so it plays animations through an AnimationController with an Animator inside it. Put this server Script inside the imported model, paste your asset ID and set LOOP:

-- Script (not a LocalScript) inside the imported Model
local model = script.Parent
local ANIMATION_ID = "rbxassetid://0" -- paste your published animation's ID
local LOOP = false -- true for spinning or swaying props, false for lids and doors

-- A prop has no Humanoid, so it plays animations through an
-- AnimationController with an Animator inside it
local controller = model:FindFirstChildOfClass("AnimationController") or Instance.new("AnimationController")
controller.Parent = model
local animator = controller:FindFirstChildOfClass("Animator") or Instance.new("Animator")
animator.Parent = controller

local animation = Instance.new("Animation")
animation.AnimationId = ANIMATION_ID

local track = animator:LoadAnimation(animation)
track.Looped = LOOP
track:Play()

if not LOOP then
	-- A one-shot track snaps back to the rest pose when it ends.
	-- Pause it just before the end instead, so the lid stays open.
	repeat
		task.wait()
	until track.Length > 0 and track.TimePosition >= track.Length - 0.1
	track:AdjustSpeed(0)
end
  • It’s a Script, not a LocalScript. When an Animator isn’t part of a player’s character, its animations only replicate to everyone if they’re loaded and started on the server.
  • Keep the model in Workspace. LoadAnimation() throws an error if the Animator isn’t in the Workspace yet.
  • Play it on demand. To open a chest when a player walks up, add a ProximityPrompt to the model and call track:Play() from its Triggered event instead of at start-up. A negative speed plays a track backwards, so track:AdjustSpeed(-1) closes it again.

Looping or one-shot

LoopingOne-shot
Clip name in Propsmith’s fileLoopAnimation
Typical propsWindmill sails, a spinning coin, a swaying lanternChest lids, doors, gates, drawers
In the scripttrack.Looped = truetrack.Looped = false
At the end of the clipStarts again from the first frameReturns to the rest pose, unless you pause it
To hold the last poseNot neededtrack:AdjustSpeed(0) just before the end

Roblox doesn’t blend a loop’s last frame into its first, so if a loop hitches at the seam, its last frame doesn’t match its first.

Troubleshooting

The animation doesn’t play

  • No bones. You imported a static Roblox file, or Rig Type was set to No Rig. Look for Bone objects under the MeshPart.
  • Not published. The script points at an unpublished animation. Publish it and use its rbxassetid:// ID.
  • Wrong owner. In a group’s game, publish the animation to the group, not to your own account.
  • Wrong side. The code runs in a LocalScript, or the Animator was created on a client. Use a server Script.
  • Error from LoadAnimation. The model wasn’t in the Workspace when the script ran.

Parts fly off, drift or fall

  • The whole prop drops through the floor when you press Play: rigged imports aren’t anchored. Tick Anchored on its MeshParts. Bones change how the mesh looks, not its physics, so anchoring doesn’t stop the animation.
  • The moving part flies away from the rest. The animation’s distances are in different units from the mesh. Re-import with Scale Unit set to Meter and Scale Factor 1.0. If you brought the clip in separately through the Animation Editor (⋯ › Import › From File), set the Rig Scale in that dialog so the units match.
  • A part moves, but not with the part it hangs from. A bone that moves no vertices of its own can still carry motion for the bones under it, and the Importer removes such bones unless Keep Zero Influence Bones is on. Turn it on and import again.
  • One chunk of a big prop stays still while the rest moves: keep the chunks in the same Model and connect them with a WeldConstraint. Roblox lets skinned MeshParts share bones when they’re joined in one Model.

The size is wrong

  • 3.57 times too small: Scale Unit was left at Studs. Re-import rather than scaling by hand, so the mesh, the bones and the animation stay in the same units.
  • Far too big: check Scale Factor. Presets save it, and 5.6 restores the Importer’s old metre conversion from before June 2026.
  • Compare with the model’s page, which lists its real-world size: the treasure chest is 0.88 m wide, about 3.1 studs.

The open door still blocks the way

Bone animation changes how a part looks, not its collision, so a door that swings open still collides where it stood closed. Turn off CanCollide on the door, or add an invisible part that you move or remove when it opens.

Something grows or shrinks in Propsmith but not in Studio

A Roblox bone’s animated offset (its Transform) is a CFrame: position and rotation, no scale. A flame that stretches won’t stretch in Studio, but hinges, slides and spins carry over.

Questions people ask

Can Roblox import animation from a GLB file?

Yes, if the animation moves the bones of a skinned mesh. Animation that moves whole mesh objects, which is how many exporters animate a lid or a door, has nothing to attach to in Roblox and doesn’t come in.

Where does Roblox Studio put an imported animation?

Since Roblox’s August 2026 importer update, Studio saves it into the AnimSaves folder in ServerStorage. That’s local working data: publish it from the Animation Editor to get an asset ID your game can play.

Do I need a Humanoid to animate a prop in Roblox?

No. Put an AnimationController with an Animator inside it in the model, then load and play the animation from a server Script.

Can one file hold several animations for Roblox?

No. Roblox imports a single animation track per mesh or model file, so export one file for each animation.

Why does my animated door still block the doorway?

Bones change how a mesh looks, not its collision. Turn off CanCollide on the moving part, or handle collision with a separate invisible part.

Sources

Checked 1 November 2026.