如何在 Spigot 1.19 中正确取消玩家加入事件并执行自定义踢出逻辑-java教程-PHP中文网

本文详解 Spigot 1.19 插件开发中 PlayerJoinEvent 的条件判断陷阱：因错误使用 else if 导致被封禁玩家无法触发数据库查询与踢出逻辑，提供修复方案、代码优化建议及生产环境注意事项。

本文详解 spigot 1.19 插件开发中 `playerjoinevent` 的条件判断陷阱：因错误使用 `else if` 导致被封禁玩家无法触发数据库查询与踢出逻辑，提供修复方案、代码优化建议及生产环境注意事项。

在 Spigot 插件开发中，PlayerJoinEvent 是处理玩家连接行为的关键入口。但如示例代码所示，一个看似微小的逻辑结构错误——将 player.isBanned() 判断置于 else if 分支下——会导致严重功能失效：被封禁玩家永远无法进入数据库校验流程，更不会被踢出。

根本原因在于前两个条件已构成逻辑全覆盖：

if (!player.hasPlayedBefore()) { ... } 
else if (player.hasPlayedBefore()) { ... }

由于 hasPlayedBefore() 返回 boolean，二者必居其一（true 或 false），因此后续的 else if (player.isBanned()) 永远不会执行——无论该玩家是否实际被封禁。

✅ 正确做法是将封禁检查改为独立 if 语句，并优先执行（因封禁应为最高优先级拦截）：

Photo Booth by Magic Studio

Photo Booth by Magic Studio是一款AI图像与设计工具，AI创建个人资料图片。

下载

@EventHandler
public void onPlayerJoin(PlayerJoinEvent event) {
    Player player = event.getPlayer();

    // ✅ 优先检查封禁状态（关键修复点）
    if (player.isBanned()) {
        // 避免阻塞主线程：异步查询 MongoDB（见下方说明）
        plugin.getServer().getScheduler().runTaskAsynchronously(plugin, () -> {
            try (MongoClient mongoClient = new MongoClient("mongodb://admin:password@185.209.223.136:2002")) {
                MongoDatabase database = mongoClient.getDatabase("test");
                MongoCollection<document> collection = database.getCollection("bans");
                // ⚠️ 修正：查询应基于 player.getName()，而非 player 对象本身
                Document query = new Document("name", player.getName());

                Document banDoc = collection.find(query).first();
                if (banDoc != null) {
                    String staff = banDoc.getString("staff", "Unknown");
                    String reason = banDoc.getString("reason", "No reason provided");
                    // ✅ 同步执行踢出（必须在主服务器线程）
                    plugin.getServer().getScheduler().runTask(plugin, () -> 
                        player.kickPlayer(ChatColor.RED + 
                            "You have been banned from this server!\n" +
                            "Reason: " + reason + "\n" +
                            "Issued by: " + staff)
                    );
                } else {
                    player.kickPlayer(ChatColor.RED + "You are banned, but ban details could not be loaded.");
                }
            } catch (Exception e) {
                plugin.getLogger().severe("Failed to check ban for " + player.getName());
                e.printStackTrace();
                player.kickPlayer(ChatColor.RED + "Server error occurred. Please try again later.");
            }
        });
        event.setCancelled(true); // ? 显式取消事件，防止默认欢迎消息干扰
        return; // 提前退出，避免后续逻辑执行
    }

    // ✅ 正常玩家欢迎消息（仅对未封禁玩家生效）
    if (!player.hasPlayedBefore()) {
        event.setJoinMessage(ChatColor.GREEN + "Welcome to the server " + player.getName() + "! We hope you enjoy your stay.");
    } else {
        event.setJoinMessage(ChatColor.GREEN + "Welcome back to the server " + player.getName() + "!");
    }
}</document>

? 关键改进说明：

逻辑顺序重排：封禁检查置于最前，且使用独立 if，确保无条件执行；
event.setCancelled(true)：显式取消事件，防止 Bukkit 默认加入消息与自定义踢出冲突；
异步数据库操作：MongoDB 查询移至异步线程，避免阻塞服务器主线程（Spigot 要求所有玩家操作如 kickPlayer() 必须在主线程执行，故需二次调度）；
资源安全释放：使用 try-with-resources 管理 MongoClient，防止连接泄漏；
健壮性增强：添加空值检查、异常捕获与降级响应，提升插件稳定性。

⚠️ 生产环境重要提醒：