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 needs | What the Roblox file does |
|---|---|
| Animation on the bones of a skinned mesh | All 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 influences | A 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 1 | Every bone is created with zero rest rotation and a scale of 1. |
| At most 4 influences per vertex | Each vertex is weighted 100% to one bone, so parts move rigidly, like hinged pieces, without stretching. |
| Under 20,000 triangles per mesh | The 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 file | One 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 materials | Flat 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:
Treasure chest11,852 triangles
Wooden crate4,052 triangles
Wooden door5,584 triangles
Fence gate4,368 triangles
Coffin7,088 triangles
Sci-fi sliding door3,626 triangles
Windmill7,044 triangles
Gold coin3,468 triangles
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
- In Studio, choose File › Import and pick the file.
- 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.
- 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.
- 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:
- Open the Animation Editor from the Avatar tab (the button is labelled Clip Editor in current Studio).
- 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.
- Click ⋯ › Load and pick the saved animation.
- For a looping animation, turn on the Looping button. It sets the default for the track’s
Loopedproperty. - 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.
- 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, sotrack:AdjustSpeed(-1)closes it again.
Looping or one-shot
| Looping | One-shot | |
|---|---|---|
| Clip name in Propsmith’s file | Loop | Animation |
| Typical props | Windmill sails, a spinning coin, a swaying lantern | Chest lids, doors, gates, drawers |
| In the script | track.Looped = true | track.Looped = false |
| At the end of the clip | Starts again from the first frame | Returns to the rest pose, unless you pause it |
| To hold the last pose | Not needed | track: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.