Flight Kick Bypass

Flight Kick Bypass is a server-side mod for Minecraft.

When a player is about to be disconnected by the vanilla server for floating or flying too long, the mod first teleports the player to the top of the first solid collision block below their current position. After that, it either continues the vanilla kick flow or keeps the player online, depending on the server config.

Why

Some modded blocks can have models or collision behavior that leave players in positions where the server repeatedly triggers the vanilla flying check. Network issues can cause similar repeated disconnects. Once this happens, the player may be kicked again immediately after reconnecting, which often requires an administrator to manually move the player or intervene through server tools.

This mod reduces that recovery work by moving the player to a valid block below them before the flying kick is processed.

Features

• Handles the vanilla multiplayer.disconnect.flying kick path.
• Teleports the player to the nearest valid block below their current X/Z position before the kick is processed.
• Resets velocity and fall distance after teleporting.
• Supports both normal player floating kicks and vehicle floating kicks.
• Can be configured to keep the player online after a successful teleport.
• Can expand the landing search to a configurable square radius if no block is found directly below the player.
• Logs the loaded config state during config load and reload.

Configuration

Both loader implementations use the same keys and defaults.

NeoForge writes its server config to <world>/serverconfig/flightkickbypass-server.toml:

kickAfterTeleport = true
expandedSearchRadius = 0
disconnectMessageSuffix = "Teleported to the nearest safe position before disconnecting."
teleportMessage = "Flying was detected for too long, so you were teleported to the nearest safe position instead of being disconnected."

Fabric writes config/flightkickbypass.json:

{
  "kickAfterTeleport": true,
  "expandedSearchRadius": 0,
  "disconnectMessageSuffix": "Teleported to the nearest safe position before disconnecting.",
  "teleportMessage": "Flying was detected for too long, so you were teleported to the nearest safe position instead of being disconnected."
}

kickAfterTeleport options:

• true default: teleport the player to the ground, then continue the vanilla kick flow.
• false: if the teleport succeeds, cancel the kick and reset the floating counter. If no valid block is found below the player, the vanilla kick still happens.

expandedSearchRadius options:

• 0 default: only search directly below the player.
• Greater than 0: if the direct search fails, search a square area around the player's current block position. A value of r searches a (2r + 1) x (2r + 1) square.

Player-facing messages:

• disconnectMessageSuffix: appended on a new line to the flying disconnect reason after a successful teleport when kickAfterTeleport is true. Set it to an empty string to disable the extra line.
• teleportMessage: sent as a system message to the player after a successful teleport when kickAfterTeleport is false. Set it to an empty string to disable the message.

Notes

This mod does not grant flight permission and does not change the vanilla movement check itself. It only changes what happens immediately before the vanilla flying disconnect is processed.

The project icon is AI-generated illustrative artwork, not an in-game screenshot.

---

Flight Kick Bypass

Flight Kick Bypass 是一个适用于 Minecraft 的服务端 mod。

当玩家即将因为原版服务器的“长时间悬空/飞行”检测而被踢出时，本 mod 会先把玩家传送到当前位置 X/Z 下方第一个具有碰撞体的方块顶部。传送完成后，可以根据服务端配置选择继续执行原版踢出流程，或保留玩家在线。

为什么做这个 mod

某些 mod 方块的模型或碰撞表现，可能会让玩家停在容易反复触发原版飞行检测的位置。网络问题也可能造成类似的连续踢出。一旦出现这种情况，玩家重连后可能立刻再次被踢出，通常需要管理员手动移动玩家，或通过服务器管理工具介入处理。

本 mod 的目的就是在飞行踢出真正执行前，先尝试把玩家移动到下方有效方块上，减少这类问题带来的人工处理成本。

功能

• 处理原版 multiplayer.disconnect.flying 踢出流程。
• 在踢出前，将玩家传送到当前 X/Z 下方最近的有效方块上方。
• 传送后清空速度并重置摔落距离。
• 支持普通玩家悬空踢出和载具悬空踢出。
• 可配置传送成功后是否继续踢出玩家。
• 如果玩家正下方找不到落点，可配置扩大为正方形半径范围搜索。
• 配置加载和重载时会在日志中输出当前配置状态。

配置

两个加载器使用相同的配置键和默认值。

NeoForge 会把服务端配置写到 <world>/serverconfig/flightkickbypass-server.toml：

kickAfterTeleport = true
expandedSearchRadius = 0
disconnectMessageSuffix = "Teleported to the nearest safe position before disconnecting."
teleportMessage = "Flying was detected for too long, so you were teleported to the nearest safe position instead of being disconnected."

Fabric 会写入 config/flightkickbypass.json：

{
  "kickAfterTeleport": true,
  "expandedSearchRadius": 0,
  "disconnectMessageSuffix": "Teleported to the nearest safe position before disconnecting.",
  "teleportMessage": "Flying was detected for too long, so you were teleported to the nearest safe position instead of being disconnected."
}

kickAfterTeleport 选项说明：

• true 默认值：先把玩家传送到地面，然后继续执行原版踢出流程。
• false：如果传送成功，则取消本次踢出并重置悬空计数。如果玩家下方找不到有效方块，仍然执行原版踢出。

expandedSearchRadius 选项说明：

• 0 默认值：只搜索玩家正下方。
• 大于 0：如果正下方搜索失败，则以玩家当前方块位置为中心搜索正方形范围。值为 r 时，搜索范围为 (2r + 1) x (2r + 1)。

向玩家展示的文本：

• disconnectMessageSuffix：当 kickAfterTeleport 为 true 且传送成功时，追加到飞行踢出原因的新一行文本。设为空字符串可以禁用这行额外提示。
• teleportMessage：当 kickAfterTeleport 为 false 且传送成功时，作为系统消息发送给玩家。设为空字符串可以禁用这条消息。

说明

本 mod 不会给予玩家飞行权限，也不会修改原版移动检测本身。它只改变原版飞行踢出即将执行前的处理行为。

项目图标为 AI 生成的说明性美术图，并非游戏内截图。