bevy_fontmesh

A simple and focused Bevy plugin for generating 3D text meshes from fonts. Powered by fontmesh.

What it does

Turns TrueType fonts into 3D meshes. You can control the extrusion depth, anchor points, and subdivision quality. Also supports per-character entities if you want to style or animate individual glyphs.

The plugin just generates the meshes - Bevy handles everything else (materials, lighting, rendering).

Quick Start

[dependencies]
bevy = "0.18"
bevy_fontmesh = "0.3.0"

use bevy::prelude::*;
use bevy_fontmesh::prelude::*;

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        .add_plugins(FontMeshPlugin::<StandardMaterial>::default())
        .add_systems(Startup, setup)
        .run();
}

fn setup(
    mut commands: Commands,
    asset_server: Res<AssetServer>,
    mut materials: ResMut<Assets<StandardMaterial>>,
) {
    commands.spawn(TextMeshBundle {
        text_mesh: TextMesh {
            text: "Hello, World!".to_string(),
            font: asset_server.load("fonts/font.ttf"),
            style: TextMeshStyle {
                depth: 0.5,
                anchor: TextAnchor::Center,
                ..default()
            },
        },
        material: MeshMaterial3d(materials.add(StandardMaterial::default())),
        ..default()
    });
}

For custom materials, add the plugin for each material type you need:

app.add_plugins(FontMeshPlugin::<MyCustomMaterial>::default())

For detailed API documentation and more examples, see docs.rs/bevy_fontmesh.

Examples

cargo run --example basic                # Simple 3D text
cargo run --example multiline             # Multiline with anchoring
cargo run --example justification         # Text alignment
cargo run --example anchors               # All anchor points
cargo run --example per_glyph             # Per-character styling
cargo run --release --example stress_test # Performance test
cargo run --release --example showcase    # Metallic "BEVY" with orbiting camera

Limitations

• No kerning: Character spacing uses advance widths only. Kerning pairs from the font are not applied.
• Font parsing: The font is re-parsed from bytes on each mesh generation. For static text this is fine; if you spawn many text entities at startup, consider reusing FontMesh handles so the asset loader runs once.
• No CFF/PostScript outlines: OpenType fonts with CFF outlines are not supported (ttf-parser limitation).

Why another text plugin?

I wanted something simple that just generates meshes and lets Bevy do the rest. No fancy features, no complex API - just font → mesh.

Supported Formats

• TrueType (.ttf) - fully supported
• OpenType (.otf) with TrueType outlines - supported
• OpenType with CFF/PostScript outlines - not supported (ttf-parser limitation)

Bevy Version Compatibility

License

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