UltimatePrediction

PEAK 全能落点预测模组。为可投掷道具、篮球与棋子、绳索炮、锁链发射器与爆炸物提供落点、最终碰撞箱、绳索长度与下垂、爆炸 / 治疗范围的实时预测。

• 游戏：PEAK（Unity 6 / Mono / BepInEx 5）
• 模组 ID：com.zhuanban.peak.ultimateprediction

安装

1. 安装 BepInExPack for PEAK。
2. 把 plugins/UltimatePrediction.dll 放到游戏的 BepInEx/plugins/ 目录。
3. 启动游戏；首次运行会在 BepInEx/config/com.zhuanban.peak.ultimateprediction.cfg 生成配置文件。

功能

投掷物落点预测

绳索炮 / 锁链发射器 / 发射类

• 绳索炮：按住精确预览键（默认鼠标右键）时，用游戏真实的绳索预制体与真实关节链重演一次完整发射：锚点飞出 → 抵达后生成绳索 → 逐帧放出。绳索形状由几十个关节的动力学决定，因此只提供精确模式。
• 锁链发射器：按住左键使用时显示锁链落点、长度与真实下垂形态。
• 发射类（反重炮、治疗飞镖）：按住左键使用时显示精确命中点与轨迹。

两套预测

① 即时解析预测（蓄力时自动显示，每帧重算，单次约 0.2~2ms）

• 按 PhysX 的积分公式解析弹道，并对真实场景做扫掠形状投射求碰撞；扫掠自带完美 CCD，不会穿透薄几何。
• 按碰撞体真实类型选投射形状（球 / 胶囊 / 盒完全精确），凸网格用「运动方向支撑点射线」精确求首次接触。
• 接触响应按 PhysX 源码对齐（材质合并、bounceThreshold、contactOffset、静 / 动摩擦）。
• 零拷贝、零烘焙、不创建任何物理场景，不产生卡顿。

② 精确物理预览（按住精确预览键，默认鼠标右键，需等 1~2 秒）

• 在主场景里放一个真实刚体探针（克隆道具预制体、剥离全部逻辑组件、保留真实碰撞体与材质），用游戏自己的 PhysX 跑完整条轨迹，结果与游戏完全一致。
• 不设任何人为限制：没有时间上限、没有弹跳次数上限、没有人为速度阈值；一直模拟到物品真正静止（PhysX 睡眠）、或按游戏规则被消耗、或按游戏规则越界销毁为止。
• 同样零拷贝零烘焙；代价是必须按真实时间跑完。

落点观察窗

投掷类道具会在屏幕角落常显一个小窗，用独立相机聚焦落点，避免落点被手持道具或地形挡住而看不清。

• 视角按落点法线自适应：墙面从正面略俯、地面从斜上方俯视、天花板从斜下仰视。
• 相机到落点距离恒定；视线被挡时换角度而不是拉近拉远，配合方向滞回与目标死区，画面稳定不闪。
• 精确物理预览时小窗持续追踪幽灵，飞行途中即可观察。
• 按住位置调整修饰键（默认右 Alt）：方向键移动小窗、+ / - 缩放；此时即使没有预测也会显示占位小窗，方便随时摆放。

配置

配置文件：BepInEx/config/com.zhuanban.peak.ultimateprediction.cfg

• 1-通用：总开关、预览透明度、预览时隐藏手中道具。
• 2-视觉：轨迹线、落点标记、碰撞箱、结果幽灵、范围预测、颜色加深、范围屏幕遮罩、各颜色与脉冲速度。
• 3-道具：每个道具的独立开关 + 发射类道具预测 + 通用投掷物预测开关。
• 4-绳索锁链：绳索预览透明度、锁链预览颜色。
• 5-高级：调试日志、启用精确物理预览、精确预览按键（默认鼠标右键）。
• 6-落点观察窗：启用观察窗、窗口宽度与位置、相机距离 / 俯仰 / 视野、位置调整修饰键。

多人安全性

• 所有预测均为本地视觉，不发送任何网络数据、不修改游戏状态。
• 即时解析预测只做只读物理查询，不创建任何物理对象。
• 精确物理探针是对世界逐对忽略碰撞的本地刚体，销毁时回滚；预览对象剥离全部联网与注册组件，无内存泄漏。

已知限制

• 即时解析预测对第一次撞击最准；需要完全一致时请使用精确物理预览。
• 飞盘 / 滑翔翼的弹道不是抛物线，且投掷没有放置类效果，因此不做预测。
• 游戏内随机量无法完全预测，预览取确定性近似。
• 精确物理预览需要按真实时间跑完（约 1~2 秒），且按住期间使用按下那一刻的蓄力值与朝向。

致谢

参考了社区模组 MagicPreview、CloudAndBounceFungusPrediction、RopePreview 的思路，实现完全独立重写并大幅增强。

1.0.0

首个正式版本。

功能

• 投掷物落点预测：魔豆、云雾菇、弹力菇、踏板菇、曲迁菇、灵药菇、炸药，以及篮球 / 传送篮球、全部棋子（C_*）和其它具有特殊投掷效果的道具。显示飞行轨迹、落点标记、最终碰撞箱、结果幽灵与爆炸 / 治疗作用范围。
  • 篮球的精确物理预览会完整模拟真实弹跳直至静止；即时预测只显示首次撞击落点（多次弹跳与真实物理发散过大，不适合即时给出）。传送篮球命中地形触发传送时显示传送点。
  • 「碰撞即使用」的道具（碎片生成、种植、传送、空中破碎等）只模拟到它真正被使用的那一帧。
• 精确物理预览（按住精确预览键，默认鼠标右键）：在主场景里用游戏自己的 PhysX 与真实碰撞体跑完整条轨迹，结果与游戏完全一致；绳索炮只有这一种模式。不设任何人为限制（没有时间上限、弹跳次数上限或速度阈值），一直模拟到物品真正静止或按游戏规则被消耗 / 越界销毁为止。
• 绳索炮 / 锁链发射器：按真实预制体与真实关节链重演发射、生长与下垂。
• 落点观察窗：投掷类道具在屏幕角落常显一个小窗聚焦落点，避免被手持道具或地形挡住看不清；精确预览时持续追踪幽灵。按住位置调整修饰键（默认右 Alt）可用方向键移动、+ / - 缩放。
• 即时解析预测与精确物理预测两套模式，各自做到所在路线的极限。
• 完整的 BepInEx 中文配置项。

安装

1. 先安装 BepInExPack for PEAK。
2. 把本模组的 plugins/UltimatePrediction.dll 放到游戏的 BepInEx/plugins/ 目录。

已知限制

• 即时解析预测对第一次撞击最准；需要完全一致时请使用精确物理预览（按住鼠标右键）。
• 飞盘 / 滑翔翼的弹道不是抛物线，且投掷没有放置类效果，因此不做预测。
• 游戏内的随机量（例如曲迁菇的部分传送细节、弹力 / 踏板菇的随机朝向）无法完全预测，预览取确定性近似。
• 所有预测均为本地视觉，不发送任何网络数据、不修改游戏状态。