RoMesh

romesh is a Rust library for parsing all current Roblox mesh formats into a single, unified mesh representation.

It’s built for tooling: converters, validators, renderers, asset pipelines, and anything else that needs to reliably read Roblox .mesh files.

✨ Features

• Parses Roblox mesh versions v1 through v5
• Single unified output regardless of source version
• One-call API — no version handling required
• Supports:
  • Geometry (vertices, faces)
  • Normals, UVs, tangents
  • Vertex colors
  • Skinning & bones
  • Subsets / LOD data

📦 Installation

[dependencies]
romesh = "0.1.0"

🚀 Quick start

Parse a mesh file

use romesh::RobloxMesh;

fn main() -> anyhow::Result<()> {
    let bytes = std::fs::read("MyMesh.mesh")?;
    let mesh = RobloxMesh::from_buffer(&bytes)?;

    println!("mesh version: {}", mesh.version);
    println!("vertices: {}", mesh.vertices.len());
    println!("faces: {}", mesh.faces.len());

    Ok(())
}

📐 What you get

RobloxMesh::from_buffer always returns the same high-level mesh type, no matter which Roblox mesh version the file uses.

Depending on the mesh, this may include:

• Geometry (vertices & faces)
• Normals / UVs / tangents
• Vertex colors
• Skinning data (weights & indices)
• Bone hierarchy
• Subsets / LOD partitions

Fields that don’t exist in the source mesh are returned as empty.

🛠️ Common use cases

• Convert Roblox meshes to other formats (glTF, OBJ, custom engines)

• Inspect or validate asset data

• Build external renderers or preview tools

• Diff or analyze mesh changes

• Research Roblox’s mesh formats

🧪 Version support

romesh supports the following Roblox mesh revisions:

• v1
• v2
• v3
• v4
• v5

Future versions can be added without changing the public API.

💖 Contribution

romesh was developed by @Bear

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

⚠️ Disclaimer

Roblox is a trademark of Roblox Corporation. This project is not affiliated with or endorsed by Roblox.