https://github.com/geowarin/godot-anim-lib-export

Convert a set of mixamo animations to an animation library usable in godot 4.
https://github.com/geowarin/godot-anim-lib-export

animation-library godot mixamo

Last synced: about 4 hours ago
JSON representation

Convert a set of mixamo animations to an animation library usable in godot 4.

• Host: GitHub
• URL: https://github.com/geowarin/godot-anim-lib-export
• Owner: geowarin
• License: mit
• Created: 2022-10-12T18:50:14.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-08-19T14:16:24.000Z (3 months ago)
• Last Synced: 2024-08-19T16:40:42.375Z (3 months ago)
• Topics: animation-library, godot, mixamo
• Language: Python
• Homepage:
• Size: 124 KB
• Stars: 10
• Watchers: 1
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Make a Godot animation library from mixamo

Convert a set of mixamo animations to an animation library usable in godot 4. 

## Requirements

You must have the following binaries in your path.

- blender

- godot 4

## Usage

```shell

git clone https://github.com/geowarin/godot-anim-lib-export.git

alias gdlib="/path/to/godot-anim-lib-export/gd_make_lib.sh /path/to/Ybot.fbx"

gdlib "my/animation/dir" "myLibrary.res"

```

## Using retargeting to use your library

Add the generated .res file to your godot project.

Import any rigged character.

Generate a humanoid Skeleton for this character.

![import settings](docs/import-settings.png)

If the dots are green, it means that godot heuristics correctly mapped your skeleton.

If some dots are red, you might have to do some manual tweaks.

Create a new inherited scene from the imported character and select the `AnimationPlayer` node.

In the animation tab click on `Animations > Manage Animations`.

In the new window, click on `Load library` and select your animation library.

![success](docs/success.png)

## Downloading from mixamo

### Character

Any character can be used, but I suggest you just get the YBot.

![character](docs/character.png)

### Animations

Download individual animations from mixamo.

Make sure you have the same character selected that you previously downloaded. 

Suggestions:

 - Tweak any animation parameters you want

   - ie, shorten lengthy animations

   - Use "in place" if you don't want to deal with root motion

   - Use mirror if necessary

     - You can make a right handed character left-handed

     - You can generate an animation in two directions (ie, "strafe-left" and "strafe-right") 

 - Download the animations without skin 

![animations](docs/animations.png)

Put all the animation fbx files in a directory.

Verify the names are matching what you want to have in your library.

You can suffix animations with "-loop" if you want them to loop (a walk cycle, for example).

## How it works

### First script: blender to generate a glb

It uses a python script to make blender:

- Import the character

- Add the TPose animation as an NLA track

- For each animation

  - import it

  - copy its animation to the character as an NLA track with the file name as the animation name

  - delete the animation from the scene

- export the scene as a glb

### Second script: uses godot to generate the library from the glb

Then it launches godot in headless mode to generate the library.

To do that, we have a "template" godot project with a `anims.glb.import` file containing:

- the parameters used for the import (type=animation library, 30fps, etc.).

- a humanoid skeleton matching the mixamo rig

We place the glb next to the `anims.glb.import` file. 

When godot launches, it imports the file in `.godot/imported`.

We find the `.res` file that has been generated and copy it where the user wants it.

You can use these scripts individually if you want.

For example, you could use the blender script to generate the glb file

and then import that in godot, changing its type to "animation library" in the import tab.