jackdaw 0.1.5

A 3D level editor built with Bevy
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
114
115
116

<img width="1917" height="1033" alt="image" src="https://github.com/user-attachments/assets/fa53542b-de0a-420b-bde0-bdcb180992a5" />

## Usage

Add [`jackdaw::EditorPlugin`](src/lib.rs#L62) to your app.

```rust
use bevy::prelude::*;
use jackdaw::EditorPlugin;

fn main() -> AppExit {
    App::new()
        .add_plugins((DefaultPlugins, EditorPlugin))
        ...
        .run()
}
```

Or have a look at the [examples](examples/) for more advanced useages.

## Keyboard Shortcuts

### Navigation

| Key | Action |
|-----|--------|
| RMB + Drag | Look around |
| WASD | Move (forward / left / back / right) |
| Q / E | Move up / down |
| Shift | Double speed |
| Scroll | Dolly forward / back |
| RMB + Scroll | Adjust move speed |
| F | Focus selected |
| Ctrl+1-9 | Save camera bookmark |
| 1-9 | Restore camera bookmark |

### Selection

| Key | Action |
|-----|--------|
| LMB | Select entity |
| Ctrl+Click | Toggle multi-select |
| Shift+LMB Drag | Box select |

### Transform

| Key | Action |
|-----|--------|
| Esc | Translate mode |
| R | Rotate mode |
| T | Scale mode |
| X | Toggle local / world space |
| MMB | Toggle snap |
| Ctrl (during drag) | Toggle snap |
| Arrows | Nudge (grid-unit move) |
| Alt+Arrows | 90° rotate |
| PageUp / PageDown | Nudge vertical |

### Entity

| Key | Action |
|-----|--------|
| Delete / Backspace | Delete selected |
| Ctrl+D | Duplicate |
| Ctrl+C | Copy components |
| Ctrl+V | Paste components |
| H | Toggle visibility |
| Alt+G | Reset position |
| Alt+R | Reset rotation |
| Alt+S | Reset scale |

### Brush Editing

| Key | Action |
|-----|--------|
| 1 | Vertex mode |
| 2 | Edge mode |
| 3 | Face mode |
| 4 | Clip mode |
| X / Y / Z | Constrain axis |
| Shift+Click | Multi-select |
| Delete | Delete selected element |
| PageUp/PageDown | Nudge selected vertices/edges/faces up/down |
| Enter | Apply clip plane |
| Esc | Exit brush edit |

### Brush Draw

| Key | Action |
|-----|--------|
| B | Draw brush (add) |
| C | Draw brush (cut) |
| Tab | Toggle add / cut mode |
| Click | Place vertex / advance phase |
| Enter | Close polygon |
| Backspace | Remove last vertex |
| Esc / Right-click | Cancel drawing |

### View

| Key | Action |
|-----|--------|
| Ctrl+Shift+W | Toggle wireframe |
| [ | Decrease grid size |
| ] | Increase grid size |
| Ctrl+Alt+Scroll | Change grid size |

### File

| Key | Action |
|-----|--------|
| Ctrl+S | Save scene |
| Ctrl+O | Open scene |
| Ctrl+Shift+N | New scene |
| Ctrl+Z | Undo |
| Ctrl+Shift+Z | Redo |