v10

Create a Discord Bot in Go

Disgo is a Discord API Wrapper designed to be flexible, performant, secure, and thread-safe. Disgo aims to provide every feature in the Discord API along with optional rate limiting, structured logging, shard management, and caching. Use the only Go module to provide a 100% one-to-one implementation of the Discord API. Disgo also provides the following exclusive features.

• EVERY Rate Limit (Global, Per Route, Per Resource, Custom, Gateway)
• Automatic Gateway Intent Calculation
• Selective Event Processing
• No Reflection or Type Assertion (Event Handling)

The API of Disgo is struct-based. This means that you do NOT need to learn which functions invoke specific functionality on Discord. Instead, knowledge of Go and the Discord API is enough to use the entire library.

Feature Complete

Go is lacking an issue-free feature complete Discord API Wrapper. Disgo will be the first library to complete this task with the help of Dasgo.

• Disgo currently implements 176 out of 176 endpoints.

  • Disgo currently supports — through tests or examples — 75 out of 176 endpoints.

  • Disgo aims to support 67 endpoints through tests (112% reached).

  • Unsupported endpoints are usable.

• All Gateway Events are implemented and connecting to the Gateway is tested.

Disgo is currently missing the following features.

• Interactions via Outgoing Webhook
• Voice Connections
• Sharding
• Cache Manager

Interested in contributing? Read the roadmap.

Future

Disgo v1.10.0 is a stable version. The definition of "stable" in this context refers to the ability to use the API Wrapper while experiencing a minimal amount of issues. Disgo will not use Backwards Compatibility as an excuse to prevent necessary improvements. Backwards compatibility must be a function of a previous design's quality. In addition, Go's package manager provides hashed versioning such that backwards compatibility should not be an issue.