bevy-discord 0.2.2

A bevy plugin for sending and receiving discord messages.
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

# Bevy Discord Plugin

![GitHub License](https://img.shields.io/github/license/AS1100K/bevy-discord)
![Crates.io Version](https://img.shields.io/crates/v/bevy-discord)
![CI](https://github.com/as1100k/bevy-discord/actions/workflows/ci.yml/badge.svg?event=push)

A very simple, bevy plugin that let you send and receive messages through bevy events.

## Usage

Add `bevy-discord` as your dependency:

```bash
$ cargo add bevy-discord --features full
```

Example Usage:

```rust
use bevy_ecs::prelude::*;
use bevy_discord::bot::{ 
    events::BMessage,
    DiscordBotRes,
    serenity::model::id::ChannelId
};
use bevy_discord::runtime::tokio_runtime;
use serde_json::json;

// Make sure to add [bevy_discord::bot::DiscordBotPlugin] to the `App`

#[allow(clippy::complexity)]
fn handle_chat_relay(
    // Event emitted when an message is received on discord
    mut events: EventReader<BMessage>,
    // Discord Res
    discord_bot_res: Res<DiscordBotRes>
) {
    for event in events.read() {
        let message_content = &event.new_message.content;
        
        println!("Got a new message -> {}", message_content);

        // ...
        // Using this message as some sort of command
        // ...
        
        // Send a message to discord
        let http = discord_bot_res.get_http().unwrap();

        tokio_runtime().spawn(async move {
            let channel_id = ChannelId::new(7);

            http.send_message(channel_id, Vec::new(), &json!({
                "content": "Hello from bevy-discord"
            })).await.unwrap();
        });
    }
}
```

_If you want real examples then, it's worth checking out crate 
[aether-core](https://github.com/AS1100K/aether/blob/main/aether-core/src/discord.rs), 
although it is archived now._

## Features

This crate using powerful cargo features.

| Feature   | Information                                                                             |
| --------- | --------------------------------------------------------------------------------------- |
| `webhook` | Uses discord webhooks, using this you can only send messages.                           |
| `bot`     | This uses `serenity` behind the scenes and you can create awesome discord bots with it. |

_both features are comes under `full` feature._

## Not Supported Features

Currently, this crate is under development and there are features that are supported by discord and serenity
but not supported by us.

| Feature       | Module    |
| ------------- | --------- |
| `voice`       | `bot`     |
| `attachments` | `webhook` |