bevy_newton 0.0.1

Real-time physics engine for Bevy engine
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96


# Bevy Newton - Newtonian Physics for Bevy

[![crates.io](https://img.shields.io/crates/v/bevy_newton.svg)](https://crates.io/crates/bevy_newton)
[![license](https://img.shields.io/badge/license-MIT%2FApache--2.0-blue)](https://github.com/VitalyAnkh/bevy_newton)
[![documentation](https://docs.rs/bevy_newton/badge.svg)](https://docs.rs/bevy_newton)

A feature-rich Newtonian physics engine natively integrated with the [Bevy game engine](https://bevyengine.org/).

<p align="center">
  <img src="https://github.com/yourusername/bevy_newton/raw/main/media/demo.gif" alt="Physics Demo">
</p>

## Features

- 🚀 **Rigid Body Dynamics**
  - Linear & angular velocity integration
  - Mass properties and inertia tensors
  - Force/torque accumulation
- 🔥 **Collision Detection**
  - Sphere, Box, Capsule, and Convex Hull primitives
  - Broad-phase spatial partitioning
  - Narrow-phase SAT (Separating Axis Theorem)
- âš¡ **Collision Resolution**
  - Impulse-based contact resolution
  - Restitution (bounciness) and friction
  - Collision events and queries
- 🧠 **Advanced Features**
  - Continuous collision detection
  - Raycasting and shape queries
  - Joint constraints (ball, hinge, prismatic)
  - Force fields and area effects

## Installation

Add to your `Cargo.toml`:

```toml
[dependencies]
bevy_newton = "0.1"
```

## Basic Usage

```rust
use bevy::prelude::*;
use bevy_newton::prelude::*;

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

```

## Feature Flags

| Feature         | Description                          | Default |
|-----------------|--------------------------------------|---------|
| `3d`            | Enable 3D physics                   | Yes     |
| `2d`            | Simplified 2D physics               | Yes      |
| `collision`     | Advanced collision features         | Yes     |
| `debug`         | Visualization tools                 | No      |
| `serialize`     | Component serialization             | No      |

## Performance

Benchmarks (Intel i9-13900K @ 5.8GHz):

| Scenario               | Entities | Time/Frame |
|------------------------|----------|------------|
| Simple Collision       | 1,000    | 0.8ms      |
| Complex Constraints    | 500      | 1.2ms      |
| Raycasting (100 rays)  | -        | 0.3ms      |

## Documentation

- [Full API Reference](https://docs.rs/bevy_newton)
- [Examples Directory](https://github.com/VitalyAnkh/bevy_newton/tree/main/examples)
- [Physics Cheat Sheet](https://github.com/VitalyAnkh/bevy_newton/wiki/Cheat-Sheet)

## Contributing

We welcome contributions! Please see our [Contribution Guide](CONTRIBUTING.md) for details.

## License

Dual-licensed under either:

- MIT License ([LICENSE-MIT](LICENSE-MIT))
- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE))

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