bevy_cards 0.17.0

A simple, no dependency bevy plugin for making card 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
87
88
89
90
91
92
93
94
95
96

# bevy_cards

A simple, no dependency bevy plugin for making card games

## Features

- Hover over, drag & drop cards
- Drop cards into slots

## How to use

```rs
use bevy::prelude::*;
use bevy_cards::prelude::*;

const CARD_WIDTH: u32 = 100;
const CARD_HEIGHT: u32 = 144;

fn main() -> AppExit {
    App::new()
        .add_plugins(DefaultPlugins)
        // add the plugin with the default card size
        .add_plugins(BevyCardsPlugin::new(CARD_WIDTH as f32, CARD_HEIGHT as f32))
        .add_systems(Startup, setup)
        .run()
}

fn setup(mut commands: Commands) {
    commands.spawn(Camera2d);

    // spawn a green card
    commands.spawn((
        Card,
        Draggable, // to drag & drop the card, we need to add the "Draggable" component
        Sprite {
            color: Color::srgb(0.0, 1.0, 0.0),
            custom_size: Some(Vec2::new(CARD_WIDTH as f32, CARD_HEIGHT as f32)),
            ..default()
        },
        Transform::from_xyz(-100.0, 0.0, 0.0),
    ));

    // spawn a blue card, thats somewhat smaller
    commands.spawn((
        Card,
        Draggable,
        CardSize(Vec2::new(CARD_WIDTH as f32 * 0.8, CARD_HEIGHT as f32 * 0.8)),
        Sprite {
            color: Color::srgb(0.0, 0.0, 1.0),
            custom_size: Some(Vec2::new(CARD_WIDTH as f32 * 0.8, CARD_HEIGHT as f32 * 0.8)),
            ..default()
        },
        Transform::from_xyz(100.0, 0.0, 0.0),
    ));
}
```

Run this example using ``cargo run --example readme``

![Readme example in action](https://media3.giphy.com/media/v1.Y2lkPTc5MGI3NjExNnpiam44MnF0cjM5bTlpbWQ4YnpzN3h0eGR3Z252OWd3eHhrdDYweSZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/A5e7Hu5k92sS99UHko/giphy.gif)

### Slots

![Slots example in action](https://media1.giphy.com/media/v1.Y2lkPTc5MGI3NjExOGNhOTJpanBubjd6Zzh0d3NtdGN2MGF4eTVmbm94ejY4MmZiM3NrbSZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/3sVNMLjDBNIx5zLlMt/giphy.gif)

[Example Code](./examples/slots.rs)

Run this example using ``cargo run --example slots``

## Concepts

### Card

Card is a component enabling your entity to be hovered, dragged and dropped around

### Slot

Slots are places your card can be dropped into

## Bevy versions supported

`bevy_cards` is not using semver, every release uses the same major and minor versions as `bevy` while the patch part is reserved
for all kinds of changes, be it bug fixes or feature updates.

| bevy   | bevy_pixcam | branch |
|--------|-------------|--------|
| 0.17.x | 0.17.x      | master |
| 0.16.x | 0.16.x      | 0.16   |

## Assets

- [assets/CuteCards.png by DANI MACCARI](https://dani-maccari.itch.io/cute-cards-deck)

## License

MIT