discordgo

package
v2.13.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 14, 2022 License: MIT, BSD-3-Clause Imports: 39 Imported by: 0

README

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

master vs develop Branch

  • The master branch represents the latest released version of DiscordGo. This branch will always have a stable and tested version of the library. Each release is tagged and you can easily download a specific release and view release notes on the github releases page.

  • The develop branch is where all development happens and almost always has new features over the master branch. However breaking changes are frequently added to develop and even sometimes bugs are introduced. Bugs get fixed and the breaking changes get documented before pushing to master.

So, what should you use?

If you can accept the constant changing nature of develop, it is the recommended branch to use. Otherwise, if you want to tail behind development slightly and have a more stable package with documented releases, use master.

Installing

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

go get will always pull the latest released version from the master branch.

go get github.com/bwmarrin/discordgo

If you want to use the develop branch, follow these steps next.

cd $GOPATH/src/github.com/bwmarrin/discordgo
git checkout develop
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("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.
  • Fork the develop branch and make your changes.
  • 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 develop 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.

Documentation

Overview

Package discordgo provides Discord binding for Go

Index

Examples

Constants

View Source 
const (

	// LogError level is used for critical errors that could lead to data loss
	// or panic that would not be returned to a calling function.
	LogError int = iota

	// LogWarning level is used for very abnormal events and errors that are
	// also returned to a calling function.
	LogWarning

	// LogInformational level is used for normal non-error activity
	LogInformational

	// LogDebug level is for very detailed non-error activity.  This is
	// very spammy and will impact performance.
	LogDebug
)
View Source 
const (
	PermissionCreateInstantInvite     int64 = 0x00000000001                     // (1 << 0)	Allows creation of instant invites	T, V, S
	PermissionKickMembers             int64 = 0x00000000002                     // (1 << 1)	Allows kicking members
	PermissionBanMembers              int64 = 0x00000000004                     // (1 << 2)	Allows banning members
	PermissionAdministrator           int64 = 0x00000000008                     // (1 << 3)	Allows all permissions and bypasses channel permission overwrites
	PermissionManageChannels          int64 = 0x00000000010                     // (1 << 4)	Allows management and editing of channels	T, V, S
	PermissionManageGuild             int64 = 0x00000000020                     // (1 << 5)	Allows management and editing of the guild
	PermissionManageServer            int64 = PermissionManageGuild             // deprecated: use PermissionManageGuild
	PermissionAddReactions            int64 = 0x00000000040                     // (1 << 6)	Allows for the addition of reactions to messages	T
	PermissionViewAuditLog            int64 = 0x00000000080                     // (1 << 7)	Allows for viewing of audit logs
	PermissionViewAuditLogs           int64 = PermissionViewAuditLog            // deprecated: use PermissionViewAuditLog
	PermissionPrioritySpeaker         int64 = 0x00000000100                     // (1 << 8)	Allows for using priority speaker in a voice channel	V
	PermissionStream                  int64 = 0x00000000200                     // (1 << 9)	Allows the user to go live	V
	PermissionViewChannel             int64 = 0x00000000400                     // (1 << 10)	Allows guild members to view a channel, which includes reading messages in text channels	T, V, S
	PermissionReadMessages            int64 = PermissionViewChannel             // deprecated: use PermissionViewChannel
	PermissionSendMessages            int64 = 0x00000000800                     // (1 << 11)	Allows for sending messages in a channel	T
	PermissionSendTTSMessages         int64 = 0x00000001000                     // (1 << 12)	Allows for sending of /tts messages	T
	PermissionManageMessages          int64 = 0x00000002000                     // (1 << 13)	Allows for deletion of other users messages	T
	PermissionEmbedLinks              int64 = 0x00000004000                     // (1 << 14)	Links sent by users with this permission will be auto-embedded	T
	PermissionAttachFiles             int64 = 0x00000008000                     // (1 << 15)	Allows for uploading images and files	T
	PermissionReadMessageHistory      int64 = 0x00000010000                     // (1 << 16)	Allows for reading of message history	T
	PermissionMentionEveryone         int64 = 0x00000020000                     // (1 << 17)	Allows for using the @everyone tag to notify all users in a channel, and the @here tag to notify all online users in a channel	T
	PermissionUseExternalEmojis       int64 = 0x00000040000                     // (1 << 18)	Allows the usage of custom emojis from other servers	T
	PermissionViewGuildInsights       int64 = 0x00000080000                     // (1 << 19)	Allows for viewing guild insights
	PermissionVoiceConnect            int64 = 0x00000100000                     // (1 << 20)	Allows for joining of a voice channel	V, S
	PermissionVoiceSpeak              int64 = 0x00000200000                     // (1 << 21)	Allows for speaking in a voice channel	V
	PermissionVoiceMuteMembers        int64 = 0x00000400000                     // (1 << 22)	Allows for muting members in a voice channel	V, S
	PermissionVoiceDeafenMembers      int64 = 0x00000800000                     // (1 << 23)	Allows for deafening of members in a voice channel	V, S
	PermissionVoiceMoveMembers        int64 = 0x00001000000                     // (1 << 24)	Allows for moving of members between voice channels	V, S
	PermissionVoiceUseVAD             int64 = 0x00002000000                     // (1 << 25)	Allows for using voice-activity-detection in a voice channel	V
	PermissionChangeNickname          int64 = 0x00004000000                     // (1 << 26)	Allows for modification of own nickname
	PermissionManageNicknames         int64 = 0x00008000000                     // (1 << 27)	Allows for modification of other users nicknames
	PermissionManageRoles             int64 = 0x00010000000                     // (1 << 28)	Allows management and editing of roles	T, V, S
	PermissionManageWebhooks          int64 = 0x00020000000                     // (1 << 29)	Allows management and editing of webhooks	T
	PermissionManageEmojisAndStickers int64 = 0x00040000000                     // (1 << 30)	Allows management and editing of emojis and stickers
	PermissionManageEmojis            int64 = PermissionManageEmojisAndStickers // deprecated: use PermissionManageEmojisAndStickers
	PermissionUseSlashCommands        int64 = PermissionUseApplicationCommands  // deprecated: use PermissionUseApplicationCommands
	PermissionUseApplicationCommands  int64 = 0x00080000000                     // (1 << 31)	Allows members to use slash commands in text channels	T
	PermissionRequestToSpeak          int64 = 0x00100000000                     // (1 << 32)	Allows for requesting to speak in stage channels. (This permission is under active development and may be changed or removed.)	S
	PermissionManageEvents            int64 = 0x00200000000                     // (1 << 33)   Allows for creating, editing, and deleting scheduled events	V, S
	PermissionManageThreads           int64 = 0x00400000000                     // (1 << 34)	Allows for deleting and archiving threads, and viewing all private threads	T
	PermissionUsePublicThreads        int64 = 0x00800000000                     // (1 << 35)	Allows for creating and participating in threads	T
	PermissionUsePrivateThreads       int64 = 0x01000000000                     // (1 << 36)	Allows for creating and participating in private threads	T
	PermissionUseExternalStickers     int64 = 0x02000000000                     // (1 << 37)	Allows the usage of custom stickers from other servers	T
	PermissionSendMessagesInThreads   int64 = 0x04000000000                     // (1 << 38)   Allows for sending messages in threads	T
	PermissionUseEmbeddedActivities   int64 = 0x08000000000                     // (1 << 39)   Allows for using Activities (applications with the EMBEDDED flag) in a voice channel	V
	PermissionModerateMembers         int64 = 0x10000000000                     // (1 << 40)   Allows for timing out users to prevent them from sending or reacting to messages in chat and threads, and from speaking in voice and stage channels

	// all bits set except the leftmost to avoid using negative numbers in case discord dosen't handle it
	PermissionAll int64 = int64(^uint64(0) >> 1)
)
View Source 
const (
	AuditLogActionGuildUpdate = 1

	AuditLogActionChannelCreate          = 10
	AuditLogActionChannelUpdate          = 11
	AuditLogActionChannelDelete          = 12
	AuditLogActionChannelOverwriteCreate = 13
	AuditLogActionChannelOverwriteUpdate = 14
	AuditLogActionChannelOverwriteDelete = 15

	AuditLogActionMemberKick       = 20
	AuditLogActionMemberPrune      = 21
	AuditLogActionMemberBanAdd     = 22
	AuditLogActionMemberBanRemove  = 23
	AuditLogActionMemberUpdate     = 24
	AuditLogActionMemberRoleUpdate = 25

	AuditLogActionRoleCreate = 30
	AuditLogActionRoleUpdate = 31
	AuditLogActionRoleDelete = 32

	AuditLogActionInviteCreate = 40
	AuditLogActionInviteUpdate = 41
	AuditLogActionInviteDelete = 42

	AuditLogActionWebhookCreate = 50
	AuditLogActionWebhookUpdate = 51
	AuditLogActionWebhookDelete = 52

	AuditLogActionEmojiCreate = 60
	AuditLogActionEmojiUpdate = 61
	AuditLogActionEmojiDelete = 62

	AuditLogActionMessageDelete = 72
)

Block contains Discord Audit Log Action Types

View Source 
const (
	ErrCodeUnknownAccount     = 10001
	ErrCodeUnknownApplication = 10002
	ErrCodeUnknownChannel     = 10003
	ErrCodeUnknownGuild       = 10004
	ErrCodeUnknownIntegration = 10005
	ErrCodeUnknownInvite      = 10006
	ErrCodeUnknownMember      = 10007
	ErrCodeUnknownMessage     = 10008
	ErrCodeUnknownOverwrite   = 10009
	ErrCodeUnknownProvider    = 10010
	ErrCodeUnknownRole        = 10011
	ErrCodeUnknownToken       = 10012
	ErrCodeUnknownUser        = 10013
	ErrCodeUnknownEmoji       = 10014
	ErrCodeUnknownWebhook     = 10015

	ErrCodeBotsCannotUseEndpoint  = 20001
	ErrCodeOnlyBotsCanUseEndpoint = 20002

	ErrCodeMaximumGuildsReached     = 30001
	ErrCodeMaximumFriendsReached    = 30002
	ErrCodeMaximumPinsReached       = 30003
	ErrCodeMaximumGuildRolesReached = 30005
	ErrCodeTooManyReactions         = 30010

	ErrCodeUnauthorized = 40001

	ErrCodeMissingAccess                             = 50001
	ErrCodeInvalidAccountType                        = 50002
	ErrCodeCannotExecuteActionOnDMChannel            = 50003
	ErrCodeEmbedCisabled                             = 50004
	ErrCodeCannotEditFromAnotherUser                 = 50005
	ErrCodeCannotSendEmptyMessage                    = 50006
	ErrCodeCannotSendMessagesToThisUser              = 50007
	ErrCodeCannotSendMessagesInVoiceChannel          = 50008
	ErrCodeChannelVerificationLevelTooHigh           = 50009
	ErrCodeOAuth2ApplicationDoesNotHaveBot           = 50010
	ErrCodeOAuth2ApplicationLimitReached             = 50011
	ErrCodeInvalidOAuthState                         = 50012
	ErrCodeMissingPermissions                        = 50013
	ErrCodeInvalidAuthenticationToken                = 50014
	ErrCodeNoteTooLong                               = 50015
	ErrCodeTooFewOrTooManyMessagesToDelete           = 50016
	ErrCodeCanOnlyPinMessageToOriginatingChannel     = 50019
	ErrCodeCannotExecuteActionOnSystemMessage        = 50021
	ErrCodeMessageProvidedTooOldForBulkDelete        = 50034
	ErrCodeInvalidFormBody                           = 50035
	ErrCodeInviteAcceptedToGuildApplicationsBotNotIn = 50036

	ErrCodeReactionBlocked = 90001
)

Block contains Discord JSON Error Response codes

View Source 
const InteractionDeadline = time.Second * 3

InteractionDeadline is the time allowed to respond to an interaction.

View Source 
const MaxIntermediaryBuffersSize = 10000

max size of buffers before they're discarded (e.g after a big incmoing event)

View Source 
const VERSION = "unknown-jonas"

VERSION of DiscordGo, follows Semantic Versioning. (http://semver.org/)

Variables

View Source 
var (
	EndpointStatus     string
	EndpointSm         string
	EndpointSmActive   string
	EndpointSmUpcoming string

	EndpointDiscord    string
	EndpointAPI        string
	EndpointGuilds     string
	EndpointChannels   string
	EndpointUsers      string
	EndpointGateway    string
	EndpointGatewayBot string
	EndpointWebhooks   string

	EndpointCDN             string
	EndpointCDNAttachments  string
	EndpointCDNAvatars      string
	EndpointCDNGuilds       string
	EndpointCDNIcons        string
	EndpointCDNSplashes     string
	EndpointCDNChannelIcons string

	EndpointAuth           string
	EndpointLogin          string
	EndpointLogout         string
	EndpointVerify         string
	EndpointVerifyResend   string
	EndpointForgotPassword string
	EndpointResetPassword  string
	EndpointRegister       string

	EndpointVoice        string
	EndpointVoiceRegions string
	EndpointVoiceIce     string

	EndpointTutorial           string
	EndpointTutorialIndicators string

	EndpointTrack        string
	EndpointSso          string
	EndpointReport       string
	EndpointIntegrations string

	EndpointUser               = func(uID string) string { return "" }
	EndpointUserAvatar         = func(uID int64, aID string) string { return "" }
	EndpointUserAvatarAnimated = func(uID int64, aID string) string { return "" }
	EndpointUserSettings       = func(uID string) string { return "" }
	EndpointUserGuilds         = func(uID string) string { return "" }
	EndpointUserGuild          = func(uID string, gID int64) string { return "" }
	EndpointUserGuildSettings  = func(uID string, gID int64) string { return "" }
	EndpointUserChannels       = func(uID string) string { return "" }
	EndpointUserDevices        = func(uID string) string { return "" }
	EndpointUserConnections    = func(uID string) string { return "" }
	EndpointUserNotes          = func(uID int64) string { return "" }

	EndpointGuild                     = func(gID int64) string { return "" }
	EndpointGuildChannels             = func(gID int64) string { return "" }
	EndpointGuildMembers              = func(gID int64) string { return "" }
	EndpointGuildMember               = func(gID int64, uID int64) string { return "" }
	EndpointGuildMemberAvatar         = func(gID, uID int64, aID string) string { return "" }
	EndpointGuildMemberAvatarAnimated = func(gID, uID int64, aID string) string { return "" }
	EndpointGuildMemberMe             = func(gID int64) string { return "" }
	EndpointGuildMemberRole           = func(gID, uID, rID int64) string {
		return ""
	}
	EndpointGuildBans            = func(gID int64) string { return "" }
	EndpointGuildBan             = func(gID, uID int64) string { return "" }
	EndpointGuildIntegrations    = func(gID int64) string { return "" }
	EndpointGuildIntegration     = func(gID, iID int64) string { return "" }
	EndpointGuildIntegrationSync = func(gID, iID int64) string {
		return ""
	}
	EndpointGuildRoles     = func(gID int64) string { return "" }
	EndpointGuildRole      = func(gID, rID int64) string { return "" }
	EndpointGuildInvites   = func(gID int64) string { return "" }
	EndpointGuildEmbed     = func(gID int64) string { return "" }
	EndpointGuildPrune     = func(gID int64) string { return "" }
	EndpointGuildIcon      = func(gID int64, hash string) string { return "" }
	EndpointGuildSplash    = func(gID int64, hash string) string { return "" }
	EndpointGuildWebhooks  = func(gID int64) string { return "" }
	EndpointGuildAuditLogs = func(gID int64) string { return "" }
	EndpointGuildEmojis    = func(gID int64) string { return "" }
	EndpointGuildEmoji     = func(gID, eID int64) string { return "" }

	EndpointChannel                   = func(cID int64) string { return "" }
	EndpointChannelPermissions        = func(cID int64) string { return "" }
	EndpointChannelPermission         = func(cID, tID int64) string { return "" }
	EndpointChannelInvites            = func(cID int64) string { return "" }
	EndpointChannelTyping             = func(cID int64) string { return "" }
	EndpointChannelMessages           = func(cID int64) string { return "" }
	EndpointChannelMessage            = func(cID, mID int64) string { return "" }
	EndpointChannelMessageAck         = func(cID, mID int64) string { return "" }
	EndpointChannelMessagesBulkDelete = func(cID int64) string { return "" }
	EndpointChannelMessagesPins       = func(cID int64) string { return "" }
	EndpointChannelMessagePin         = func(cID, mID int64) string { return "" }

	EndpointGroupIcon = func(cID int64, hash string) string { return "" }

	EndpointChannelWebhooks = func(cID int64) string { return "" }
	EndpointWebhook         = func(wID int64) string { return "" }
	EndpointWebhookToken    = func(wID int64, token string) string { return "" }

	EndpointDefaultUserAvatar = func(uDiscriminator string) string { return "" }

	EndpointMessageReactionsAll = func(cID, mID int64) string { return "" }
	EndpointMessageReactions    = func(cID, mID int64, emoji EmojiName) string {
		return ""
	}
	EndpointMessageReaction = func(cID, mID int64, emoji EmojiName, uID string) string {
		return ""
	}

	EndpointRelationships       = func() string { return "" }
	EndpointRelationship        = func(uID int64) string { return "" }
	EndpointRelationshipsMutual = func(uID int64) string { return "" }

	EndpointGuildCreate = ""

	EndpointInvite = func(iID string) string { return "" }

	EndpointIntegrationsJoin = func(iID string) string { return "" }

	EndpointEmoji         = func(eID int64) string { return "" }
	EndpointEmojiAnimated = func(eID int64) string { return "" }

	EndpointOauth2          = ""
	EndpointApplications    = ""
	EndpointApplication     = func(aID int64) string { return "" }
	EndpointApplicationMe   = ""
	EndpointApplicationsBot = func(aID int64) string { return "" }

	EndpointApplicationNonOauth2 = func(aID int64) string { return "" }
	EndpointApplicationCommands  = func(aID int64) string { return "" }
	EndpointApplicationCommand   = func(aID int64, cmdID int64) string {
		return ""
	}

	EndpointApplicationGuildCommands = func(aID int64, gID int64) string {
		return ""
	}

	EndpointApplicationGuildCommand = func(aID int64, gID int64, cmdID int64) string {
		return ""
	}

	EndpointApplicationGuildCommandsPermissions = func(aID int64, gID int64) string {
		return ""
	}

	EndpointApplicationGuildCommandPermissions = func(aID int64, gID int64, cmdID int64) string {
		return ""
	}

	EndpointInteractions        = ""
	EndpointInteractionCallback = func(interactionID int64, token string) string {
		return ""
	}
	EndpointWebhookInteraction = func(applicationID int64, token string) string {
		return ""
	}
	EndpointInteractionOriginalMessage = func(applicationID int64, token string) string {
		return ""
	}
	EndpointInteractionFollowupMessage = func(applicationID int64, token string, messageID int64) string {
		return ""
	}
)

Known Discord API Endpoints.

View Source 
var (
	ErrBadAuth        = errors.New("authentication failed")
	ErrInvalidIntent  = errors.New("one of the gateway intents passed was invalid")
	ErrDisabledIntent = errors.New("an intent you specified has not been enabled or not been whitelisted for")
	ErrInvalidShard   = errors.New("you specified a invalid sharding setup")
)
View Source 
var (
	ErrJSONUnmarshal           = errors.New("json unmarshal")
	ErrStatusOffline           = errors.New("You can't set your Status to offline")
	ErrVerificationLevelBounds = errors.New("VerificationLevel out of bounds, should be between 0 and 3")
	ErrPruneDaysBounds         = errors.New("the number of days should be more than or equal to 1")
	ErrGuildNoIcon             = errors.New("guild does not have an icon set")
	ErrGuildNoSplash           = errors.New("guild does not have a splash set")
	ErrUnauthorized            = errors.New("HTTP request was unauthorized. This could be because the provided token was not a bot token. Please add \"Bot \" to the start of your token. https://discordapp.com/developers/docs/reference#authentication-example-bot-token-authorization-header")
	ErrTokenInvalid            = errors.New("Invalid token provided, it has been marked as invalid")
)

All error constants

View Source 
var APIVersion = "10"

APIVersion is the Discord API version used for the REST and Websocket API.

View Source 
var (
	ErrAlreadyOpen = errors.New("connection already open")
)
View Source 
var ErrMFA = errors.New("account has 2FA enabled")

ErrMFA will be risen by New when the user has 2FA.

View Source 
var ErrNilState = errors.New("state not instantiated, please use discordgo.New() or assign Session.State")

ErrNilState is returned when the state is nil.

View Source 
var ErrStateNotFound = errors.New("state cache not found")

ErrStateNotFound is returned when the state cache requested is not found

View Source 
var ErrTimeoutWaitingForVoice = errors.New("timeout waiting for voice")
View Source 
var GatewayLogger func(shardID int, connID int, msgL int, format string, a ...interface{})
View Source 
var Locales = map[Locale]string{
	EnglishUS:    "English (United States)",
	EnglishGB:    "English (Great Britain)",
	Bulgarian:    "Bulgarian",
	ChineseCN:    "Chinese (China)",
	ChineseTW:    "Chinese (Taiwan)",
	Croatian:     "Croatian",
	Czech:        "Czech",
	Danish:       "Danish",
	Dutch:        "Dutch",
	Finnish:      "Finnish",
	French:       "French",
	German:       "German",
	Greek:        "Greek",
	Hindi:        "Hindi",
	Hungarian:    "Hungarian",
	Italian:      "Italian",
	Japanese:     "Japanese",
	Korean:       "Korean",
	Lithuanian:   "Lithuanian",
	Norwegian:    "Norwegian",
	Polish:       "Polish",
	PortugueseBR: "Portuguese (Brazil)",
	Romanian:     "Romanian",
	Russian:      "Russian",
	SpanishES:    "Spanish (Spain)",
	Swedish:      "Swedish",
	Thai:         "Thai",
	Turkish:      "Turkish",
	Ukrainian:    "Ukrainian",
	Vietnamese:   "Vietnamese",
	Unknown:      "unknown",
}

Locales is a map of all the languages codes to their names.

View Source 
var Logger func(msgL, caller int, format string, a ...interface{})

Logger can be used to replace the standard logging for discordgo

Functions

func CheckRetry 

func CheckRetry(_ context.Context, resp *http.Response, err error) (bool, error)

func CreateEndpoints 

func CreateEndpoints(base string)

func DecodeSnowflake 

func DecodeSnowflake(dst *int64, dec *gojay.Decoder) error

func GetEventInterface 

func GetEventInterface(evtType string) interface{}

func IsEmbedEmpty added in v2.3.1 

func IsEmbedEmpty(embed *MessageEmbed) bool

func MemberPermissions 

func MemberPermissions(guild *Guild, channel *Channel, member *Member) (apermissions int64)

Calculates the permissions for a member. https://support.discordapp.com/hc/en-us/articles/206141927-How-is-the-permission-hierarchy-structured-

func MultipartBodyWithJSON added in v2.3.0 

func MultipartBodyWithJSON(data interface{}, files []*File) (requestContentType string, requestBody []byte, err error)

MultipartBodyWithJSON returns the contentType and body for a discord request data : The object to encode for payload_json in the multipart request files : Files to include in the request

func StrID 

func StrID(id int64) string

func VerifyInteraction added in v2.3.0 

func VerifyInteraction(r *http.Request, key ed25519.PublicKey) bool

VerifyInteraction implements message verification of the discord interactions api signing algorithm, as documented here: https://discord.com/developers/docs/interactions/receiving-and-responding#security-and-authorization

Types

type APIErrorMessage 

type APIErrorMessage struct {
	Code    int    `json:"code"`
	Message string `json:"message"`
}

An APIErrorMessage is an api error message returned from discord

type Ack 

type Ack struct {
	Token string `json:"token"`
}

An Ack is used to ack messages

type ActionsRow added in v2.3.0 

type ActionsRow struct {
	Components []MessageComponent `json:"components"`
}

ActionsRow is a container for components within one row.

func (ActionsRow) MarshalJSON added in v2.3.0 

func (r ActionsRow) MarshalJSON() ([]byte, error)

MarshalJSON is a method for marshaling ActionsRow to a JSON object.

func (ActionsRow) Type added in v2.3.0 

func (r ActionsRow) Type() ComponentType

Type is a method to get the type of a component.

func (*ActionsRow) UnmarshalJSON added in v2.3.0 

func (r *ActionsRow) UnmarshalJSON(data []byte) error

UnmarshalJSON is a helper function to unmarshal Actions Row.

type Activities 

type Activities []*Game

func (*Activities) UnmarshalJSONArray 

func (a *Activities) UnmarshalJSONArray(dec *gojay.Decoder) error

type AllowedMentionType 

type AllowedMentionType string
const (
	AllowedMentionTypeRoles    AllowedMentionType = "roles"
	AllowedMentionTypeUsers    AllowedMentionType = "users"
	AllowedMentionTypeEveryone AllowedMentionType = "everyone"
)

type AllowedMentions 

type AllowedMentions struct {
	// Allowed mention types to parse from message content
	Parse []AllowedMentionType `json:"parse"`

	// Slice of role ids to mention
	Roles IDSlice `json:"roles"`

	// Slice of users to mention
	Users IDSlice `json:"users"`

	RepliedUser bool `json:"replied_user"`
}

type Application 

type Application struct {
	ID                  int64     `json:"id,string,omitempty"`
	Name                string    `json:"name"`
	Description         string    `json:"description,omitempty"`
	Icon                string    `json:"icon,omitempty"`
	Secret              string    `json:"secret,omitempty"`
	RedirectURIs        *[]string `json:"redirect_uris,omitempty"`
	BotRequireCodeGrant bool      `json:"bot_require_code_grant,omitempty"`
	BotPublic           bool      `json:"bot_public,omitempty"`
	RPCApplicationState int       `json:"rpc_application_state,omitempty"`
	Flags               int       `json:"flags,omitempty"`
	Owner               *User     `json:"owner"`
	Bot                 *User     `json:"bot"`
}

An Application struct stores values for a Discord OAuth2 Application

Example 
package main

import (
	"log"
	"os"

	"github.com/whoseline/yagpdb/v2/lib/discordgo"
)

func main() {

	// Authentication Token pulled from environment variable DGU_TOKEN
	Token := os.Getenv("DGU_TOKEN")
	if Token == "" {
		return
	}

	// Create a new Discordgo session
	dg, err := discordgo.New(Token)
	if err != nil {
		log.Println(err)
		return
	}

	// Create an new Application
	ap := &discordgo.Application{}
	ap.Name = "TestApp"
	ap.Description = "TestDesc"
	ap, err = dg.ApplicationCreate(ap)
	log.Printf("ApplicationCreate: err: %+v, app: %+v\n", err, ap)

	// Get a specific Application by it's ID
	ap, err = dg.Application(ap.ID)
	log.Printf("Application: err: %+v, app: %+v\n", err, ap)

	// Update an existing Application with new values
	ap.Description = "Whooooa"
	ap, err = dg.ApplicationUpdate(ap.ID, ap)
	log.Printf("ApplicationUpdate: err: %+v, app: %+v\n", err, ap)

	// create a new bot account for this application
	bot, err := dg.ApplicationBotCreate(ap.ID)
	log.Printf("BotCreate: err: %+v, bot: %+v\n", err, bot)

	// Get a list of all applications for the authenticated user
	apps, err := dg.Applications()
	log.Printf("Applications: err: %+v, apps : %+v\n", err, apps)
	for k, v := range apps {
		log.Printf("Applications: %d : %+v\n", k, v)
	}

	// Delete the application we created.
	err = dg.ApplicationDelete(ap.ID)
	log.Printf("Delete: err: %+v\n", err)
}

Output:

type ApplicationCommand 

type ApplicationCommand struct {
	ID                int64                  `json:"id,string,omitempty"`
	ApplicationID     int64                  `json:"application_id,string,omitempty"`
	Version           string                 `json:"version,omitempty"`
	Type              ApplicationCommandType `json:"type,omitempty"`
	Name              string                 `json:"name"`
	NameLocalizations *map[Locale]string     `json:"name_localizations,omitempty"`
	DefaultPermission *bool                  `json:"default_permission,omitempty"`

	Description              string                      `json:"description,omitempty"`
	DescriptionLocalizations *map[Locale]string          `json:"description_localizations,omitempty"`
	Options                  []*ApplicationCommandOption `json:"options"`
	NSFW                     bool                        `json:"nsfw,omitempty"`
}

ApplicationCommand represents an application's slash command.

type ApplicationCommandCreate 

type ApplicationCommandCreate struct {
	GuildID int64 `json:"guild_id,string"`
	ApplicationCommand
}

new Slash Command was created

type ApplicationCommandDelete 

type ApplicationCommandDelete struct {
	GuildID int64 `json:"guild_id,string"`
	ApplicationCommand
}

Slash Command was deleted

type ApplicationCommandInteractionData 

type ApplicationCommandInteractionData struct {
	ID       int64                                      `json:"id,string"`
	Name     string                                     `json:"name"`
	Resolved *ApplicationCommandInteractionDataResolved `json:"resolved"`

	// Slash command options
	Options []*ApplicationCommandInteractionDataOption `json:"options"`
	// Target (user/message) id on which context menu command was called.
	// The details are stored in Resolved according to command type.
	TargetID int64 `json:"target_id,string"`
}

ApplicationCommandInteractionData contains the data of application command interaction.

func (ApplicationCommandInteractionData) Type added in v2.3.0 

func (ApplicationCommandInteractionData) Type() InteractionType

Type returns the type of interaction data.

type ApplicationCommandInteractionDataOption 

type ApplicationCommandInteractionDataOption struct {
	Name string                       `json:"name"`
	Type ApplicationCommandOptionType `json:"type"`
	// NOTE: Contains the value specified by Type.
	Value   interface{}                                `json:"value,omitempty"`
	Options []*ApplicationCommandInteractionDataOption `json:"options,omitempty"`

	// NOTE: autocomplete interaction only.
	Focused bool `json:"focused,omitempty"`
}

ApplicationCommandInteractionDataOption represents an option of a slash command.

func (ApplicationCommandInteractionDataOption) BoolValue added in v2.3.0 

func (o ApplicationCommandInteractionDataOption) BoolValue() bool

BoolValue is a utility function for casting option value to bool

func (ApplicationCommandInteractionDataOption) ChannelValue added in v2.3.0 

func (o ApplicationCommandInteractionDataOption) ChannelValue(s *Session) *Channel

ChannelValue is a utility function for casting option value to channel object. s : Session object, if not nil, function additionally fetches all channel's data

func (ApplicationCommandInteractionDataOption) FloatValue added in v2.3.0 

func (o ApplicationCommandInteractionDataOption) FloatValue() float64

FloatValue is a utility function for casting option value to float

func (ApplicationCommandInteractionDataOption) IntValue added in v2.3.0 

func (o ApplicationCommandInteractionDataOption) IntValue() int64

IntValue is a utility function for casting option value to integer

func (ApplicationCommandInteractionDataOption) RoleValue added in v2.3.0 

func (o ApplicationCommandInteractionDataOption) RoleValue(s *Session, gID int64) *Role

RoleValue is a utility function for casting option value to role object. s : Session object, if not nil, function additionally fetches all role's data

func (ApplicationCommandInteractionDataOption) StringValue added in v2.3.0 

func (o ApplicationCommandInteractionDataOption) StringValue() string

StringValue is a utility function for casting option value to string

func (ApplicationCommandInteractionDataOption) UintValue added in v2.3.0 

func (o ApplicationCommandInteractionDataOption) UintValue() uint64

UintValue is a utility function for casting option value to unsigned integer

func (*ApplicationCommandInteractionDataOption) UnmarshalJSON 

func (a *ApplicationCommandInteractionDataOption) UnmarshalJSON(b []byte) error

func (ApplicationCommandInteractionDataOption) UserValue added in v2.3.0 

func (o ApplicationCommandInteractionDataOption) UserValue(s *Session) *User

UserValue is a utility function for casting option value to user object. s : Session object, if not nil, function additionally fetches all user's data

type ApplicationCommandInteractionDataResolved 

type ApplicationCommandInteractionDataResolved struct {
	Users       map[int64]*User              `json:"users"`
	Members     map[int64]*Member            `json:"members"`
	Roles       map[int64]*Role              `json:"roles"`
	Channels    map[int64]*Channel           `json:"channels"`
	Messages    map[int64]*Message           `json:"messages"`
	Attachments map[int64]*MessageAttachment `json:"attachments"`
}

ApplicationCommandInteractionDataResolved contains resolved data of command execution. Partial Member objects are missing user, deaf and mute fields. Partial Channel objects only have id, name, type and permissions fields.

func (*ApplicationCommandInteractionDataResolved) UnmarshalJSON 

func (a *ApplicationCommandInteractionDataResolved) UnmarshalJSON(b []byte) error

type ApplicationCommandOption 

type ApplicationCommandOption struct {
	Type                     ApplicationCommandOptionType `json:"type"`
	Name                     string                       `json:"name"`
	NameLocalizations        map[Locale]string            `json:"name_localizations,omitempty"`
	Description              string                       `json:"description,omitempty"`
	DescriptionLocalizations map[Locale]string            `json:"description_localizations,omitempty"`

	ChannelTypes []ChannelType               `json:"channel_types"`
	Required     bool                        `json:"required"`
	Options      []*ApplicationCommandOption `json:"options"`

	// NOTE: mutually exclusive with Choices.
	Autocomplete bool                              `json:"autocomplete"`
	Choices      []*ApplicationCommandOptionChoice `json:"choices"`
	// Minimal value of number/integer option.
	MinValue *float64 `json:"min_value,omitempty"`
	// Maximum value of number/integer option.
	MaxValue float64 `json:"max_value,omitempty"`
}

ApplicationCommandOption represents an option/subcommand/subcommands group.

type ApplicationCommandOptionChoice 

type ApplicationCommandOptionChoice struct {
	Name              string            `json:"name"`
	NameLocalizations map[Locale]string `json:"name_localizations,omitempty"`
	Value             interface{}       `json:"value"`
}

ApplicationCommandOptionChoice represents a slash command option choice.

type ApplicationCommandOptionType 

type ApplicationCommandOptionType uint8

ApplicationCommandOptionType indicates the type of a slash command's option. 

const (
	ApplicationCommandOptionSubCommand      ApplicationCommandOptionType = 1
	ApplicationCommandOptionSubCommandGroup ApplicationCommandOptionType = 2
	ApplicationCommandOptionString          ApplicationCommandOptionType = 3
	ApplicationCommandOptionInteger         ApplicationCommandOptionType = 4
	ApplicationCommandOptionBoolean         ApplicationCommandOptionType = 5
	ApplicationCommandOptionUser            ApplicationCommandOptionType = 6
	ApplicationCommandOptionChannel         ApplicationCommandOptionType = 7
	ApplicationCommandOptionRole            ApplicationCommandOptionType = 8
	ApplicationCommandOptionMentionable     ApplicationCommandOptionType = 9
	ApplicationCommandOptionNumber          ApplicationCommandOptionType = 10
	ApplicationCommandOptionAttachment      ApplicationCommandOptionType = 11
)

Application command option types.

func (ApplicationCommandOptionType) String added in v2.3.0 

func (t ApplicationCommandOptionType) String() string

type ApplicationCommandPermissionType 

type ApplicationCommandPermissionType uint8

ApplicationCommandPermissionType indicates whether a permission is user or role based. 

const (
	ApplicationCommandPermissionTypeRole ApplicationCommandPermissionType = 1
	ApplicationCommandPermissionTypeUser ApplicationCommandPermissionType = 2
)

Application command permission types.

type ApplicationCommandPermissions 

type ApplicationCommandPermissions struct {
	ID         int64                            `json:"id,string"`
	Type       ApplicationCommandPermissionType `json:"type"`
	Permission bool                             `json:"permission"`
}

ApplicationCommandPermissions represents a single user or role permission for a command.

type ApplicationCommandPermissionsList added in v2.3.0 

type ApplicationCommandPermissionsList struct {
	Permissions []*ApplicationCommandPermissions `json:"permissions"`
}

ApplicationCommandPermissionsList represents a list of ApplicationCommandPermissions, needed for serializing to JSON.

type ApplicationCommandType added in v2.3.0 

type ApplicationCommandType uint8

ApplicationCommandType represents the type of application command. 

const (
	// ChatApplicationCommand is default command type. They are slash commands (i.e. called directly from the chat).
	ChatApplicationCommand ApplicationCommandType = 1
	// UserApplicationCommand adds command to user context menu.
	UserApplicationCommand ApplicationCommandType = 2
	// MessageApplicationCommand adds command to message context menu.
	MessageApplicationCommand ApplicationCommandType = 3
)

Application command types

type ApplicationCommandUpdate 

type ApplicationCommandUpdate struct {
	GuildID int64 `json:"guild_id,string"`
	ApplicationCommand
}

Slash Command was updated

type Assets 

type Assets struct {
	LargeImageID string `json:"large_image,omitempty"`
	SmallImageID string `json:"small_image,omitempty"`
	LargeText    string `json:"large_text,omitempty"`
	SmallText    string `json:"small_text,omitempty"`
}

An Assets struct contains assets and labels used in the rich presence "playing .." Game

type AuditLogEntry 

type AuditLogEntry struct {
	TargetID int64 `json:"target_id,string"`
	Changes  []struct {
		NewValue interface{} `json:"new_value"`
		OldValue interface{} `json:"old_value"`
		Key      string      `json:"key"`
	} `json:"changes,omitempty"`
	UserID     int64 `json:"user_id,string"`
	ID         int64 `json:"id,string"`
	ActionType int   `json:"action_type"`
	Options    struct {
		DeleteMembersDay string `json:"delete_member_days"`
		MembersRemoved   string `json:"members_removed"`
		ChannelID        int64  `json:"channel_id,string"`
		Count            string `json:"count"`
		ID               int64  `json:"id,string"`
		Type             string `json:"type"`
		RoleName         string `json:"role_name"`
	} `json:"options,omitempty"`
	Reason string `json:"reason"`
}

type Bucket 

type Bucket struct {
	sync.Mutex
	Key       string
	Remaining int

	Userdata interface{}
	// contains filtered or unexported fields
}

Bucket represents a ratelimit bucket, each bucket gets ratelimited individually (-global ratelimits)

func (*Bucket) Release 

func (b *Bucket) Release(headers http.Header, lockCounter int64) error

Release unlocks the bucket and reads the headers to update the buckets ratelimit info and locks up the whole thing in case if there's a global ratelimit.

type Button added in v2.3.0 

type Button struct {
	Label    string         `json:"label"`
	Style    ButtonStyle    `json:"style"`
	Disabled bool           `json:"disabled"`
	Emoji    ComponentEmoji `json:"emoji"`

	// NOTE: Only button with LinkButton style can have link. Also, URL is mutually exclusive with CustomID.
	URL      string `json:"url,omitempty"`
	CustomID string `json:"custom_id,omitempty"`
}

Button represents button component.

func (Button) MarshalJSON added in v2.3.0 

func (b Button) MarshalJSON() ([]byte, error)

MarshalJSON is a method for marshaling Button to a JSON object.

func (Button) Type added in v2.3.0 

func (Button) Type() ComponentType

Type is a method to get the type of a component.

type ButtonStyle added in v2.3.0 

type ButtonStyle uint

ButtonStyle is style of button. 

const (
	// PrimaryButton is a button with blurple color.
	PrimaryButton ButtonStyle = 1
	// SecondaryButton is a button with grey color.
	SecondaryButton ButtonStyle = 2
	// SuccessButton is a button with green color.
	SuccessButton ButtonStyle = 3
	// DangerButton is a button with red color.
	DangerButton ButtonStyle = 4
	// LinkButton is a special type of button which navigates to a URL. Has grey color.
	LinkButton ButtonStyle = 5
)

Button styles.

type Channel 

type Channel struct {
	// The ID of the channel.
	ID int64 `json:"id,string"`

	// The ID of the guild to which the channel belongs, if it is in a guild.
	// Else, this ID is empty (e.g. DM channels).
	GuildID int64 `json:"guild_id,string"`

	// The name of the channel.
	Name string `json:"name"`

	// The topic of the channel.
	Topic string `json:"topic"`

	// The type of the channel.
	Type ChannelType `json:"type"`

	// The ID of the last message sent in the channel. This is not
	// guaranteed to be an ID of a valid message.
	LastMessageID int64 `json:"last_message_id,string"`

	// Whether the channel is marked as NSFW.
	NSFW bool `json:"nsfw"`

	// Icon of the group DM channel.
	Icon string `json:"icon"`

	// The position of the channel, used for sorting in client.
	Position int `json:"position"`

	// The bitrate of the channel, if it is a voice channel.
	Bitrate int `json:"bitrate"`

	// The recipients of the channel. This is only populated in DM channels.
	Recipients []*User `json:"recipients"`

	// The messages in the channel. This is only present in state-cached channels,
	// and State.MaxMessageCount must be non-zero.
	Messages []*Message `json:"-"`

	// A list of permission overwrites present for the channel.
	PermissionOverwrites []*PermissionOverwrite `json:"permission_overwrites"`

	// The user limit of the voice channel.
	UserLimit int `json:"user_limit"`

	// The ID of the parent channel, if the channel is under a category
	ParentID int64 `json:"parent_id,string"`

	RateLimitPerUser int `json:"rate_limit_per_user"`

	ThreadMetadata *ThreadMetadata `json:"thread_metadata"`
}

A Channel holds all data related to an individual Discord channel.

func (*Channel) GetChannelID 

func (c *Channel) GetChannelID() int64

func (*Channel) GetGuildID 

func (c *Channel) GetGuildID() int64

func (*Channel) Mention 

func (c *Channel) Mention() string

Mention returns a string which mentions the channel

type ChannelCreate 

type ChannelCreate struct {
	*Channel
}

ChannelCreate is the data for a ChannelCreate event.

type ChannelDelete 

type ChannelDelete struct {
	*Channel
}

ChannelDelete is the data for a ChannelDelete event.

type ChannelEdit 

type ChannelEdit struct {
	Name                 string                 `json:"name,omitempty"`
	Topic                string                 `json:"topic,omitempty"`
	NSFW                 bool                   `json:"nsfw,omitempty"`
	Position             *int                   `json:"position,omitempty"`
	Bitrate              int                    `json:"bitrate,omitempty"`
	UserLimit            int                    `json:"user_limit,omitempty"`
	PermissionOverwrites []*PermissionOverwrite `json:"permission_overwrites,omitempty"`
	ParentID             *null.String           `json:"parent_id,omitempty"`
	RateLimitPerUser     *int                   `json:"rate_limit_per_user,omitempty"`
}

A ChannelEdit holds Channel Feild data for a channel edit.

type ChannelEvent 

type ChannelEvent interface {
	GetChannelID() int64
}

type ChannelPinsUpdate 

type ChannelPinsUpdate struct {
	LastPinTimestamp string `json:"last_pin_timestamp"`
	ChannelID        int64  `json:"channel_id,string"`
	GuildID          int64  `json:"guild_id,string,omitempty"`
}

ChannelPinsUpdate stores data for a ChannelPinsUpdate event.

func (*ChannelPinsUpdate) GetChannelID 

func (cp *ChannelPinsUpdate) GetChannelID() int64

func (*ChannelPinsUpdate) GetGuildID 

func (cp *ChannelPinsUpdate) GetGuildID() int64

type ChannelType 

type ChannelType int

ChannelType is the type of a Channel 

const (
	ChannelTypeGuildText          ChannelType = 0  // a text channel within a server
	ChannelTypeDM                 ChannelType = 1  // a direct message between users
	ChannelTypeGuildVoice         ChannelType = 2  // a voice channel within a server
	ChannelTypeGroupDM            ChannelType = 3  // a direct message between multiple users
	ChannelTypeGuildCategory      ChannelType = 4  // an organizational category that contains up to 50 channels
	ChannelTypeGuildNews          ChannelType = 5  // a channel that users can follow and crosspost into their own server
	ChannelTypeGuildStore         ChannelType = 6  // a channel in which game developers can sell their game on Discord
	ChannelTypeGuildNewsThread    ChannelType = 10 // a temporary sub-channel within a GUILD_NEWS channel
	ChannelTypeGuildPublicThread  ChannelType = 11 // a temporary sub-channel within a GUILD_TEXT channel
	ChannelTypeGuildPrivateThread ChannelType = 12 // a temporary sub-channel within a GUILD_TEXT channel that is only viewable by those invited and those with the MANAGE_THREADS permission
	ChannelTypeGuildStageVoice    ChannelType = 13 // a voice channel for hosting events with an audience
	ChannelTypeGuildForum         ChannelType = 15 // a channel that can only contain threads
)

Block contains known ChannelType values

func (ChannelType) IsThread 

func (t ChannelType) IsThread() bool

type ChannelUpdate 

type ChannelUpdate struct {
	*Channel
}

ChannelUpdate is the data for a ChannelUpdate event.

type ComponentEmoji added in v2.3.0 

type ComponentEmoji struct {
	Name     string `json:"name,omitempty"`
	ID       int64  `json:"id,string,omitempty"`
	Animated bool   `json:"animated,omitempty"`
}

ComponentEmoji represents button emoji, if it does have one.

type ComponentType added in v2.3.0 

type ComponentType uint

ComponentType is type of component. 

const (
	ActionsRowComponent ComponentType = 1
	ButtonComponent     ComponentType = 2
	SelectMenuComponent ComponentType = 3
	TextInputComponent  ComponentType = 4
)

MessageComponent types.

type Connect 

type Connect struct{}

Connect is the data for a Connect event. This is a sythetic event and is not dispatched by Discord.

type CreateApplicationCommandRequest 

type CreateApplicationCommandRequest struct {
	Name              string                      `json:"name"`                         // 1-32 character name matching ^[\w-]{1,32}$
	Description       string                      `json:"description"`                  // 1-100 character description
	Options           []*ApplicationCommandOption `json:"options"`                      // the parameters for the command
	DefaultPermission *bool                       `json:"default_permission,omitempty"` // (default true)	whether the command is enabled by default when the app is added to a guild
	NSFW              bool                        `json:"nsfw,omitempty"`               // marks a command as age-restricted
}

type CtxKey 

type CtxKey int
const (
	CtxKeyRatelimitBucket CtxKey = iota
)

type Disconnect 

type Disconnect struct{}

Disconnect is the data for a Disconnect event. This is a sythetic event and is not dispatched by Discord.

type DiscordFloat 

type DiscordFloat float64

Discord is super inconsistent with with types in some places (especially presence updates, might aswell change them to map[string]interface{} soon because there is 0 validation)

func (*DiscordFloat) UnmarshalJSON 

func (df *DiscordFloat) UnmarshalJSON(data []byte) error

type DiscordInt64 

type DiscordInt64 int64

func (*DiscordInt64) UnmarshalJSON 

func (di *DiscordInt64) UnmarshalJSON(data []byte) error

type EditApplicationCommandRequest 

type EditApplicationCommandRequest struct {
	Name              *string                      `json:"name,omitempty"`               //	1-32 character name matching ^[\w-]{1,32}$
	Description       *string                      `json:"description,omitempty"`        //	1-100 character description
	Options           *[]*ApplicationCommandOption `json:"options,omitempty"`            // the parameters for the command
	DefaultPermission *bool                        `json:"default_permission,omitempty"` // (default true)	whether the command is enabled by default when the app is added to a guild
}

type Emoji 

type Emoji struct {
	ID            int64   `json:"id,string"`
	Name          string  `json:"name"`
	Roles         IDSlice `json:"roles,string"`
	Managed       bool    `json:"managed"`
	RequireColons bool    `json:"require_colons"`
	Animated      bool    `json:"animated"`
}

Emoji struct holds data related to Emoji's

func (*Emoji) APIName 

func (e *Emoji) APIName() string

APIName returns an correctly formatted API name for use in the MessageReactions endpoints.

func (*Emoji) MessageFormat 

func (e *Emoji) MessageFormat() string

MessageFormat returns a correctly formatted Emoji for use in Message content and embeds

type EmojiName 

type EmojiName struct {
	// contains filtered or unexported fields
}

func (EmojiName) String 

func (emoji EmojiName) String() string

type Event 

type Event struct {
	Operation GatewayOP          `json:"op"`
	Sequence  int64              `json:"s"`
	Type      string             `json:"t"`
	RawData   gojay.EmbeddedJSON `json:"d"`
	// Struct contains one of the other types in this file.
	Struct interface{} `json:"-"`
}

Event provides a basic initial struct for all websocket events.

func (*Event) NKeys 

func (evt *Event) NKeys() int

func (*Event) UnmarshalJSONObject 

func (evt *Event) UnmarshalJSONObject(dec *gojay.Decoder, key string) error

implement gojay.UnmarshalerJSONObject

type EventHandler 

type EventHandler interface {
	// Type returns the type of event this handler belongs to.
	Type() string

	// Handle is called whenever an event of Type() happens.
	// It is the receivers responsibility to type assert that the interface
	// is the expected struct.
	Handle(*Session, interface{})
}

EventHandler is an interface for Discord events.

type EventInterfaceProvider 

type EventInterfaceProvider interface {
	// Type is the type of event this handler belongs to.
	Type() string

	// New returns a new instance of the struct this event handler handles.
	// This is called once per event.
	// The struct is provided to all handlers of the same Type().
	New() interface{}
}

EventInterfaceProvider is an interface for providing empty interfaces for Discord events.

type ExplicitContentFilterLevel 

type ExplicitContentFilterLevel int

ExplicitContentFilterLevel type definition 

const (
	ExplicitContentFilterDisabled ExplicitContentFilterLevel = iota
	ExplicitContentFilterMembersWithoutRoles
	ExplicitContentFilterAllMembers
)

Constants for ExplicitContentFilterLevel levels from 0 to 2 inclusive

type File 

type File struct {
	Name        string
	ContentType string
	Reader      io.Reader
}

File stores info about files you e.g. send in messages.

type FriendSourceFlags 

type FriendSourceFlags struct {
	All           bool `json:"all"`
	MutualGuilds  bool `json:"mutual_guilds"`
	MutualFriends bool `json:"mutual_friends"`
}

FriendSourceFlags stores ... TODO :)

type Game 

type Game struct {
	Name          string     `json:"name"`
	Type          GameType   `json:"type"`
	URL           string     `json:"url,omitempty"`
	Details       string     `json:"details,omitempty"`
	State         string     `json:"state,omitempty"`
	TimeStamps    TimeStamps `json:"timestamps,omitempty"`
	Assets        Assets     `json:"assets,omitempty"`
	ApplicationID string     `json:"application_id,omitempty"`
	Instance      int8       `json:"instance,omitempty"`
}

A Game struct holds the name of the "playing .." game for a user

func (*Game) NKeys 

func (g *Game) NKeys() int

func (*Game) UnmarshalJSONObject 

func (g *Game) UnmarshalJSONObject(dec *gojay.Decoder, key string) error

implement gojay.UnmarshalerJSONObject

type GameType 

type GameType int

GameType is the type of "game" (see GameType* consts) in the Game struct 

const (
	GameTypeGame GameType = iota
	GameTypeStreaming
	GameTypeListening
	GameTypeWatching
)

Valid GameType values

type GatewayBotResponse 

type GatewayBotResponse struct {
	URL               string            `json:"url"`
	Shards            int               `json:"shards"`
	SessionStartLimit SessionStartLimit `json:"session_start_limit"`
}

GatewayBotResponse stores the data for the gateway/bot response

type GatewayConnection 

type GatewayConnection struct {
	// contains filtered or unexported fields
}

func NewGatewayConnection 

func NewGatewayConnection(parent *GatewayConnectionManager, id int, intents []GatewayIntent) *GatewayConnection

func (*GatewayConnection) Close 

func (g *GatewayConnection) Close() error

Close closes the gateway connection

func (*GatewayConnection) Reconnect 

func (g *GatewayConnection) Reconnect(forceReIdentify bool) error

Reconnect is a helper for Close() and Connect() and will attempt to resume if possible

func (*GatewayConnection) ReconnectUnlessClosed 

func (g *GatewayConnection) ReconnectUnlessClosed(forceReIdentify bool) error

ReconnectUnlessStopped will not reconnect if close was called earlier

func (*GatewayConnection) RequestGuildMembers 

func (g *GatewayConnection) RequestGuildMembers(d *RequestGuildMembersData)

func (*GatewayConnection) Status 

func (g *GatewayConnection) Status() (st GatewayStatus)

Status returns the current status of the connection

func (*GatewayConnection) UpdateStatusComplex 

func (g *GatewayConnection) UpdateStatusComplex(usd UpdateStatusData)

UpdateStatusComplex allows for sending the raw status update data untouched by discordgo.

type GatewayConnectionManager 

type GatewayConnectionManager struct {
	// contains filtered or unexported fields
}

GatewayConnectionManager is responsible for managing the gateway connections for a single shard We create a new GatewayConnection every time we reconnect to avoid a lot of synchronization needs and also to avoid having to manually reset the connection state, all the workers related to the old connection should eventually stop, and if they're late they will be working on a closed connection anyways so it dosen't matter

func (*GatewayConnectionManager) ChannelVoiceJoin 

func (g *GatewayConnectionManager) ChannelVoiceJoin(gID, cID int64, mute, deaf bool) (voice *VoiceConnection, err error)

ChannelVoiceJoin joins the session user to a voice channel. 

gID     : Guild ID of the channel to join.
cID     : Channel ID of the channel to join.
mute    : If true, you will be set to muted upon joining.
deaf    : If true, you will be set to deafened upon joining.

func (*GatewayConnectionManager) ChannelVoiceLeave 

func (g *GatewayConnectionManager) ChannelVoiceLeave(gID int64)

func (*GatewayConnectionManager) Close 

func (g *GatewayConnectionManager) Close() (err error)

func (*GatewayConnectionManager) GetCurrentConnection 

func (g *GatewayConnectionManager) GetCurrentConnection() *GatewayConnection

func (*GatewayConnectionManager) GetSessionInfo 

func (s *GatewayConnectionManager) GetSessionInfo() (sessionID string, sequence int64, resumeGatewayUrl string)

func (*GatewayConnectionManager) HeartBeatStats 

func (g *GatewayConnectionManager) HeartBeatStats() (lastSend time.Time, lastAck time.Time)

func (*GatewayConnectionManager) Open 

func (g *GatewayConnectionManager) Open() error

func (*GatewayConnectionManager) Reconnect 

func (g *GatewayConnectionManager) Reconnect(forceIdentify bool) error

func (*GatewayConnectionManager) RequestGuildMemberByID 

func (g *GatewayConnectionManager) RequestGuildMemberByID(guildID int64, query int64, limit int)

func (*GatewayConnectionManager) RequestGuildMembers 

func (g *GatewayConnectionManager) RequestGuildMembers(guildID int64, query string, limit int)

func (*GatewayConnectionManager) RequestGuildMembersComplex 

func (g *GatewayConnectionManager) RequestGuildMembersComplex(d *RequestGuildMembersData)

func (*GatewayConnectionManager) SetSessionInfo 

func (s *GatewayConnectionManager) SetSessionInfo(sessionID string, sequence int64, resumeGatewayUrl string)

func (*GatewayConnectionManager) Status 

func (g *GatewayConnectionManager) Status() GatewayStatus

Status returns the status of the current active connection

type GatewayIdentifyRatelimiter 

type GatewayIdentifyRatelimiter interface {
	RatelimitIdentify(shardID int) // Called whenever an attempted identify is made, can be called from multiple goroutines at the same time
}

GatewayIdentifyRatelimiter is if you need some custom identify ratelimit logic (if you're running shards across processes for example) 

var IdentifyRatelimiter GatewayIdentifyRatelimiter = &StdGatewayIdentifyRatleimiter{}

This is used at the package level because it can be used by multiple sessions !! Changing this after starting 1 or more gateway sessions will lead to undefined behaviour

type GatewayIntent 

type GatewayIntent int
const (
	GatewayIntentGuilds GatewayIntent = 1 << 0

	GatewayIntentGuildMembers GatewayIntent = 1 << 1

	GatewayIntentGuildBans GatewayIntent = 1 << 2

	GatewayIntentGuildEmojis GatewayIntent = 1 << 3

	GatewayIntentGuildIntegrations GatewayIntent = 1 << 4

	GatewayIntentGuildWebhooks GatewayIntent = 1 << 5

	GatewayIntentGuildInvites GatewayIntent = 1 << 6

	GatewayIntentGuildVoiceStates GatewayIntent = 1 << 7

	GatewayIntentGuildPresences GatewayIntent = 1 << 8

	GatewayIntentGuildMessages GatewayIntent = 1 << 9

	GatewayIntentGuildMessageReactions GatewayIntent = 1 << 10

	GatewayIntentGuildMessageTyping GatewayIntent = 1 << 11

	GatewayIntentDirectMessages GatewayIntent = 1 << 12

	GatewayIntentDirectMessageReactions GatewayIntent = 1 << 13

	GatewayIntentDirectMessageTyping GatewayIntent = 1 << 14
	// - TYPING_START
	GatewayIntentMessageContent GatewayIntent = 1 << 15

	GatewayIntentGuildScheduledEvents GatewayIntent = 1 << 16
)

type GatewayOP 

type GatewayOP int

GatewayOP represents a gateway operation see https://discordapp.com/developers/docs/topics/gateway#gateway-opcodespayloads-gateway-opcodes 

const (
	GatewayOPDispatch            GatewayOP = 0  // (Receive)
	GatewayOPHeartbeat           GatewayOP = 1  // (Send/Receive)
	GatewayOPIdentify            GatewayOP = 2  // (Send)
	GatewayOPStatusUpdate        GatewayOP = 3  // (Send)
	GatewayOPVoiceStateUpdate    GatewayOP = 4  // (Send)
	GatewayOPVoiceServerPing     GatewayOP = 5  // (Send)
	GatewayOPResume              GatewayOP = 6  // (Send)
	GatewayOPReconnect           GatewayOP = 7  // (Receive)
	GatewayOPRequestGuildMembers GatewayOP = 8  // (Send)
	GatewayOPInvalidSession      GatewayOP = 9  // (Receive)
	GatewayOPHello               GatewayOP = 10 // (Receive)
	GatewayOPHeartbeatACK        GatewayOP = 11 // (Receive)
)

type GatewayStatus 

type GatewayStatus int
const (
	GatewayStatusDisconnected GatewayStatus = iota
	GatewayStatusConnecting
	GatewayStatusIdentifying
	GatewayStatusResuming
	GatewayStatusReady
)

func (GatewayStatus) String 

func (gs GatewayStatus) String() string

type Guild 

type Guild struct {
	// The ID of the guild.
	ID int64 `json:"id,string"`

	// The name of the guild. (2–100 characters)
	Name string `json:"name"`

	Description string `json:"description"`

	PreferredLocale string `json:"preferred_locale"`

	// The hash of the guild's icon. Use Session.GuildIcon
	// to retrieve the icon itself.
	Icon string `json:"icon"`

	// The voice region of the guild.
	Region string `json:"region"`

	// The ID of the AFK voice channel.
	AfkChannelID int64 `json:"afk_channel_id,string"`

	// The user ID of the owner of the guild.
	OwnerID int64 `json:"owner_id,string"`

	// The time at which the current user joined the guild.
	// This field is only present in GUILD_CREATE events and websocket
	// update events, and thus is only present in state-cached guilds.
	JoinedAt Timestamp `json:"joined_at"`

	// The hash of the guild's splash.
	Splash string `json:"splash"`

	// The timeout, in seconds, before a user is considered AFK in voice.
	AfkTimeout int `json:"afk_timeout"`

	// The number of members in the guild.
	// This field is only present in GUILD_CREATE events and websocket
	// update events, and thus is only present in state-cached guilds.
	MemberCount int `json:"member_count"`

	// The verification level required for the guild.
	VerificationLevel VerificationLevel `json:"verification_level"`

	// Whether the guild is considered large. This is
	// determined by a member threshold in the identify packet,
	// and is currently hard-coded at 250 members in the library.
	Large bool `json:"large"`

	// The default message notification setting for the guild.
	// 0 == all messages, 1 == mentions only.
	DefaultMessageNotifications int `json:"default_message_notifications"`

	// A list of roles in the guild.
	Roles []*Role `json:"roles"`

	// A list of the custom emojis present in the guild.
	Emojis []*Emoji `json:"emojis"`

	// A list of the members in the guild.
	// This field is only present in GUILD_CREATE events and websocket
	// update events, and thus is only present in state-cached guilds.
	Members []*Member `json:"members"`

	// A list of partial presence objects for members in the guild.
	// This field is only present in GUILD_CREATE events and websocket
	// update events, and thus is only present in state-cached guilds.
	Presences []*Presence `json:"presences"`

	// A list of channels in the guild.
	// This field is only present in GUILD_CREATE events
	Channels []*Channel `json:"channels"`

	// All active threads in the guild that current user has permission to view
	// This field is only present in GUILD_CREATE events
	Threads []*Channel `json:"threads"`

	// A list of voice states for the guild.
	// This field is only present in GUILD_CREATE events and websocket
	// update events, and thus is only present in state-cached guilds.
	VoiceStates  []*VoiceState `json:"voice_states"`
	MaxPresences int           `json:"max_presences"`
	MaxMembers   int           `json:"max_members"`

	// Whether this guild is currently unavailable (most likely due to outage).
	// This field is only present in GUILD_CREATE events and websocket
	// update events, and thus is only present in state-cached guilds.
	Unavailable bool `json:"unavailable"`

	// The explicit content filter level
	ExplicitContentFilter ExplicitContentFilterLevel `json:"explicit_content_filter"`

	// The list of enabled guild features
	Features []string `json:"features"`

	// Required MFA level for the guild
	MfaLevel MfaLevel `json:"mfa_level"`

	// Whether or not the Server Widget is enabled
	WidgetEnabled bool `json:"widget_enabled"`

	// The Channel ID for the Server Widget
	WidgetChannelID string `json:"widget_channel_id"`

	// The Channel ID to which system messages are sent (eg join and leave messages)
	SystemChannelID string `json:"system_channel_id"`

	ApproximateMemberCount   int `json:"approximate_member_count"`
	ApproximatePresenceCount int `json:"approximate_presence_count"`
}

A Guild holds all data related to a specific Discord Guild. Guilds are also sometimes referred to as Servers in the Discord client.

func (*Guild) Channel 

func (g *Guild) Channel(id int64) *Channel

func (*Guild) GetGuildID 

func (g *Guild) GetGuildID() int64

func (*Guild) Role 

func (g *Guild) Role(id int64) *Role

type GuildApplicationCommandPermissions 

type GuildApplicationCommandPermissions struct {
	ID            int64                            `json:"id,string"`
	ApplicationID int64                            `json:"application_id,string"`
	GuildID       int64                            `json:"guild_id,string"`
	Permissions   []*ApplicationCommandPermissions `json:"permissions"`
}

GuildApplicationCommandPermissions represents all permissions for a single guild command.

type GuildAuditLog 

type GuildAuditLog struct {
	Webhooks []struct {
		ChannelID int64  `json:"channel_id,string"`
		GuildID   int64  `json:"guild_id,string"`
		ID        string `json:"id"`
		Avatar    string `json:"avatar"`
		Name      string `json:"name"`
	} `json:"webhooks,omitempty"`
	Users           []*User          `json:"users,omitempty"`
	AuditLogEntries []*AuditLogEntry `json:"audit_log_entries"`
}

A GuildAuditLog stores data for a guild audit log.

type GuildBan 

type GuildBan struct {
	Reason string `json:"reason"`
	User   *User  `json:"user"`
}

A GuildBan stores data for a guild ban.

type GuildBanAdd 

type GuildBanAdd struct {
	User    *User `json:"user"`
	GuildID int64 `json:"guild_id,string"`
}

GuildBanAdd is the data for a GuildBanAdd event.

func (*GuildBanAdd) GetGuildID 

func (gba *GuildBanAdd) GetGuildID() int64

type GuildBanRemove 

type GuildBanRemove struct {
	User    *User `json:"user"`
	GuildID int64 `json:"guild_id,string"`
}

GuildBanRemove is the data for a GuildBanRemove event.

func (*GuildBanRemove) GetGuildID 

func (e *GuildBanRemove) GetGuildID() int64

type GuildCreate 

type GuildCreate struct {
	*Guild
}

GuildCreate is the data for a GuildCreate event.

type GuildDelete 

type GuildDelete struct {
	*Guild
}

GuildDelete is the data for a GuildDelete event.

type GuildEmbed 

type GuildEmbed struct {
	Enabled   bool  `json:"enabled"`
	ChannelID int64 `json:"channel_id,string"`
}

A GuildEmbed stores data for a guild embed.

type GuildEmojisUpdate 

type GuildEmojisUpdate struct {
	GuildID int64    `json:"guild_id,string"`
	Emojis  []*Emoji `json:"emojis"`
}

A GuildEmojisUpdate is the data for a guild emoji update event.

func (*GuildEmojisUpdate) GetGuildID 

func (e *GuildEmojisUpdate) GetGuildID() int64

type GuildEvent 

type GuildEvent interface {
	GetGuildID() int64
}

type GuildIntegrationsUpdate 

type GuildIntegrationsUpdate struct {
	GuildID int64 `json:"guild_id,string"`
}

GuildIntegrationsUpdate is the data for a GuildIntegrationsUpdate event.

func (*GuildIntegrationsUpdate) GetGuildID 

func (e *GuildIntegrationsUpdate) GetGuildID() int64

type GuildMemberAdd 

type GuildMemberAdd struct {
	*Member
}

GuildMemberAdd is the data for a GuildMemberAdd event.

func (*GuildMemberAdd) GetGuildID 

func (e *GuildMemberAdd) GetGuildID() int64

type GuildMemberRemove 

type GuildMemberRemove struct {
	*Member
}

GuildMemberRemove is the data for a GuildMemberRemove event.

type GuildMemberUpdate 

type GuildMemberUpdate struct {
	*Member
}

GuildMemberUpdate is the data for a GuildMemberUpdate event.

type GuildMembersChunk 

type GuildMembersChunk struct {
	GuildID    int64     `json:"guild_id,string"`
	Members    []*Member `json:"members"`
	ChunkIndex int       `json:"chunk_index"`
	ChunkCount int       `json:"chunk_count"`
	Nonce      string    `json:"nonce"`
}

A GuildMembersChunk is the data for a GuildMembersChunk event.

func (*GuildMembersChunk) GetGuildID 

func (e *GuildMembersChunk) GetGuildID() int64

type GuildParams 

type GuildParams struct {
	Name                        string             `json:"name,omitempty"`
	Region                      string             `json:"region,omitempty"`
	VerificationLevel           *VerificationLevel `json:"verification_level,omitempty"`
	DefaultMessageNotifications int                `json:"default_message_notifications,omitempty"` // TODO: Separate type?
	AfkChannelID                int64              `json:"afk_channel_id,omitempty,string"`
	AfkTimeout                  int                `json:"afk_timeout,omitempty"`
	Icon                        string             `json:"icon,omitempty"`
	OwnerID                     int64              `json:"owner_id,omitempty,string"`
	Splash                      string             `json:"splash,omitempty"`
}

A GuildParams stores all the data needed to update discord guild settings

type GuildRole 

type GuildRole struct {
	Role    *Role `json:"role"`
	GuildID int64 `json:"guild_id,string"`
}

A GuildRole stores data for guild roles.

func (*GuildRole) GetGuildID 

func (e *GuildRole) GetGuildID() int64

type GuildRoleCreate 

type GuildRoleCreate struct {
	*GuildRole
}

GuildRoleCreate is the data for a GuildRoleCreate event.

type GuildRoleDelete 

type GuildRoleDelete struct {
	RoleID  int64 `json:"role_id,string"`
	GuildID int64 `json:"guild_id,string"`
}

A GuildRoleDelete is the data for a GuildRoleDelete event.

func (*GuildRoleDelete) GetGuildID 

func (e *GuildRoleDelete) GetGuildID() int64

type GuildRoleUpdate 

type GuildRoleUpdate struct {
	*GuildRole
}

GuildRoleUpdate is the data for a GuildRoleUpdate event.

type GuildStickersUpdate 

type GuildStickersUpdate struct {
}

guild stickers were updated

type GuildUpdate 

type GuildUpdate struct {
	*Guild
}

GuildUpdate is the data for a GuildUpdate event.

type ICEServer 

type ICEServer struct {
	URL        string `json:"url"`
	Username   string `json:"username"`
	Credential string `json:"credential"`
}

A ICEServer stores data for a specific voice ICE server.

type IDSlice 

type IDSlice []int64

IDSlice Is a slice of snowflake id's that properly marshals and unmarshals the way discord expects them to They unmarshal from string arrays and marshals back to string arrays

func (IDSlice) MarshalJSON 

func (ids IDSlice) MarshalJSON() ([]byte, error)

func (*IDSlice) UnmarshalJSON 

func (ids *IDSlice) UnmarshalJSON(data []byte) error

func (*IDSlice) UnmarshalJSONArray 

func (ids *IDSlice) UnmarshalJSONArray(dec *gojay.Decoder) error

implement UnmarshalerJSONArray

type Integration 

type Integration struct {
	ID                string             `json:"id"`
	Name              string             `json:"name"`
	Type              string             `json:"type"`
	Enabled           bool               `json:"enabled"`
	Syncing           bool               `json:"syncing"`
	RoleID            string             `json:"role_id"`
	ExpireBehavior    int                `json:"expire_behavior"`
	ExpireGracePeriod int                `json:"expire_grace_period"`
	User              *User              `json:"user"`
	Account           IntegrationAccount `json:"account"`
	SyncedAt          Timestamp          `json:"synced_at"`
}

Integration stores integration information

type IntegrationAccount 

type IntegrationAccount struct {
	ID   string `json:"id"`
	Name string `json:"name"`
}

IntegrationAccount is integration account information sent by the UserConnections endpoint

type Interaction 

type Interaction struct {
	ID            int64           `json:"id,string"`
	ApplicationID int64           `json:"application_id,string"`
	Type          InteractionType `json:"type"`
	Data          InteractionData `json:"data"`
	GuildID       int64           `json:"guild_id,string"`
	ChannelID     int64           `json:"channel_id,string"`

	// The message on which interaction was used.
	// NOTE: this field is only filled when a button click triggered the interaction. Otherwise it will be nil.
	Message *Message `json:"message"`

	// The member who invoked this interaction.
	// NOTE: this field is only filled when the slash command was invoked in a guild;
	// if it was invoked in a DM, the `User` field will be filled instead.
	// Make sure to check for `nil` before using this field.
	Member *Member `json:"member"`
	// The user who invoked this interaction.
	// NOTE: this field is only filled when the slash command was invoked in a DM;
	// if it was invoked in a guild, the `Member` field will be filled instead.
	// Make sure to check for `nil` before using this field.
	User *User `json:"user"`

	// The user's discord client locale.
	Locale Locale `json:"locale"`
	// The guild's locale. This defaults to EnglishUS
	// NOTE: this field is only filled when the interaction was invoked in a guild.
	GuildLocale *Locale `json:"guild_locale"`

	Token   string `json:"token"`
	Version int    `json:"version"`

	DataCommand *ApplicationCommandInteractionData
}

Interaction represents data of an interaction.

func (Interaction) ApplicationCommandData added in v2.3.0 

func (i Interaction) ApplicationCommandData() (data ApplicationCommandInteractionData)

ApplicationCommandData is helper function to assert the inner InteractionData to ApplicationCommandInteractionData. Make sure to check that the Type of the interaction is InteractionApplicationCommand before calling.

func (Interaction) MessageComponentData added in v2.3.0 

func (i Interaction) MessageComponentData() (data MessageComponentInteractionData)

MessageComponentData is helper function to assert the inner InteractionData to MessageComponentInteractionData. Make sure to check that the Type of the interaction is InteractionMessageComponent before calling.

func (Interaction) ModalSubmitData added in v2.3.0 

func (i Interaction) ModalSubmitData() (data ModalSubmitInteractionData)

ModalSubmitData is helper function to assert the inner InteractionData to ModalSubmitInteractionData. Make sure to check that the Type of the interaction is InteractionModalSubmit before calling.

func (*Interaction) UnmarshalJSON 

func (i *Interaction) UnmarshalJSON(raw []byte) error

UnmarshalJSON is a method for unmarshalling JSON object to Interaction.

type InteractionApplicationCommandCallbackData 

type InteractionApplicationCommandCallbackData struct {
	TTS             bool             `json:"tts,omitempty"`              //	is the response TTS
	Content         *string          `json:"content,omitempty"`          //	message content
	Embeds          []MessageEmbed   `json:"embeds,omitempty"`           // supports up to 10 embeds
	AllowedMentions *AllowedMentions `json:"allowed_mentions,omitempty"` // allowed mentions object
	Flags           int              `json:"flags,omitempty"`            //	set to 64 to make your response ephemeral
}

type InteractionCreate 

type InteractionCreate struct {
	Interaction
}

type InteractionData added in v2.3.0 

type InteractionData interface {
	Type() InteractionType
}

InteractionData is a common interface for all types of interaction data.

type InteractionResponse 

type InteractionResponse struct {
	Type InteractionResponseType  `json:"type,omitempty"`
	Data *InteractionResponseData `json:"data,omitempty"`
}

InteractionResponse represents a response for an interaction event.

type InteractionResponseData added in v2.3.0 

type InteractionResponseData struct {
	TTS             bool               `json:"tts"`
	Content         string             `json:"content"`
	Components      []MessageComponent `json:"components"`
	Embeds          []*MessageEmbed    `json:"embeds"`
	AllowedMentions *AllowedMentions   `json:"allowed_mentions,omitempty"`
	Flags           uint64             `json:"flags,omitempty"`
	Files           []*File            `json:"-"`

	// NOTE: autocomplete interaction only.
	Choices []*ApplicationCommandOptionChoice `json:"choices,omitempty"`

	CustomID string `json:"custom_id,omitempty"`
	Title    string `json:"title,omitempty"`
}

InteractionResponseData is response data for an interaction.

type InteractionResponseType 

type InteractionResponseType uint8

InteractionResponseType is type of interaction response. 

const (
	// InteractionResponsePong is for ACK ping event.
	InteractionResponsePong InteractionResponseType = 1
	// InteractionResponseChannelMessageWithSource is for responding with a message, showing the user's input.
	InteractionResponseChannelMessageWithSource InteractionResponseType = 4
	// InteractionResponseDeferredChannelMessageWithSource acknowledges that the event was received, and that a follow-up will come later.
	InteractionResponseDeferredChannelMessageWithSource InteractionResponseType = 5
	// InteractionResponseDeferredMessageUpdate acknowledges that the message component interaction event was received, and message will be updated later.
	InteractionResponseDeferredMessageUpdate InteractionResponseType = 6
	// InteractionResponseUpdateMessage is for updating the message to which message component was attached.
	InteractionResponseUpdateMessage InteractionResponseType = 7
	// InteractionApplicationCommandAutocompleteResult shows autocompletion results. Autocomplete interaction only.
	InteractionApplicationCommandAutocompleteResult InteractionResponseType = 8
	// InteractionResponseModal is for responding to an interaction with a modal window.
	InteractionResponseModal InteractionResponseType = 9
)

Interaction response types.

type InteractionType 

type InteractionType uint8

InteractionType indicates the type of an interaction event. 

const (
	InteractionPing                           InteractionType = 1
	InteractionApplicationCommand             InteractionType = 2
	InteractionMessageComponent               InteractionType = 3
	InteractionApplicationCommandAutocomplete InteractionType = 4
	InteractionModalSubmit                    InteractionType = 5
)

Interaction types

func (InteractionType) String added in v2.3.0 

func (t InteractionType) String() string

type Invite 

type Invite struct {
	Guild     *Guild    `json:"guild"`
	Channel   *Channel  `json:"channel"`
	Inviter   *User     `json:"inviter"`
	Code      string    `json:"code"`
	CreatedAt Timestamp `json:"created_at"`
	MaxAge    int       `json:"max_age"`
	Uses      int       `json:"uses"`
	MaxUses   int       `json:"max_uses"`
	Revoked   bool      `json:"revoked"`
	Temporary bool      `json:"temporary"`
	Unique    bool      `json:"unique"`

	// will only be filled when using InviteWithCounts
	ApproximatePresenceCount int `json:"approximate_presence_count"`
	ApproximateMemberCount   int `json:"approximate_member_count"`
}

A Invite stores all data related to a specific Discord Guild or Channel invite.

type InviteCreate 

type InviteCreate struct {
	GuildID   int64 `json:"guild_id,string"`
	ChannelID int64 `json:"channel_id,string"`

	Code      string    `json:"code"`
	CreatedAt Timestamp `json:"created_at"`

	MaxAge    int  `json:"max_age"`
	MaxUses   int  `json:"max_uses"`
	Temporary bool `json:"temporary"`
	Uses      int  `json:"uses"`

	Inviter *InviteUser `json:"inviter"`
}

InviteCreate is the data for the InviteCreate event

type InviteDelete 

type InviteDelete struct {
	GuildID   int64  `json:"guild_id,string"`
	ChannelID int64  `json:"channel_id,string"`
	Code      string `json:"code"`
}

InviteDelete is the data for the InviteDelete event

type InviteUser 

type InviteUser struct {
	ID            int64  `json:"id,string"`
	Avatar        string `json:"avatar"`
	Discriminator string `json:"discriminator"`
	Username      string `json:"username"`
}

InviteUser is a partial user obejct from the invite event(s)

type Locale added in v2.3.0 

type Locale string

Locale represents the accepted languages for Discord. https://discord.com/developers/docs/reference#locales 

const (
	EnglishUS    Locale = "en-US"
	EnglishGB    Locale = "en-GB"
	Bulgarian    Locale = "bg"
	ChineseCN    Locale = "zh-CN"
	ChineseTW    Locale = "zh-TW"
	Croatian     Locale = "hr"
	Czech        Locale = "cs"
	Danish       Locale = "da"
	Dutch        Locale = "nl"
	Finnish      Locale = "fi"
	French       Locale = "fr"
	German       Locale = "de"
	Greek        Locale = "el"
	Hindi        Locale = "hi"
	Hungarian    Locale = "hu"
	Italian      Locale = "it"
	Japanese     Locale = "ja"
	Korean       Locale = "ko"
	Lithuanian   Locale = "lt"
	Norwegian    Locale = "no"
	Polish       Locale = "pl"
	PortugueseBR Locale = "pt-BR"
	Romanian     Locale = "ro"
	Russian      Locale = "ru"
	SpanishES    Locale = "es-ES"
	Swedish      Locale = "sv-SE"
	Thai         Locale = "th"
	Turkish      Locale = "tr"
	Ukrainian    Locale = "uk"
	Vietnamese   Locale = "vi"
	Unknown      Locale = ""
)

All defined locales in Discord

func (Locale) String added in v2.3.0 

func (l Locale) String() string

String returns the human-readable string of the locale

type Member 

type Member struct {
	// The guild ID on which the member exists.
	GuildID int64 `json:"guild_id,string"`

	// The time at which the member joined the guild, in ISO8601.
	JoinedAt Timestamp `json:"joined_at"`

	// The nickname of the member, if they have one.
	Nick string `json:"nick"`

	// The guild avatar hash of the member, if they have one.
	Avatar string `json:"avatar"`

	// Whether the member is deafened at a guild level.
	Deaf bool `json:"deaf"`

	// Whether the member is muted at a guild level.
	Mute bool `json:"mute"`

	// The underlying user on which the member is based.
	User *User `json:"user"`

	// A list of IDs of the roles which are possessed by the member.
	Roles IDSlice `json:"roles,string"`

	// Whether the user has not yet passed the guild's Membership Screening requirements
	Pending bool `json:"pending"`

	// The time at which the member's timeout will expire.
	// Time in the past or nil if the user is not timed out.
	TimeoutExpiresAt *time.Time `json:"communication_disabled_until"`
}

A Member stores user information for Guild members. A guild member represents a certain user's presence in a guild.

func (*Member) AvatarURL 

func (m *Member) AvatarURL(size string) string

func (*Member) GetGuildID 

func (m *Member) GetGuildID() int64

type Message 

type Message struct {
	// The ID of the message.
	ID int64 `json:"id,string"`

	// The ID of the channel in which the message was sent.
	ChannelID int64 `json:"channel_id,string"`

	// The ID of the guild in which the message was sent.
	GuildID int64 `json:"guild_id,string,omitempty"`

	// The content of the message.
	Content string `json:"content"`

	// The time at which the messsage was sent.
	// CAUTION: this field may be removed in a
	// future API version; it is safer to calculate
	// the creation time via the ID.
	Timestamp Timestamp `json:"timestamp"`

	// The time at which the last edit of the message
	// occurred, if it has been edited.
	EditedTimestamp Timestamp `json:"edited_timestamp"`

	// The roles mentioned in the message.
	MentionRoles IDSlice `json:"mention_roles,string"`

	// Whether the message is text-to-speech.
	TTS bool `json:"tts"`

	// Whether the message mentions everyone.
	MentionEveryone bool `json:"mention_everyone"`

	// The author of the message. This is not guaranteed to be a
	// valid user (webhook-sent messages do not possess a full author).
	Author *User `json:"author"`

	// A list of attachments present in the message.
	Attachments []*MessageAttachment `json:"attachments"`

	// A list of components attached to the message.
	Components []MessageComponent `json:"-"`

	// A list of embeds present in the message. Multiple
	// embeds can currently only be sent by webhooks.
	Embeds []*MessageEmbed `json:"embeds"`

	// A list of users mentioned in the message.
	Mentions []*User `json:"mentions"`

	// Whether the message is pinned or not.
	Pinned bool `json:"pinned"`

	// A list of reactions to the message.
	Reactions []*MessageReactions `json:"reactions"`

	// The type of the message.
	Type MessageType `json:"type"`

	WebhookID int64 `json:"webhook_id,string"`

	Member *Member `json:"member"`

	// MessageReference contains reference data sent with crossposted or reply messages.
	// This does not contain the reference *to* this message; this is for when *this* message references another.
	// To generate a reference to this message, use (*Message).Reference().
	MessageReference *MessageReference `json:"message_reference"`

	// The message associated with the message_reference
	// NOTE: This field is only returned for messages with a type of 19 (REPLY) or 21 (THREAD_STARTER_MESSAGE).
	// If the message is a reply but the referenced_message field is not present,
	// the backend did not attempt to fetch the message that was being replied to, so its state is unknown.
	// If the field exists but is null, the referenced message was deleted.
	ReferencedMessage *Message `json:"referenced_message"`

	// Is sent when the message is a response to an Interaction, without an existing message.
	// This means responses to message component interactions do not include this property,
	// instead including a MessageReference, as components exist on preexisting messages.
	Interaction *MessageInteraction `json:"interaction"`
}

A Message stores all data related to a specific Discord message.

func (*Message) ContentWithMentionsReplaced 

func (m *Message) ContentWithMentionsReplaced() (content string)

ContentWithMentionsReplaced will replace all @<id> mentions with the username of the mention.

func (*Message) ContentWithMoreMentionsReplaced 

func (m *Message) ContentWithMoreMentionsReplaced(s *Session) (content string, err error)

ContentWithMoreMentionsReplaced will replace all @<id> mentions with the username of the mention, but also role IDs and more.

func (*Message) GetChannelID 

func (m *Message) GetChannelID() int64

func (*Message) GetGuildID 

func (m *Message) GetGuildID() int64
func (m *Message) Link() string

func (*Message) Reference added in v2.3.0 

func (m *Message) Reference() *MessageReference

Reference returns MessageReference of given message

type MessageAck 

type MessageAck struct {
	MessageID int64 `json:"message_id,string"`
	ChannelID int64 `json:"channel_id,string"`
}

MessageAck is the data for a MessageAck event.

type MessageAttachment 

type MessageAttachment struct {
	ID       string `json:"id"`
	URL      string `json:"url"`
	ProxyURL string `json:"proxy_url"`
	Filename string `json:"filename"`
	Width    int    `json:"width"`
	Height   int    `json:"height"`
	Size     int    `json:"size"`
}

A MessageAttachment stores data for message attachments.

type MessageComponent added in v2.3.0 

type MessageComponent interface {
	json.Marshaler
	Type() ComponentType
}

MessageComponent is a base interface for all message components.

func MessageComponentFromJSON added in v2.3.0 

func MessageComponentFromJSON(b []byte) (MessageComponent, error)

MessageComponentFromJSON is a helper function for unmarshaling message components

type MessageComponentInteractionData added in v2.3.0 

type MessageComponentInteractionData struct {
	CustomID      string        `json:"custom_id"`
	ComponentType ComponentType `json:"component_type"`

	// NOTE: Only filled when ComponentType is SelectMenuComponent (3). Otherwise is nil.
	Values []string `json:"values"`
}

MessageComponentInteractionData contains the data of message component interaction.

func (MessageComponentInteractionData) Type added in v2.3.0 

func (MessageComponentInteractionData) Type() InteractionType

Type returns the type of interaction data.

type MessageCreate 

type MessageCreate struct {
	*Message
}

MessageCreate is the data for a MessageCreate event.

type MessageDelete 

type MessageDelete struct {
	*Message
}

MessageDelete is the data for a MessageDelete event.

type MessageDeleteBulk 

type MessageDeleteBulk struct {
	Messages  IDSlice `json:"ids"`
	ChannelID int64   `json:"channel_id,string"`
	GuildID   int64   `json:"guild_id,string"`
}

MessageDeleteBulk is the data for a MessageDeleteBulk event

func (*MessageDeleteBulk) GetChannelID 

func (e *MessageDeleteBulk) GetChannelID() int64

func (*MessageDeleteBulk) GetGuildID 

func (e *MessageDeleteBulk) GetGuildID() int64

type MessageEdit 

type MessageEdit struct {
	Content         *string            `json:"content,omitempty"`
	Components      []MessageComponent `json:"components"`
	Embeds          []*MessageEmbed    `json:"embeds,omitempty"`
	AllowedMentions AllowedMentions    `json:"allowed_mentions,omitempty"`
	Flags           MessageFlags       `json:"flags,omitempty"`

	ID      int64
	Channel int64
}

MessageEdit is used to chain parameters via ChannelMessageEditComplex, which is also where you should get the instance from.

func NewMessageEdit 

func NewMessageEdit(channelID int64, messageID int64) *MessageEdit

NewMessageEdit returns a MessageEdit struct, initialized with the Channel and ID.

func (*MessageEdit) SetContent 

func (m *MessageEdit) SetContent(str string) *MessageEdit

SetContent is the same as setting the variable Content, except it doesn't take a pointer.

func (*MessageEdit) SetEmbeds added in v2.3.0 

func (m *MessageEdit) SetEmbeds(embeds []*MessageEmbed) *MessageEdit

SetEmbeds is a convenience function for setting the embeds, so you can chain commands.

type MessageEmbed 

type MessageEmbed struct {
	URL         string                 `json:"url,omitempty"`
	Type        string                 `json:"type,omitempty"`
	Title       string                 `json:"title,omitempty"`
	Description string                 `json:"description,omitempty"`
	Timestamp   string                 `json:"timestamp,omitempty"`
	Color       int                    `json:"color,omitempty"`
	Footer      *MessageEmbedFooter    `json:"footer,omitempty"`
	Image       *MessageEmbedImage     `json:"image,omitempty"`
	Thumbnail   *MessageEmbedThumbnail `json:"thumbnail,omitempty"`
	Video       *MessageEmbedVideo     `json:"video,omitempty"`
	Provider    *MessageEmbedProvider  `json:"provider,omitempty"`
	Author      *MessageEmbedAuthor    `json:"author,omitempty"`
	Fields      []*MessageEmbedField   `json:"fields,omitempty"`
	// contains filtered or unexported fields
}

An MessageEmbed stores data for message embeds.

func ValidateComplexMessageEmbeds added in v2.3.1 

func ValidateComplexMessageEmbeds(embeds []*MessageEmbed) []*MessageEmbed

func (*MessageEmbed) GetMarshalNil 

func (e *MessageEmbed) GetMarshalNil() bool

func (*MessageEmbed) MarshalJSON 

func (e *MessageEmbed) MarshalJSON() ([]byte, error)

func (*MessageEmbed) MarshalNil 

func (e *MessageEmbed) MarshalNil(flag bool) *MessageEmbed

type MessageEmbedAuthor 

type MessageEmbedAuthor struct {
	URL          string `json:"url,omitempty"`
	Name         string `json:"name,omitempty"`
	IconURL      string `json:"icon_url,omitempty"`
	ProxyIconURL string `json:"proxy_icon_url,omitempty"`
}

MessageEmbedAuthor is a part of a MessageEmbed struct.

type MessageEmbedField 

type MessageEmbedField struct {
	Name   string `json:"name,omitempty"`
	Value  string `json:"value,omitempty"`
	Inline bool   `json:"inline,omitempty"`
}

MessageEmbedField is a part of a MessageEmbed struct.

type MessageEmbedFooter 

type MessageEmbedFooter struct {
	Text         string `json:"text,omitempty"`
	IconURL      string `json:"icon_url,omitempty"`
	ProxyIconURL string `json:"proxy_icon_url,omitempty"`
}

MessageEmbedFooter is a part of a MessageEmbed struct.

type MessageEmbedImage 

type MessageEmbedImage struct {
	URL      string `json:"url,omitempty"`
	ProxyURL string `json:"proxy_url,omitempty"`
	Width    int    `json:"width,omitempty"`
	Height   int    `json:"height,omitempty"`
}

MessageEmbedImage is a part of a MessageEmbed struct.

type MessageEmbedProvider 

type MessageEmbedProvider struct {
	URL  string `json:"url,omitempty"`
	Name string `json:"name,omitempty"`
}

MessageEmbedProvider is a part of a MessageEmbed struct.

type MessageEmbedThumbnail 

type MessageEmbedThumbnail struct {
	URL      string `json:"url,omitempty"`
	ProxyURL string `json:"proxy_url,omitempty"`
	Width    int    `json:"width,omitempty"`
	Height   int    `json:"height,omitempty"`
}

MessageEmbedThumbnail is a part of a MessageEmbed struct.

type MessageEmbedVideo 

type MessageEmbedVideo struct {
	URL      string `json:"url,omitempty"`
	ProxyURL string `json:"proxy_url,omitempty"`
	Width    int    `json:"width,omitempty"`
	Height   int    `json:"height,omitempty"`
}

MessageEmbedVideo is a part of a MessageEmbed struct.

type MessageFlags added in v2.3.0 

type MessageFlags int

MessageFlags is the flags of "message" (see MessageFlags* consts) https://discord.com/developers/docs/resources/channel#message-object-message-flags 

const (
	// MessageFlagsCrossPosted This message has been published to subscribed channels (via Channel Following).
	MessageFlagsCrossPosted MessageFlags = 1 << 0
	// MessageFlagsIsCrossPosted this message originated from a message in another channel (via Channel Following).
	MessageFlagsIsCrossPosted MessageFlags = 1 << 1
	// MessageFlagsSuppressEmbeds do not include any embeds when serializing this message.
	MessageFlagsSuppressEmbeds MessageFlags = 1 << 2
	// TODO: deprecated, remove when compatibility is not needed
	MessageFlagsSupressEmbeds MessageFlags = 1 << 2
	// MessageFlagsSourceMessageDeleted the source message for this crosspost has been deleted (via Channel Following).
	MessageFlagsSourceMessageDeleted MessageFlags = 1 << 3
	// MessageFlagsUrgent this message came from the urgent message system.
	MessageFlagsUrgent MessageFlags = 1 << 4
	// MessageFlagsHasThread this message has an associated thread, with the same id as the message.
	MessageFlagsHasThread MessageFlags = 1 << 5
	// MessageFlagsEphemeral this message is only visible to the user who invoked the Interaction.
	MessageFlagsEphemeral MessageFlags = 1 << 6
	// MessageFlagsLoading this message is an Interaction Response and the bot is "thinking".
	MessageFlagsLoading MessageFlags = 1 << 7
	// MessageFlagsFailedToMentionSomeRolesInThread this message failed to mention some roles and add their members to the thread.
	MessageFlagsFailedToMentionSomeRolesInThread MessageFlags = 1 << 8
)

Valid MessageFlags values

type MessageInteraction 

type MessageInteraction struct {
	ID   int64           `json:"id,string"`
	Type InteractionType `json:"type"`
	Name string          `json:"name"`
	User *User           `json:"user"`

	// Member is only present when the interaction is from a guild.
	Member *Member `json:"member"`
}

MessageInteraction contains information about the application command interaction which generated the message.

type MessageReaction 

type MessageReaction struct {
	UserID    int64 `json:"user_id,string"`
	MessageID int64 `json:"message_id,string"`
	Emoji     Emoji `json:"emoji"`
	ChannelID int64 `json:"channel_id,string"`
	GuildID   int64 `json:"guild_id,string,omitempty"`
}

MessageReaction stores the data for a message reaction.

func (*MessageReaction) GetChannelID 

func (mr *MessageReaction) GetChannelID() int64

func (*MessageReaction) GetGuildID 

func (mr *MessageReaction) GetGuildID() int64

type MessageReactionAdd 

type MessageReactionAdd struct {
	*MessageReaction
}

MessageReactionAdd is the data for a MessageReactionAdd event.

type MessageReactionRemove 

type MessageReactionRemove struct {
	*MessageReaction
}

MessageReactionRemove is the data for a MessageReactionRemove event.

type MessageReactionRemoveAll 

type MessageReactionRemoveAll struct {
	*MessageReaction
}

MessageReactionRemoveAll is the data for a MessageReactionRemoveAll event.

type MessageReactionRemoveEmoji 

type MessageReactionRemoveEmoji struct {
	ChannelID int64 `json:"channel_id,string"`
	GuildID   int64 `json:"guild_id,string"`
	MessageID int64 `json:"message_id,string"`
	Emoji     Emoji `json:"emoji"`
}

all reactions for a given emoji were explicitly removed from a message

type MessageReactions 

type MessageReactions struct {
	Count int    `json:"count"`
	Me    bool   `json:"me"`
	Emoji *Emoji `json:"emoji"`
}

MessageReactions holds a reactions object for a message.

type MessageReference added in v2.3.0 

type MessageReference struct {
	MessageID int64 `json:"message_id,string"`
	ChannelID int64 `json:"channel_id,string"`
	GuildID   int64 `json:"guild_id,string,omitempty"`
}

MessageReference contains reference data sent with crossposted messages

type MessageSend 

type MessageSend struct {
	Content         string             `json:"content,omitempty"`
	Embeds          []*MessageEmbed    `json:"embeds,omitempty"`
	TTS             bool               `json:"tts"`
	Components      []MessageComponent `json:"components"`
	Files           []*File            `json:"-"`
	AllowedMentions AllowedMentions    `json:"allowed_mentions,omitempty"`
	Reference       *MessageReference  `json:"message_reference,omitempty"`

	// TODO: Remove this when compatibility is not required.
	File *File `json:"-"`
}

MessageSend stores all parameters you can send with ChannelMessageSendComplex.

type MessageType 

type MessageType int

MessageType is the type of Message 

const (
	MessageTypeDefault                                 MessageType = 0
	MessageTypeRecipientAdd                            MessageType = 1
	MessageTypeRecipientRemove                         MessageType = 2
	MessageTypeCall                                    MessageType = 3
	MessageTypeChannelNameChange                       MessageType = 4
	MessageTypeChannelIconChange                       MessageType = 5
	MessageTypeChannelPinnedMessage                    MessageType = 6
	MessageTypeGuildMemberJoin                         MessageType = 7
	MessageTypeUserPremiumGuildSubscription            MessageType = 8
	MessageTypeUserPremiumGuildSubscriptionTier1       MessageType = 9
	MessageTypeUserPremiumGuildSubscriptionTier2       MessageType = 10
	MessageTypeUserPremiumGuildSubscriptionTier3       MessageType = 11
	MessageTypeChannelFollowAdd                        MessageType = 12
	MessageTypeGuildDiscoveryDisqualified              MessageType = 14
	MessageTypeGuildDiscoveryRequalified               MessageType = 15
	MessageTypeGuildDiscoveryGracePeriodInitialWarning MessageType = 16
	MessageTypeGuildDiscoveryGracePeriodFinalWarning   MessageType = 17
	MessageTypeThreadCreated                           MessageType = 18
	MessageTypeReply                                   MessageType = 19
	MessageTypeApplicationCommand                      MessageType = 20
	MessageTypeThreadStarterMessage                    MessageType = 21
	MessageTypeGuildInviteReminder                     MessageType = 22
)

Block contains the valid known MessageType values

func (MessageType) IsSystem 

func (m MessageType) IsSystem() bool

IsSystem returns wether the message type is a system message type, a message created by discord

type MessageUpdate 

type MessageUpdate struct {
	*Message
}

MessageUpdate is the data for a MessageUpdate event.

type MfaLevel 

type MfaLevel int

MfaLevel type definition 

const (
	MfaLevelNone MfaLevel = iota
	MfaLevelElevated
)

Constants for MfaLevel levels from 0 to 1 inclusive

type ModalSubmitInteractionData added in v2.3.0 

type ModalSubmitInteractionData struct {
	CustomID   string             `json:"custom_id"`
	Components []MessageComponent `json:"components"`
}

ModalSubmitInteractionData contains the data of modal submit interaction.

func (ModalSubmitInteractionData) Type added in v2.3.0 

func (ModalSubmitInteractionData) Type() InteractionType

Type returns the type of interaction data.

func (*ModalSubmitInteractionData) UnmarshalJSON added in v2.3.0 

func (d *ModalSubmitInteractionData) UnmarshalJSON(data []byte) error

UnmarshalJSON is a helper function to correctly unmarshal Components.

type NullableID 

type NullableID int64

A NullableID is a nullable snowflake ID that represents null as the value 0. It marshals into "null" if its value is 0, and otherwise marshals into the string representation of its value. Unmarshaling behaves similarly, and accepts null, string, and integer values.

func (NullableID) MarshalJSON 

func (i NullableID) MarshalJSON() ([]byte, error)

func (*NullableID) UnmarshalJSON 

func (i *NullableID) UnmarshalJSON(data []byte) error

type Packet 

type Packet struct {
	SSRC      uint32
	Sequence  uint16
	Timestamp uint32
	Type      []byte
	Opus      []byte
	PCM       []int16
}

A Packet contains the headers and content of a received voice packet.

type PermissionOverwrite 

type PermissionOverwrite struct {
	ID    int64                   `json:"id,string"`
	Type  PermissionOverwriteType `json:"type"`
	Deny  int64                   `json:"deny,string"`
	Allow int64                   `json:"allow,string"`
}

A PermissionOverwrite holds permission overwrite data for a Channel

type PermissionOverwriteType 

type PermissionOverwriteType int
const (
	PermissionOverwriteTypeRole   PermissionOverwriteType = 0
	PermissionOverwriteTypeMember PermissionOverwriteType = 1
)

type Presence 

type Presence struct {
	User   *User  `json:"user"`
	Status Status `json:"status"`

	Activities Activities `json:"activities"`
}

A Presence stores the online, offline, or idle and game status of Guild members.

func (*Presence) NKeys 

func (p *Presence) NKeys() int

func (*Presence) UnmarshalJSONObject 

func (p *Presence) UnmarshalJSONObject(dec *gojay.Decoder, key string) error

implement gojay.UnmarshalerJSONObject

type PresenceUpdate 

type PresenceUpdate struct {
	Presence
	GuildID int64 `json:"guild_id,string"`
}

PresenceUpdate is the data for a PresenceUpdate event.

func (*PresenceUpdate) GetGuildID 

func (e *PresenceUpdate) GetGuildID() int64

func (*PresenceUpdate) NKeys 

func (p *PresenceUpdate) NKeys() int

func (*PresenceUpdate) UnmarshalJSONObject 

func (p *PresenceUpdate) UnmarshalJSONObject(dec *gojay.Decoder, key string) error

implement gojay.UnmarshalerJSONObject

type PresencesReplace 

type PresencesReplace []*Presence

PresencesReplace is the data for a PresencesReplace event.

type RESTError 

type RESTError struct {
	Request      *http.Request
	Response     *http.Response
	ResponseBody []byte

	Message *APIErrorMessage // Message may be nil.
}

RESTError stores error information about a request with a bad response code. Message is not always present, there are cases where api calls can fail without returning a json message.

func (RESTError) Error 

func (r RESTError) Error() string

type RateLimit 

type RateLimit struct {
	*TooManyRequests
	URL string
}

RateLimit is the data for a RateLimit event. This is a sythetic event and is not dispatched by Discord.

type RateLimiter 

type RateLimiter struct {
	sync.Mutex

	MaxConcurrentRequests int
	// contains filtered or unexported fields
}

RateLimiter holds all ratelimit buckets

func NewRatelimiter 

func NewRatelimiter() *RateLimiter

NewRatelimiter returns a new RateLimiter

func (*RateLimiter) CurrentConcurrentLocks 

func (r *RateLimiter) CurrentConcurrentLocks() int

func (*RateLimiter) GetBucket 

func (r *RateLimiter) GetBucket(key string) *Bucket

GetBucket retrieves or creates a bucket

func (*RateLimiter) GetWaitTime 

func (r *RateLimiter) GetWaitTime(b *Bucket, minRemaining int) time.Duration

GetWaitTime returns the duration you should wait for a Bucket

func (*RateLimiter) LockBucket 

func (r *RateLimiter) LockBucket(bucketID string) (b *Bucket, lockID int64)

LockBucket Locks until a request can be made

func (*RateLimiter) LockBucketObject 

func (r *RateLimiter) LockBucketObject(b *Bucket) (lockID int64)

LockBucketObject Locks an already resolved bucket until a request can be made

func (*RateLimiter) SetGlobalTriggered 

func (r *RateLimiter) SetGlobalTriggered(to time.Time)

type ReadState 

type ReadState struct {
	MentionCount  int   `json:"mention_count"`
	LastMessageID int64 `json:"last_message_id,string"`
	ID            int64 `json:"id,string"`
}

A ReadState stores data on the read state of channels.

type ReaderWithMockClose 

type ReaderWithMockClose struct {
	*bytes.Reader
}

func (*ReaderWithMockClose) Close 

func (rwmc *ReaderWithMockClose) Close() error

type Ready 

type Ready struct {
	Version          int          `json:"v"`
	SessionID        string       `json:"session_id"`
	User             *SelfUser    `json:"user"`
	ReadState        []*ReadState `json:"read_state"`
	PrivateChannels  []*Channel   `json:"private_channels"`
	Guilds           []*Guild     `json:"guilds"`
	ResumeGatewayUrl string       `json:"resume_gateway_url"`

	// Undocumented fields
	Settings          *Settings            `json:"user_settings"`
	UserGuildSettings []*UserGuildSettings `json:"user_guild_settings"`
	Relationships     []*Relationship      `json:"relationships"`
	Presences         []*Presence          `json:"presences"`
	Notes             map[string]string    `json:"notes"`
}

A Ready stores all data for the websocket READY event.

type Relationship 

type Relationship struct {
	User *User  `json:"user"`
	Type int    `json:"type"` // 1 = friend, 2 = blocked, 3 = incoming friend req, 4 = sent friend req
	ID   string `json:"id"`
}

A Relationship between the logged in user and Relationship.User

type RelationshipAdd 

type RelationshipAdd struct {
	*Relationship
}

RelationshipAdd is the data for a RelationshipAdd event.

type RelationshipRemove 

type RelationshipRemove struct {
	*Relationship
}

RelationshipRemove is the data for a RelationshipRemove event.

type RequestGuildMembersData 

type RequestGuildMembersData struct {
	GuildID   int64 `json:"guild_id,string"`
	Limit     int   `json:"limit"`
	Presences bool  `json:"presences"`

	Query   *string `json:"query,omitempty"`
	UserIDs IDSlice `json:"user_ids,omitempty"`
	Nonce   string  `json:"nonce"`
}

type Resumed 

type Resumed struct {
	Trace []string `json:"_trace"`
}

Resumed is the data for a Resumed event.

type Role 

type Role struct {
	// The ID of the role.
	ID int64 `json:"id,string"`

	// The name of the role.
	Name string `json:"name"`

	// Whether this role is managed by an integration, and
	// thus cannot be manually added to, or taken from, members.
	Managed bool `json:"managed"`

	// Whether this role is mentionable.
	Mentionable bool `json:"mentionable"`

	// Whether this role is hoisted (shows up separately in member list).
	Hoist bool `json:"hoist"`

	// The hex color of this role.
	Color int `json:"color"`

	// The position of this role in the guild's role hierarchy.
	Position int `json:"position"`

	// The permissions of the role on the guild (doesn't include channel overrides).
	// This is a combination of bit masks; the presence of a certain permission can
	// be checked by performing a bitwise AND between this int and the permission.
	Permissions int64 `json:"permissions,string"`
}

A Role stores information about Discord guild member roles.

func (*Role) Mention 

func (r *Role) Mention() string

Mention returns a string which mentions the role

type RoleCreate 

type RoleCreate struct {
	Name        string `json:"name,omitempty"`
	Permissions int64  `json:"permissions,string,omitempty"`
	Color       int32  `json:"color,omitempty"`
	Hoist       bool   `json:"hoist"`
	Mentionable bool   `json:"mentionable"`
}

type Roles 

type Roles []*Role

Roles are a collection of Role

func (Roles) Len 

func (r Roles) Len() int

func (Roles) Less 

func (r Roles) Less(i, j int) bool

func (Roles) Swap 

func (r Roles) Swap(i, j int)

type SelectMenu added in v2.3.0 

type SelectMenu struct {
	CustomID string `json:"custom_id,omitempty"`
	// The text which will be shown in the menu if there's no default options or all options was deselected and component was closed.
	Placeholder string `json:"placeholder"`
	// This value determines the minimal amount of selected items in the menu.
	MinValues *int `json:"min_values,omitempty"`
	// This value determines the maximal amount of selected items in the menu.
	// If MaxValues or MinValues are greater than one then the user can select multiple items in the component.
	MaxValues int                `json:"max_values,omitempty"`
	Options   []SelectMenuOption `json:"options"`
	Disabled  bool               `json:"disabled"`
}

SelectMenu represents select menu component.

func (SelectMenu) MarshalJSON added in v2.3.0 

func (m SelectMenu) MarshalJSON() ([]byte, error)

MarshalJSON is a method for marshaling SelectMenu to a JSON object.

func (SelectMenu) Type added in v2.3.0 

func (SelectMenu) Type() ComponentType

Type is a method to get the type of a component.

type SelectMenuOption added in v2.3.0 

type SelectMenuOption struct {
	Label       string         `json:"label,omitempty"`
	Value       string         `json:"value"`
	Description string         `json:"description"`
	Emoji       ComponentEmoji `json:"emoji"`
	// Determines whenever option is selected by default or not.
	Default bool `json:"default"`
}

SelectMenuOption represents an option for a select menu.

type SelfUser 

type SelfUser struct {
	*User
	Token string `json:"token"`
}

A SelfUser stores user data about the token owner. Includes a few extra fields than a normal user struct.

type Session 

type Session struct {

	// Authentication token for this session
	Token   string
	MFA     bool
	Intents []GatewayIntent

	// Debug for printing JSON request/responses
	Debug    bool // Deprecated, will be removed.
	LogLevel int

	// Should the session reconnect the websocket on errors.
	ShouldReconnectOnError bool

	// Should the session request compressed websocket data.
	Compress bool

	// Sharding
	ShardID    int
	ShardCount int

	// Should state tracking be enabled.
	// State tracking is the best way for getting the the users
	// active guilds and the members of the guilds.
	StateEnabled bool

	// Whether or not to call event handlers synchronously.
	// e.g false = launch event handlers in their own goroutines.
	SyncEvents bool

	// Max number of REST API retries
	MaxRestRetries int

	// Managed state object, updated internally with events when
	// StateEnabled is true.
	State *State

	// The http client used for REST requests
	Client *http.Client

	// Stores the last HeartbeatAck that was recieved (in UTC)
	LastHeartbeatAck time.Time

	// used to deal with rate limits
	Ratelimiter *RateLimiter

	// The gateway websocket connection
	GatewayManager *GatewayConnectionManager
	// contains filtered or unexported fields
}

A Session represents a connection to the Discord API.

func New 

func New(args ...interface{}) (s *Session, err error)

New creates a new Discord session and will automate some startup tasks if given enough information to do so. Currently you can pass zero arguments and it will return an empty Discord session. There are 3 ways to call New: 

With a single auth token - All requests will use the token blindly,
    no verification of the token will be done and requests may fail.
    IF THE TOKEN IS FOR A BOT, IT MUST BE PREFIXED WITH `BOT `
    eg: `"Bot <token>"`
With an email and password - Discord will sign in with the provided
    credentials.
With an email, password and auth token - Discord will verify the auth
    token, if it is invalid it will sign in with the provided
    credentials. This is the Discord recommended way to sign in.

NOTE: While email/pass authentication is supported by DiscordGo it is HIGHLY DISCOURAGED by Discord. Please only use email/pass to obtain a token and then use that authentication token for all future connections. Also, doing any form of automation with a user (non Bot) account may result in that account being permanently banned from Discord.

func (*Session) AddHandler 

func (s *Session) AddHandler(handler interface{}) func()

AddHandler allows you to add an event handler that will be fired anytime the Discord WSAPI event that matches the function fires. The first parameter is a *Session, and the second parameter is a pointer to a struct corresponding to the event for which you want to listen.

eg: 

Session.AddHandler(func(s *discordgo.Session, m *discordgo.MessageCreate) {
})

or: 

Session.AddHandler(func(s *discordgo.Session, m *discordgo.PresenceUpdate) {
})

List of events can be found at this page, with corresponding names in the library for each event: https://discordapp.com/developers/docs/topics/gateway#event-names There are also synthetic events fired by the library internally which are available for handling, like Connect, Disconnect, and RateLimit. events.go contains all of the Discord WSAPI and synthetic events that can be handled.

The return value of this method is a function, that when called will remove the event handler.

func (*Session) AddHandlerOnce 

func (s *Session) AddHandlerOnce(handler interface{}) func()

AddHandlerOnce allows you to add an event handler that will be fired the next time the Discord WSAPI event that matches the function fires. See AddHandler for more details.

func (*Session) Application 

func (s *Session) Application(appID int64) (st *Application, err error)

Application returns an Application structure of a specific Application 

appID : The ID of an Application

func (*Session) ApplicationBotCreate 

func (s *Session) ApplicationBotCreate(appID int64) (st *User, err error)

ApplicationBotCreate creates an Application Bot Account 

appID : The ID of an Application

NOTE: func name may change, if I can think up something better.

func (*Session) ApplicationCreate 

func (s *Session) ApplicationCreate(ap *Application) (st *Application, err error)

ApplicationCreate creates a new Application 

name : Name of Application / Bot
uris : Redirect URIs (Not required)

func (*Session) ApplicationDelete 

func (s *Session) ApplicationDelete(appID int64) (err error)

ApplicationDelete deletes an existing Application 

appID : The ID of an Application

func (*Session) ApplicationMe 

func (s *Session) ApplicationMe() (st *Application, err error)

Application returns an Application structure of the current bot

func (*Session) ApplicationUpdate 

func (s *Session) ApplicationUpdate(appID int64, ap *Application) (st *Application, err error)

ApplicationUpdate updates an existing Application 

var : desc

func (*Session) Applications 

func (s *Session) Applications() (st []*Application, err error)

Applications returns all applications for the authenticated user

func (*Session) BatchEditGuildApplicationCommandsPermissions 

func (s *Session) BatchEditGuildApplicationCommandsPermissions(applicationID int64, guildID int64, data []*GuildApplicationCommandPermissions) (st []*GuildApplicationCommandPermissions, err error)

BatchEditGuildApplicationCommandsPermissions Fetches command permissions for a specific command for your application in a guild. PUT /applications/{application.id}/guilds/{guild.id}/commands/permissions

func (*Session) BulkOverwriteGlobalApplicationCommands 

func (s *Session) BulkOverwriteGlobalApplicationCommands(applicationID int64, data []*CreateApplicationCommandRequest) (st []*ApplicationCommand, err error)

BulkOverwriteGlobalApplicationCommands Takes a list of application commands, overwriting existing commands that are registered globally for this application. Updates will be available in all guilds after 1 hour. PUT /applications/{application.id}/commands

func (*Session) BulkOverwriteGuildApplicationCommands 

func (s *Session) BulkOverwriteGuildApplicationCommands(applicationID int64, guildID int64, data []*CreateApplicationCommandRequest) (st []*ApplicationCommand, err error)

BulkOverwriteGuildApplicationCommands Takes a list of application commands, overwriting existing commands for the guild. PUT /applications/{application.id}/guilds/{guild.id}/commands

func (*Session) Channel 

func (s *Session) Channel(channelID int64) (st *Channel, err error)

Channel returns a Channel structure of a specific Channel. channelID : The ID of the Channel you want returned.

func (*Session) ChannelDelete 

func (s *Session) ChannelDelete(channelID int64) (st *Channel, err error)

ChannelDelete deletes the given channel channelID : The ID of a Channel

func (*Session) ChannelEdit 

func (s *Session) ChannelEdit(channelID int64, name string) (*Channel, error)

ChannelEdit edits the given channel channelID : The ID of a Channel name : The new name to assign the channel.

func (*Session) ChannelEditComplex 

func (s *Session) ChannelEditComplex(channelID int64, data *ChannelEdit) (st *Channel, err error)

ChannelEditComplex edits an existing channel, replacing the parameters entirely with ChannelEdit struct channelID : The ID of a Channel data : The channel struct to send

func (*Session) ChannelFileSend 

func (s *Session) ChannelFileSend(channelID int64, name string, r io.Reader) (*Message, error)

ChannelFileSend sends a file to the given channel. channelID : The ID of a Channel. name: The name of the file. io.Reader : A reader for the file contents.

func (*Session) ChannelFileSendWithMessage 

func (s *Session) ChannelFileSendWithMessage(channelID int64, content string, name string, r io.Reader) (*Message, error)

ChannelFileSendWithMessage sends a file to the given channel with an message. DEPRECATED. Use ChannelMessageSendComplex instead. channelID : The ID of a Channel. content: Optional Message content. name: The name of the file. io.Reader : A reader for the file contents.

func (*Session) ChannelInviteCreate 

func (s *Session) ChannelInviteCreate(channelID int64, i Invite) (st *Invite, err error)

ChannelInviteCreate creates a new invite for the given channel. channelID : The ID of a Channel i : An Invite struct with the values MaxAge, MaxUses and Temporary defined.

func (*Session) ChannelInvites 

func (s *Session) ChannelInvites(channelID int64) (st []*Invite, err error)

ChannelInvites returns an array of Invite structures for the given channel channelID : The ID of a Channel

func (*Session) ChannelMessage 

func (s *Session) ChannelMessage(channelID, messageID int64) (st *Message, err error)

ChannelMessage gets a single message by ID from a given channel. channeld : The ID of a Channel messageID : the ID of a Message

func (*Session) ChannelMessageAck 

func (s *Session) ChannelMessageAck(channelID, messageID int64, lastToken string) (st *Ack, err error)

ChannelMessageAck acknowledges and marks the given message as read channeld : The ID of a Channel messageID : the ID of a Message lastToken : token returned by last ack

func (*Session) ChannelMessageDelete 

func (s *Session) ChannelMessageDelete(channelID, messageID int64) (err error)

ChannelMessageDelete deletes a message from the Channel.

func (*Session) ChannelMessageEdit 

func (s *Session) ChannelMessageEdit(channelID, messageID int64, content string) (*Message, error)

ChannelMessageEdit edits an existing message, replacing it entirely with the given content. channelID : The ID of a Channel messageID : The ID of a Message content : The contents of the message

func (*Session) ChannelMessageEditComplex 

func (s *Session) ChannelMessageEditComplex(msg *MessageEdit) (st *Message, err error)

ChannelMessageEditComplex edits an existing message, replacing it entirely with the given MessageEdit struct

func (*Session) ChannelMessageEditEmbed 

func (s *Session) ChannelMessageEditEmbed(channelID, messageID int64, embed *MessageEmbed) (*Message, error)

ChannelMessageEditEmbed edits an existing message with embedded data. channelID : The ID of a Channel messageID : The ID of a Message embed : The embed data to send

func (*Session) ChannelMessageEditEmbedList added in v2.3.0 

func (s *Session) ChannelMessageEditEmbedList(channelID, messageID int64, embeds []*MessageEmbed) (*Message, error)

ChannelMessageEditEmbeds edits an existing message with a list of embedded data. channelID : The ID of a Channel messageID : The ID of a Message embeds : The list of embed data to send

func (*Session) ChannelMessagePin 

func (s *Session) ChannelMessagePin(channelID, messageID int64) (err error)

ChannelMessagePin pins a message within a given channel. channelID: The ID of a channel. messageID: The ID of a message.

func (*Session) ChannelMessageSend 

func (s *Session) ChannelMessageSend(channelID int64, content string) (*Message, error)

ChannelMessageSend sends a message to the given channel. channelID : The ID of a Channel. content : The message to send.

func (*Session) ChannelMessageSendComplex 

func (s *Session) ChannelMessageSendComplex(channelID int64, msg *MessageSend) (st *Message, err error)

ChannelMessageSendComplex sends a message to the given channel. channelID : The ID of a Channel. data : The message struct to send.

func (*Session) ChannelMessageSendEmbed 

func (s *Session) ChannelMessageSendEmbed(channelID int64, embed *MessageEmbed) (*Message, error)

ChannelMessageSendEmbed sends a message to the given channel with embedded data. channelID : The ID of a Channel. embed : The embed data to send.

func (*Session) ChannelMessageSendEmbedList added in v2.3.0 

func (s *Session) ChannelMessageSendEmbedList(channelID int64, embeds []*MessageEmbed) (*Message, error)

ChannelMessageSendEmbeds sends a message to the given channel with list of embedded data. channelID : The ID of a Channel. embed : The list embed data to send.

func (*Session) ChannelMessageSendEmbeds added in v2.3.0 

func (s *Session) ChannelMessageSendEmbeds(channelID int64, embeds []*MessageEmbed) (*Message, error)

ChannelMessageSendEmbeds sends a message to the given channel with multiple embedded data. channelID : The ID of a Channel. embeds : The embeds data to send.

func (*Session) ChannelMessageSendReply added in v2.3.0 

func (s *Session) ChannelMessageSendReply(channelID int64, content string, reference *MessageReference) (*Message, error)

ChannelMessageSendReply sends a message to the given channel with reference data. channelID : The ID of a Channel. content : The message to send. reference : The message reference to send.

func (*Session) ChannelMessageSendTTS 

func (s *Session) ChannelMessageSendTTS(channelID int64, content string) (*Message, error)

ChannelMessageSendTTS sends a message to the given channel with Text to Speech. channelID : The ID of a Channel. content : The message to send.

func (*Session) ChannelMessageUnpin 

func (s *Session) ChannelMessageUnpin(channelID, messageID int64) (err error)

ChannelMessageUnpin unpins a message within a given channel. channelID: The ID of a channel. messageID: The ID of a message.

func (*Session) ChannelMessages 

func (s *Session) ChannelMessages(channelID int64, limit int, beforeID, afterID, aroundID int64) (st []*Message, err error)

ChannelMessages returns an array of Message structures for messages within a given channel. channelID : The ID of a Channel. limit : The number messages that can be returned. (max 100) beforeID : If provided all messages returned will be before given ID. afterID : If provided all messages returned will be after given ID. aroundID : If provided all messages returned will be around given ID.

func (*Session) ChannelMessagesBulkDelete 

func (s *Session) ChannelMessagesBulkDelete(channelID int64, messages []int64) (err error)

ChannelMessagesBulkDelete bulk deletes the messages from the channel for the provided messageIDs. If only one messageID is in the slice call channelMessageDelete function. If the slice is empty do nothing. channelID : The ID of the channel for the messages to delete. messages : The IDs of the messages to be deleted. A slice of message IDs. A maximum of 100 messages.

func (*Session) ChannelMessagesPinned 

func (s *Session) ChannelMessagesPinned(channelID int64) (st []*Message, err error)

ChannelMessagesPinned returns an array of Message structures for pinned messages within a given channel channelID : The ID of a Channel.

func (*Session) ChannelPermissionDelete 

func (s *Session) ChannelPermissionDelete(channelID, targetID int64) (err error)

ChannelPermissionDelete deletes a specific permission override for the given channel. NOTE: Name of this func may change.

func (*Session) ChannelPermissionSet 

func (s *Session) ChannelPermissionSet(channelID, targetID int64, targetType PermissionOverwriteType, allow, deny int64) (err error)

ChannelPermissionSet creates a Permission Override for the given channel. NOTE: This func name may changed. Using Set instead of Create because you can both create a new override or update an override with this function.

func (*Session) ChannelTyping 

func (s *Session) ChannelTyping(channelID int64) (err error)

ChannelTyping broadcasts to all members that authenticated user is typing in the given channel. channelID : The ID of a Channel

func (*Session) ChannelWebhooks 

func (s *Session) ChannelWebhooks(channelID int64) (st []*Webhook, err error)

ChannelWebhooks returns all webhooks for a given channel. channelID: The ID of a channel.

func (*Session) Close 

func (s *Session) Close() error

Close maintains backwards compatibility with old discordgo versions It's the same as s.GatewayManager.Close()

func (*Session) CreateFollowupMessage 

func (s *Session) CreateFollowupMessage(applicationID int64, token string, data *WebhookParams) (st *Message, err error)

CreateFollowupMessage Creates a followup message for an Interaction. Functions the same as Execute Webhook, but wait is always true, and flags can be set to 64 in the body to send an ephemeral message. POST /webhooks/{application.id}/{interaction.token}

func (*Session) CreateGlobalApplicationCommand 

func (s *Session) CreateGlobalApplicationCommand(applicationID int64, command *CreateApplicationCommandRequest) (st *ApplicationCommand, err error)

CreateGlobalApplicationCommand creates a new global command. New global commands will be available in all guilds after 1 hour. POST /applications/{application.id}/commands

func (*Session) CreateGuildApplicationCommands 

func (s *Session) CreateGuildApplicationCommands(applicationID int64, guildID int64, data *CreateApplicationCommandRequest) (st *ApplicationCommand, err error)

CreateGuildApplicationCommands Create a new guild command. New guild commands will be available in the guild immediately. Returns 201 and an ApplicationCommand object. If the command did not already exist, it will count toward daily application command create limits. POST /applications/{application.id}/guilds/{guild.id}/commands

func (*Session) CreateInteractionResponse 

func (s *Session) CreateInteractionResponse(interactionID int64, token string, data *InteractionResponse) (err error)

CreateInteractionResponse Create a response to an Interaction from the gateway. Takes an Interaction response. POST /interactions/{interaction.id}/{interaction.token}/callback

func (*Session) DeleteFollowupMessage 

func (s *Session) DeleteFollowupMessage(applicationID int64, token string, messageID int64) (err error)

DeleteFollowupMessage Deletes a followup message for an Interaction. DELETE /webhooks/{application.id}/{interaction.token}/messages/{message.id}

func (*Session) DeleteGlobalApplicationCommand 

func (s *Session) DeleteGlobalApplicationCommand(applicationID int64, cmdID int64) (err error)

DeleteGlobalApplicationCommand deletes a global command. DELETE /applications/{application.id}/commands/{command.id}

func (*Session) DeleteGuildApplicationCommand 

func (s *Session) DeleteGuildApplicationCommand(applicationID int64, guildID int64, cmdID int64) (err error)

DeleteGuildApplicationCommand Delete a guild command. DELETE /applications/{application.id}/guilds/{guild.id}/commands/{command.id}

func (*Session) DeleteInteractionResponse 

func (s *Session) DeleteInteractionResponse(applicationID int64, token string) (err error)

DeleteInteractionResponse Deletes the initial Interaction response. DELETE /webhooks/{application.id}/{interaction.token}/messages/@original

func (*Session) EditFollowupMessage 

func (s *Session) EditFollowupMessage(applicationID int64, token string, messageID int64, data *WebhookParams) (st *Message, err error)

EditFollowupMessage Edits a followup message for an Interaction. Functions the same as Edit Webhook Message. PATCH /webhooks/{application.id}/{interaction.token}/messages/{message.id}

func (*Session) EditGlobalApplicationCommand 

func (s *Session) EditGlobalApplicationCommand(applicationID int64, cmdID int64, data *EditApplicationCommandRequest) (st *ApplicationCommand, err error)

EditGlobalApplicationCommand edits a global command. Updates will be available in all guilds after 1 hour. PATCH /applications/{application.id}/commands/{command.id}

func (*Session) EditGuildApplicationCommand 

func (s *Session) EditGuildApplicationCommand(applicationID int64, guildID int64, cmdID int64, data *EditApplicationCommandRequest) (st *ApplicationCommand, err error)

EditGuildApplicationCommand Edit a guild command. Updates for guild commands will be available immediately. PATCH /applications/{application.id}/guilds/{guild.id}/commands/{command.id}

func (*Session) EditGuildApplicationCommandPermissions 

func (s *Session) EditGuildApplicationCommandPermissions(applicationID int64, guildID int64, cmdID int64, permissions []*ApplicationCommandPermissions) (err error)

EditGuildApplicationCommandPermissions Edits command permissions for a specific command for your application in a guild. PUT /applications/{application.id}/guilds/{guild.id}/commands/{command.id}/permissions TODO: what does this return? docs dosn't say

func (*Session) EditOriginalInteractionResponse 

func (s *Session) EditOriginalInteractionResponse(applicationID int64, token string, data *WebhookParams) (st *Message, err error)

Edits the initial Interaction response. Functions the same as Edit Webhook Message. PATCH /webhooks/{application.id}/{interaction.token}/messages/@original

func (*Session) Gateway 

func (s *Session) Gateway() (gateway string, err error)

Gateway returns the websocket Gateway address

func (*Session) GatewayBot 

func (s *Session) GatewayBot() (st *GatewayBotResponse, err error)

GatewayBot returns the websocket Gateway address and the recommended number of shards

func (*Session) GetGlobalApplicationCommand 

func (s *Session) GetGlobalApplicationCommand(applicationID int64, cmdID int64) (st *ApplicationCommand, err error)

GetGlobalApplicationCommand fetches a global command for your application. Returns an ApplicationCommand object. GET /applications/{application.id}/commands/{command.id}

func (*Session) GetGlobalApplicationCommands 

func (s *Session) GetGlobalApplicationCommands(applicationID int64) (st []*ApplicationCommand, err error)

GetGlobalApplicationCommands fetches all of the global commands for your application. Returns an array of ApplicationCommand objects. GET /applications/{application.id}/commands

func (*Session) GetGuildApplicationCommand 

func (s *Session) GetGuildApplicationCommand(applicationID int64, guildID int64, cmdID int64) (st *ApplicationCommand, err error)

GetGuildApplicationCommand Fetch a guild command for your application. GET /applications/{application.id}/guilds/{guild.id}/commands/{command.id}

func (*Session) GetGuildApplicationCommandPermissions 

func (s *Session) GetGuildApplicationCommandPermissions(applicationID int64, guildID int64, cmdID int64) (st *GuildApplicationCommandPermissions, err error)

GetGuildApplicationCommandPermissions Fetches command permissions for a specific command for your application in a guild. GET /applications/{application.id}/guilds/{guild.id}/commands/{command.id}/permissions

func (*Session) GetGuildApplicationCommands 

func (s *Session) GetGuildApplicationCommands(applicationID int64, guildID int64) (st []*ApplicationCommand, err error)

GetGuildApplicationCommands fetches all of the guild commands for your application for a specific guild. GET /applications/{application.id}/guilds/{guild.id}/commands

func (*Session) GetGuildApplicationCommandsPermissions 

func (s *Session) GetGuildApplicationCommandsPermissions(applicationID int64, guildID int64) (st []*GuildApplicationCommandPermissions, err error)

GetGuildApplicationCommandPermissions Fetches command permissions for all commands for your application in a guild. GET /applications/{application.id}/guilds/{guild.id}/commands/permissions

func (*Session) GetOriginalInteractionResponse 

func (s *Session) GetOriginalInteractionResponse(applicationID int64, token string) (st *Message, err error)

GetOriginalInteractionResponse Returns the initial Interaction response. Functions the same as Get Webhook Message. GET /webhooks/{application.id}/{interaction.token}/messages/@original

func (*Session) Guild 

func (s *Session) Guild(guildID int64) (st *Guild, err error)

Guild returns a Guild structure of a specific Guild. guildID : The ID of a Guild

func (*Session) GuildAuditLog 

func (s *Session) GuildAuditLog(guildID, userID, beforeID int64, actionType, limit int) (st *GuildAuditLog, err error)

GuildAuditLog returns the audit log for a Guild. guildID : The ID of a Guild. userID : If provided the log will be filtered for the given ID. beforeID : If provided all log entries returned will be before the given ID. actionType : If provided the log will be filtered for the given Action Type. limit : The number messages that can be returned. (default 50, min 1, max 100)

func (*Session) GuildBan 

func (s *Session) GuildBan(guildID, userID int64) (st *GuildBan, err error)

GuildBan returns a ban object for the given user or a 404 not found if the ban cannot be found. Requires the BAN_MEMBERS permission. guildID : The ID of a Guild.

func (*Session) GuildBanCreate 

func (s *Session) GuildBanCreate(guildID, userID int64, days int) (err error)

GuildBanCreate bans the given user from the given guild. guildID : The ID of a Guild. userID : The ID of a User days : The number of days of previous comments to delete.

func (*Session) GuildBanCreateWithReason 

func (s *Session) GuildBanCreateWithReason(guildID, userID int64, reason string, days int) (err error)

GuildBanCreateWithReason bans the given user from the given guild also providing a reaso. guildID : The ID of a Guild. userID : The ID of a User reason : The reason for this ban days : The number of days of previous comments to delete.

func (*Session) GuildBanDelete 

func (s *Session) GuildBanDelete(guildID, userID int64) (err error)

GuildBanDelete removes the given user from the guild bans guildID : The ID of a Guild. userID : The ID of a User

func (*Session) GuildBans 

func (s *Session) GuildBans(guildID int64) (st []*GuildBan, err error)

GuildBans returns an array of User structures for all bans of a given guild. guildID : The ID of a Guild.

func (*Session) GuildChannelCreate 

func (s *Session) GuildChannelCreate(guildID int64, name string, ctype ChannelType) (st *Channel, err error)

GuildChannelCreate creates a new channel in the given guild guildID : The ID of a Guild. name : Name of the channel (2-100 chars length) ctype : Type of the channel

func (*Session) GuildChannelCreateWithOverwrites 

func (s *Session) GuildChannelCreateWithOverwrites(guildID int64, name string, ctype ChannelType, parentID int64, overwrites []*PermissionOverwrite) (st *Channel, err error)

GuildChannelCreateWithOverwrites creates a new channel in the given guild guildID : The ID of a Guild. name : Name of the channel (2-100 chars length) ctype : Type of the channel overwrites : slice of permission overwrites

func (*Session) GuildChannels 

func (s *Session) GuildChannels(guildID int64) (st []*Channel, err error)

GuildChannels returns an array of Channel structures for all channels of a given guild. guildID : The ID of a Guild.

func (*Session) GuildChannelsReorder 

func (s *Session) GuildChannelsReorder(guildID int64, channels []*Channel) (err error)

GuildChannelsReorder updates the order of channels in a guild guildID : The ID of a Guild. channels : Updated channels.

func (*Session) GuildCreate 

func (s *Session) GuildCreate(name string) (st *Guild, err error)

GuildCreate creates a new Guild name : A name for the Guild (2-100 characters)

func (*Session) GuildDelete 

func (s *Session) GuildDelete(guildID int64) (st *Guild, err error)

GuildDelete deletes a Guild. guildID : The ID of a Guild

func (*Session) GuildEdit 

func (s *Session) GuildEdit(guildID int64, g GuildParams) (st *Guild, err error)

GuildEdit edits a new Guild guildID : The ID of a Guild g : A GuildParams struct with the values Name, Region and VerificationLevel defined.

func (*Session) GuildEmbed 

func (s *Session) GuildEmbed(guildID int64) (st *GuildEmbed, err error)

GuildEmbed returns the embed for a Guild. guildID : The ID of a Guild.

func (*Session) GuildEmbedEdit 

func (s *Session) GuildEmbedEdit(guildID int64, enabled bool, channelID int64) (err error)

GuildEmbedEdit returns the embed for a Guild. guildID : The ID of a Guild.

func (*Session) GuildEmojiCreate 

func (s *Session) GuildEmojiCreate(guildID int64, name, image string, roles []int64) (emoji *Emoji, err error)

GuildEmojiCreate creates a new emoji guildID : The ID of a Guild. name : The Name of the Emoji. image : The base64 encoded emoji image, has to be smaller than 256KB. roles : The roles for which this emoji will be whitelisted, can be nil.

func (*Session) GuildEmojiDelete 

func (s *Session) GuildEmojiDelete(guildID, emojiID int64) (err error)

GuildEmojiDelete deletes an Emoji. guildID : The ID of a Guild. emojiID : The ID of an Emoji.

func (*Session) GuildEmojiEdit 

func (s *Session) GuildEmojiEdit(guildID, emojiID int64, name string, roles []int64) (emoji *Emoji, err error)

GuildEmojiEdit modifies an emoji guildID : The ID of a Guild. emojiID : The ID of an Emoji. name : The Name of the Emoji. roles : The roles for which this emoji will be whitelisted, can be nil.

func (*Session) GuildIcon 

func (s *Session) GuildIcon(guildID int64) (img image.Image, err error)

GuildIcon returns an image.Image of a guild icon. guildID : The ID of a Guild.

func (*Session) GuildIntegrationCreate 

func (s *Session) GuildIntegrationCreate(guildID int64, integrationType string, integrationID int64) (err error)

GuildIntegrationCreate creates a Guild Integration. guildID : The ID of a Guild. integrationType : The Integration type. integrationID : The ID of an integration.

func (*Session) GuildIntegrationDelete 

func (s *Session) GuildIntegrationDelete(guildID, integrationID int64) (err error)

GuildIntegrationDelete removes the given integration from the Guild. guildID : The ID of a Guild. integrationID : The ID of an integration.

func (*Session) GuildIntegrationEdit 

func (s *Session) GuildIntegrationEdit(guildID, integrationID int64, expireBehavior, expireGracePeriod int, enableEmoticons bool) (err error)

GuildIntegrationEdit edits a Guild Integration. guildID : The ID of a Guild. integrationType : The Integration type. integrationID : The ID of an integration. expireBehavior : The behavior when an integration subscription lapses (see the integration object documentation). expireGracePeriod : Period (in seconds) where the integration will ignore lapsed subscriptions. enableEmoticons : Whether emoticons should be synced for this integration (twitch only currently).

func (*Session) GuildIntegrationSync 

func (s *Session) GuildIntegrationSync(guildID, integrationID int64) (err error)

GuildIntegrationSync syncs an integration. guildID : The ID of a Guild. integrationID : The ID of an integration.

func (*Session) GuildIntegrations 

func (s *Session) GuildIntegrations(guildID int64) (st []*Integration, err error)

GuildIntegrations returns an array of Integrations for a guild. guildID : The ID of a Guild.

func (*Session) GuildInvites 

func (s *Session) GuildInvites(guildID int64) (st []*Invite, err error)

GuildInvites returns an array of Invite structures for the given guild guildID : The ID of a Guild.

func (*Session) GuildLeave 

func (s *Session) GuildLeave(guildID int64) (err error)

GuildLeave leaves a Guild. guildID : The ID of a Guild

func (*Session) GuildMember 

func (s *Session) GuildMember(guildID, userID int64) (st *Member, err error)

GuildMember returns a member of a guild. 

guildID   : The ID of a Guild.
userID    : The ID of a User

func (*Session) GuildMemberAdd 

func (s *Session) GuildMemberAdd(accessToken string, guildID, userID int64, nick string, roles []int64, mute, deaf bool) (err error)

GuildMemberAdd force joins a user to the guild. 

accessToken   : Valid access_token for the user.
guildID       : The ID of a Guild.
userID        : The ID of a User.
nick          : Value to set users nickname to
roles         : A list of role ID's to set on the member.
mute          : If the user is muted.
deaf          : If the user is deafened.

func (*Session) GuildMemberDelete 

func (s *Session) GuildMemberDelete(guildID, userID int64) (err error)

GuildMemberDelete removes the given user from the given guild. guildID : The ID of a Guild. userID : The ID of a User

func (*Session) GuildMemberDeleteWithReason 

func (s *Session) GuildMemberDeleteWithReason(guildID, userID int64, reason string) (err error)

GuildMemberDeleteWithReason removes the given user from the given guild. guildID : The ID of a Guild. userID : The ID of a User reason : The reason for the kick

func (*Session) GuildMemberEdit 

func (s *Session) GuildMemberEdit(guildID, userID int64, roles []string) (err error)

GuildMemberEdit edits the roles of a member. guildID : The ID of a Guild. userID : The ID of a User. roles : A list of role ID's to set on the member.

func (*Session) GuildMemberMove 

func (s *Session) GuildMemberMove(guildID, userID, channelID int64) (err error)

GuildMemberMove moves a guild member from one voice channel to another/none 

guildID   : The ID of a Guild.
userID    : The ID of a User.
channelID : The ID of a channel to move user to. Use 0 to disconnect the member.

NOTE : I am not entirely set on the name of this function and it may change prior to the final 1.0.0 release of Discordgo

func (*Session) GuildMemberNickname 

func (s *Session) GuildMemberNickname(guildID, userID int64, nickname string) (err error)

GuildMemberNickname updates the nickname of a guild member guildID : The ID of a guild userID : The ID of a user or "@me" which is a shortcut of the current user ID nickname : The new nickname

func (*Session) GuildMemberNicknameMe 

func (s *Session) GuildMemberNicknameMe(guildID int64, nickname string) (err error)

GuildMemberNicknameMe updates the nickname the current user guildID : The ID of a guild nickname : The new nickname

func (*Session) GuildMemberRoleAdd 

func (s *Session) GuildMemberRoleAdd(guildID, userID, roleID int64) (err error)

GuildMemberRoleAdd adds the specified role to a given member 

guildID   : The ID of a Guild.
userID    : The ID of a User.
roleID 	  : The ID of a Role to be assigned to the user.

func (*Session) GuildMemberRoleRemove 

func (s *Session) GuildMemberRoleRemove(guildID, userID, roleID int64) (err error)

GuildMemberRoleRemove removes the specified role to a given member 

guildID   : The ID of a Guild.
userID    : The ID of a User.
roleID 	  : The ID of a Role to be removed from the user.

func (*Session) GuildMemberTimeout added in v2.3.0 

func (s *Session) GuildMemberTimeout(guildID int64, userID int64, until *time.Time, reason string) (err error)

GuildMemberTimeout times out a guild member 

guildID   : The ID of a Guild.
userID    : The ID of a User.
until     : The timestamp for how long a member should be timed out.
            Set to nil to remove timeout.

func (*Session) GuildMemberTimeoutWithReason added in v2.3.0 

func (s *Session) GuildMemberTimeoutWithReason(guildID int64, userID int64, until *time.Time, reason string) (err error)

GuildMemberTimeoutWithReason times out a guild member with a mandatory reason 

guildID   : The ID of a Guild.
userID    : The ID of a User.
until     : The timestamp for how long a member should be timed out.
            Set to nil to remove timeout.

reason : The reason for the timeout

func (*Session) GuildMembers 

func (s *Session) GuildMembers(guildID int64, after int64, limit int) (st []*Member, err error)

GuildMembers returns a list of members for a guild. 

guildID  : The ID of a Guild.
after    : The id of the member to return members after
limit    : max number of members to return (max 1000)

func (*Session) GuildPrune 

func (s *Session) GuildPrune(guildID int64, days uint32) (count uint32, err error)

GuildPrune Begin as prune operation. Requires the 'KICK_MEMBERS' permission. Returns an object with one 'pruned' key indicating the number of members that were removed in the prune operation. guildID : The ID of a Guild. days : The number of days to count prune for (1 or more).

func (*Session) GuildPruneCount 

func (s *Session) GuildPruneCount(guildID int64, days uint32) (count uint32, err error)

GuildPruneCount Returns the number of members that would be removed in a prune operation. Requires 'KICK_MEMBER' permission. guildID : The ID of a Guild. days : The number of days to count prune for (1 or more).

func (*Session) GuildRoleCreate 

func (s *Session) GuildRoleCreate(guildID int64) (st *Role, err error)

GuildRoleCreate returns a new Guild Role. guildID: The ID of a Guild.

func (*Session) GuildRoleCreateComplex 

func (s *Session) GuildRoleCreateComplex(guildID int64, roleCreate RoleCreate) (st *Role, err error)

GuildRoleCreateComplex returns a new Guild Role. guildID: The ID of a Guild.

func (*Session) GuildRoleDelete 

func (s *Session) GuildRoleDelete(guildID, roleID int64) (err error)

GuildRoleDelete deletes an existing role. guildID : The ID of a Guild. roleID : The ID of a Role.

func (*Session) GuildRoleEdit 

func (s *Session) GuildRoleEdit(guildID, roleID int64, name string, color int, hoist bool, perm int64, mention bool) (st *Role, err error)

GuildRoleEdit updates an existing Guild Role with new values guildID : The ID of a Guild. roleID : The ID of a Role. name : The name of the Role. color : The color of the role (decimal, not hex). hoist : Whether to display the role's users separately. perm : The permissions for the role. mention : Whether this role is mentionable

func (*Session) GuildRoleReorder 

func (s *Session) GuildRoleReorder(guildID int64, roles []*Role) (st []*Role, err error)

GuildRoleReorder reoders guild roles guildID : The ID of a Guild. roles : A list of ordered roles.

func (*Session) GuildRoles 

func (s *Session) GuildRoles(guildID int64) (st []*Role, err error)

GuildRoles returns all roles for a given guild. guildID : The ID of a Guild.

func (*Session) GuildSplash 

func (s *Session) GuildSplash(guildID int64) (img image.Image, err error)

GuildSplash returns an image.Image of a guild splash image. guildID : The ID of a Guild.

func (*Session) GuildWebhooks 

func (s *Session) GuildWebhooks(guildID int64) (st []*Webhook, err error)

GuildWebhooks returns all webhooks for a given guild. guildID: The ID of a Guild.

func (*Session) GuildWithCounts 

func (s *Session) GuildWithCounts(guildID int64) (st *Guild, err error)

Guild returns a Guild structure of a specific Guild. guildID : The ID of a Guild

func (*Session) HandleEvent 

func (s *Session) HandleEvent(t string, i interface{})

Handles an event type by calling internal methods, firing handlers and firing the interface{} event.

func (*Session) Invite 

func (s *Session) Invite(inviteID string) (st *Invite, err error)

Invite returns an Invite structure of the given invite inviteID : The invite code

func (*Session) InviteAccept 

func (s *Session) InviteAccept(inviteID string) (st *Invite, err error)

InviteAccept accepts an Invite to a Guild or Channel inviteID : The invite code

func (*Session) InviteDelete 

func (s *Session) InviteDelete(inviteID string) (st *Invite, err error)

InviteDelete deletes an existing invite inviteID : the code of an invite

func (*Session) InviteWithCounts 

func (s *Session) InviteWithCounts(inviteID string) (st *Invite, err error)

InviteWithCounts returns an Invite structure of the given invite including approximate member counts inviteID : The invite code

func (*Session) MessageReactionAdd 

func (s *Session) MessageReactionAdd(channelID, messageID int64, emoji string) error

MessageReactionAdd creates an emoji reaction to a message. channelID : The channel ID. messageID : The message ID. emoji : Either the unicode emoji for the reaction, or a guild emoji identifier.

func (*Session) MessageReactionRemove 

func (s *Session) MessageReactionRemove(channelID, messageID int64, emoji string, userID int64) error

MessageReactionRemove deletes an emoji reaction to a message. channelID : The channel ID. messageID : The message ID. emoji : Either the unicode emoji for the reaction, or a guild emoji identifier. userID : The ID of the user to delete the reaction for.

func (*Session) MessageReactionRemoveEmoji 

func (s *Session) MessageReactionRemoveEmoji(channelID, messageID int64, emoji string) error

MessageReactionRemoveEmoji deletes all emoji reactions in a message. channelID : The channel ID. messageID : The message ID. emoji : Either the unicode emoji for the reaction, or a guild emoji identifier.

func (*Session) MessageReactionRemoveMe 

func (s *Session) MessageReactionRemoveMe(channelID, messageID int64, emoji string) error

MessageReactionRemoveMe deletes an emoji reaction to a message the current user made. channelID : The channel ID. messageID : The message ID. emoji : Either the unicode emoji for the reaction, or a guild emoji identifier.

func (*Session) MessageReactions 

func (s *Session) MessageReactions(channelID, messageID int64, emoji string, limit int, before, after int64) (st []*User, err error)

MessageReactions gets all the users reactions for a specific emoji. channelID : The channel ID. messageID : The message ID. emoji : Either the unicode emoji for the reaction, or a guild emoji identifier. limit : max number of users to return (max 100)

func (*Session) MessageReactionsRemoveAll 

func (s *Session) MessageReactionsRemoveAll(channelID, messageID int64) error

MessageReactionsRemoveAll deletes all reactions from a message channelID : The channel ID messageID : The message ID.

func (*Session) Open 

func (s *Session) Open() error

Open is a helper for Session.GatewayConnectionManager.Open()

func (*Session) RelationshipDelete 

func (s *Session) RelationshipDelete(userID int64) (err error)

RelationshipDelete removes the relationship with a user. userID: ID of the user.

func (*Session) RelationshipFriendRequestAccept 

func (s *Session) RelationshipFriendRequestAccept(userID int64) (err error)

RelationshipFriendRequestAccept accepts a friend request from a user. userID: ID of the user.

func (*Session) RelationshipFriendRequestSend 

func (s *Session) RelationshipFriendRequestSend(userID int64) (err error)

RelationshipFriendRequestSend sends a friend request to a user. userID: ID of the user.

func (*Session) RelationshipUserBlock 

func (s *Session) RelationshipUserBlock(userID int64) (err error)

RelationshipUserBlock blocks a user. userID: ID of the user.

func (*Session) RelationshipsGet 

func (s *Session) RelationshipsGet() (r []*Relationship, err error)

RelationshipsGet returns an array of all the relationships of the user.

func (*Session) RelationshipsMutualGet 

func (s *Session) RelationshipsMutualGet(userID int64) (mf []*User, err error)

RelationshipsMutualGet returns an array of all the users both @me and the given user is friends with. userID: ID of the user.

func (*Session) Request 

func (s *Session) Request(method, urlStr string, data interface{}, headers map[string]string) (response []byte, err error)

Request is the same as RequestWithBucketID but the bucket id is the same as the urlStr

func (*Session) RequestWithBucket 

func (s *Session) RequestWithBucket(method, urlStr, contentType string, b []byte, headers map[string]string, bucket *Bucket) (response []byte, err error)

RequestWithLockedBucket makes a request using a bucket that's already been locked

func (*Session) RequestWithBucketID 

func (s *Session) RequestWithBucketID(method, urlStr string, data interface{}, headers map[string]string, bucketID string) (response []byte, err error)

RequestWithBucketID makes a (GET/POST/...) Requests to Discord REST API with JSON data.

func (*Session) UpdateListeningStatus 

func (s *Session) UpdateListeningStatus(game string) (err error)

UpdateListeningStatus is used to set the user to "Listening to..." If game!="" then set to what user is listening to Else, set user to active and no game.

func (*Session) UpdateStatus 

func (s *Session) UpdateStatus(idle int, game string) (err error)

UpdateStatus is used to update the user's status. If idle>0 then set status to idle. If game!="" then set game. if otherwise, set status to active, and no game.

func (*Session) UpdateStatusComplex 

func (s *Session) UpdateStatusComplex(usd UpdateStatusData) (err error)

func (*Session) UpdateStreamingStatus 

func (s *Session) UpdateStreamingStatus(idle int, game string, url string) (err error)

UpdateStreamingStatus is used to update the user's streaming status. If idle>0 then set status to idle. If game!="" then set game. If game!="" and url!="" then set the status type to streaming with the URL set. if otherwise, set status to active, and no game.

func (*Session) User 

func (s *Session) User(userID int64) (st *User, err error)

User returns the user details of the given userID userID : A user ID

func (*Session) UserAvatar 

func (s *Session) UserAvatar(userID int64) (img image.Image, err error)

UserAvatar is deprecated. Please use UserAvatarDecode userID : A user ID or "@me" which is a shortcut of current user ID

func (*Session) UserAvatarDecode 

func (s *Session) UserAvatarDecode(u *User) (img image.Image, err error)

UserAvatarDecode returns an image.Image of a user's Avatar user : The user which avatar should be retrieved

func (*Session) UserChannelCreate 

func (s *Session) UserChannelCreate(recipientID int64) (st *Channel, err error)

UserChannelCreate creates a new User (Private) Channel with another User recipientID : A user ID for the user to which this channel is opened with.

func (*Session) UserChannelPermissions 

func (s *Session) UserChannelPermissions(userID, channelID int64) (apermissions int64, err error)

UserChannelPermissions returns the permission of a user in a channel. userID : The ID of the user to calculate permissions for. channelID : The ID of the channel to calculate permission for.

NOTE: This function is now deprecated and will be removed in the future. Please see the same function inside state.go

func (*Session) UserChannels 

func (s *Session) UserChannels() (st []*Channel, err error)

UserChannels returns an array of Channel structures for all private channels.

func (*Session) UserConnections 

func (s *Session) UserConnections() (conn []*UserConnection, err error)

UserConnections returns the user's connections

func (*Session) UserGuildSettingsEdit 

func (s *Session) UserGuildSettingsEdit(guildID int64, settings *UserGuildSettingsEdit) (st *UserGuildSettings, err error)

UserGuildSettingsEdit Edits the users notification settings for a guild guildID : The ID of the guild to edit the settings on settings : The settings to update

func (*Session) UserGuilds 

func (s *Session) UserGuilds(limit int, beforeID, afterID int64) (st []*UserGuild, err error)

UserGuilds returns an array of UserGuild structures for all guilds. limit : The number guilds that can be returned. (max 100) beforeID : If provided all guilds returned will be before given ID. afterID : If provided all guilds returned will be after given ID.

func (*Session) UserMe 

func (s *Session) UserMe() (st *User, err error)

UserMe returns the user details of the current user

func (*Session) UserNoteSet 

func (s *Session) UserNoteSet(userID int64, message string) (err error)

UserNoteSet sets the note for a specific user.

func (*Session) UserSettings 

func (s *Session) UserSettings() (st *Settings, err error)

UserSettings returns the settings for a given user

func (*Session) UserUpdate 

func (s *Session) UserUpdate(email, password, username, avatar, newPassword string) (st *User, err error)

UserUpdate updates a users settings.

func (*Session) UserUpdateStatus 

func (s *Session) UserUpdateStatus(status Status) (st *Settings, err error)

UserUpdateStatus update the user status status : The new status (Actual valid status are 'online','idle','dnd','invisible')

func (*Session) VoiceICE 

func (s *Session) VoiceICE() (st *VoiceICE, err error)

VoiceICE returns the voice server ICE information

func (*Session) VoiceRegions 

func (s *Session) VoiceRegions() (st []*VoiceRegion, err error)

VoiceRegions returns the voice server regions

func (*Session) Webhook 

func (s *Session) Webhook(webhookID int64) (st *Webhook, err error)

Webhook returns a webhook for a given ID webhookID: The ID of a webhook.

func (*Session) WebhookCreate 

func (s *Session) WebhookCreate(channelID int64, name, avatar string) (st *Webhook, err error)

WebhookCreate returns a new Webhook. channelID: The ID of a Channel. name : The name of the webhook. avatar : The avatar of the webhook.

func (*Session) WebhookDelete 

func (s *Session) WebhookDelete(webhookID int64) (err error)

WebhookDelete deletes a webhook for a given ID webhookID: The ID of a webhook.

func (*Session) WebhookDeleteWithToken 

func (s *Session) WebhookDeleteWithToken(webhookID int64, token string) (st *Webhook, err error)

WebhookDeleteWithToken deletes a webhook for a given ID with an auth token. webhookID: The ID of a webhook. token : The auth token for the webhook.

func (*Session) WebhookEdit 

func (s *Session) WebhookEdit(webhookID int64, name, avatar string, channelID int64) (st *Role, err error)

WebhookEdit updates an existing Webhook. webhookID: The ID of a webhook. name : The name of the webhook. avatar : The avatar of the webhook.

func (*Session) WebhookEditWithToken 

func (s *Session) WebhookEditWithToken(webhookID int64, token, name, avatar string) (st *Role, err error)

WebhookEditWithToken updates an existing Webhook with an auth token. webhookID: The ID of a webhook. token : The auth token for the webhook. name : The name of the webhook. avatar : The avatar of the webhook.

func (*Session) WebhookExecute 

func (s *Session) WebhookExecute(webhookID int64, token string, wait bool, data *WebhookParams) (err error)

WebhookExecute executes a webhook. webhookID: The ID of a webhook. token : The auth token for the webhook

func (*Session) WebhookExecuteComplex 

func (s *Session) WebhookExecuteComplex(webhookID int64, token string, wait bool, data *WebhookParams) (m *Message, err error)

WebhookExecuteComplex executes a webhook. webhookID: The ID of a webhook. token : The auth token for the webhook

func (*Session) WebhookWithToken 

func (s *Session) WebhookWithToken(webhookID int64, token string) (st *Webhook, err error)

WebhookWithToken returns a webhook for a given ID webhookID: The ID of a webhook. token : The auth token for the webhook.

type SessionStartLimit 

type SessionStartLimit struct {
	Total      int   `json:"total"`
	Remaining  int   `json:"remaining"`
	ResetAfter int64 `json:"reset_after"`
}

type Settings 

type Settings struct {
	RenderEmbeds           bool               `json:"render_embeds"`
	InlineEmbedMedia       bool               `json:"inline_embed_media"`
	InlineAttachmentMedia  bool               `json:"inline_attachment_media"`
	EnableTtsCommand       bool               `json:"enable_tts_command"`
	MessageDisplayCompact  bool               `json:"message_display_compact"`
	ShowCurrentGame        bool               `json:"show_current_game"`
	ConvertEmoticons       bool               `json:"convert_emoticons"`
	Locale                 string             `json:"locale"`
	Theme                  string             `json:"theme"`
	GuildPositions         IDSlice            `json:"guild_positions,string"`
	RestrictedGuilds       IDSlice            `json:"restricted_guilds,string"`
	FriendSourceFlags      *FriendSourceFlags `json:"friend_source_flags"`
	Status                 Status             `json:"status"`
	DetectPlatformAccounts bool               `json:"detect_platform_accounts"`
	DeveloperMode          bool               `json:"developer_mode"`
}

A Settings stores data for a specific users Discord client settings.

type StageInstanceCreate 

type StageInstanceCreate struct {
}

stage instance was created

type StageInstanceDelete 

type StageInstanceDelete struct {
}

stage instance was deleted or closed

type StageInstanceUpdate 

type StageInstanceUpdate struct {
}

stage instance was updated

type State 

type State struct {
	sync.RWMutex
	Ready

	// MaxMessageCount represents how many messages per channel the state will store.
	MaxMessageCount int
	TrackChannels   bool
	TrackEmojis     bool
	TrackMembers    bool
	TrackRoles      bool
	TrackVoice      bool
	TrackPresences  bool
	// contains filtered or unexported fields
}

A State contains the current known state. As discord sends this in a READY blob, it seems reasonable to simply use that struct as the data store.

func NewState 

func NewState() *State

NewState creates an empty state.

func (*State) Channel 

func (s *State) Channel(channelID int64) (*Channel, error)

Channel gets a channel by ID, it will look in all guilds and private channels.

func (*State) ChannelAdd 

func (s *State) ChannelAdd(channel *Channel) error

ChannelAdd adds a channel to the current world state, or updates it if it already exists. Channels may exist either as PrivateChannels or inside a guild.

func (*State) ChannelRemove 

func (s *State) ChannelRemove(channel *Channel) error

ChannelRemove removes a channel from current world state.

func (*State) Emoji 

func (s *State) Emoji(guildID, emojiID int64) (*Emoji, error)

Emoji returns an emoji for a guild and emoji id.

func (*State) EmojiAdd 

func (s *State) EmojiAdd(guildID int64, emoji *Emoji) error

EmojiAdd adds an emoji to the current world state.

func (*State) EmojisAdd 

func (s *State) EmojisAdd(guildID int64, emojis []*Emoji) error

EmojisAdd adds multiple emojis to the world state.

func (*State) Guild 

func (s *State) Guild(guildID int64) (*Guild, error)

Guild gets a guild by ID. Useful for querying if @me is in a guild: 

_, err := discordgo.Session.State.Guild(guildID)
isInGuild := err == nil

func (*State) GuildAdd 

func (s *State) GuildAdd(guild *Guild) error

GuildAdd adds a guild to the current world state, or updates it if it already exists.

func (*State) GuildChannel 

func (s *State) GuildChannel(guildID, channelID int64) (*Channel, error)

GuildChannel gets a channel by ID from a guild. This method is Deprecated, use Channel(channelID)

func (*State) GuildRemove 

func (s *State) GuildRemove(guild *Guild) error

GuildRemove removes a guild from current world state.

func (*State) Member 

func (s *State) Member(guildID, userID int64) (*Member, error)

Member gets a member by ID from a guild.

func (*State) MemberAdd 

func (s *State) MemberAdd(member *Member) error

MemberAdd adds a member to the current world state, or updates it if it already exists.

func (*State) MemberRemove 

func (s *State) MemberRemove(member *Member) error

MemberRemove removes a member from current world state.

func (*State) Message 

func (s *State) Message(channelID, messageID int64) (*Message, error)

Message gets a message by channel and message ID.

func (*State) MessageAdd 

func (s *State) MessageAdd(message *Message) error

MessageAdd adds a message to the current world state, or updates it if it exists. If the channel cannot be found, the message is discarded. Messages are kept in state up to s.MaxMessageCount per channel.

func (*State) MessageRemove 

func (s *State) MessageRemove(message *Message) error

MessageRemove removes a message from the world state.

func (*State) OnInterface 

func (s *State) OnInterface(se *Session, i interface{}) (err error)

OnInterface handles all events related to states.

func (*State) Presence 

func (s *State) Presence(guildID, userID int64) (*Presence, error)

Presence gets a presence by ID from a guild.

func (*State) PresenceAdd 

func (s *State) PresenceAdd(guildID int64, presence *Presence) error

PresenceAdd adds a presence to the current world state, or updates it if it already exists.

func (*State) PresenceRemove 

func (s *State) PresenceRemove(guildID int64, presence *Presence) error

PresenceRemove removes a presence from the current world state.

func (*State) PrivateChannel 

func (s *State) PrivateChannel(channelID int64) (*Channel, error)

PrivateChannel gets a private channel by ID. This method is Deprecated, use Channel(channelID)

func (*State) Role 

func (s *State) Role(guildID, roleID int64) (*Role, error)

Role gets a role by ID from a guild.

func (*State) RoleAdd 

func (s *State) RoleAdd(guildID int64, role *Role) error

RoleAdd adds a role to the current world state, or updates it if it already exists.

func (*State) RoleRemove 

func (s *State) RoleRemove(guildID, roleID int64) error

RoleRemove removes a role from current world state by ID.

func (*State) UserChannelPermissions 

func (s *State) UserChannelPermissions(userID, channelID int64) (apermissions int64, err error)

UserChannelPermissions returns the permission of a user in a channel. userID : The ID of the user to calculate permissions for. channelID : The ID of the channel to calculate permission for.

func (*State) UserColor 

func (s *State) UserColor(userID, channelID int64) int

UserColor returns the color of a user in a channel. While colors are defined at a Guild level, determining for a channel is more useful in message handlers. 0 is returned in cases of error, which is the color of @everyone. userID : The ID of the user to calculate the color for. channelID : The ID of the channel to calculate the color for.

type Status 

type Status string

Status type definition 

const (
	StatusOnline       Status = "online"
	StatusIdle         Status = "idle"
	StatusDoNotDisturb Status = "dnd"
	StatusInvisible    Status = "invisible"
	StatusOffline      Status = "offline"
)

Constants for Status with the different current available status

type StdGatewayIdentifyRatleimiter 

type StdGatewayIdentifyRatleimiter struct {
	// contains filtered or unexported fields
}

Standard implementation of the GatewayIdentifyRatelimiter

func (*StdGatewayIdentifyRatleimiter) RatelimitIdentify 

func (rl *StdGatewayIdentifyRatleimiter) RatelimitIdentify(shardID int)

type TextInput added in v2.3.0 

type TextInput struct {
	CustomID    string         `json:"custom_id"`
	Label       string         `json:"label"`
	Style       TextInputStyle `json:"style"`
	Placeholder string         `json:"placeholder,omitempty"`
	Value       string         `json:"value,omitempty"`
	Required    bool           `json:"required"`
	MinLength   int            `json:"min_length,omitempty"`
	MaxLength   int            `json:"max_length,omitempty"`
}

TextInput represents text input component.

func (TextInput) MarshalJSON added in v2.3.0 

func (m TextInput) MarshalJSON() ([]byte, error)

MarshalJSON is a method for marshaling TextInput to a JSON object.

func (TextInput) Type added in v2.3.0 

func (TextInput) Type() ComponentType

Type is a method to get the type of a component.

type TextInputStyle added in v2.3.0 

type TextInputStyle uint

TextInputStyle is style of text in TextInput component. 

const (
	TextInputShort     TextInputStyle = 1
	TextInputParagraph TextInputStyle = 2
)

Text styles

type ThreadCreate 

type ThreadCreate struct {
	Channel
}

thread created, also sent when being added to a private thread

type ThreadDelete 

type ThreadDelete struct {
	ID       int64 `json:"id,string"`
	GuildID  int64 `json:"guild_id,string"`
	ParentID int64 `json:"parent_id,string"`
	Type     ChannelType
}

thread was deleted

type ThreadListSync 

type ThreadListSync struct {
	GuildID  int64           `json:"guild_id,string"` // snowflake	the id of the guild
	Channels IDSlice         `json:"channel_ids"`     // array of snowflakes	the parent channel ids whose threads are being synced. If omitted, then threads were synced for the entire guild. This array may contain channel_ids that have no active threads as well, so you know to clear that data.
	Threads  []*Channel      `json:"threads"`         // array of channel objects	all active threads in the given channels that the current user can access
	Members  []*ThreadMember `json:"members"`         // array of thread member objects	all thread member objects from the synced threads for the current user, indicating which threads the current user has been added to
}

sent when gaining access to a channel, contains all active threads in that channel

type ThreadMember 

type ThreadMember struct {
	ID            int64     `json:"id,string"`      // the id of the thread (NOT INCLUDED IN GUILDCREATE)
	UserID        int64     `json:"user_id,string"` // the id of the user (NOT INCLUDED IN GUILDCREATE)
	JoinTimestamp Timestamp `json:"join_timestamp"` // the time the current user last joined the thread
	Flags         int       `json:"flags"`          // any user-thread settings, currently only used for notifications
}

A thread member is used to indicate whether a user has joined a thread or not.

type ThreadMemberUpdate 

type ThreadMemberUpdate struct {
	ThreadMember
}

thread member for the current user was updated

type ThreadMembersUpdate 

type ThreadMembersUpdate struct {
	ID             int64           `json:"id,string"`          // snowflake	the id of the thread
	GuildID        int64           `json:"guild_id,string"`    // snowflake	the id of the guild
	MemberCount    int             `json:"member_count"`       // integer	the approximate number of members in the thread, capped at 50
	AddedMembers   []*ThreadMember `json:"added_members"`      // array of thread member objects	the users who were added to the thread
	RemovedMembers IDSlice         `json:"removed_member_ids"` // array of snowflakes	the id of the users who were removed from the thread
}

some user(s) were added to or removed from a thread

type ThreadMetadata 

type ThreadMetadata struct {
	Archived            bool   `json:"archived"`              // whether the thread is archived
	AutoArchiveDuration int    `json:"auto_archive_duration"` // duration in minutes to automatically archive the thread after recent activity, can be set to: 60, 1440, 4320, 10080
	ArchiveTimestamp    string `json:"archive_timestamp"`     // timestamp when the thread's archive status was last changed, used for calculating recent activity
	Locked              bool   `json:"locked"`                // whether the thread is locked; when a thread is locked, only users with MANAGE_THREADS can unarchive it
}

type ThreadUpdate 

type ThreadUpdate struct {
	Channel
}

thread was updated

type TimeStamps 

type TimeStamps struct {
	EndTimestamp   int64 `json:"end,omitempty"`
	StartTimestamp int64 `json:"start,omitempty"`
}

A TimeStamps struct contains start and end times used in the rich presence "playing .." Game

func (*TimeStamps) NKeys 

func (t *TimeStamps) NKeys() int

func (*TimeStamps) UnmarshalJSON 

func (t *TimeStamps) UnmarshalJSON(b []byte) error

UnmarshalJSON unmarshals JSON into TimeStamps struct

func (*TimeStamps) UnmarshalJSONObject 

func (t *TimeStamps) UnmarshalJSONObject(dec *gojay.Decoder, key string) error

type Timestamp 

type Timestamp string

Timestamp stores a timestamp, as sent by the Discord API.

func (Timestamp) Parse 

func (t Timestamp) Parse() (time.Time, error)

Parse parses a timestamp string into a time.Time object. The only time this can fail is if Discord changes their timestamp format.

type TooManyRequests 

type TooManyRequests struct {
	Bucket     string  `json:"bucket"`
	Message    string  `json:"message"`
	RetryAfter float64 `json:"retry_after"`
	Global     bool    `json:"global"`
}

A TooManyRequests struct holds information received from Discord when receiving a HTTP 429 response.

func (*TooManyRequests) RetryAfterDur 

func (t *TooManyRequests) RetryAfterDur() time.Duration

type TypingStart 

type TypingStart struct {
	UserID    int64 `json:"user_id,string"`
	ChannelID int64 `json:"channel_id,string"`
	Timestamp int   `json:"timestamp"`
	GuildID   int64 `json:"guild_id,string,omitempty"`
}

TypingStart is the data for a TypingStart event.

func (*TypingStart) GetChannelID 

func (e *TypingStart) GetChannelID() int64

func (*TypingStart) GetGuildID 

func (e *TypingStart) GetGuildID() int64

func (*TypingStart) NKeys 

func (ts *TypingStart) NKeys() int

func (*TypingStart) UnmarshalJSONObject 

func (ts *TypingStart) UnmarshalJSONObject(dec *gojay.Decoder, key string) error

implement gojay.UnmarshalerJSONObject

type UpdateStatusData 

type UpdateStatusData struct {
	IdleSince *int   `json:"since"`
	Game      *Game  `json:"game"`
	AFK       bool   `json:"afk"`
	Status    string `json:"status"`
}

type User 

type User struct {
	// The ID of the user.
	ID int64 `json:"id,string"`

	// The user's username.
	Username string `json:"username"`

	// The hash of the user's avatar. Use Session.UserAvatar
	// to retrieve the avatar itself.
	Avatar string `json:"avatar"`

	// The user's chosen language option.
	Locale string `json:"locale"`

	// The discriminator of the user (4 numbers after name).
	Discriminator string `json:"discriminator"`

	// Whether the user is a bot.
	Bot bool `json:"bot"`
}

A User stores all data for an individual Discord user.

func (*User) AvatarURL 

func (u *User) AvatarURL(size string) string

AvatarURL returns a URL to the user's avatar. 

size:    The size of the user's avatar as a power of two
         if size is an empty string, no size parameter will
         be added to the URL.

func (*User) Mention 

func (u *User) Mention() string

Mention return a string which mentions the user

func (*User) NKeys 

func (u *User) NKeys() int

func (*User) String 

func (u *User) String() string

String returns a unique identifier of the form username#discriminator

func (*User) UnmarshalJSONObject 

func (u *User) UnmarshalJSONObject(dec *gojay.Decoder, key string) error

implement gojay.UnmarshalerJSONObject

type UserConnection 

type UserConnection struct {
	ID           string         `json:"id"`
	Name         string         `json:"name"`
	Type         string         `json:"type"`
	Revoked      bool           `json:"revoked"`
	Integrations []*Integration `json:"integrations"`
}

UserConnection is a Connection returned from the UserConnections endpoint

type UserGuild 

type UserGuild struct {
	ID          int64  `json:"id,string"`
	Name        string `json:"name"`
	Icon        string `json:"icon"`
	Owner       bool   `json:"owner"`
	Permissions int64  `json:"permissions,string"`
}

A UserGuild holds a brief version of a Guild

type UserGuildSettings 

type UserGuildSettings struct {
	SupressEveryone      bool                                `json:"suppress_everyone"`
	Muted                bool                                `json:"muted"`
	MobilePush           bool                                `json:"mobile_push"`
	MessageNotifications int                                 `json:"message_notifications"`
	GuildID              int64                               `json:"guild_id,string"`
	ChannelOverrides     []*UserGuildSettingsChannelOverride `json:"channel_overrides"`
}

A UserGuildSettings stores data for a users guild settings.

type UserGuildSettingsChannelOverride 

type UserGuildSettingsChannelOverride struct {
	Muted                bool  `json:"muted"`
	MessageNotifications int   `json:"message_notifications"`
	ChannelID            int64 `json:"channel_id,string"`
}

A UserGuildSettingsChannelOverride stores data for a channel override for a users guild settings.

type UserGuildSettingsEdit 

type UserGuildSettingsEdit struct {
	SupressEveryone      bool                                         `json:"suppress_everyone"`
	Muted                bool                                         `json:"muted"`
	MobilePush           bool                                         `json:"mobile_push"`
	MessageNotifications int                                          `json:"message_notifications"`
	ChannelOverrides     map[string]*UserGuildSettingsChannelOverride `json:"channel_overrides"`
}

A UserGuildSettingsEdit stores data for editing UserGuildSettings

type UserGuildSettingsUpdate 

type UserGuildSettingsUpdate struct {
	*UserGuildSettings
}

UserGuildSettingsUpdate is the data for a UserGuildSettingsUpdate event.

type UserNoteUpdate 

type UserNoteUpdate struct {
	ID   int64  `json:"id,string"`
	Note string `json:"note"`
}

UserNoteUpdate is the data for a UserNoteUpdate event.

type UserSettingsUpdate 

type UserSettingsUpdate map[string]interface{}

UserSettingsUpdate is the data for a UserSettingsUpdate event.

type UserUpdate 

type UserUpdate struct {
	*User
}

UserUpdate is the data for a UserUpdate event.

func (*UserUpdate) NKeys 

func (u *UserUpdate) NKeys() int

func (*UserUpdate) UnmarshalJSONObject 

func (u *UserUpdate) UnmarshalJSONObject(dec *gojay.Decoder, key string) error

implement gojay.UnmarshalerJSONObject

type VerificationLevel 

type VerificationLevel int

VerificationLevel type definition 

const (
	VerificationLevelNone VerificationLevel = iota
	VerificationLevelLow
	VerificationLevelMedium
	VerificationLevelHigh
)

Constants for VerificationLevel levels from 0 to 3 inclusive

type VoiceConnection 

type VoiceConnection struct {
	sync.RWMutex

	Debug     bool // If true, print extra logging -- DEPRECATED
	LogLevel  int
	Ready     bool // If true, voice is ready to send/receive audio
	UserID    int64
	GuildID   int64
	ChannelID int64

	OpusSend chan []byte  // Chan for sending opus audio
	OpusRecv chan *Packet // Chan for receiving opus audio

	// Used to allow blocking until connected
	Connected chan bool
	// contains filtered or unexported fields
}

A VoiceConnection struct holds all the data and functions related to a Discord Voice Connection.

func (*VoiceConnection) AddHandler 

func (v *VoiceConnection) AddHandler(h VoiceSpeakingUpdateHandler)

AddHandler adds a Handler for VoiceSpeakingUpdate events.

func (*VoiceConnection) ChangeChannel 

func (v *VoiceConnection) ChangeChannel(channelID int64, mute, deaf bool) (err error)

ChangeChannel sends Discord a request to change channels within a Guild !!! NOTE !!! This function may be removed in favour of just using ChannelVoiceJoin

func (*VoiceConnection) Close 

func (v *VoiceConnection) Close()

Close closes the voice ws and udp connections

func (*VoiceConnection) Disconnect 

func (v *VoiceConnection) Disconnect() (err error)

Disconnect disconnects from this voice channel and closes the websocket and udp connections to Discord. !!! NOTE !!! this function may be removed in favour of ChannelVoiceLeave

func (*VoiceConnection) Speaking 

func (v *VoiceConnection) Speaking(b bool) (err error)

Speaking sends a speaking notification to Discord over the voice websocket. This must be sent as true prior to sending audio and should be set to false once finished sending audio. 

b  : Send true if speaking, false if not.

type VoiceICE 

type VoiceICE struct {
	TTL     string       `json:"ttl"`
	Servers []*ICEServer `json:"servers"`
}

A VoiceICE stores data for voice ICE servers.

type VoiceRegion 

type VoiceRegion struct {
	ID       string `json:"id"`
	Name     string `json:"name"`
	Hostname string `json:"sample_hostname"`
	Port     int    `json:"sample_port"`
}

A VoiceRegion stores data for a specific voice region server.

type VoiceServerUpdate 

type VoiceServerUpdate struct {
	Token    string `json:"token"`
	GuildID  int64  `json:"guild_id,string"`
	Endpoint string `json:"endpoint"`
}

VoiceServerUpdate is the data for a VoiceServerUpdate event.

func (*VoiceServerUpdate) GetGuildID 

func (e *VoiceServerUpdate) GetGuildID() int64

type VoiceSpeakingUpdate 

type VoiceSpeakingUpdate struct {
	UserID   string `json:"user_id"`
	SSRC     int    `json:"ssrc"`
	Speaking bool   `json:"speaking"`
}

VoiceSpeakingUpdate is a struct for a VoiceSpeakingUpdate event.

type VoiceSpeakingUpdateHandler 

type VoiceSpeakingUpdateHandler func(vc *VoiceConnection, vs *VoiceSpeakingUpdate)

VoiceSpeakingUpdateHandler type provides a function definition for the VoiceSpeakingUpdate event

type VoiceState 

type VoiceState struct {
	UserID    int64  `json:"user_id,string"`
	SessionID string `json:"session_id"`
	ChannelID int64  `json:"channel_id,string"`
	GuildID   int64  `json:"guild_id,string"`
	Suppress  bool   `json:"suppress"`
	SelfMute  bool   `json:"self_mute"`
	SelfDeaf  bool   `json:"self_deaf"`
	Mute      bool   `json:"mute"`
	Deaf      bool   `json:"deaf"`
}

A VoiceState stores the voice states of Guilds

type VoiceStateUpdate 

type VoiceStateUpdate struct {
	*VoiceState
}

VoiceStateUpdate is the data for a VoiceStateUpdate event.

type Webhook 

type Webhook struct {
	ID        int64  `json:"id,string"`
	GuildID   int64  `json:"guild_id,string"`
	ChannelID int64  `json:"channel_id,string"`
	User      *User  `json:"user"`
	Name      string `json:"name"`
	Avatar    string `json:"avatar"`
	Token     string `json:"token"`
}

Webhook stores the data for a webhook.

type WebhookParams 

type WebhookParams struct {
	Content         string             `json:"content,omitempty"`
	Username        string             `json:"username,omitempty"`
	AvatarURL       string             `json:"avatar_url,omitempty"`
	TTS             bool               `json:"tts,omitempty"`
	File            *File              `json:"-,omitempty"`
	Components      []MessageComponent `json:"components"`
	Embeds          []*MessageEmbed    `json:"embeds,omitempty"`
	Flags           int64              `json:"flags,omitempty"`
	AllowedMentions *AllowedMentions   `json:"allowed_mentions,omitempty"`
}

WebhookParams is a struct for webhook params, used in the WebhookExecute command.

type WebhooksUpdate 

type WebhooksUpdate struct {
	GuildID   int64 `json:"guild_id,string"`
	ChannelID int64 `json:"channel_id,string"`
}

WebhooksUpdate is the data for a WebhooksUpdate event

func (*WebhooksUpdate) GetChannelID 

func (e *WebhooksUpdate) GetChannelID() int64

func (*WebhooksUpdate) GetGuildID 

func (e *WebhooksUpdate) GetGuildID() int64

Source Files

View all Source files

Directories

Path Synopsis
tools
cmd/eventhandlers

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.