SkeletonProfile in Godot – Complete Guide

Venturing into the world of game development can sometimes feel like a daunting prospect filled with complex concepts and elaborate tools, but fear not! One of the most powerful tools in a game developer’s arsenal is the Godot Engine, and it comes packed with features like the SkeletonProfile class to make your life easier. Understanding the capabilities of such classes can empower you to create more dynamic and advanced character animations in your games. So, let’s dive into the SkeletonProfile and unfold the magic it holds for your future projects.

What is SkeletonProfile?

SkeletonProfile is a resource in Godot 4 that acts as a foundational class for creating a virtual skeleton profile. This profile is pivotal for retargeting, which is the process of mapping one set of animations to a different skeleton. Retargeting can significantly speed up game development by reusing existing animations, thus saving time and resources.

What Is It Used For?

SkeletonProfile provides functionalities essential for retargeting animations in Godot. By defining bone names, parents, tails, and other parameters, this resource helps in the retargeting process, ensuring that animations conform correctly to different skeletal structures. This is particularly useful when dealing with characters that share similar yet distinct anatomical structures, allowing for seamless animation across a variety of figures.

Why Should I Learn It?

Grasping the concept of SkeletonProfile and its implementation:

– **Enhances Reusability:** It enables developers to reuse animations across different character models, cutting down the time spent on animating each character individually.
– **Facilitates Flexibility:** It allows for greater flexibility and creativity in character design, as animations are not tied to a single model.
– **Improves Efficiency:** Understanding SkeletonProfile can significantly improve the efficiency of your animation workflow within the Godot Engine.

Let’s get ready to delve deeper into SkeletonProfile and learn through practical examples how it can revolutionize your animation retargeting process within Godot Engine.

CTA Small Image

Creating a SkeletonProfile

Before we delve into animating with the SkeletonProfile class, it’s important to understand how to create a SkeletonProfile within the Godot Engine. We start by defining the various bones and their hierarchy, which will serve as the reference structure for our animations.

// Load your skeleton data (replace 'YourSkeleton.tscn' with your actual skeleton scene)
var my_skeleton = preload("res://YourSkeleton.tscn").instance()

// Create a new skeleton profile
var skeleton_profile =

// Define a bone with its name and parent index (0 for no parent)
skeleton_profile.add_bone("torso", 0)
skeleton_profile.add_bone("head", skeleton_profile.find_bone("torso"))

Each bone in the SkeletonProfile must have a unique name and specify the index of its parent bone, if any.

Setting Up Bones’ Pose

After we’ve created the SkeletonProfile and defined the bones, we need to establish the rest pose for each bone. The rest pose is the default or neutral position of the bones from which animations will be generated.

// Adding rest pose information for each bone
skeleton_profile.set_bone_rest("torso", Transform(Basis(), Vector3(0, 0, 0)))
skeleton_profile.set_bone_rest("head", Transform(Basis(), Vector3(0, 2, 0)))

// Apply the rest poses to the skeleton

The rest pose is defined using a Transform, which combines rotation, position, and scale to define the pose.

Adjusting Bone Lengths for Correct Retargeting

Bone lengths are crucial for correct retargeting of animations. You should adjust bone lengths to match those of the source animation. In Godot, you can specify the “tail” of a bone to determine its length.

// Set the tail positions for each bone
skeleton_profile.set_bone_tail("torso", Vector3(0, 2, 0))
skeleton_profile.set_bone_tail("head", Vector3(0, 3.5, 0))

These tails will assist in calculating the correct positions during the animation retargeting process.

Exporting and Reusing SkeletonProfile

Once we’ve fully set up the SkeletonProfile, we can save it for reuse in other projects or with different skeletons. This facilitates the reusability of animations in multiple character models.

// Save the configured skeleton profile to a resource file"res://my_skeleton_profile.tres", skeleton_profile)

Later, you can load the saved SkeletonProfile and apply it to another skeleton.

// Load a previously saved skeleton profile
var loaded_profile = load("res://my_skeleton_profile.tres")

// Apply loaded profile to a new skeleton instance
var new_skeleton = preload("res://AnotherSkeleton.tscn").instance()

In the following section of this tutorial, we will put these skills into practice by exploring how to retarget animations from one model to another using our newly created and exported SkeletonProfile. Stay tuned to unlock the full potential of your animations in Godot!To kick off our journey into animation retargeting with the SkeletonProfile, we will explore the process of applying an animation created for one character skeleton to another with a different bone structure. Understanding this process is essential for efficient animation workflow.

Retargeting an Animation with SkeletonProfile

The actual magic happens when we retarget animations. We start by loading the SkeletonProfile, the source and target skeletal animations.

// Load the SkeletonProfile
var skeleton_profile = load("res://my_skeleton_profile.tres")

// Load the source animation
var animation_source = load("res://source_animation.tres")

// Load the character skeletal that needs to have the animation retargeted
var character_skeleton = preload("res://CharacterSkeleton.tscn").instance()

Now we’ll create an AnimationPlayer node and add it to the target skeleton.

// Create an AnimationPlayer and add it to the character skeleton
var animation_player =

Next, we retarget the source animation on the profile to the new skeleton, creating a new animation in the process.

// Retarget the source animation to the new skeleton using the profile
var retargeted_animation = skeleton_profile.retarget_animation(animation_source, character_skeleton)

// Then, add this retargeted animation to the AnimationPlayer
animation_player.add_animation("retargeted_animation", retargeted_animation)

After adding the newly created animation to the AnimationPlayer, we can play the retargeted animation on our character skeleton.

// Play the retargeted animation"retargeted_animation")

If your target skeleton has differently named bones than what’s specified in the SkeletonProfile, you must remap these names accordingly.

