Quickstart with Discord4J
Learn how to install Discord4J and where to go next to get a bot up and running.
#
Download / InstallationThe recommended way to get Discord4J is to use a build automation tool like Gradle or Maven. Use the appropriate snippet below for your preferred dependency manager.
- Gradle
- Maven
- SBT
repositories { mavenCentral()}
dependencies { implementation 'com.discord4j:discord4j-core:VERSION'}
<dependencies> <dependency> <groupId>com.discord4j</groupId> <artifactId>discord4j-core</artifactId> <version>VERSION</version> </dependency></dependencies>
libraryDependencies ++= Seq( "com.discord4j" % "discord4j-core" % "VERSION")
#
Basic BotWith D4J installed, you can start writing your bot! Here's an example of a dead-simple "ping-pong" bot which simply responds "Pong!" any time someone sends "!ping".
DiscordClient.create("TOKEN") .withGateway(client -> client.on(MessageCreateEvent.class, event -> { Message message = event.getMessage();
if (message.getContent().equalsIgnoreCase("!ping")) { return message.getChannel() .flatMap(channel -> channel.createMessage("Pong!")); }
return Mono.empty(); })) .block();
This basic example is easily extended to do all kinds of commands!
See the Basic Bot Tutorial for an in-depth explanation of this example.