Instalação
Instale o DiscordKit e prepare um projeto Go para desenvolver aplicações para Discord.
DiscordKit é distribuído como um módulo Go normal.
Requisitos
Seção intitulada “Requisitos”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 projeto Go
Seção intitulada “Crie um projeto Go”Crie um diretório para sua aplicação:
mkdir my-discord-botcd my-discord-botInicialize um módulo Go:
go mod init example.com/my-discord-botSubstitua example.com/my-discord-bot pelo caminho real do módulo que pretende
utilizar.
Instale o DiscordKit
Seção intitulada “Instale o DiscordKit”Adicione DiscordKit ao projeto:
go get github.com/freitaseric/discordkitGo adicionará DiscordKit e suas dependências necessárias ao go.mod.
Verifique a instalação
Seção intitulada “Verifique a instalação”Crie um arquivo main.go:
package main
import ( "fmt"
"github.com/freitaseric/discordkit")
func main() { router := discordkit.NewRouter()
fmt.Printf("%T\n", router)}Execute:
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.
Versões durante o desenvolvimento
Seção intitulada “Versões durante o desenvolvimento”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:
go get github.com/freitaseric/discordkit@VERSIONPróximo passo
Seção intitulada “Próximo passo”Agora vamos estabelecer uma conexão completa com o Discord em Seu primeiro bot.