// Remap bones if necessary
skeleton_profile.remap_bones(character_skeleton, {
    "source_bone_name1": "target_bone_name1",
    "source_bone_name2": "target_bone_name2",
    // Add more mappings as necessary for each bone

Furthermore, it’s crucial to update the SkeletonProfile with the proper rest poses from the target skeleton to ensure the animation behaves correctly.

// Loop through each bone in the target skeleton and update its rest pose in the profile
for bone_idx in range(character_skeleton.get_bone_count()):
    var bone_name = character_skeleton.get_bone_name(bone_idx)
    var rest_pose = character_skeleton.get_bone_global_rest(bone_idx)
    skeleton_profile.set_bone_rest(bone_name, rest_pose)

Lastly, we need to save the state on the AnimationPlayer to prevent it from being lost when the game is closed.

// Save the state of the AnimationPlayer before the game closes
var current_animation = animation_player.current_animation
var current_animation_pos = animation_player.current_animation_pos

// You can use these stored variables to restore the state when the game starts again, true)

By following these steps, you can retarget animations across different skeletons effectively. With SkeletonProfile, you can advance your Godot animation framework to a new level of expertise and efficiency. This knowledge can open countless doors in your game development journey, adding a rich layer of immersion and engagement through meticulously crafted animations for your multitude of diverse characters.Once you’ve become proficient with the basics of animation retargeting as mentioned before, you’ll discover that there are more advanced opportunities to fine-tune and control the animation process. The following examples showcase how you can leverage the Godot Engine’s capabilities to take your animations to a sophisticated level.

Let’s begin by adjusting the playback speed of your animation. Sometimes the retargeted animation may need a different timing to match your game pace or the character’s personality.

// Adjust the playback speed of the animation
animation_player.playback_speed = 0.75 // 75% of the original speed

Handling looping animations is another common requirement. Whether it’s a walk cycle or idle animation, you need to set whether an animation should repeat.

// Set the retargeted animation to loop
retargeted_animation.loop = true

Transitioning smoothly between animations is a subtle but significant detail that can greatly enhance the fluidity of your game’s visuals. Godot provides a simple way to transition from one animation to another.

// Change from one animation to another with a transition time of 0.5 seconds
animation_player.transition_to("new_animation", 0.5)

Fine-tuning animations to fit different character scales is also essential. Godot’s SkeletonProfile class allows you to scale rest poses to match the size of your character without altering the original animation.

// Scale the rest poses for a smaller character
for bone_name in skeleton_profile.get_bones():
    var bone_rest = skeleton_profile.get_bone_rest(bone_name)
    bone_rest.origin *= 0.5 // Reduce the scale by half
    skeleton_profile.set_bone_rest(bone_name, bone_rest)

Adjusting the influence of certain bones can give you more creative control over the resulting animation. For instance, if a character’s spine should be more flexible or stiff, you can adjust the weights accordingly.

// Adjust the weight of a specific bone on the animation
var weight_for_spine = 0.8 // 80% influence
retargeted_animation.track_set_importance(retargeted_animation.find_track("Spine"), weight_for_spine)

Inverse Kinematics (IK) is often used in game animation to create more dynamic movements, such as a character reaching for objects. If you’re working with IK, you can set up IK chains within the SkeletonProfile.

// Setup an IK chain for a character's arm
var ik_chain =

Knowing how to blend animations can create more natural transitions and character movements—like blending walking into running.

// Blend between a walk and run animation based on the character's speed
var speed_ratio = character.get_speed() / character.get_max_speed()
animation_player.set_blend_amount("walk_animation", 1.0 - speed_ratio)
animation_player.set_blend_amount("run_animation", speed_ratio)

These are just a handful of the ways you can manipulate and control animations using the Godot Engine and the SkeletonProfile class. Proficiency in using these tools can significantly improve the quality of your game, providing a seamless and dynamic player experience. Game development with Godot becomes a gateway to not just creating games, but crafting worlds that live and breathe through their inhabitants’ movements.

Continuing Your Godot Journey

Embracing the full spectrum of game development with Godot is an exciting adventure, and your journey doesn’t have to end here. With a vast array of concepts to explore and mechanics to master, the next step is to expand your knowledge and skills. To aid in your continuous learning, we invite you to check out our Godot Game Development Mini-Degree, a meticulously structured program designed to take you from beginner to building complete, cross-platform games with Godot 4.

Our Godot courses range from beginner to more advanced levels and cover a wide array of essential topics. You’ll dive into using 2D and 3D assets, get hands-on with GDScript, and design intricate gameplay systems. The versatility of our Godot content ensures there’s always more to learn and create. Plus, flexibility is key at Zenva – access our courses anytime, on any device, and earn certificates as you sail through each module.

Whether you’re exploring game development as a future career or honing your existing skills, our collection of Godot courses will provide the blueprint you need to build engaging, interactive games that could captivate players around the world. Start scripting your success story with Zenva today!


In the realm of game development, tools like the SkeletonProfile in the Godot Engine are powerful allies, enhancing creativity and efficiency. By mastering these tools, you unlock new possibilities, breathe life into your characters, and define the motion of your digital worlds with precision and flair. We at Zenva are invested in your success and growth as a game developer and take pride in offering resources designed to boost your journey every step of the way.

Embrace the opportunity to elevate your game creation skills to spectacular new heights. Take the leap with our Godot Game Development Mini-Degree—a treasure trove of knowledge ready for you to unlock. Together, let’s turn your game development dreams into your reality. Happy coding!

Python Blog Image

FINAL DAYS: Unlock coding courses in Unity, Godot, Unreal, Python and more.