如何在IntelliJ中使用Java JDA创建验证按钮并分配Verified角色

前提准备 #

确保你的IntelliJ项目已正确引入JDA依赖：

• Maven项目：在pom.xml中添加

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>5.0.0-beta.20</version> <!-- 使用最新稳定版 -->
    <exclusions>
        <exclusion>
            <groupId>club.minnced</groupId>
            <artifactId>opus-java</artifactId>
        </exclusion>
    </exclusions>
</dependency>

• Gradle项目：在build.gradle中添加

dependencies {
    implementation 'net.dv8tion:JDA:5.0.0-beta.20'
}

步骤1：发送带验证按钮的规则消息 #

编写代码向指定规则频道发送包含规则提示和验证按钮的消息：

public class RuleMessageSender {
    public static void sendRuleMessage(JDA jda) {
        // 替换为你的规则频道ID
        TextChannel ruleChannel = jda.getTextChannelById(123456789012345678L);
        if (ruleChannel == null) {
            System.err.println("规则频道不存在");
            return;
        }

        // 构建验证按钮
        Button verifyButton = Button.success("verify_button", "我已阅读并同意规则");
        ActionRow actionRow = ActionRow.of(verifyButton);

        // 构建规则嵌入消息
        EmbedBuilder embed = new EmbedBuilder()
                .setTitle("服务器规则")
                .setDescription("1. 遵守Discord社区准则\n2. 禁止刷屏与广告\n3. 尊重所有成员")
                .setColor(Color.GREEN);

        ruleChannel.sendMessageEmbeds(embed.build())
                .addComponents(actionRow)
                .queue();
    }
}

调用时机：在JDA初始化完成后（如JDABuilder.build().awaitReady()之后），执行RuleMessageSender.sendRuleMessage(jda)。

步骤2：处理按钮点击事件 #

创建事件监听器，监听按钮点击并为用户添加Verified角色：

public class VerifyButtonListener extends ListenerAdapter {
    @Override
    public void onButtonClick(ButtonClickEvent event) {
        // 过滤非验证按钮的点击
        if (!event.getButton().getId().equals("verify_button")) {
            return;
        }

        Member member = event.getMember();
        if (member == null) {
            event.reply("无法获取用户信息").setEphemeral(true).queue();
            return;
        }

        // 替换为你的Verified角色ID
        Role verifiedRole = event.getGuild().getRoleById(987654321098765432L);
        if (verifiedRole == null) {
            event.reply("验证角色不存在").setEphemeral(true).queue();
            return;
        }

        // 检查用户是否已拥有验证角色
        if (member.getRoles().contains(verifiedRole)) {
            event.reply("你已经是验证用户了").setEphemeral(true).queue();
            return;
        }

        // 添加角色并反馈结果
        event.getGuild().addRoleToMember(member, verifiedRole).queue(
                success -> event.reply("验证成功！已为你添加Verified角色").setEphemeral(true).queue(),
                error -> event.reply("添加角色失败，请联系管理员").setEphemeral(true).queue()
        );
    }
}

注册监听器：在JDA初始化时添加监听器

JDABuilder.createDefault("你的机器人Token")
        .addEventListeners(new VerifyButtonListener())
        .build()
        .awaitReady();

关键注意事项 #

• 确保机器人拥有管理角色权限，且Verified角色的位置在机器人角色下方（否则机器人无法为用户添加该角色）。
• 按钮ID（示例中的verify_button）需唯一，避免与其他按钮冲突。
• 使用setEphemeral(true)让回复仅对点击用户可见，避免频道消息混乱。

内容的提问来源于stack exchange，提问作者Ice Wizard