Skeletons

Learn about Skeletons, Bones, and animation data management in Unreal Engine.

A Skeleton is a hierarchy that is used to define Bones (sometimes called joints) in a Skeletal Mesh. In some ways, these Bones mimic a real biological skeleton due to their position and control over how characters deform.

In Unreal Engine, Skeletons are used to store and associate animation data, the overall skeletal hierarchy, and Animation Sequences. Skeleton Assets can also be shared through a variety of methods, enabling for additional animations and data to be shared between different Skeletons.

This document provides an overview of how to create and use Skeletons.

Prerequisites

  • Your project contains a Skeletal Mesh Actor, or you have a skinned FBX character to import into Unreal Engine.

Creating Skeletons

The primary way to create a Skeleton is to import a skinned character FBX, which then converts to a Skeletal Mesh in Unreal Engine. When importing a Skeletal Mesh, in the FBX Import Options window, leaving the Skeleton field empty will automatically create a Skeleton Asset based on the skinned character being imported.

import skeletal mesh

After importing your character, the Skeleton Asset will be created along with other Skeletal Mesh Assets.

skeleton asset

You can also create a copy of a Skeleton from any Skeletal Mesh by right-clicking on it in the Content Browser and selecting Skeleton > Create Skeleton. This creates a new Skeleton associated with an existing mesh. If that mesh had another Skeleton associated with it, it will re-link to the new Skeleton and any animations will then link to the new Skeleton.

create skeleton copy

Double-click the Skeleton Asset to open the Skeleton Editor.

skeleton editor

Skeleton Tree Information

Bones and other items displayed in the Skeleton Tree can appear different depending on several factors.

Icon

Description

IconBone1.png

A normal Bone that influences vertices on the Skeletal Mesh.

IconBone2.png

A Bone in the current Skeleton that doesn't influence vertices on the Skeletal Mesh. These Bones are typically used in an auxiliary manner, such as for attaching weapons or props, while still being animatable as a Bone.

IconSocket.png

A Socket, which is a static point that acts as an offset attachment point for Bones.

IconVirtual.png

A Virtual Bone, which is a Bone that follows the transforms of another Bone, but in a different Bone space. These are useful for locking down unwanted joint movements, and are used in conjunction with IK.

IconNoBone.png

A Bone that exists in the Skeleton, but is not used by the current Skeletal Mesh. This can happen if you have merged Skeletons, or are previewing different LODs on this Skeleton that are not using certain Bones.

Animation Data Storage

In addition to controlling animation, Skeletons in Unreal Engine also store animation-specific data. When data is created from those sources, such as creating an Animation Notify in an Animation Sequence, it gets added to the Skeleton as shared data.

Skeletons store the following types of animation data:

This data can be viewed in dedicated tool panels by clicking Window in the Skeleton Editor menu, then enabling one or more of these panels.

animation data panels

Sharing Skeletons

An important feature of Skeleton Assets is that a single Skeleton Asset can be used by multiple Skeletal Meshes, so long as the Skeletal Meshes use the same general rig hierarchy. This means that the names and hierarchical order of your Bones must be consistent in order for sharing to work correctly.

For example, consider a limb with three Bones in a Skeletal Mesh. The bones are named 1, 2, and 3:

sharing skeleton example 1

If you want to share this Skeleton with another Skeletal Mesh, you will need to keep these Bones in the same order and with the same names. The second Skeletal Mesh, however, can contain Bones that are additions or peripheral to the hierarchy. Any time animation data is received for a Bone that is not included in the Skeletal Mesh, that animation data will be ignored.

In that case, your new hierarchy could look like the image below. Here, the second Skeletal Mesh has extra Bones, while still retaining and not interfering with the original hierarchy from the first Skeletal Mesh.

sharing skeleton example 2

However, in order for both Skeletal Meshes to use the same Skeleton Asset, you cannot change the hierarchy order or rename the Bones. If a second Skeletal Mesh uses a different Bone hierarchy and naming structure, you will need to create a new Skeleton Asset.

sharing skeleton example 3

If you insert a bone into the hierarchy without changing the order, you will be able to share successfully. However in most cases the extra bone may cause unintended transform offsets in your skeleton. It is recommended that you avoid this if possible.

sharing skeleton example 4

Taking these sharing rules into account, there are several ways you can share Skeletons between Skeletal Meshes in Unreal Engine. These are detailed below.

Merging during Import

The first method for sharing Skeletons is done during the FBX import process. When importing your new Skeletal Mesh (with additional and peripheral Bones compliant with the rules above), you can select a Skeleton from a Skeletal Mesh that already exists in your project. Unreal Engine will then merge the Skeletons, appending any new Bones into the hierarchy. Additionally, your Skeleton's proportions will be defined by the original Skeletal Mesh from which it was created.

merge sharing

If you are importing a Skeleton that is vastly different from the Skeleton you are attempting to merge to and breaks any sharing rules, you will see an error message:

failed to merge bones

In this case, you may need to create a new Skeleton Asset for the Skeletal Mesh you are importing, rather than merge into an existing one.

When viewing your merged Skeleton, you will see these additional Bones listed in your hierarchy, but they will only be visible and active for the Skeletal Mesh they are intended for.

ShareVar1.png

ShareVar2.png

Skeletal Mesh Variant 1

Skeletal Mesh Variant 2

Compatible Skeletons

You can also share Skeletons in a non-destructive manner by using the Compatible Skeletons property in the Skeleton Editor. This allows for different skeletons to act similar to merging, but still maintains separate Skeleton Assets.

To make a Skeleton compatible with another, open the Skeleton Editor, then open the Asset Details panel by selecting Window > Asset Details from the main menu. In the Asset Details panel, locate the Compatible Skeletons property.

compatible skeletons

Click Add (+) to add a Skeleton entry to the list, and then select a different Skeleton to use.

add compatible skeleton

Now, animations can be shared from the Skeleton that was added to the compatible list.

compatible skeletons

Skeleton compatibility is not bi-directional. If you set Skeleton 1 to be compatible with Skeleton 2, that does not also mean that Skeleton 2 is compatible with Skeleton 1. If you want sharing to be fully bi-directional, you will also need to set Skeleton 2 to be compatible with Skeleton 1.

Skeleton Features

Skeletons in Unreal Engine support a variety of features for attaching, blending, and other settings. Refer to the following pages to learn more about these features:

TopicIcon.png

Animation Retargeting

Describes how retargeted animations can be used with multiple Skeletal Meshes, allowing you to share animations.

Describes how retargeted animations can be used with multiple Skeletal Meshes, allowing you to share animations.

TopicIcon.png

Blend Masks and Blend Profiles

Exclude Bones or change their individual blend speed by using Blend Masks and Blend Profiles.

Exclude Bones or change their individual blend speed by using Blend Masks and Blend Profiles.

TopicIcon.png

Skeletal Mesh LODs

Generate and modify LODs for Skeletal Meshes using the Skeletal Mesh Reduction Tool

Generate and modify LODs for Skeletal Meshes using the Skeletal Mesh Reduction Tool

TopicIcon.png

Skeletal Mesh Sockets

Create attachment points within your Skeletal Mesh using Sockets.

Create attachment points within your Skeletal Mesh using Sockets.

TopicIcon.png

Virtual Bones

Resolve layered animation problems by using Virtual Bones with IK.

Resolve layered animation problems by using Virtual Bones with IK.

Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.
Take our survey
Cancel