bevy_vrm1

Caution

This crate is in an early stage of development and may undergo breaking changes.

Note

This crate only supports VRM 1.0.

This crate allows you to use VRM1.0 and VRMA.

Usage

Name	currently supported
Spring Bone	✅
Look At	✅
Animation(vrma)	✅
Node Constraint	✅
First Person	❌

Spring Bone

This is a feature for expressing the sway of a character's hair and other parts.

• spring bone specification(en)
• spring bone specification(ja)

examples

• spring_bone.rs

Look At

• look at specification(en)
• look at specification(ja)

LookAt is a component for animating the line of sight into a VRM model. You can use the LookAt component to track a specific target or the mouse cursor.

examples

• look_at_cursor.rs
• look_at_target.rs

Animation(vrma)

You can play animations using VRMA.

• vrma specification(en)
• vrma specification(ja)

examples

• vrma.rs

Node Constraint

Node Constraint is a feature for constraining node transformations in real-time, primarily designed for Humanoid bones. This library supports all three constraint types defined in the VRMC_node_constraint-1.0 specification:

• node constraint specification(en)
• node constraint specification(ja)

Constraint Types

Rotation Constraint

• Transfers the entire local rotation from a source node to destination nodes
• Typical use case: Sub-arms and auxiliary bones
• Supports weight parameter for interpolation (0.0 - 1.0)

Roll Constraint

• Transfers rotation around a specific axis (X, Y, or Z)
• Typical use case: Twist bones for arms and legs
• Supports weight parameter and configurable roll axis

Aim Constraint

• Rotates a node to face a target node
• Typical use case: Clothing sleeves and accessories
• Supports weight parameter and configurable aim axis (PositiveX, NegativeX, PositiveY, NegativeY, PositiveZ, NegativeZ)

All constraint types use spherical linear interpolation (slerp) based on the weight parameter to blend between the rest rotation and the constrained rotation.

Features

Feature	Description	default
serde	derive Serialize and Deserialize for components	no
log	enable log for debugging	no

Versions

bevy_vrm1	bevy
0.1.0 ~	0.16

Credits

Using bevy_game_template to CI.

Sample Models

• AliciaSolid by © DWANGO Co., Ltd.

Contact

• Discord: @not_not_elm