Spigot端Flicking Scoreboard计分板远程连接时玩家移动触发闪烁求助
问题根源
你当前代码的核心问题是每次PlayerMoveEvent触发时都会新建完整的Scoreboard对象替换玩家原有计分板:
- 本地环境ping极低,客户端销毁旧计分板、加载新计分板的时间差可忽略,所以看不出闪烁
- 远程环境存在网络延迟,两个操作的时间差被放大,就会出现周期性空白闪烁
- 额外影响:
PlayerMoveEvent每秒触发几十次,频繁创建新计分板会额外增加服务端性能损耗、网络发包量
优化方案
核心原则:计分板仅初始化1次,后续仅更新发生变化的行内容,不要全量替换。
- 每个玩家加入时仅初始化1次计分板,用Team绑定固定的计分板行,后续更新直接修改Team的后缀即可,不需要重建整个计分板
- 给
PlayerMoveEvent增加触发限制:只有玩家的方块坐标真实发生变化时才触发更新,同时增加更新冷却,避免高频调用 - 静态内容(比如玩家数、固定提示行)可以单独做定时更新,不要和移动事件绑定
修改后参考代码
import org.bukkit.ChatColor; import org.bukkit.Location; 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.PlayerMoveEvent; import org.bukkit.event.player.PlayerQuitEvent; import org.bukkit.scoreboard.DisplaySlot; import org.bukkit.scoreboard.Objective; import org.bukkit.scoreboard.Scoreboard; import org.bukkit.scoreboard.ScoreboardManager; import org.bukkit.scoreboard.Team; import org.jetbrains.annotations.NotNull; import java.util.HashMap; public class ScoreSidebar implements Listener { // 存储每个玩家的上次更新时间和上次坐标,做防抖用 private final HashMap<Player, Long> lastUpdateTime = new HashMap<>(); private final HashMap<Player, Location> lastLocation = new HashMap<>(); // 存储每个玩家的坐标更新用Team,避免每次查找 private final HashMap<Player, Team> locationTeam = new HashMap<>(); private final long UPDATE_COOLDOWN = 200; // 最小更新间隔200ms,可自行调整 @EventHandler public void onPlayerJoinBoard(@NotNull PlayerJoinEvent event) { Player player = event.getPlayer(); createBoard(player); // 初始化玩家的上次记录 lastUpdateTime.put(player, System.currentTimeMillis()); lastLocation.put(player, player.getLocation()); } @EventHandler public void onPlayerMove(@NotNull PlayerMoveEvent event) { Player player = event.getPlayer(); long now = System.currentTimeMillis(); // 冷却判断 if (now - lastUpdateTime.getOrDefault(player, 0L) < UPDATE_COOLDOWN) { return; } Location currentLoc = player.getLocation(); Location lastLoc = lastLocation.get(player); // 只有方块坐标变化才更新 if (currentLoc.getBlockX() == lastLoc.getBlockX() && currentLoc.getBlockY() == lastLoc.getBlockY() && currentLoc.getBlockZ() == lastLoc.getBlockZ()) { return; } // 更新坐标记录和时间记录 lastLocation.put(player, currentLoc); lastUpdateTime.put(player, now); // 仅更新坐标行,不重建整个计分板 updateLocation(player, currentLoc); } public void createBoard(@NotNull Player player) { ScoreboardManager manager = Bukkit.getScoreboardManager(); assert manager != null; Scoreboard board = manager.getNewScoreboard(); Objective o = board.registerNewObjective("Scores", "dummy", ChatColor.AQUA + "§lSTATUS"); o.setDisplaySlot(DisplaySlot.SIDEBAR); // 固定行直接创建即可 o.getScore(" ").setScore(6); // 玩家数行如果需要实时更新可以单独做定时任务,这里暂时保留原有写法,后续可优化 o.getScore(ChatColor.YELLOW + "PLAYER: " + ChatColor.BOLD + Bukkit.getOnlinePlayers().size() + ChatColor.WHITE + "/명").setScore(5); // 坐标行用Team实现动态更新 Team locTeam = board.registerNewTeam("location"); // 前缀固定为MOVEMENT标识 locTeam.setPrefix(ChatColor.GOLD + "MOVEMENT: " + ChatColor.WHITE); // 拿不显示的字符作为Team的关联项,避免和其他行冲突 String entry = ChatColor.RESET.toString(); locTeam.addEntry(entry); o.getScore(entry).setScore(4); locationTeam.put(player, locTeam); // 初始化坐标 updateLocation(player, player.getLocation()); o.getScore(ChatColor.GRAY + " " + " X | Y | Z ").setScore(3); o.getScore("").setScore(2); o.getScore(ChatColor.GRAY + "uhm... ").setScore(1); player.setScoreboard(board); } // 单独的坐标更新方法,仅修改Team后缀,发包量极小,不会触发闪烁 private void updateLocation(Player player, Location loc) { Team team = locationTeam.get(player); if (team != null) { team.setSuffix(loc.getBlockX() + " " + loc.getBlockY() + " " + loc.getBlockZ()); } } // 玩家退出时清理缓存,避免内存泄漏 @EventHandler public void onPlayerQuit(@NotNull PlayerQuitEvent event) { Player player = event.getPlayer(); lastUpdateTime.remove(player); lastLocation.remove(player); locationTeam.remove(player); } }
额外优化建议
- 玩家数、服务器信息等固定间隔更新的内容,不要和移动事件绑定,单独开一个同步定时任务每1~2秒更新一次即可
- 如果需要更复杂的计分板内容,可直接使用社区成熟的计分板封装API,内部已经做了防抖、增量更新等优化,不需要自己重复造轮子
内容的提问来源于stack exchange,提问作者KeenyTool
相关产品推荐
相关产品推荐

