修复随机传送过程中的卡方块

src/main/java/org/windy/teleportoffset/TeleportOffset.java

@@ -88,67 +88,83 @@ public boolean onCommand(CommandSender sender, Command command, String label, St
         return false;
     }
 
+    // 使用 @EventHandler 注解，表示这是一个事件处理器
     @EventHandler
     public void onPlayerTeleport(PlayerTeleportEvent event) {
-        //旧位置
+
+        // 通过 event.getFrom() 获取玩家传送前的位置，并通过 clone() 方法创建一个副本，确保不会对原位置对象进行修改
         Location oldLocation = Objects.requireNonNull(event.getFrom()).clone();
-        //目的位置
+        // 通过 event.getTo() 获取玩家传送后的位置，并通过 clone() 方法创建一个副本，确保不会对原位置对象进行修改
         Location location = Objects.requireNonNull(event.getTo()).clone();
 
-        // 获取玩家和目标世界的名字
+        // 获取进行传送的玩家对象以及目标位置所在的世界对象
         Player player = event.getPlayer();
+        // 获取目标世界的名称
         String worldName = Objects.requireNonNull(location.getWorld()).getName();
+        // 获取玩家的名称
         String playerName = player.getName();
 
+        // 根据配置判断是否要对玩家的传送目标位置进行偏移
         if (disabledWorlds.contains(worldName)) {
+            // 如果目标世界在配置的列表中，将按照配置中的偏移量对目标位置进行修改
             location.add(offsetX, offsetY, offsetZ);
+            // 使用自定义的日志记录器记录一条信息，表示玩家已被执行偏移
             log("玩家" + playerName + "已被执行偏移" + offsetX + "," + offsetY + "," + offsetZ);
-        }else{
+        } else {
+            // 如果目标世界不在禁用列表中，调用自定义方法 findHighestNonAirBlockLocation 找到目标位置的最高非空气方块位置
             location = findHighestNonAirBlockLocation(location);
+            // 使用自定义的日志记录器记录一条信息，表示已为玩家找到最高位置
             log("玩家 " + playerName + " 当前世界最高点：" + location);
         }
+
+        // 将调整后的位置对象进行 clone()，以确保在设置传送目的地时不会影响到原始 position 对象，并将这个 clone 后的对象作为最终传送目的地
         final Location finalLocation = location.clone();
+        // 通过 event.setTo(finalLocation) 将最终的传送目的地设置到 event 中，使得玩家会被传送到这个新的位置
         event.setTo(finalLocation);
 
-
+        // 使用自定义的日志记录器记录一条信息，表示玩家应该从旧位置传送到新位置
         log("玩家 " + playerName + " 应该从 " + oldLocation + " 传送到: " + location);
 
+        // 获取目标位置的 Y 坐标值并记录到日志中，以方便后续检查
+        double TargetY = location.getY();
+        log("所以玩家"+playerName+"的目标Y值是："+TargetY);
 
-        //传送检查
+        // 获取玩家当前的实际 Y 坐标值并记录到日志中，以方便后续检查和比较
+        double currentY = player.getLocation().getY();
+        log("但是！玩家" + playerName + "Y值实际是：" + currentY);
 
-        double initialY = player.getLocation().getY();
-        log("玩家" + playerName + "Y值应该是：" + initialY);
-        // 传送前设置无敌
+        // 在传送前设置玩家为无敌状态，确保玩家在传送过程中不会受到伤害
         player.setInvulnerable(true);
 
-        //  new BukkitRunnable() {
-        //    @Override
-        //  public void run() {
+        // 创建一个新的 BukkitRunnable 任务，用于检查玩家的 Y 坐标是否在误差范围内，以及在必要时重新传送玩家
         if (player.isOnline()) {   // 检查玩家是否在线
-            double currentY = player.getLocation().getY(); //检查后的Y值
-            if (Math.abs(currentY - initialY) <= 1) {
-                    log("但是玩家 " + playerName + " 的 Y 坐标在误差的上下 1 个单位范围内: " + currentY);
+            if (Math.abs(currentY - TargetY) <= 1) {
+                // 如果玩家当前的 Y 坐标值与目标 Y 坐标值的差的绝对值小于或等于 1，则记录一条日志，表示玩家的 Y 坐标在误差范围内
+                log("所以！玩家 " + playerName + " 的 Y 坐标在误差的上下 1 个单位范围内: " + currentY);
             } else {
+                // 如果玩家当前的 Y 坐标值与目标 Y 坐标值的差的绝对值大于 1，则记录一条日志，表示玩家的 Y 坐标不在误差范围内，并启动一个新的定时任务来检查 Y 坐标
                 log("但是玩家 " + playerName + " 的 Y 坐标不在误差的上下 1 个单位范围内: " + currentY);
-                    // 重新传送一遍，限制重试次数
+                // 重新传送一遍，限制重试次数
                 new BukkitRunnable() {
                     int retries = 0;
 
                     @Override
                     public void run() {
-                        if (retries >= times || !player.isOnline()) {
+                        if (retries >= times ||!player.isOnline()) {
                             this.cancel();
                             return;
                         }
 
                         double currentY = player.getLocation().getY();
-                        if (Math.abs(currentY - initialY) <= 1) {
+                        if (Math.abs(currentY - TargetY) <= 1) {
+                            // 如果玩家的 Y 坐标在误差范围内，记录一条日志并取消当前定时任务
                             log("尝试重新传送，但是 " + playerName + " 的 Y 坐标在误差的上下 1 个单位范围内: " + currentY);
                             this.cancel();
                         } else {
-                            // 重新传送玩家
+                            // 如果玩家的 Y 坐标不在误差范围内，重新传送玩家到最终位置，并增加重试次数
                             Bukkit.getScheduler().runTask(TeleportOffset.this, () -> {
                                 player.teleport(finalLocation);
+                                // 记录一条日志，表示重新传送
                                 log("因此玩家" + playerName + "再次传送到: " + finalLocation);
                             });
                             retries++;
@@ -157,24 +173,26 @@ public void run() {
                 }.runTaskTimer(TeleportOffset.this, 0L, 5L); // 每0.5秒检查一次
             }
         } else {
+            // 如果玩家不在线，记录一条日志表示已退出传送修正过程
             log("由于玩家 " + playerName + "不在线，已退出传送修正。");
         }
-        //   }
-        //  }.runTaskLater(this, 60L); // 3秒后检查
 
-        // 4秒后移除无敌效果
+        // 启动一个新的 BukkitRunnable 任务，用于在 4 秒后移除玩家的无敌效果
         new BukkitRunnable() {
             @Override
             public void run() {
                 if (player.isOnline()) {
+                    // 如果玩家在线，移除其无敌效果，并记录一条日志表示移除成功
                     player.setInvulnerable(false);
                     getLogger().info("移除玩家 " + player.getName() + " 的无敌效果。");
                 } else {
+                    // 如果玩家不在线，记录一条日志表示玩家不存在或已离线
                     getLogger().info("玩家 " + player.getName() + " 不在线或不存在！");
                 }
             }
         }.runTaskLater(this, 80L);
     }
+
     private Location findHighestNonAirBlockLocation(Location location) {
         World world = location.getWorld();
         int x = location.getBlockX();