bevy_vrm1

Crates.iobevy_vrm1
lib.rsbevy_vrm1
version0.5.0
created_at2025-06-01 10:25:25.195408+00
updated_at2026-01-14 03:54:42.359353+00
descriptionAllows you to use VRM and VRMA in Bevy
homepage
repositoryhttps://github.com/not-elm/bevy_vrm1
max_upload_size
id1697024
size3,039,796
elm (not-elm)

documentation

README

bevy_vrm1

Crates.io Docs

[!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

SpringBone

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

examples

Look At

LookAt

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

Animation(vrma)

VRMA

You can play animations using VRMA.

examples

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:

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.5.0 ~ 0.18
0.4.0 ~ 0.17
0.1.0 ~ 0.16

Credits

Using bevy_game_template to CI.

Sample Models

  • AliciaSolid by © DWANGO Co., Ltd.
Commit count: 67

cargo fmt