aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: e191f8e0e1501c2f1f2750df805cfd1764037a64 (plain)
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
# bevy_blacklight_material

[![Crates](https://img.shields.io/crates/v/bevy_blacklight_material)](https://crates.io/crates/bevy_blacklight_material)
![License](https://img.shields.io/badge/license-0BSD%2FMIT%2FApache-blue.svg)
![Tag](https://img.shields.io/github/v/tag/exvacuum/bevy_blacklight_material)
![Build](https://img.shields.io/github/actions/workflow/status/exvacuum/bevy_blacklight_material/rust.yml)

A plugin for the [Bevy Engine](https://bevyengine.org) which adds a "blacklight" material that is revealed by spot lights marked with a `Blacklight` component.

Feel free to contribute if you want to improve this, it was thrown together pretty hastily so there's bound to be some errors or oversights.

## Compatibility

| Crate Version | Bevy Version |
|---            |---           |
| 0.1           | 0.14         |

## Installation

### crates.io
```toml
[dependencies]
bevy_blacklight_material = "0.1"
```

### Using git URL in Cargo.toml
```toml
[dependencies.bevy_rustysynth]
git = "https://github.com/exvacuum/bevy_blacklight_material.git"
```

## Usage

In `main.rs`:
```rs
use bevy::prelude::*;

fn main() {
    App::new()
        .add_plugins((
            DefaultPlugins,
            BlacklightPlugin,
        ))
        .run();
}
```
Then you can create blacklight-emitting spotlights, and reveal-able surfaces, like this:
```rs
// Mesh with blacklight material
commands.spawn(MaterialMeshBundle {
    material: asset_server.add(BlacklightMaterial {
        // base texture, color, etc
        ..Default::default()
    }),
    ..Default::default()
});


// Blacklight
commands.spawn((
    Blacklight, // Marker component
    SpotLightBundle {
        spot_light: SpotLight {
            // outer/inner angle, range
            ..Default::default()
        },
        ..Default::default()     
    },
));
```

## License

This crate is licensed under your choice of 0BSD, Apache-2.0, or MIT license.