Bez popisu

xIceArcher 842ddb357a Support for multiple embeds in message routes (#1000) před 3 roky
docs a7c15e1bab Misc changes to docs (#907) před 3 roky
examples 9d9602318a Context menus (#978) před 3 roky
tools d22169d60f Remove type checks for handlers, it's done implicitly in the handlerForInterface call. (#305) před 7 roky
.gitignore b0fa920925 Slash commands (#856) před 3 roky
.travis.yml 9c33bfbada Update unmarshal function to wrap ErrJSONUnmarshal and return specific error message. Requires at least Go 1.13. (#924) před 3 roky
LICENSE f7e105a4f5 Rename GoDiscord to Discordgo in LICENSE (develop) před 8 roky
README.md df74d8bbe6 README updates (#935) před 3 roky
components.go 4ebe5a08ee Selects component (#954) před 3 roky
discord.go d4d47b65ee Bump library version to v0.23.0 před 3 roky
discord_test.go c41dc15a10 Add changes to presences, remove Game type před 3 roky
endpoints.go 30251cf325 Fix EndpointInvite (#892) před 3 roky
event.go 2f40c4489c gofmt pass před 4 roky
eventhandlers.go b0fa920925 Slash commands (#856) před 3 roky
events.go d655d6df7b Add BeforeDelete to GuildDelete struct (#962) před 3 roky
go.mod 9c33bfbada Update unmarshal function to wrap ErrJSONUnmarshal and return specific error message. Requires at least Go 1.13. (#924) před 3 roky
go.sum 9c33bfbada Update unmarshal function to wrap ErrJSONUnmarshal and return specific error message. Requires at least Go 1.13. (#924) před 3 roky
interactions.go 9d9602318a Context menus (#978) před 3 roky
interactions_test.go dc3c2d5533 implement interaction request signing verification před 3 roky
logging.go 42fd45c4a3 Changed "consistancy" to "consistency" in logging.go před 4 roky
message.go 842ddb357a Support for multiple embeds in message routes (#1000) před 3 roky
message_test.go 4f55d76981 update Activity struct and add emoji functions (#895) před 3 roky
mkdocs.yml b5bb8f7477 Some website contented added :) před 8 roky
oauth2.go f5bb723db8 Convert more constants to absolute values před 3 roky
oauth2_test.go ecd6077268 fixed small typo in oauth2_test.go před 6 roky
ratelimit.go b0fa920925 Slash commands (#856) před 3 roky
ratelimit_test.go 0f0aaad011 Correct header in rate limit test před 3 roky
restapi.go 842ddb357a Support for multiple embeds in message routes (#1000) před 3 roky
restapi_test.go 9c33bfbada Update unmarshal function to wrap ErrJSONUnmarshal and return specific error message. Requires at least Go 1.13. (#924) před 3 roky
state.go d655d6df7b Add BeforeDelete to GuildDelete struct (#962) před 3 roky
structs.go 0fad116c6c feat: add ActivityTypeCompeting (5) (#990) před 3 roky
types.go fede59cfa0 Fixed compilation issues před 7 roky
types_test.go 0c11cae782 Timestamp type; a string with a Parse() function před 8 roky
user.go f36553e31f fix UserFlags constant types (#937) před 3 roky
user_test.go 52ad9e2feb add String() method to User (#350) před 7 roky
util.go ab47f123ba support allowing webhook edits with files, and responding to interactions with files (#931) před 3 roky
util_test.go 9b1ba78bc6 Adding millisecond precision to SnowflakeTimestamp utility (#732) před 4 roky
voice.go b18e1d7276 Fix RTP extended header parsing před 3 roky
webhook.go 4ebe5a08ee Selects component (#954) před 3 roky
wsapi.go 3fcad20924 Fix all the typos that goreportcard detected. před 3 roky

README.md

DiscordGo

Go Reference Go Report Card 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.

  • Go Reference
  • 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.