jolt-rust

April 11, 2025 · View on GitHub

Rust bindings for Jolt Physics 5.3.0 using JoltC.

This project is an early work in progress. Watch for exposed nails.

Goals

joltc-sys: Functioning, up-to-date unsafe bindings to Jolt Physics
rolt: Ergonomic, safe bindings to Jolt Physics

Crates

`joltc-sys` — Jolt bindings via JoltC

This crate contains unsafe bindings to JoltC.

joltc-sys = "0.2.0"

Features:

double-precision: Enable higher precision simulation using doubles instead of floats.
object-layer-u32: Changes the ObjectLayer type to use 32 bits instead of 16 bits.

`rolt` — aspirationally safe Rust Jolt bindings

This crate contains a higher-level wrapper around JoltC, providing ergonomics comparable to using Jolt from C++.

The safety of this crate is currently provided on a best-effort basis.

rolt = "0.2.0"

Features:

double-precision: Forwards to joltc-sys/double-precision
object-layer-u32: Forwards to joltc-sys/object-layer-u32

`hello-world-sys` — HelloWorld using `joltc-sys`

This is a port of Jolt's HelloWorld example to Rust using jolt-sys. It isn't pretty nor safe, but it does have identical behavior.

`hello-world` — HelloWorld using `rolt`

This is a port of Jolt's HelloWorld example to Rust using the jolt crate. The goal of this example is to replicate the behavior of the original example entirely in safe Rust.

Submodules

This repository uses Git submodules. Make sure to initialize submodules recursively so that JoltC and Jolt are both referenced correctly in your checkout:

git submodule update --init --recursive

License

Licensed under either of

Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.