maple 0.3.0

A 3D game 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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

# 🍁 Maple 🍁


A 3D game engine written in Rust with a focus on simplicity and ease of use.

## Features


- **3D Rendering** - Built-in primitives, GLTF model loading, and PBR materials
- **Physics** - Integrated 3D physics with rapier for rigid body and collider nodes
- **Node-Based** - Hierarchical scene graph with parent-child relationships
- **Behavior System** - Event-driven behaviors using `.on()` handlers

## Showcase


![Bistro](https://raw.githubusercontent.com/ToothlessBrush/maple/main/images/bistro.png)
![Helmet](https://raw.githubusercontent.com/ToothlessBrush/maple/main/images/helmet.png)

## Quick Start


Add Maple with Cargo:
```bash
cargo add maple
```

Create a basic scene:
```rust
use maple::prelude::*;

fn main() {
    App::new(Config::default())
        .add_plugin(Core3D)
        .add_plugin(Physics3D)
        .load_scene(MainScene)
        .run();
}

pub struct MainScene;

impl SceneBuilder for MainScene {
    fn build(&mut self, _assets: &AssetLibrary) -> Scene {
        let scene = Scene::default();

        scene
            .spawn(
                "Camera",
                Camera3D::builder()
                    .position((-10.0, 10.0, 10.0))
                    .far_plane(100.0)
                    .orientation_vector(
                        Vec3::ZERO
                            - Vec3 {
                                x: -10.0,
                                y: 10.0,
                                z: 10.0,
                            },
                    )
                    .build(),
            )
            .on::<Ready>(|ctx| {
                ctx.game.get_resource_mut::<Input>().set_cursor_locked(true);
            })
            .on::<Update>(Camera3D::free_fly(1.0, 1.0));

        scene.spawn(
            "floor",
            Mesh3D::plane()
                .position((0.0, -2.0, 0.0))
                .scale_factor(10.0)
                .build(),
        );

        scene.spawn(
            "cube",
            Mesh3D::cube()
                .material(MaterialProperties::default().with_base_color_factor(Color::BLUE))
                .build(),
        );

        scene.spawn(
            "direct",
            DirectionalLight::builder()
                .direction((-1.0, -1.0, -1.0))
                .intensity(10.0)
                .bias(0.0001)
                .build(),
        );

        scene
    }
}
```

## Examples


Check out the examples by cloning this repo

```bash
# Physics demo

cargo run --example physics_demo

# First-person player controller

cargo run --example player_controller

# Model loading from GLTF

cargo run --example model_loading
```

# Contributing


Contributions are welcome! If you have suggestions for improvements, feel free to create a pull request or open an issue.

# License


This project is licensed under the MIT License