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*.
• Proper error handling

conststd=@import("std");constDiscord=@import("discord");constShard=Discord.Shard;varsession:*Discord.Session=undefined;fnready(_:*Shard,payload:Discord.Ready)!void{std.debug.print("logged in as {s}\n",.{payload.user.username});}fnmessage_create(_:*Shard,message:Discord.Message)!void{if(message.content!=nullandstd.ascii.eqlIgnoreCase(message.content.?,"!hi")){varresult=trysession.api.sendMessage(message.channel_id,.{.content="hi :)"});deferresult.deinit();constm=result.value.unwrap();std.debug.print("sent: {?s}\n",.{m.content});}}pubfnmain()!void{vargpa:std.heap.GeneralPurposeAllocator(.{})=.init;constallocator=gpa.allocator();session=tryallocator.create(Discord.Session);session.*=Discord.init(allocator);defersession.deinit();constenv_map=tryallocator.create(std.process.EnvMap);env_map.*=trystd.process.getEnvMap(allocator);deferenv_map.deinit();consttoken=env_map.get("DISCORD_TOKEN")orelse{@panic("DISCORD_TOKEN not found in environment variables");};constintents=comptimeblk:{varbits:Discord.Intents=.{};bits.Guilds=true;bits.GuildMessages=true;bits.GuildMembers=true;// WARNING:// YOU MUST SET THIS ON DEV PORTAL// OTHERWISE THE LIBRARY WILL CRASHbits.MessageContent=true;break:blkbits;};trysession.start(.{.intents=intents,.authorization=token,.run=.{.message_create=&message_create,.ready=&ready},.log=.yes,.options=.{},.cache=.defaults(allocator),});}

Installation

// In your build.zig fileconstexe=b.addExecutable(.{.name="beluga",.root_source_file=b.path("src/main.zig"),.target=target,// just a suggestion, use .ReleaseSafe.optimize=optimize,// must always be on, hard dependency.link_libc=true,// self-hosted backed is unstable as of today 2025年05月16日, .use_llvm=true,});constdzig=b.dependency("discordzig",.{});exe.root_module.addImport("discord.zig",dzig.module("discord.zig"));

Warning: the library is intended to be used with the latest dev version of Zig.

contributing

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

• Support server: https://discord.gg/RBHkBt7nP5
• The original repo: https://git.yuzucchii.xyz/yuzucchii/discord.zig

general roadmap

missing structures

missing events right now

http methods missing