That's it! You have created a bot and put it in your discord server.
Starting your bot with Kord
Go to your bot's application page from the previous section of this guide. There's a Token section with a 'Copy' button. This'll put your bot's token in your clipboard.
Right now we assume you have basic knowledge of gradle or maven, you can find out how to add Kord to your project in the installation section of the README.
The minimal code to get your bot online is the following:
suspend fun main() {
val kord = Kord("your bot token")
kord.login()
}
Run this code, and your bot will appear online in your client's sidebar. login Will keep your bot logged in until you tell it to log out, or stop the program through some other means.
Making a simple ping-pong bot
Copy the code above:
suspend fun main() {
val kord = Kord("your bot token")
kord.login()
}
Kord allows you to listen to events either through the events property, or the on extension function.
Since our requirements are pretty simple, we'll use the latter. We'll want to listen to a newly created message, aka MessageCreateEvent:
suspend fun main() {
val kord = Kord("your bot token")
kord.on<MessageCreateEvent> { // runs every time a message is created that our bot can read
// ignore other bots, even ourselves. We only serve humans here!
if (message.author?.isBot != false) return@on
// check if our command is being invoked
if (message.content != "!ping") return@on
// all clear, give them the pong!
message.channel.createMessage("pong!")
}
kord.login {
// we need to specify this to receive the content of messages
@OptIn(PrivilegedIntent::class)
intents += Intent.MessageContent
}
}
That's it, you now have a bot that'll respond pongs to your pings. With that, you have the very basics covered.
