暫無描述

Bruce Marriner 7fc9331e04 Created message.go to store code related to the Message struct. 9 年之前
examples 29a6b3abef Renamed example to examples 9 年之前
tests 4f3b4b7a4b Added isConnected helper func 9 年之前
.travis.yml 6be9be241d Lets see if Travis will test using Go 1.3, 1.4, 1.5, and tip. 9 年之前
LICENSE bc323b57a1 Initial commit 9 年之前
README.md aebe839e13 Updated readme 9 年之前
discord.go 301fb980d3 Updated copyright year, cleaned up some comments. 9 年之前
endpoints.go 301fb980d3 Updated copyright year, cleaned up some comments. 9 年之前
message.go 7fc9331e04 Created message.go to store code related to the Message struct. 9 年之前
restapi.go 351f477135 Merge pull request #55 from Rivalo/develop 9 年之前
state.go 7ad8d52369 Contributions will be listed elsewhere. 9 年之前
structs.go 7fc9331e04 Created message.go to store code related to the Message struct. 9 年之前
util.go 301fb980d3 Updated copyright year, cleaned up some comments. 9 年之前
voice.go 50394ab954 Merge branch 'develop' of https://github.com/bwmarrin/Discordgo into develop 9 年之前
wsapi.go d998b1fac2 Normalize name capitalization 9 年之前

README.md

Discordgo GoDoc Go report Build Status

Discordgo is a Go package that provides low level bindings to the Discord chat client API.

  • See dgVoice for experimental voice support.

Join #go_discordgo Discord chat channel for support.

Getting Started

Installing

Discordgo has been tested to compile on Debian 8 (Go 1.3.3), FreeBSD 10 (Go 1.5.1), and Windows 7 (Go 1.5.2).

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

$ go get github.com/bwmarrin/discordgo

Usage

Import the package into your project.

import "github.com/bwmarrin/discordgo"

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

discord, err := discordgo.New("username", "password")

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 functions, constants, and structures.

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.

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

  • Basic - New A basic example using the easy New() helper function
  • Basic - API A basic example using the low level API functions.
  • Bruxism A chat bot for YouTube and Discord
  • GoGerard A modern bot for Discord
  • Digo A pluggable bot for your Discord server

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.