Startseite Erkunden Hilfe
Anmelden
thisnthat
/
discordgo
1
0
Fork 0
Dateien Issues 0 Pull-Requests 0 Wiki

Keine Beschreibung

Struktur: afae8a76ba
Branches Tags
discordgo
ZIP TAR.GZ
Bruce Marriner afae8a76ba Cleanup. vor 9 Jahren
bot a5336e53da Inital add of example bot vor 9 Jahren
LICENSE bc323b57a1 Initial commit vor 9 Jahren
README.md afae8a76ba Cleanup. vor 9 Jahren
channel.go 05ff822438 Stop trying to fight Discord's Int's as Strings and just use strings. vor 9 Jahren
discord.go f4445fb782 Commented out file, as it's not being used now. vor 9 Jahren
guild.go 91207ece15 Large additions to REST API and Websocket API. vor 9 Jahren
restapi.go 91207ece15 Large additions to REST API and Websocket API. vor 9 Jahren
session.go a3903aaa50 Fixes to GuildRole events vor 9 Jahren
structs.go 91207ece15 Large additions to REST API and Websocket API. vor 9 Jahren
users.go 05ff822438 Stop trying to fight Discord's Int's as Strings and just use strings. vor 9 Jahren
util.go 2448f72489 Major rewrite of REST API to include constants for all endpoints vor 9 Jahren
wsapi.go 91207ece15 Large additions to REST API and Websocket API. vor 9 Jahren

README.md

Discordgo

A Discord API for Golang

Discordgo provides a mostly complete low-level Golang interface to the Discord REST and Websocket API.

Usage Example

package main

import (
	"fmt"
	"time"

	"github.com/bwmarrin/discordgo"
)

func main() {

	var err error

	// Create a new Discord Session and set a handler for the OnMessageCreate
    // event that happens for every new message on any channel
	Session := discordgo.Session{
		OnMessageCreate: messageCreate,
	}

	// Login to the Discord server and store the authentication token
	// inside the Session
	Session.Token, err = Session.Login("coolusername", "cleverpassword")
	if err != nil {
		fmt.Println(err)
		return
	}

	// Open websocket connection
	err = Session.Open()
	if err != nil {
		fmt.Println(err)
	}

	// Do websocket handshake.
	err = Session.Handshake()
	if err != nil {
		fmt.Println(err)
	}

	// Listen for events.
	Session.Listen()
	return
}

func messageCreate(s *discordgo.Session, m discordgo.Message) {
	fmt.Printf("%25d %s %20s > %s\n", m.ChannelId, time.Now().Format(time.Stamp), m.Author.Username, m.Content)
}

What Works

Low level functions exist for the majority of the REST and Websocket API.

  • Login/Logout
  • Open/Close Websocket and listen for events.
  • Accept/Create/Delete Invites
  • Get User details (Name, ID, Settings, etc)
  • List/Create User Channels (Private Message Channels)
  • List/Create Guilds
  • List/Create Guild Channels
  • List Guild Members
  • Receive/Send Messages to Channels

What's Unfinished

  • Editing User Profile settings
  • Permissions related functions.
  • Functions for Maintenance Status
  • Voice Channel support.

Credits

Special thanks goes to both the below projects who helped me get started with this project. If you're looking for alternative Golang interfaces to Discord please check both of these out.

Other Discord APIs