bevy_map 0.5.0

Complete 2D tilemap editor and runtime for Bevy games
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

# bevy_map

Complete 2D tilemap editor and runtime for Bevy games.

Part of [bevy_map_editor](https://github.com/jbuehler23/bevy_map_editor).

## Quick Start

Add to your `Cargo.toml`:

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

Load and display a map:

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

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        .add_plugins(MapRuntimePlugin)
        .add_systems(Startup, load_map)
        .run();
}

fn load_map(mut commands: Commands, asset_server: Res<AssetServer>) {
    commands.spawn(Camera2d);
    commands.spawn(MapHandle(asset_server.load("maps/level.map.json")));
}
```

## Features

- `runtime` (default) - Map loading and bevy_ecs_tilemap rendering
- `physics` - Avian2D collision integration
- `hot-reload` (default) - File watching for development

```toml
# With physics support
bevy_map = { version = "0.1", features = ["physics"] }
```

## Modules

| Module      | Description                          |
|-------------|--------------------------------------|
| `prelude`   | Common imports for most use cases    |
| `core`      | Data types (Level, Layer, Tileset)   |
| `runtime`   | Runtime loading and rendering        |
| `animation` | Sprite sheet animations              |
| `dialogue`  | Branching dialogue trees             |
| `autotile`  | Wang tile terrain system             |

## Custom Entities

Define game entities that spawn from map data:

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

#[derive(Component, MapEntity)]
#[map_entity(type_name = "NPC")]
pub struct Npc {
    #[map_prop]
    pub name: String,
    #[map_prop(default = 100)]
    pub health: i32,
}

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        .add_plugins(MapRuntimePlugin)
        .register_map_entity::<Npc>()
        .run();
}
```

## License

MIT OR Apache-2.0