Discord.zig

A high-performance bleeding edge Discord library in Zig, featuring full API coverage, sharding support, and fine-tuned parsing

• Sharding Support: Ideal for large bots, enabling distributed load handling.
• 100% API Coverage & Fully Typed: Offers complete access to Discord's API with strict typing for reliable and safe code.
• High Performance: Faster than whichever library you can name (WIP)
• Flexible Payload Parsing: Supports payload parsing through both zlib and zstd.
• Language Agnostic: Primarily in Zig, but also compatible with JavaScript. (PERHAPS?)

// Sample code
const Session = @import("discord.zig").Session;
const Discord = @import("discord.zig").Discord;
const Intents = Discord.Intents;
const std = @import("std");

const token = "Bot MTI5ODgzOTgzMDY3OTEzMDE4OA...";  // Replace with your actual token

fn message_create(message: Discord.Message) void {
    // Define your message handling logic here
    std.debug.print("Captured message: {?s}\n", .{message.content});
}

pub fn main() !void {
    var arena = std.heap.ArenaAllocator.init(std.heap.page_allocator);
    defer arena.deinit();
    const allocator = arena.allocator();

    var handler = try Session.init(allocator, .{
        .token = token,
        .intents = Intents.fromRaw(37379),
        .run = Session.GatewayDispatchEvent{ .message_create = &message_create },
    });
    errdefer handler.deinit();

    const t = try std.Thread.spawn(.{}, Session.readMessage, .{ &handler, null });
    defer t.join();
}

Installation

// In your build.zig file
const exe = b.addExecutable(.{
    .name = "marin",
    .root_source_file = b.path("src/main.zig"),
    .target = target,
    .optimize = optimize,
});

const dzig = b.dependency("discord.zig", .{});

exe.root_module.addImport("discord.zig", dzig.module("discord.zig"));

TIP: make sure you use the latest Zig!

contributing

Contributions are welcome! Please open an issue or pull request if you'd like to help improve the library.

event coverage roadmap

Event	Support
application_command_permissions_update	❌
auto_moderation_rule_create	❌
auto_moderation_rule_update	❌
auto_moderation_rule_delete	❌
auto_moderation_action_execution	❌
channel_create	❌
channel_update	❌
channel_delete	❌
channel_pins_update	❌
thread_create	❌
thread_update	❌
thread_delete	❌
thread_list_sync	❌
thread_member_update	❌
thread_members_update	❌
guild_audit_log_entry_create	❌
guild_create	❌
guild_update	❌
guild_delete	❌
guild_ban_add	❌
guild_ban_remove	❌
guild_emojis_update	❌
guild_stickers_update	❌
guild_integrations_update	❌
guild_member_add	❌
guild_member_remove	❌
guild_member_update	❌
guild_members_chunk	❌
guild_role_create	❌
guild_role_update	❌
guild_role_delete	❌
guild_scheduled_event_create	❌
guild_scheduled_event_update	❌
guild_scheduled_event_delete	❌
guild_scheduled_event_user_add	❌
guild_scheduled_event_user_remove	❌
integration_create	❌
integration_update	❌
integration_delete	❌
interaction_create	❌
invite_create	❌
invite_delete	❌
message_create: ?*const fn (message: Discord.Message) void	✅
message_update: ?*const fn (message: Discord.Message) void	✅
message_delete: ?*const fn (message: Discord.MessageDelete) void	✅
message_delete_bulk: ?*const fn (message: Discord.MessageDeleteBulk) void	✅
message_reaction_add	❌
message_reaction_remove	❌
message_reaction_remove_all	❌
message_reaction_remove_emoji	❌
presence_update	❌
stage_instance_create	❌
stage_instance_update	❌
stage_instance_delete	❌
typing_start	❌
user_update	❌
voice_channel_effect_send	❌
voice_state_update	❌
voice_server_update	❌
webhooks_update	❌
entitlement_create	❌
entitlement_update	❌
entitlement_delete	❌
message_poll_vote_add	❌
message_poll_vote_remove	❌
ready: ?*const fn (data: Discord.Ready) void	✅
resumed	❌
any: ?*const fn (data: []const u8) void	✅