原创 工具 FlySpeedChecker - 防止加速飞行 1.1.0

# ============================================
# FlySpeedChecker 飞行速度检测插件配置
# 兼容 MC 1.12.2 (Spigot/Paper/CatServer)
# 速度单位: 格/秒 (blocks per second)
# ============================================

# 检测设置
check:
  # 检测间隔（单位：tick，20tick = 1秒）
  interval: 10
  # 飞行状态下的最大水平速度（格/秒）
  # 正常飞行约 11，按住Ctrl加速飞行约 22
  max-horizontal-speed: 30
  # 飞行状态下的最大垂直速度（格/秒）
  # 正常上升约 4，加速上升约 7-8（加速俯冲可能达到 15+，如有误判可调高）
  max-vertical-speed: 10
  # 连续检测到超速多少次后才执行惩罚（防止误判）
  violation-threshold: 3

  # 生存模式非法飞行检测（作弊模组的"加速飞行"不声明 isFlying，
  # 旧的只查 isFlying 的逻辑完全检测不到，只有这条线能抓到：
  # 悬浮/无重力/快速升空，且用服务端方块判定，伪造 onGround 无法绕过）
  survival-fly:
    enabled: true
    # 空中持续上升速度上限（格/秒），正常跳跃不会超过 6
    max-up-speed: 10.0
    # 悬浮判定窗口：连续多少次采样没有正常下落量就判定为悬浮
    # 每次采样间隔 = interval tick，6 次 = 3 秒；作弊者可悬浮数分钟，3 秒足够
    hover-checks: 6
    # 每个采样窗口的最小下落量（格），高于此值(即下落不足)视为"没有重力"
    hover-fall-threshold: -0.5

  # 地面/空中移动加速检测（抓加速移动、非正常疾跑）
  walk-speed:
    enabled: true
    # 步行/疾跑最大速度（格/秒），正常疾跑约 5.6，跳步约 7
    max-speed: 10.0
    # 每级速度药水放大的比例（0.2 = 每级 +20%）
    speed-effect-factor: 0.2

  # 豁免场景（防止误判，务必保持开启）
  exempt:
    # 鞘翅滑翔（含烟花助推，速度不可控无法设阈值）
    elytra: true
    # 骑乘载具/生物（船、马、矿车等，速度由服务端决定）
    vehicle: true
    # 在水/岩浆中（游泳、踩水悬浮是合法行为）
    water: true
    # 缓慢飘浮(Levitation)药水效果
    levitation: true
    # 受到击退/爆炸/弹射物等外部速度后的宽限采样次数
    velocity-grace-checks: 5

# 惩罚设置
punishment:
  # 是否踢出玩家
  kick: true
  # 飞行超速踢出消息
  kick-message: "&c你因飞行速度过快被踢出服务器！"
  # 生存模式非法飞行踢出消息
  survival-fly-kick-message: "&c你因非法飞行被踢出服务器！"
  # 移动加速踢出消息
  speed-kick-message: "&c你因移动速度异常被踢出服务器！"

# 警告设置
warning:
  # 是否启用警告
  enabled: true
  # 警告方式：broadcast(全服公告), private(私聊), bossbar(Boss栏), none(关闭)
  # 可多选，用逗号分隔，例如：broadcast,private,bossbar
  type: "broadcast,private,bossbar"

  # 全服公告消息
  broadcast-message: "&6[警告] &c玩家 &e%player% &c因飞行速度过快被踢出服务器！"

  # 私聊消息（发送给违规玩家）
  private-message: "&c警告：你的飞行速度超过限制，请降低速度！"

  # BossBar设置
  bossbar:
    # BossBar标题
    title: "&c警告：飞行速度过快！"
    # BossBar颜色：BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW
    color: RED
    # BossBar样式：SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
    style: SOLID
    # BossBar显示时长（单位：秒）
    duration: 5

# 绕过设置
bypass:
  # 拥有 flyspeedchecker.bypass 权限的玩家是否绕过检测
  use-permission: true
  # 创造模式是否绕过检测
  creative-bypass: false
  # 旁观者模式是否绕过检测
  spectator-bypass: true