鞘翅 Bot 说明

对手不必处于甲飞状态：普通飞行、滑翔与穿甲滞空按实际装备和运动观测处理。

• 长矛撤离：结合剩余蓄力、间距与目标远离速度重新接敌；保留近距离脱离、最短撤离时间与超时上限，SPEAR 和 MXS 共用。观测不稳定时不据此提前追击。
• 1.21.1 兼容：1.21.1 原版没有长矛。长矛模式依赖支持长矛的 1.21.11 服务端，以及保留原始物品标记的协议转换；已验证外部 ViaProxy 链路。支持持用蓄力碰撞，不包含新版协议的刺击动作；其他转换链和插件改造需另行验证。
• Mace 页：Rotate 控制重锤攻击转头，YawStep 控制每 tick 最大转角，MoveFix 配合分步转头修正移动。关闭 Rotate 后仍需实际朝向目标；这些选项不替代飞行导航和长矛瞄准。
• 出手条件：接收到的目标位置用于范围、瞄准与遮挡检查；等待切槽和转头实际提交。取消的攻击不提前消耗冷却，长矛使用包取消后不会保留虚假蓄力。
• 落地与回拉：已加载区块内按脚底支撑校验落地，身体碰墙不算落地；回拉清理旧追击、闪避、武器控制和待确认命中。
• Aura 协作：空战控制武器时 Aura 保留协作优先级；Aura 的 TP 往返默认关闭，在滑翔、骑乘或空战控制武器期间不执行。

实际提交只表示客户端已发送，不等于服务器接受攻击。不同服务器的延迟、回拉和命中结果仍需实测。完整改动见更新日志。

本次汇总 rc17 之后的界面、甲飞入口、战斗协同、目标运动适配和诊断改动。飞行方向由 ElytraFlight 控制，追击由 AerialCombat 控制，换甲单独在 ArmorFly 中启用。

默认名称迁移：GuangxiElytra 显示为 ElytraFlight，GuangxiElytraChase 显示为 AerialCombat。旧配置 ID、按键和旧命令保留，自定义显示名不被覆盖。下文保留设置内部名称以便对照旧配置。

验证边界：rc21 成品当时通过 67 个回归任务、26,026 项混淆检查和同 SHA 双 Java 启动检查。尚无新版实服胜率、FPS 收益或 rc21 遥测接收验证；“滑翔加速”不能证明对方使用了烟花，“胸甲空中”也不是识别某种客户端的结论。完整累计更新日志 · rc17 历史说明与当时验证。

准备鞘翅与未选中快捷栏里的胸甲，开启“甲飞”进行装备轮换；需要自动追击时再开启 AerialCombat。重锤俯冲保留装备优先权，修正、重生与停止时恢复相关状态。

AutoRocket默认开

独立甲飞期间按飞行状态补充烟花；不代表会在不满足滑翔或材料条件时强制使用。

旧配置迁移

保留原来已经生效的甲飞状态；仅有旧开关残留而飞行原本关闭时，不自动打开甲飞。项目预设保持相关模块关闭，使用前按需开启。

输入 .diag start 60 后按平时方式飞行和交战，使用 .diag status 或 .timings 20 查看，.diag stop 提前结束，.diag export 保存到游戏目录的 guizhouware/diagnostics/。Diagnostics HUD 在采样期间显示状态。

读数口径：报告覆盖已接入的模块耗时、近似 P95、渲染间隔、GC、缓存、发包取消和动作等待。rc22 还可查看锚原位复用、阶段阻塞、事件合并与确认耗时。父子计时不可直接相加，渲染间隔不等于 GPU 耗时，本地发包通过不等于服务器确认。.diag 详细报告仅在本地保存。

自动遥测：rc21 起，含有效遥测凭据的客户端进入游戏后自动上传诊断；.telemetry status 查看接收状态，HTTP 确认不等于独立核验落盘。范围与账号关联见自动上传须知。

四种追击模式按当前目标自动完成接近、攻击、脱离、重试的整个循环。模块会自己驾驶鞘翅（需 AutoControlElytra），玩家可以随时按键接管。

追击模式（Mode）

保留的设置

Range / PlayerOnly / DynamicTarget

索敌范围、仅玩家和动态换目标；范围默认 80 格，动态换目标默认关闭。

AutoControlElytra / OnlyWhenNoWasd

自动接管飞行默认开启；手动方向键优先默认关闭。

AutoWeapon / Rotate

自动选武器和重锤攻击转头默认开启。转头仍须通过最终朝向与射线检查。

FollowGroundHeightExtra

跟随地面目标时额外抬高航线，默认 2 格。

