nightshade-editor 0.10.0

An interactive editor for the Nightshade game engine
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
117
118
119
120
121

# Nightshade Editor


An interactive editor and scene inspector for the [Nightshade](https://github.com/matthewjberger/nightshade) game engine.

<img width="1238" height="1346" alt="image" src="https://github.com/user-attachments/assets/dcfab536-f067-4988-b3f5-d8839444aaea" />

## Installation


### From crates.io


```bash
cargo install nightshade-editor
```

### From source


```bash
git clone https://github.com/matthewjberger/nightshade.git
cd nightshade
cargo build --release -p nightshade-editor
```

## Usage


Run the editor:

```bash
nightshade-editor
```

Or use the justfile:

```bash
just run
```

## Features


### Scene Management

- **Scene tree** - Hierarchical view of entities with parent-child relationships
- **Component inspector** - View and edit entity components
- **Entity selection** - Click entities to inspect their properties

### Rendering

- **3D viewport** - WGPU-based renderer with WebGPU support
- **Fly camera controls** - WASD movement with mouse look
- **Grid and skybox** - Scene navigation helpers
- **Alpha blending** - Support for opaque, mask, and blend (OIT) transparency modes
- **Material editing** - Edit base color, alpha mode, and alpha cutoff in real-time
- **SDF text rendering** - Signed distance field text with outline support
- **HUD overlays** - Screen-space UI elements

### Tools

- **Mesh spawning** - Create cubes, spheres, planes, and cylinders
- **Line rendering** - GPU-accelerated line primitives with frustum culling
- **3D text** - Spawn text objects with customizable properties
- **Stress testing** - Tools for performance profiling (5K text lattice, 10K meshes, 20K lines)

### Post-Processing

- **Render graph system** - Modular pass-based rendering pipeline
- **Grayscale effect** - Example compute shader post-process

### Performance

- **FPS counter** - Frame rate display
- **Entity count** - Total entities in scene
- **Line count** - Line primitive usage

## Controls


| Input | Action |
|-------|--------|
| **Middle mouse** | Orbit camera |
| **Shift + Middle mouse** | Pan camera |
| **Scroll wheel** | Zoom |
| **Numpad 0** | Toggle fly camera mode (WASD + right-click look) |
| **Numpad 1/3/7** | Front / Right / Top view |
| **Numpad 5** | Toggle orthographic / perspective |
| **G / R / S** | Grab / Rotate / Scale selected entity |
| **X** | Delete selected entity |
| **Tab** | Toggle local / world coordinate space |
| **Q** | Exit editor |

## Architecture


The editor is built on top of the Nightshade engine and demonstrates:

- **ECS pattern** using [freecs](https://github.com/matthewjberger/freecs)
- **Data-oriented design** with component-based architecture
- **WGPU rendering** with custom render graph
- **egui integration** for immediate-mode UI
- **Cross-platform support** (native and WASM)

## Development


### Building for WASM


```bash
trunk serve --open --config apps/editor/Trunk.toml
```

### Running tests


```bash
cargo test --all
```

### Linting


```bash
cargo clippy --all --tests -- -D warnings
```

## License


Licensed under the [MIT License](https://github.com/matthewjberger/nightshade/blob/main/LICENSE).

## Links


- [Nightshade Engine](https://github.com/matthewjberger/nightshade)
- [Documentation](https://docs.rs/nightshade)
- [Crates.io](https://crates.io/crates/nightshade-editor)