Keine Beschreibung

Carson Hoffman b7a2a4b7fa Correct rate limit test magnitude vor 3 Jahren
docs 56905d9db3 Remove references to develop branch vor 4 Jahren
examples 657ac048fe Switch example to use UpdateGameStatus vor 3 Jahren
tools d22169d60f Remove type checks for handlers, it's done implicitly in the handlerForInterface call. (#305) vor 7 Jahren
.gitignore e26e635684 Add bitwise permission const PermissionViewChannel vor 4 Jahren
.travis.yml 96848bf0be Drop 1.11 and 1.12 checks in Travis vor 3 Jahren
LICENSE f7e105a4f5 Rename GoDiscord to Discordgo in LICENSE (develop) vor 8 Jahren
README.md 56905d9db3 Remove references to develop branch vor 4 Jahren
discord.go bca349d46d Change library version to alpha for v8 vor 3 Jahren
discord_test.go c41dc15a10 Add changes to presences, remove Game type vor 3 Jahren
endpoints.go daaafb5a7f Rename fields for v8 vor 3 Jahren
event.go 2f40c4489c gofmt pass vor 4 Jahren
eventhandlers.go 0af46d54e7 adds support for Webhooks Update event (#561) vor 6 Jahren
events.go c41dc15a10 Add changes to presences, remove Game type vor 3 Jahren
go.mod bd7cb04d47 Since Go is intent on a Go value being in go.mod vor 5 Jahren
go.sum 9b7b311486 Add go module support vor 6 Jahren
interactions.go dc3c2d5533 implement interaction request signing verification vor 3 Jahren
interactions_test.go dc3c2d5533 implement interaction request signing verification vor 3 Jahren
logging.go 42fd45c4a3 Changed "consistancy" to "consistency" in logging.go vor 4 Jahren
message.go 9fc2793e83 Add reply and application command message types vor 3 Jahren
message_test.go 82be39a218 Remove redundant line vor 6 Jahren
mkdocs.yml b5bb8f7477 Some website contented added :) vor 8 Jahren
oauth2.go c78bd2c24c Add team data to applications (#787) vor 4 Jahren
oauth2_test.go ecd6077268 fixed small typo in oauth2_test.go vor 6 Jahren
ratelimit.go 866ecccb2e Support millisecond precision in rate limits vor 3 Jahren
ratelimit_test.go b7a2a4b7fa Correct rate limit test magnitude vor 3 Jahren
restapi.go daaafb5a7f Rename fields for v8 vor 3 Jahren
restapi_test.go d45cbf73f0 Changed test Nickname, for fun! vor 7 Jahren
state.go c41dc15a10 Add changes to presences, remove Game type vor 3 Jahren
structs.go c41dc15a10 Add changes to presences, remove Game type vor 3 Jahren
types.go fede59cfa0 Fixed compilation issues vor 7 Jahren
types_test.go 0c11cae782 Timestamp type; a string with a Parse() function vor 8 Jahren
user.go 2fe5745a4e chore: add missing fields in User struct (#790) vor 4 Jahren
user_test.go 52ad9e2feb add String() method to User (#350) vor 7 Jahren
util.go 9b1ba78bc6 Adding millisecond precision to SnowflakeTimestamp utility (#732) vor 4 Jahren
util_test.go 9b1ba78bc6 Adding millisecond precision to SnowflakeTimestamp utility (#732) vor 4 Jahren
voice.go 9bcbfecf1d Add lock to prevent race condition (#816) vor 4 Jahren
wsapi.go 9548146f69 Fix comment on UpdateGameStatus vor 3 Jahren

README.md

DiscordGo

GoDoc Go report Build Status Discord Gophers Discord API

DiscordGo is a Go package that provides low level bindings to the Discord chat client API. DiscordGo has nearly complete support for all of the Discord API endpoints, websocket interface, and voice interface.

If you would like to help the DiscordGo package please use this link to add the official DiscordGo test bot dgo to your server. This provides indispensable help to this project.

  • See dgVoice package for an example of additional voice helper functions and features for DiscordGo.

  • See dca for an experimental stand alone tool that wraps ffmpeg to create opus encoded audio appropriate for use with Discord (and DiscordGo).

For help with this package or general Go discussion, please join the Discord Gophers chat server.

Getting Started

Installing

This assumes you already have a working Go environment, if not please see this page first.

go get will always pull the latest tagged release from the master branch.

go get github.com/bwmarrin/discordgo

Usage

Import the package into your project.

import "github.com/bwmarrin/discordgo"

Construct a new Discord client which can be used to access the variety of Discord API functions and to set callback functions for Discord events.

discord, err := discordgo.New("Bot " + "authentication token")

See Documentation and Examples below for more detailed information.

Documentation

NOTICE: This library and the Discord API are unfinished. Because of that there may be major changes to library in the future.

The DiscordGo code is fairly well documented at this point and is currently the only documentation available. Both GoDoc and GoWalker (below) present that information in a nice format.

  • GoDoc
  • Go Walker
  • Hand crafted documentation coming eventually.

Examples

Below is a list of examples and other projects using DiscordGo. Please submit an issue if you would like your project added or removed from this list.

Troubleshooting

For help with common problems please reference the Troubleshooting section of the project wiki.

Contributing

Contributions are very welcomed, however please follow the below guidelines.

  • First open an issue describing the bug or enhancement so it can be discussed.
  • Try to match current naming conventions as closely as possible.
  • This package is intended to be a low level direct mapping of the Discord API, so please avoid adding enhancements outside of that scope without first discussing it.
  • Create a Pull Request with your changes against the master branch.

List of Discord APIs

See this chart for a feature comparison and list of other Discord API libraries.

Special Thanks

Chris Rhodes - For the DiscordGo logo and tons of PRs.