
本文讲解为何非静态 ArrayList 在 Bukkit 事件监听中无法跨实例共享数据,并提供基于 CopyOnWriteArrayList 的线程安全解决方案,确保玩家加入/移除夜视效果后,死亡重生时仍能正确触发效果。
本文讲解为何非静态 arraylist 在 bukkit 事件监听中无法跨实例共享数据,并提供基于 `copyonwritearraylist` 的线程安全解决方案,确保玩家加入/移除夜视效果后,死亡重生时仍能正确触发效果。
在开发 Bukkit 插件时,一个常见误区是将状态容器(如 ArrayList)声明为实例变量(即非 static)。正如示例代码所示,private ArrayList 每次插件类被初始化(例如通过 getServer().getPluginManager().registerEvents(...) 或命令注册)时,都会创建一个新的独立列表副本。这意味着:
- 命令执行时操作的是某个实例的
gammaList; - 而
@EventHandler方法可能由另一个实例(或不同线程)调用,其gammaList为空或不包含同一对象引用; - 结果就是
gammaList.contains(player)在onPlayerDie中始终返回false,效果无法延续。
✅ 正确做法是将列表声明为 static + 线程安全集合。Bukkit/Spigot 的事件回调(如 EntityResurrectEvent)运行在主服务器线程,但命令执行与事件触发可能存在微小并发窗口(尤其在高负载或多插件环境下),因此推荐使用 CopyOnWriteArrayList —— 它专为读多写少场景设计,迭代时不会抛出 ConcurrentModificationException,且 contains()、add()、remove() 均线程安全。
以下是修复后的完整代码(含关键注释):
public class Gamma implements CommandExecutor, Listener {
// ✅ 静态 + 线程安全:确保全插件生命周期内唯一、可跨事件共享
private static final List<player> gammaList = new CopyOnWriteArrayList();
@Override
public boolean onCommand(CommandSender sender, Command cmd, String label, String[] args) {
if (!(sender instanceof Player player)) {
sender.sendMessage("仅玩家可执行此命令。");
return true;
}
if (gammaList.contains(player)) {
gammaList.remove(player);
player.sendMessage(ChatColor.GREEN + "成功" + ChatColor.RED + "移除" + ChatColor.GREEN + "夜视效果!");
player.removePotionEffect(PotionEffectType.NIGHT_VISION);
} else {
gammaList.add(player);
player.sendMessage(ChatColor.GREEN + "成功" + ChatColor.DARK_GREEN + "启用" + ChatColor.GREEN + "夜视效果!");
player.addPotionEffect(new PotionEffect(PotionEffectType.NIGHT_VISION, Integer.MAX_VALUE, 1, false, false));
}
return true;
}
@EventHandler
public void onPlayerDie(EntityResurrectEvent event) {
// 注意:EntityResurrectEvent 触发于玩家重生时(非死亡瞬间)
// 若需死亡时添加效果,请改用 PlayerDeathEvent 并在 respawn 后延迟应用
if (event.getEntity() instanceof Player player && gammaList.contains(player)) {
// 延迟1 tick 确保重生完成(避免因状态未就绪导致失效)
Bukkit.getScheduler().runTaskLater(this, () -> {
player.addPotionEffect(new PotionEffect(PotionEffectType.NIGHT_VISION, Integer.MAX_VALUE, 1, false, false));
}, 1L);
}
}
}</player>
⚠️ 重要注意事项:
-
EntityResurrectEvent的语义:它表示玩家已成功重生(respawn),而非刚死亡。若目标是“死亡后立即恢复夜视”,应监听PlayerDeathEvent并结合Player#spigot().respawn()或延迟任务实现; -
内存泄漏风险:
Player对象未自动清理。建议在玩家离线时从列表移除(监听PlayerQuitEvent):@EventHandler public void onPlayerQuit(PlayerQuitEvent event) { gammaList.remove(event.getPlayer()); } -
Integer.MAX_VALUE的副作用:永久性药水效果可能导致客户端卡顿或兼容性问题,生产环境建议设为较大值(如20 * 60 * 60表示1小时)并定期刷新; -
插件卸载清理:在
onDisable()中清空列表,避免残留引用阻碍 GC。
通过以上改进,gammaList 成为插件全局唯一的、线程安全的状态中心,彻底解决事件间数据不同步问题,是 Bukkit 插件状态管理的最佳实践之一。










