You need to enable JavaScript to run this app. Spigot端Flicking Scoreboard计分板远程连接时玩家移动触发闪烁求助
优惠活动
大模型
产品
解决方案
定价
更多

Spigot端Flicking Scoreboard计分板远程连接时玩家移动触发闪烁求助

问题根源

你当前代码的核心问题是每次PlayerMoveEvent触发时都会新建完整的Scoreboard对象替换玩家原有计分板:

  • 本地环境ping极低,客户端销毁旧计分板、加载新计分板的时间差可忽略,所以看不出闪烁
  • 远程环境存在网络延迟,两个操作的时间差被放大,就会出现周期性空白闪烁
  • 额外影响:PlayerMoveEvent每秒触发几十次,频繁创建新计分板会额外增加服务端性能损耗、网络发包量
优化方案

核心原则:计分板仅初始化1次,后续仅更新发生变化的行内容,不要全量替换。

  1. 每个玩家加入时仅初始化1次计分板,用Team绑定固定的计分板行,后续更新直接修改Team的后缀即可,不需要重建整个计分板
  2. 给PlayerMoveEvent增加触发限制:只有玩家的方块坐标真实发生变化时才触发更新,同时增加更新冷却,避免高频调用
  3. 静态内容(比如玩家数、固定提示行)可以单独做定时更新,不要和移动事件绑定

修改后参考代码

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.08 17:48:01