如何实现玩家朝向的平滑旋转动画-java教程-PHP中文网

如何实现玩家朝向的平滑旋转动画

本文介绍在 minecraft 服务端插件（bukkit/spigot）中，通过分步插值方式实现玩家视角（yaw/pitch）的平滑转向，避免直接设置导致的瞬时跳变，提升视觉体验。

本文介绍在 minecraft 服务端插件（bukkit/spigot）中，通过分步插值方式实现玩家视角（yaw/pitch）的平滑转向，避免直接设置导致的瞬时跳变，提升视觉体验。

在开发 Bukkit 插件时，若需让一名玩家（如 NPC 或旁观者）平滑地转向目标方向（例如另一个玩家），直接调用 player.setRotation(yaw, pitch) 会造成视角瞬间切换，产生“卡顿”或“抖动”的不自然效果。根本原因在于：该方法执行的是瞬时赋值，缺乏时间维度上的过渡。

真正的平滑旋转，本质是插值动画（interpolated animation）——即在起始角度与目标角度之间，按固定时间间隔（如每 tick）逐步更新角度值，形成连续变化的视觉效果。

✅ 正确实现思路：线性插值 + 定时任务

以 1 秒（20 ticks）完成转向为例，核心步骤如下：

计算总偏移量：deltaYaw = targetYaw - currentYaw，deltaPitch = targetPitch - currentPitch；
拆分为等量步进：每 tick 增加 deltaYaw / 20 和 deltaPitch / 20；
使用 BukkitScheduler 每 tick 执行一次更新，并持续累加当前角度；
到达终点后自动停止任务（关键！避免内存泄漏和无效计算）。

以下是优化后的完整示例代码（含健壮性处理）：

public class SmoothRotationTask implements Runnable {
    private final Player targetPlayer;
    private final Location targetLocation; // 可为另一玩家的位置，用于计算目标朝向
    private float currentYaw;
    private float currentPitch;
    private final float targetYaw;
    private final float targetPitch;
    private final int totalTicks;
    private int elapsedTicks = 0;

    public SmoothRotationTask(Player player, Location targetLoc, int durationTicks) {
        this.targetPlayer = player;
        this.targetLocation = targetLoc;
        this.currentYaw = player.getLocation().getYaw();
        this.currentPitch = player.getLocation().getPitch();

        // 计算目标朝向（面向 targetLoc 的水平+垂直角度）
        Vector dir = targetLoc.clone().subtract(player.getLocation()).toVector();
        this.targetYaw = (float) Math.toDegrees(-Math.atan2(dir.getX(), dir.getZ()));
        this.targetPitch = (float) Math.toDegrees(-Math.asin(dir.getY() / dir.length()));

        this.totalTicks = Math.max(1, durationTicks);
    }

    @Override
    public void run() {
        if (elapsedTicks >= totalTicks || !targetPlayer.isOnline()) {
            // 到达终点或玩家离线：清理任务
            cancel();
            return;
        }

        // 线性插值：当前值 = 起始值 + (目标值 - 起始值) * (已过比例)
        float ratio = (float) elapsedTicks / totalTicks;
        float yaw = currentYaw + (targetYaw - currentYaw) * ratio;
        float pitch = currentPitch + (targetPitch - currentPitch) * ratio;

        // 应用到所有非目标玩家（按原需求）
        for (Player p : Bukkit.getOnlinePlayers()) {
            if (p != targetPlayer) {
                p.setBodyRotation(yaw, pitch, 0f); // 更推荐 setBodyRotation（1.20.5+）或 setRotation
            }
        }

        elapsedTicks++;
    }

    public void cancel() {
        // 实际使用中建议保存 BukkitTask 引用以便取消
    }
}

⚠️ 关键注意事项

Yaw/Pitch 归一化：Minecraft 中 Yaw 范围为 [-180, 180)，直接线性插值跨 ±180° 会出现反向旋转（如从 179° → -179°）。生产环境应使用最短路径插值（对 yaw 差取模并修正符号），本文为简洁略去，但实际项目中务必处理；
任务生命周期管理：必须在完成或玩家下线时显式取消 BukkitTask（通过 task.cancel()），否则定时器将持续运行，造成性能浪费与潜在 NPE；
API 兼容性：setBodyRotation()（1.20.5+）比 setRotation() 更准确地控制身体朝向；若需兼容旧版本，请回退至 setRotation() 并注意其仅影响视角，不影响实体朝向逻辑；
性能优化：避免在 run() 中重复调用 Bukkit.getOnlinePlayers()（可缓存列表）；若仅需转向特定玩家，勿遍历全部在线玩家。