Bukkit插件开发：高效管理和取消玩家专属的重复任务

public class MyPlugin extends JavaPlugin implements Listener {
    private boolean stopRepeater = true; // 全局标志
    private int taskID; // 全局任务ID

    @Override
    public void onEnable() {
        getServer().getPluginManager().registerEvents(this, this);
    }

    @EventHandler
    public void onLogin(final PlayerJoinEvent event) {
        final Player thePlayer = event.getPlayer();
        this.stopRepeater = true; // 每次登录都会重置此标志
        getLogger().info(String.valueOf(thePlayer.getName()) + " is logging in!");

        // 此处创建的任务ID会覆盖上一个玩家的任务ID
        taskID = Bukkit.getServer().getScheduler().scheduleSyncRepeatingTask(this, () -> {
            if(this.stopRepeater) { // 这个条件判断对所有任务都有效
                // 记录玩家位置的逻辑
                getLogger().info(thePlayer.getName() + " current position: " + thePlayer.getLocation());
            }
        }, 0L, 20L); // 每秒执行一次
    }

    @EventHandler
    public void onQuit(final PlayerQuitEvent event) {
        Player thePlayer = event.getPlayer(); 
        // 注意：此条件在PlayerQuitEvent中通常为false，因为玩家已经离线
        if(!thePlayer.isOnline()) { 
            this.stopRepeater = false; // 停止所有任务的标志
            Bukkit.getScheduler().cancelTask(taskID); // 仅取消最后创建的任务
            getLogger().info(String.valueOf(event.getPlayer().getName()) + " has left the game");
        }
    }
}

package com.example.myplugin;

import org.bukkit.Bukkit;
import org.bukkit.entity.Player;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;
import org.bukkit.event.player.PlayerJoinEvent;
import org.bukkit.event.player.PlayerQuitEvent;
import org.bukkit.plugin.java.JavaPlugin;
import org.bukkit.scheduler.BukkitTask;

import java.util.HashMap;
import java.util.UUID;

public class PlayerTrackingPlugin extends JavaPlugin implements Listener {

    // 存储玩家UUID到其对应任务的映射
    private final HashMap<UUID, BukkitTask> playerTrackingTasks = new HashMap<>();

    @Override
    public void onEnable() {
        // 注册事件监听器
        getServer().getPluginManager().registerEvents(this, this);
        getLogger().info("PlayerTrackingPlugin has been enabled!");
    }

    @Override
    public void onDisable() {
        // 插件禁用时，取消所有由本插件创建的Bukkit任务
        // 这将确保所有玩家的跟踪任务都被停止，避免资源泄露
        Bukkit.getScheduler().cancelTasks(this); 
        playerTrackingTasks.clear(); // 清空HashMap
        getLogger().info("PlayerTrackingPlugin has been disabled! All tasks cancelled.");
    }

    @EventHandler
    public void onPlayerJoin(final PlayerJoinEvent event) {
        final Player player = event.getPlayer();
        getLogger().info(player.getName() + " 已登录！开始跟踪其位置。");

        // 使用 runTaskTimer 而非 scheduleSyncRepeatingTask，因为它直接返回 BukkitTask
        // 这是一个同步重复任务，每秒执行一次（20 tick = 1秒）
        BukkitTask task = Bukkit.getScheduler().runTaskTimer(this, () -> {
            // 这是玩家专属的重复任务逻辑
            // 例如：记录玩家位置到日志或数据库
            getLogger().info(player.getName() + " 当前位置: " + player.getLocation().getBlockX() + ", " 
                               + player.getLocation().getBlockY() + ", " + player.getLocation().getBlockZ());
            // 注意：此处 lambda 表达式捕获了 'player' 变量，每个任务实例都关联到特定的玩家
        }, 0L, 20L); // 0L 延迟，20L 周期 (1秒)

        // 将任务添加到HashMap中，键为玩家的UUID
        playerTrackingTasks.put(player.getUniqueId(), task);
        getLogger().info("为玩家 " + player.getName() + " 启动了跟踪任务 (Task ID: " + task.getTaskId() + ").");
    }

    @EventHandler
    public void onPlayerQuit(final PlayerQuitEvent event) {
        Player player = event.getPlayer();
        getLogger().info(player.getName() + " 已退出游戏。尝试取消其跟踪任务。");

        // 从HashMap中移除并获取对应的BukkitTask
        BukkitTask task = playerTrackingTasks.remove(player.getUniqueId());

        if (task != null) { // 检查任务是否存在，防止空指针异常
            task.cancel(); // 取消该玩家的重复任务
            getLogger().info("成功取消了玩家 " + player.getName() + " 的跟踪任务 (Task ID: " + task.getTaskId() + ").");
        } else {
            getLogger().warning("未找到玩家 " + player.getName() + " 的跟踪任务。可能任务已取消或未启动。");
        }
    }
}