4 releases (2 breaking)

Uses new Rust 2024

0.18.1-rc.1	Mar 3, 2026
0.18.0	Feb 23, 2026
0.17.0	Jan 4, 2026
0.1.0	Sep 23, 2025
0.1.0-17	~~Oct 6, 2025~~

#862 in Game dev

MIT/Apache

59KB
990 lines

bevy_ufbx

FBX asset loader for Bevy powered by ufbx.

Bevy compatibility

bevy	bevy_ufbx
0.18	0.18
0.17	0.17

Installation

[dependencies]
bevy     = "0.18"
bevy_ufbx = "0.18"

Quick start

use bevy::prelude::*;
use bevy_ufbx::FbxPlugin;

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        .add_plugins(FbxPlugin)
        .add_systems(Startup, setup)
        .run();
}

fn setup(mut commands: Commands, asset_server: Res<AssetServer>) {
    commands.spawn(Camera3d::default());
    commands.spawn(SceneRoot(
        asset_server.load("character.fbx#Scene0"),
    ));
}

Loading with custom settings

use bevy_ufbx::{Fbx, FbxLoaderSettings};

fn setup(asset_server: Res<AssetServer>) {
    asset_server.load_with_settings::<Fbx, FbxLoaderSettings>(
        "environment.fbx",
        |s| {
            s.load_cameras = false;
            s.load_lights  = false;
        },
    );
}

`FbxLoaderSettings` fields

Field	Type	Default	Description
`load_meshes`	`RenderAssetUsages`	`RenderAssetUsages::default()`	Which worlds the mesh is available in
`load_materials`	`RenderAssetUsages`	`RenderAssetUsages::default()`	Which worlds the material is available in
`load_cameras`	`bool`	`true`	Import cameras from the FBX
`load_lights`	`bool`	`true`	Import lights from the FBX
`include_source`	`bool`	`false`	Keep raw bytes in the loaded asset
`convert_coordinates`	`bool`	`false`	Remap axes to Bevy's right-handed Y-up space

Asset labels

Individual sub-assets can be addressed with #Label path suffixes:

Label	Type	Description
`Scene{N}`	`Scene`	Scene hierarchy (N = scene index)
`Mesh{N}`	`Mesh`	Triangulated mesh
`Material{N}`	`StandardMaterial`	PBR material
`Node{N}`	`FbxNode`	Transform node
`Skin{N}`	`FbxSkin`	Skeletal skin
`DefaultMaterial`	`StandardMaterial`	Fallback material when none is present

let scene    = asset_server.load::<Scene>("model.fbx#Scene0");
let mesh     = asset_server.load::<Mesh>("model.fbx#Mesh0");
let material = asset_server.load::<StandardMaterial>("model.fbx#Material0");

Supported features

Triangle meshes with positions, normals, and UVs
Multi-material meshes (face groups per material)
PBR materials (base color, metallic, roughness, normal, emission, AO)
Texture mapping, including .fbm embedded texture folders
Skeletal skinning data (bone weights / bind poses)
Scene hierarchy (node transforms)
Directional, point, and spot lights

Limitations

Animation curves are parsed but not yet forwarded to Bevy's animation system
Cameras are not imported into Bevy camera components
NURBS and subdivision surfaces are not supported (ufbx triangulates on load)

Example

cargo run --example load_fbx -- my_model.fbx

License

Licensed under either of MIT or Apache 2.0 at your option.

Dependencies

~62–100MB
~1.5M SLoC