Your first bot
Let’s build the simplest bot you can using AckCord. The only thing it will do is to log in, and print a line to the console when it has done so.
First add AckCord to your project by adding these statements to your
resolvers += Resolver.JCenterRepository
libraryDependencies += "net.katsstuff" %% "ackcord" % "0.18.1"
Most of these examples assume these imports.
Next we need a bot token. You can get one by going to https://discord.com/developers/applications, creating a new application, and then creating a bot for your application.
val token = "<token>" //Your Discord token. Be very careful to never give this to anyone else
The first thing you need when logging in is a
ClientSettings instance. For you
first bot, the defaults are fine, just pass it your token. This value also
contains a lot of other useful stuff, so keep it around. This time you’ll only
use the execution context it contains, and create a client. Using that client
you can then listen for specific messages and events. Once you have set
everything up, you call login.
val clientSettings = ClientSettings(token)
//The client settings contains an excecution context that you can use before you have access to the client
//In real code, please dont block on the client construction
val client = Await.result(clientSettings.createClient(), Duration.Inf)
//The client also contains an execution context
case _: APIMessage.Ready => println("Now ready")
And that’s it. You’ve now created your first bot. Now, this is probably not the only thing you want to do. Next I would recommend you to check out the pages for events, requests, and CacheSnapshot as well. Going over the commands API is probably also a smart thing to do.