Spigot插件开发如何正确实现玩家移动状态检测功能？

原有方案失效原因 #

数组存储触发事件玩家方案问题 #

• 事件处理方法用static修饰，Spigot事件监听机制不会触发静态方法，你的玩家移动列表本质从未被写入数据
• 列表仅添加元素不做定期清理/更新，玩家只要触发过一次移动就会永久被判定为移动状态，完全无法判断实时移动情况
• 直接存储Player对象会导致玩家退出后无法被GC，引发内存泄漏

速度向量判定方案问题 #

• 浮点数直接用== 0判断精度问题极大，玩家潜行、走路等低速移动时速度向量长度极小，容易被误判为0
• getVelocity()仅能反映受外力作用的移动状态，玩家主动行走、爬楼梯等操作的速度向量经常被服务器判定为0，和实际移动状态不符
• 服务器速度同步存在延迟，无法匹配玩家实时移动情况

可行解决方案（推荐） #

采用「监听移动事件+存储最后移动时间戳」的方案，是目前Spigot生态下判断移动状态最稳定的实现：

1. 首先定义全局存储结构，用玩家UUID避免内存泄漏

// 线程安全的HashMap存储玩家UUID对应最后一次移动的时间戳
private static final Map<UUID, Long> LAST_MOVE_TIME = new ConcurrentHashMap<>();

2. 编写移动事件监听逻辑，过滤仅转动视角的无效触发

@EventHandler
public void onPlayerMove(PlayerMoveEvent e) {
    Player player = e.getPlayer();
    Location from = e.getFrom();
    Location to = e.getTo();
    // 仅当坐标发生变化时更新移动时间，不需要判断视角移动可以去掉这个判断
    if (from.getX() != to.getX() || from.getY() != to.getY() || from.getZ() != to.getZ()) {
        LAST_MOVE_TIME.put(player.getUniqueId(), System.currentTimeMillis());
    }
}

3. 编写玩家退出事件清理逻辑，避免内存泄漏

@EventHandler
public void onPlayerQuit(PlayerQuitEvent e) {
    LAST_MOVE_TIME.remove(e.getPlayer().getUniqueId());
}

4. 编写移动状态判断方法，根据时间差判定是否静止

public static boolean isMoving(Player p) {
    long lastMove = LAST_MOVE_TIME.getOrDefault(p.getUniqueId(), 0L);
    // 阈值可根据需求调整，单位毫秒，200ms对应10个游戏tick，预留网络延迟余量
    return System.currentTimeMillis() - lastMove < 200;
}

额外注意事项 #

• 事件监听类需要添加@Listener注解，并且在插件onEnable方法中通过Bukkit.getPluginManager().registerEvents()完成注册，否则事件不会触发
• 如果需要更高的判定精度，可以把时间阈值调整到100ms，不要低于50ms（单个游戏tick的时长），否则会因为网络波动出现大量误判

内容的提问来源于stack exchange，提问作者Sysy