Pular para o conteúdo
Documentação DiscordKit

Instalação

Instale o DiscordKit e prepare um projeto Go para desenvolver aplicações para Discord.

Abrir texto

DiscordKit é distribuído como um módulo Go normal.

Atualmente, DiscordKit requer:

  • Go 1.26 ou superior;
  • uma aplicação Discord e um token de bot;
  • discordgo através da versão utilizada pelo próprio DiscordKit.

Você não precisa instalar discordgo separadamente ao iniciar um projeto novo. O sistema de módulos do Go resolverá automaticamente as dependências do DiscordKit.

Crie um diretório para sua aplicação:

Janela do terminal
mkdir my-discord-bot
cd my-discord-bot

Inicialize um módulo Go:

Janela do terminal
go mod init example.com/my-discord-bot

Substitua example.com/my-discord-bot pelo caminho real do módulo que pretende utilizar.

Adicione DiscordKit ao projeto:

Janela do terminal
go get github.com/freitaseric/discordkit

Go adicionará DiscordKit e suas dependências necessárias ao go.mod.

Crie um arquivo main.go:

package main
import (
"fmt"
"github.com/freitaseric/discordkit"
)
func main() {
router := discordkit.NewRouter()
fmt.Printf("%T\n", router)
}

Execute:

Janela do terminal
go run .

Se o projeto compilar normalmente, DiscordKit está pronto para ser utilizado.

Usando DiscordKit em um projeto discordgo existente

Seção intitulada “Usando DiscordKit em um projeto discordgo existente”

DiscordKit não cria nem substitui sua discordgo.Session.

Aplicações existentes podem adotá-lo gradualmente:

session, err := discordgo.New("Bot " + token)
if err != nil {
return err
}
router := discordkit.NewRouter()
session.AddHandler(router.Handle)

Handlers existentes do discordgo podem coexistir com handlers gerenciados pelo DiscordKit enquanto a aplicação é migrada aos poucos.

Antes de DiscordKit atingir uma API estável v1, novas versões podem introduzir mudanças incompatíveis.

Para manter builds reproduzíveis, mantenha go.mod e go.sum versionados e, quando necessário, utilize uma versão explícita:

Janela do terminal
go get github.com/freitaseric/discordkit@VERSION

Agora vamos estabelecer uma conexão completa com o Discord em Seu primeiro bot.