目录
- 第一章 Discord账号注册
- 第二章 Discord创建服务器
- 第三章 Discord创建机器人
- 3.1、创建应用
- 3.2、创建机器人
- 3.3、配置机器人
- 3.4、添加机器人
- 第四章 Discord机器人开发准备
- 4.1、推荐资料
- 4.2、创建工程
- 4.3、添加依赖
- 4.4、获取Token
- 4.5、编写主类
- 第五章 Discord机器人开发初级
- 5.1、和机器人对话
- 5.2、获取历史消息
- 5.3、删除指定消息
- 5.4、删除所有消息
- 第六章 Discord机器人开发中级
- 6.1、监听公会事件
- 6.2、监听频道事件
- 6.3、监听消息事件
- 第七章 Discord机器人开发高级
- 7.1、指令行的开发
- 7.2、右键菜单开发
- 7.3、下拉列表开发
- 7.4、各种按钮开发
- 7.5、模态框的开发
第一章 Discord账号注册
温馨提示:在阅读本文章内容之前,请确保您能正常访问外网。
官方网址: https://discord.com/
注册页面: https://discord.com/register
第二章 Discord创建服务器
第三章 Discord创建机器人
3.1、创建应用
开发者平台: https://discord.com/developers/applications
3.2、创建机器人
3.3、配置机器人
3.4、添加机器人
第四章 Discord机器人开发准备
温馨提示:在进行开发前,请确保您的开发环境是:jdk1.8、maven3.6.3、idea2021.1
4.1、推荐资料
- JDA推荐视频: 点击打开
- JDA开发文档: 点击打开
- JDA源码地址: 点击打开
4.2、创建工程
4.3、添加依赖
<dependencies>
<dependency>
<groupId>net.dv8tion</groupId>
<artifactId>JDA</artifactId>
<version>5.0.0-alpha.12</version>
</dependency>
</dependencies>
4.4、获取Token
4.5、编写主类
package cn.caochenlei;
import net.dv8tion.jda.api.JDA;
import net.dv8tion.jda.api.JDABuilder;
public class JavaBotApp {
private static final String TOKEN = "******替换成你自己的******";
public static void main(String[] args) throws Exception {
JDA jda = JDABuilder.createDefault(TOKEN).build().awaitReady();
}
}
第五章 Discord机器人开发初级
5.1、和机器人对话
JavaBotApp
package cn.caochenlei;
import cn.caochenlei.event.MessageEvent;
import net.dv8tion.jda.api.JDA;
import net.dv8tion.jda.api.JDABuilder;
public class JavaBotApp {
private static final String TOKEN = "******替换成你自己的******";
public static void main(String[] args) throws Exception {
JDA jda = JDABuilder.createDefault(TOKEN).build().awaitReady();
jda.addEventListener(new MessageEvent());
}
}
MessageEvent
package cn.caochenlei.event;
import net.dv8tion.jda.api.OnlineStatus;
import net.dv8tion.jda.api.Permission;
import net.dv8tion.jda.api.entities.*;
import net.dv8tion.jda.api.events.message.MessageReceivedEvent;
import net.dv8tion.jda.api.hooks.ListenerAdapter;
import org.jetbrains.annotations.NotNull;
import java.util.EnumSet;
import java.util.List;
public class MessageEvent extends ListenerAdapter {
@Override
public void onMessageReceived(@NotNull MessageReceivedEvent event) {
if (event.getAuthor().isBot()) {
return;
}
Message message = event.getMessage();
Guild guild = message.getGuild();
String guildId = guild.getId();
String guildName = guild.getName();
System.out.println("guildId = " + guildId);
System.out.println("guildName = " + guildName);
MessageChannel channel = message.getChannel();
String channelId = channel.getId();
String channelName = channel.getName();
ChannelType channelType = channel.getType();
System.out.println("channelId = " + channelId);
System.out.println("channelName = " + channelName);
System.out.println("channelType = " + channelType);
Member member = message.getMember();
String memberId = member.getId();
String memberNickname = member.getNickname();
String memberEffectiveName = member.getEffectiveName();
List<Role> memberRoles = member.getRoles();
EnumSet<Permission> memberPermissions = member.getPermissions();
OnlineStatus memberOnlineStatus = member.getOnlineStatus();
System.out.println("memberId = " + memberId);
System.out.println("memberNickname = " + memberNickname);
System.out.println("memberEffectiveName = " + memberEffectiveName);
System.out.println("memberRoles = " + memberRoles);
System.out.println("memberPermissions = " + memberPermissions);
System.out.println("memberOnlineStatus = " + memberOnlineStatus);
String messageId = message.getId();
String messageContentRaw = message.getContentRaw();
MessageType messageType = message.getType();
System.out.println("messageId = " + messageId);
System.out.println("messageContentRaw = " + messageContentRaw);
System.out.println("messageType = " + messageType);
channel.sendMessage("bot already received").queue();
}
}
5.2、获取历史消息
JavaBotApp
package cn.caochenlei;
import cn.caochenlei.event.MessageEvent;
import net.dv8tion.jda.api.JDA;
import net.dv8tion.jda.api.JDABuilder;
import net.dv8tion.jda.api.entities.Guild;
import net.dv8tion.jda.api.entities.Message;
import net.dv8tion.jda.api.entities.TextChannel;
import net.dv8tion.jda.api.entities.VoiceChannel;
import java.util.ArrayList;
import java.util.List;
import java.util.Objects;
public class JavaBotApp {
private static final String TOKEN = "******替换成你自己的******";
public static void main(String[] args) throws Exception {
JDA jda = JDABuilder.createDefault(TOKEN).build().awaitReady();
Guild guild = jda.getGuildById("985525076327792690");
TextChannel textChannel = jda.getTextChannelById("985525076822724670");
VoiceChannel voiceChannel = jda.getVoiceChannelById("985525076822724671");
List<Message> historyMessage = getHistoryMessage(textChannel);
System.out.println("historyMessageSize = " + historyMessage.size());
historyMessage.forEach(message -> {
System.out.println(message.getContentRaw());
});
}
public static List<Message> getHistoryMessage(TextChannel textChannel) {
List<Message> messageList = new ArrayList<>();
int limit = 100;
int size;
String lastMsgId = null;
List<Message> retrievedHistory;
do {
if (lastMsgId == null) {
retrievedHistory = textChannel.getHistoryFromBeginning(limit).complete().getRetrievedHistory();
} else {
retrievedHistory = textChannel.getHistoryAfter(lastMsgId, limit).complete().getRetrievedHistory();
}
Objects.requireNonNull(retrievedHistory);
messageList.addAll(retrievedHistory);
size = retrievedHistory.size();
System.out.printf("current request size %d\n", size);
if (!retrievedHistory.isEmpty()) {
lastMsgId = retrievedHistory.get(0).getId();
}
if (size < limit) {
break;
}
} while (true);
messageList.sort(((o1, o2) -> (int) (o1.getTimeCreated().toEpochSecond() - o2.getTimeCreated().toEpochSecond())));
return messageList;
}
}
除此之外另外一种方式:
getHistoryMessage(textChannel, messagesList -> {
messagesList.forEach(message -> {
System.out.println(message.getContentRaw());
});
});
public static void getHistoryMessage(MessageChannel channel, Consumer<List<Message>> callback) {
List<Message> messages = new ArrayList<>();
channel.getIterableHistory()
.cache(false)
.forEachAsync((message) -> messages.add(message))
.thenRun(() -> messages.sort(((o1, o2) -> (int) (o1.getTimeCreated().toEpochSecond() - o2.getTimeCreated().toEpochSecond()))))
.thenRun(() -> callback.accept(messages));
}
获取最近指定条数消息:
getLastMessage(textChannel, 5, messagesList -> {
messagesList.forEach(message -> {
System.out.println(message.getContentRaw());
});
});
public static void getLastMessage(MessageChannel channel, int limit, Consumer<List<Message>> callback) {
List<Message> messages = new ArrayList<>(limit);
channel.getIterableHistory()
.cache(false)
.forEachAsync((message) -> {
messages.add(message);
return messages.size() < limit;
})
.thenRun(() -> messages.sort(((o1, o2) -> (int) (o1.getTimeCreated().toEpochSecond() - o2.getTimeCreated().toEpochSecond()))))
.thenRun(() -> callback.accept(messages));
}
5.3、删除指定消息
JavaBotApp
if (!historyMessage.isEmpty()) {
textChannel.deleteMessageById(historyMessage.get(historyMessage.size() - 1).getId()).queue();
System.out.println("delete last message complete");
}
5.4、删除所有消息
POM.XML
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>31.1-jre</version>
</dependency>
JavaBotApp
if (!historyMessage.isEmpty()) {
List<String> messageIds = historyMessage.stream().map(Message::getId).collect(Collectors.toList());
List<List<String>> partitionList = Lists.partition(messageIds, 100);
for (List<String> partitionIds : partitionList) {
textChannel.deleteMessagesByIds(partitionIds).queue();
}
System.out.println("delete all message complete");
}
第六章 Discord机器人开发中级
事件列表:点击访问
6.1、监听公会事件
常见示例代码: GuildEvent
package cn.caochenlei.event;
import net.dv8tion.jda.api.events.guild.GuildLeaveEvent;
import net.dv8tion.jda.api.events.guild.invite.GuildInviteCreateEvent;
import net.dv8tion.jda.api.events.guild.invite.GuildInviteDeleteEvent;
import net.dv8tion.jda.api.events.guild.member.GuildMemberJoinEvent;
import net.dv8tion.jda.api.events.guild.member.GuildMemberRemoveEvent;
import net.dv8tion.jda.api.events.guild.member.GuildMemberRoleAddEvent;
import net.dv8tion.jda.api.events.guild.member.GuildMemberRoleRemoveEvent;
import net.dv8tion.jda.api.hooks.ListenerAdapter;
import org.jetbrains.annotations.NotNull;
public class GuildEvent extends ListenerAdapter {
@Override
public void onGuildInviteCreate(@NotNull GuildInviteCreateEvent event) {
System.out.println("一个邀请被创建了");
}
@Override
public void onGuildInviteDelete(@NotNull GuildInviteDeleteEvent event) {
System.out.println("一个邀请被删除了");
}
@Override
public void onGuildMemberJoin(@NotNull GuildMemberJoinEvent event) {
System.out.println("有新成员进入公会");
}
@Override
public void onGuildLeave(@NotNull GuildLeaveEvent event) {
System.out.println("有老成员离开公会");
}
@Override
public void onGuildMemberRemove(@NotNull GuildMemberRemoveEvent event) {
System.out.println("有成员被移除公会");
}
@Override
public void onGuildMemberRoleAdd(@NotNull GuildMemberRoleAddEvent event) {
System.out.println("公会成员添加角色");
}
@Override
public void onGuildMemberRoleRemove(@NotNull GuildMemberRoleRemoveEvent event) {
System.out.println("公会成员移除角色");
}
}
6.2、监听频道事件
常见示例代码: ChannelEvent
package cn.caochenlei.event;
import net.dv8tion.jda.api.events.channel.ChannelCreateEvent;
import net.dv8tion.jda.api.events.channel.ChannelDeleteEvent;
import net.dv8tion.jda.api.events.channel.update.ChannelUpdateNameEvent;
import net.dv8tion.jda.api.hooks.ListenerAdapter;
import org.jetbrains.annotations.NotNull;
public class ChannelEvent extends ListenerAdapter {
@Override
public void onChannelCreate(@NotNull ChannelCreateEvent event) {
System.out.println("频道被创建了");
}
@Override
public void onChannelDelete(@NotNull ChannelDeleteEvent event) {
System.out.println("频道被删除了");
}
@Override
public void onChannelUpdateName(@NotNull ChannelUpdateNameEvent event) {
System.out.println("频道名称变了");
}
}
6.3、监听消息事件
常见示例代码: MessageEvent
package cn.caochenlei.event;
import net.dv8tion.jda.api.OnlineStatus;
import net.dv8tion.jda.api.Permission;
import net.dv8tion.jda.api.entities.*;
import net.dv8tion.jda.api.events.message.MessageDeleteEvent;
import net.dv8tion.jda.api.events.message.MessageEmbedEvent;
import net.dv8tion.jda.api.events.message.MessageReceivedEvent;
import net.dv8tion.jda.api.events.message.MessageUpdateEvent;
import net.dv8tion.jda.api.hooks.ListenerAdapter;
import org.jetbrains.annotations.NotNull;
import java.util.EnumSet;
import java.util.List;
public class MessageEvent extends ListenerAdapter {
@Override
public void onMessageReceived(@NotNull MessageReceivedEvent event) {
System.out.println("消息被接收了");
}
@Override
public void onMessageDelete(@NotNull MessageDeleteEvent event) {
System.out.println("消息被删除了");
}
@Override
public void onMessageUpdate(@NotNull MessageUpdateEvent event) {
System.out.println("消息被更新了");
}
@Override
public void onMessageEmbed(@NotNull MessageEmbedEvent event) {
System.out.println("接收卡片消息");
}
}
第七章 Discord机器人开发高级
7.1、指令行的开发
SlashCommandEvent
package cn.caochenlei.event;
import net.dv8tion.jda.api.EmbedBuilder;
import net.dv8tion.jda.api.JDA;
import net.dv8tion.jda.api.JDABuilder;
import net.dv8tion.jda.api.entities.Guild;
import net.dv8tion.jda.api.events.interaction.command.SlashCommandInteractionEvent;
import net.dv8tion.jda.api.hooks.ListenerAdapter;
import net.dv8tion.jda.api.interactions.commands.OptionType;
import net.dv8tion.jda.api.interactions.commands.build.Commands;
import org.jetbrains.annotations.NotNull;
public class SlashCommandEvent extends ListenerAdapter {
private static final String TOKEN = "******替换成你自己的******";
public static void main(String[] args) throws Exception {
JDA jda = JDABuilder.createDefault(TOKEN).build().awaitReady();
jda.addEventListener(new SlashCommandEvent());
for (Guild guild : jda.getGuilds()) {
guild.updateCommands().addCommands(
Commands.slash("show_slash_command", "show slash command example")
.addOption(OptionType.STRING, "param1", "Please enter param1", true)
.addOption(OptionType.STRING, "param2", "Please enter param2", true)
).queue();
}
}
@Override
public void onSlashCommandInteraction(@NotNull SlashCommandInteractionEvent event) {
event.deferReply().queue();
if ("show_slash_command".equals(event.getName())) {
String param1 = event.getOption("param1").getAsString();
String param2 = event.getOption("param2").getAsString();
EmbedBuilder embedBuilder = new EmbedBuilder();
embedBuilder.setTitle("Result");
embedBuilder.addField("param1:", param1, false);
embedBuilder.addField("param2:", param2, false);
embedBuilder.setFooter("This is a footer.");
event.getHook().sendMessageEmbeds(embedBuilder.build()).queue();
}
}
}
7.2、右键菜单开发
ContextEvent
package cn.caochenlei.event;
import net.dv8tion.jda.api.JDA;
import net.dv8tion.jda.api.JDABuilder;
import net.dv8tion.jda.api.entities.Guild;
import net.dv8tion.jda.api.events.interaction.command.MessageContextInteractionEvent;
import net.dv8tion.jda.api.events.interaction.command.UserContextInteractionEvent;
import net.dv8tion.jda.api.hooks.ListenerAdapter;
import net.dv8tion.jda.api.interactions.commands.build.Commands;
public class ContextEvent extends ListenerAdapter {
private static final String TOKEN = "******替换成你自己的******";
public static void main(String[] args) throws Exception {
JDA jda = JDABuilder.createDefault(TOKEN).build().awaitReady();
jda.addEventListener(new ContextEvent());
for (Guild guild : jda.getGuilds()) {
guild.updateCommands().addCommands(
Commands.user("Get user avatar"),
Commands.message("Count words")
).queue();
}
}
@Override
public void onUserContextInteraction(UserContextInteractionEvent event) {
event.deferReply().queue();
if ("Get user avatar".equals(event.getName())) {
event.getHook().sendMessage("Avatar: " + event.getTarget().getEffectiveAvatarUrl()).queue();
}
}
@Override
public void onMessageContextInteraction(MessageContextInteractionEvent event) {
event.deferReply().queue();
if ("Count words".equals(event.getName())) {
event.getHook().sendMessage("Words: " + event.getTarget().getContentRaw().split("\\s+").length).queue();
}
}
}
7.3、下拉列表开发
DropdownEvent
package cn.caochenlei.event;
import net.dv8tion.jda.api.JDA;
import net.dv8tion.jda.api.JDABuilder;
import net.dv8tion.jda.api.entities.Emoji;
import net.dv8tion.jda.api.entities.Guild;
import net.dv8tion.jda.api.events.interaction.command.SlashCommandInteractionEvent;
import net.dv8tion.jda.api.events.interaction.component.SelectMenuInteractionEvent;
import net.dv8tion.jda.api.hooks.ListenerAdapter;
import net.dv8tion.jda.api.interactions.commands.build.Commands;
import net.dv8tion.jda.api.interactions.components.selections.SelectMenu;
import net.dv8tion.jda.api.interactions.components.selections.SelectOption;
import org.jetbrains.annotations.NotNull;
public class DropdownEvent extends ListenerAdapter {
private static final String TOKEN = "******替换成你自己的******";
public static void main(String[] args) throws Exception {
JDA jda = JDABuilder.createDefault(TOKEN).build().awaitReady();
jda.addEventListener(new DropdownEvent());
for (Guild guild : jda.getGuilds()) {
guild.updateCommands().addCommands(
Commands.slash("show_dropdown", "This is a command description.")
).queue();
}
}
@Override
public void onSlashCommandInteraction(@NotNull SlashCommandInteractionEvent event) {
event.deferReply().queue();
if ("show_dropdown".equals(event.getName())) {
SelectMenu selectMenu = SelectMenu.create("choose-food")
.addOption("Pizza", "pizza", "this is a pizza")
.addOption("Hot Dog", "hot dog", "this is a hot dog")
.addOption("Noodle", "noodle", "this is a noodle")
.addOptions(SelectOption.of("hamburger", "hamburger")
.withDescription("this is a hamburger")
.withEmoji(Emoji.fromUnicode("\uD83C\uDF54"))
.withDefault(true))
.build();
event.getHook().sendMessage("Choose your favorite food").addActionRow(selectMenu).queue();
}
}
@Override
public void onSelectMenuInteraction(@NotNull SelectMenuInteractionEvent event) {
event.deferReply().queue();
if ("choose-food".equals(event.getComponentId())) {
event.getHook().sendMessage("You chose " + event.getValues().get(0)).queue();
}
}
}
7.4、各种按钮开发
ButtonEvent
package cn.caochenlei.event;
import net.dv8tion.jda.api.JDA;
import net.dv8tion.jda.api.JDABuilder;
import net.dv8tion.jda.api.entities.Emoji;
import net.dv8tion.jda.api.entities.Guild;
import net.dv8tion.jda.api.events.interaction.command.SlashCommandInteractionEvent;
import net.dv8tion.jda.api.events.interaction.component.ButtonInteractionEvent;
import net.dv8tion.jda.api.hooks.ListenerAdapter;
import net.dv8tion.jda.api.interactions.commands.build.Commands;
import net.dv8tion.jda.api.interactions.components.buttons.Button;
import org.jetbrains.annotations.NotNull;
public class ButtonEvent extends ListenerAdapter {
private static final String TOKEN = "******替换成你自己的******";
public static void main(String[] args) throws Exception {
JDA jda = JDABuilder.createDefault(TOKEN).build().awaitReady();
jda.addEventListener(new ButtonEvent());
for (Guild guild : jda.getGuilds()) {
guild.updateCommands().addCommands(
Commands.slash("show_button", "This is a command description.")
).queue();
}
}
@Override
public void onSlashCommandInteraction(@NotNull SlashCommandInteractionEvent event) {
String name = event.getName();
if ("show_button".equals(name)) {
event.reply("Click the button to say hello")
.addActionRow(
Button.primary("btn1", "Click Me").withEmoji(Emoji.fromMarkdown("<:github:849286315580719104>")),
Button.success("btn2", "Click Me").withEmoji(Emoji.fromMarkdown("<:github:849286315580719104>")),
Button.secondary("btn3", "Click Me").withEmoji(Emoji.fromMarkdown("<:github:849286315580719104>")),
Button.danger("btn4", "Click Me").withEmoji(Emoji.fromMarkdown("<:github:849286315580719104>")),
Button.link("https://www.baidu.com/", "百度一下").withEmoji(Emoji.fromMarkdown("<:github:849286315580719104>"))
).queue();
}
}
@Override
public void onButtonInteraction(@NotNull ButtonInteractionEvent event) {
event.deferReply().queue();
if ("btn1".equals(event.getComponentId())) {
event.getHook().sendMessage("you click btn1 and say hello").queue();
} else if ("btn2".equals(event.getComponentId())) {
event.getHook().sendMessage("you click btn2 and say hello").queue();
} else if ("btn3".equals(event.getComponentId())) {
event.getHook().sendMessage("you click btn3 and say hello").queue();
} else if ("btn4".equals(event.getComponentId())) {
event.getHook().sendMessage("you click btn4 and say hello").queue();
}
}
}
7.5、模态框的开发
ModalEvent
package cn.caochenlei.event;
import net.dv8tion.jda.api.JDA;
import net.dv8tion.jda.api.JDABuilder;
import net.dv8tion.jda.api.entities.Guild;
import net.dv8tion.jda.api.events.interaction.ModalInteractionEvent;
import net.dv8tion.jda.api.events.interaction.command.SlashCommandInteractionEvent;
import net.dv8tion.jda.api.hooks.ListenerAdapter;
import net.dv8tion.jda.api.interactions.commands.build.Commands;
import net.dv8tion.jda.api.interactions.components.ActionRow;
import net.dv8tion.jda.api.interactions.components.Modal;
import net.dv8tion.jda.api.interactions.components.text.TextInput;
import net.dv8tion.jda.api.interactions.components.text.TextInputStyle;
import org.jetbrains.annotations.NotNull;
public class ModalEvent extends ListenerAdapter {
private static final String TOKEN = "******替换成你自己的******";
public static void main(String[] args) throws Exception {
JDA jda = JDABuilder.createDefault(TOKEN).build().awaitReady();
jda.addEventListener(new ModalEvent());
for (Guild guild : jda.getGuilds()) {
guild.updateCommands().addCommands(
Commands.slash("show_modal", "This is a command description.")
).queue();
}
}
@Override
public void onSlashCommandInteraction(@NotNull SlashCommandInteractionEvent event) {
if ("show_modal".equals(event.getName())) {
TextInput subject = TextInput.create("subject", "Subject", TextInputStyle.SHORT)
.setPlaceholder("Subject of this ticket")
.setMinLength(1)
.setMaxLength(10)
.build();
TextInput body = TextInput.create("body", "Body", TextInputStyle.PARAGRAPH)
.setPlaceholder("Your concerns go here")
.setMinLength(1)
.setMaxLength(10)
.build();
Modal modal = Modal.create("form", "Modal Form")
.addActionRows(ActionRow.of(subject), ActionRow.of(body))
.build();
event.replyModal(modal).queue();
}
}
@Override
public void onModalInteraction(@NotNull ModalInteractionEvent event) {
event.deferReply().queue();
if ("form".equals(event.getModalId())) {
String subject = event.getValue("subject").getAsString();
String body = event.getValue("body").getAsString();
System.out.println("subject = " + subject);
System.out.println("body = " + body);
event.getHook().sendMessage("Thanks for your request!").queue();
}
}
}
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)