discordrs

Standalone Discord bot framework for Rust with Components V2, Gateway WebSocket, and HTTP client

Features

• Gateway WebSocket client with connect, heartbeat, identify, resume, reconnect, and zlib compression
• HTTP REST client with automatic 429 rate-limit retry
• Components V2 builders (Container, TextDisplay, Section, MediaGallery, Button, SelectMenu, and more)
• Modal builders with RadioGroup, CheckboxGroup, and Checkbox
• V2 modal submission parser that preserves all V2 component types that serenity drops
• Interaction routing helpers: parse_raw_interaction and parse_interaction_context
• Feature-gated modules: gateway for bot client runtime, interactions for HTTP Interactions Endpoint

Install

[dependencies]
discordrs = "0.3.0"

[dependencies]
# Gateway bot client
discordrs = { version = "0.3.0", features = ["gateway"] }

# HTTP Interactions Endpoint
discordrs = { version = "0.3.0", features = ["interactions"] }

# Both runtime modes
discordrs = { version = "0.3.0", features = ["gateway", "interactions"] }

Quick Example

use discordrs::{BotClient, Context, EventHandler, gateway_intents};
use discordrs::{create_container, respond_with_container, parse_raw_interaction, parse_interaction_context, RawInteraction};
use async_trait::async_trait;
use serde_json::Value;

struct Handler;

#[async_trait]
impl EventHandler for Handler {
    async fn ready(&self, _ctx: Context, ready: Value) {
        println!("Bot ready! User: {}", ready["user"]["username"]);
    }
    async fn interaction_create(&self, ctx: Context, interaction: Value) {
        let ictx = parse_interaction_context(&interaction).unwrap();
        match parse_raw_interaction(&interaction).unwrap() {
            RawInteraction::Command { name, .. } => {
                if name.as_deref() == Some("hello") {
                    let container = create_container("Hello", "Hello, World!", vec![], None);
                    let _ = respond_with_container(&ctx.http, &ictx.id, &ictx.token, container, false).await;
                }
            }
            _ => {}
        }
    }
}

#[tokio::main]
async fn main() {
    let token = std::env::var("DISCORD_TOKEN").unwrap();
    BotClient::builder(&token, gateway_intents::GUILDS | gateway_intents::GUILD_MESSAGES)
        .event_handler(Handler)
        .start()
        .await
        .unwrap();
}

Components V2 Example

use discordrs::{
    button_style, create_container, send_container_message, ButtonConfig, DiscordHttpClient,
};

async fn send_support_panel(http: &DiscordHttpClient, channel_id: u64) -> Result<(), discordrs::Error> {
    let buttons = vec![
        ButtonConfig::new("ticket_open", "Open Ticket").style(button_style::PRIMARY),
        ButtonConfig::new("ticket_status", "Check Status").style(button_style::SECONDARY),
    ];

    let container = create_container(
        "Support Panel",
        "Use the buttons below to manage support requests.",
        buttons,
        None,
    );

    send_container_message(http, channel_id, container).await?;
    Ok(())
}

Modal Example with RadioGroup

use discordrs::{
    CheckboxBuilder, CheckboxGroupBuilder, ModalBuilder, RadioGroupBuilder, SelectOption,
};

let modal = ModalBuilder::new("preferences_modal", "Preferences")
    .add_radio_group(
        "Theme",
        Some("Pick one"),
        RadioGroupBuilder::new("theme")
            .add_option(SelectOption::new("Light", "light"))
            .add_option(SelectOption::new("Dark", "dark"))
            .required(true),
    )
    .add_checkbox_group(
        "Notifications",
        Some("Choose any"),
        CheckboxGroupBuilder::new("notify_channels")
            .add_option(SelectOption::new("Email", "email"))
            .add_option(SelectOption::new("Push", "push"))
            .min_values(0)
            .max_values(2),
    )
    .add_checkbox(
        "Agree to Terms",
        None,
        CheckboxBuilder::new("agree_terms").required(true),
    );

Feature Flags

Notes

• discordrs started as a helper around serenity workflows, but v0.3.0 is now a fully standalone framework.
• The parser keeps V2 modal component types, including Label, RadioGroup, and CheckboxGroup, so routing logic can keep full fidelity.