ComfyUI Node: UniRig: Apply Animation

UniRig: Apply Animation:

The UniRigApplyAnimation node is designed to seamlessly apply animations to rigged 3D models, particularly those compatible with Mixamo rigs. This node is part of the ComfyUI-UniRig suite and leverages animation templates to enhance the animation process. By utilizing this node, you can efficiently transfer animations from one rigged model to another, ensuring that the animations are correctly mapped to the corresponding bones. This is particularly beneficial for artists who want to animate characters without delving into the complexities of manual rigging and animation transfer. The node supports direct animation application using the bpy module, which allows for in-process animation handling, making it a powerful tool for streamlining the animation workflow in 3D projects.

UniRig: Apply Animation Input Parameters:

model_fbx

The model_fbx parameter specifies the file path to the FBX file of the rigged model to which the animation will be applied. This parameter is crucial as it determines the target model that will receive the animation data. The file path should be a valid string pointing to an existing FBX file. There are no specific minimum or maximum values, but the file must be compatible with the Mixamo rigging system for optimal results.

animation_fbx

The animation_fbx parameter indicates the file path to the FBX file containing the animation data. This file should include the animation actions that you wish to apply to the target model. Like the model_fbx, this parameter requires a valid string path to an existing FBX file. The animation data should be compatible with the Mixamo rigging system to ensure proper bone mapping and animation transfer.

output_fbx

The output_fbx parameter defines the file path where the resulting animated model will be saved. This parameter is essential for specifying the destination of the output file, which will contain the rigged model with the applied animation. The path should be a valid string, and the directory must be writable to ensure successful file export.

UniRig: Apply Animation Output Parameters:

output_fbx

The output_fbx parameter serves as both an input and output parameter. As an output, it provides the file path to the newly created FBX file that contains the rigged model with the applied animation. This output is crucial for verifying the success of the animation application process and for further use in 3D projects or rendering pipelines.

UniRig: Apply Animation Usage Tips:

• Ensure that both the model_fbx and animation_fbx files are compatible with the Mixamo rigging system to avoid compatibility issues and ensure smooth animation transfer.
• Use descriptive and organized file paths for the output_fbx to easily locate and manage your animated models, especially when working on large projects with multiple assets.

UniRig: Apply Animation Common Errors and Solutions:

Animation does not have mixamorig: bone names!

• Explanation: This error occurs when the animation file does not contain bone names prefixed with mixamorig:, which is required for compatibility with Mixamo-rigged models.
• Solution: Verify that the animation_fbx file is correctly rigged with Mixamo and contains the necessary bone naming conventions. If not, consider re-rigging the model using Mixamo or adjusting the bone names to match the required format.

No animation action found

• Explanation: This error indicates that the node could not find any animation actions within the provided animation file.
• Solution: Ensure that the animation_fbx file contains valid animation actions. You may need to open the file in a 3D software like Blender to check for and assign animation actions before using the node.