MaceHeight / MaceAdaptive

重锤偏好高度默认 80 格，自适应高度默认开启；实际按脱离滑翔、下落条件和拦截路线处理。

MaceMinFallDistance / MaceUseExtraAttack

最低下落距离默认 1.5 格；普通补刀默认开启，但仍检查范围、冷却和转头。

SpearAttackDistance / SpearPullOverDistance

长矛接敌和撤离距离，默认均 8 格；实际攻击仍受武器能力和服务器交互限制。

武器设置按模式显示；原威胁判断、规避、预测及多线程调参已收为内部策略。长矛不再常驻周期扫头，仅在满足蓄能、距离、速度等条件且持续未命中时有限搜索。目标运动分类依据观测，不假定对方一定开启甲飞。

当前战斗限制：尚未证明在 Grim 下稳定胜过参考端，重锤有效下砸仍需改进。GZBoost 手动飞行的速度实测不等于空战速度或伤害。下方旧版胜率记录仅适用于各自历史测试。

装备鞘翅与烟花，开启飞行后用 WASD 指定方向，空格拉升、潜行下降。Grim 自动使用耦合巡航；Mode 下方的 GZBoost 默认关闭，需要高速时自行打开，不需要按冲刺键。

必要选项

ModeGrim / NoAC

默认 Grim：烟花推进与协议适配。NoAC：直接速度控制，对应旧 VOID，用于无移动反作弊的环境。

GZBoostGrim · 默认关

支持双视角协议时增强手动巡航、下降及方向拉升。普通巡航无需开启；不支持双视角时聊天提示并回退单视角，不保证高速。

GZBoostModeGZBoost 开启后显示 · 默认 Aggressive

Aggressive（激进）保留当前拉升；Gentle（温和）减少沿轴拉升摆幅。选择随配置保存，再次开关 GZBoost 不会重置选择。两档平飞、下降、对角拉升和原位上升规则相同，温和不是整体限速模式。

AdaptiveSlowdownGrim · 默认关

开启后，关联拉回会降低受控飞行预算，稳定后逐步恢复。关闭时仍清理旧动作和短暂停推，但不累计降速惩罚。

SpeedBps / ClimbBpsNoAC · 默认 40 / 40

水平与升降目标速度，单位格/秒，范围 1–300。它们不控制 Grim 下的实际速度。

FreeLook默认开

观察镜头与飞行航向分离；不等于双视角协议支持，也不能消除实际摆动。

AutoFly默认关

无方向输入时继续自动飞行。

TerrainGuard / AutoEquip默认开

地形保护与自动装备鞘翅。甲飞仍由独立 ArmorFly 模块控制。

速度参考 · 不是通用上限

测试条件：1.21.11 开发端 + ViaFabricPlus 4.4.2，目标 1.20.3–1.20.4；Paper 1.20.4 build 499、Grim 2.3.73、ViaVersion 5.12.0，生存、无豁免、原版移动检查开启。本机低延迟，60 FPS，每玩家区块加载/发送速率 400/400。数据为最后 15 秒的服务端净位移。未在所有服务器、1.21.1 客户端或甲飞/战斗组合下重复验证。

使用差异：普通 Grim 使用基础耦合巡航；协议允许时可使用双视角。GZBoost 在此基础上更积极推进和拉升，会消耗更多烟花，实际摆动可能影响窄路和接敌。原生协议或不支持的转换链自动回退，不能靠勾选开关获得相同速度。

回弹、后台计算与旧配置

回弹后作废旧路线与动作；自适应降速另行按需启用。后台计算使用有界快照和队列，攻击、换装、转头、碰撞复核留在主线程。用 .diag start 60 与 .timings 20 查看开销；不再提供额外的飞行线程开关。

旧 VOID/FIREWORKS 等配置会迁移；内部角度、接受范围、GrimBoost 及旧实验参数不再显示为可调项。GZBoost 是新开关，默认关闭。旧版下载预设只作历史参考，建议先保存现配置再载入。累计更新日志与发行校验

空战 HUD 采用两层结构：未锁定目标时显示巡航层（我方飞行状态），锁定目标后交叉淡入目标层（敌情面板）。配套网页原型：点此打开（含实时模拟数据、明暗主题与锁定/丢失切换演示）。

状态说明：HUD 可在编辑器拖动、键盘微调、滚轮缩放，右键打开单元素外观页，设置背景/文字/强调颜色与背景透明度；旧手动布局保留。目标层新增运动类型，Diagnostics 元素显示本地采样；没有实时数据的编辑元素标为预览。网页原型使用模拟数据，具体设置以游戏内为准。