UltimatePrediction

UltimatePrediction

PEAK 全能落點預測模組。爲可投擲道具、籃球與棋子、繩索炮、鎖鏈發射器與爆炸物提供落點、最終碰撞箱、繩索長度與下垂、爆炸 / 治療範圍的實時預測。

• 遊戲：PEAK（Unity 6 / Mono / BepInEx 5）
• 模組 ID：com.zhuanban.peak.ultimateprediction

安裝

• 安裝 BepInExPack for PEAK。
• 把 plugins/UltimatePrediction.dll 放到遊戲的 BepInEx/plugins/ 目錄。
• 啓動遊戲；首次運行會在 BepInEx/config/com.zhuanban.peak.ultimateprediction.cfg 生成配置文件。

功能

投擲物落點預測

| 道具 | 預測內容 |

|---|---|

| 魔豆 | 落點、生長法線、藤蔓長度與最終碰撞箱（可攀爬 / 不可攀爬着色） |

| 雲霧菇 | 按遊戲真實的「速度 + 時間」破碎條件預測破碎點與雲臺落點 |

| 彈力菇 | 破碎點、彈力平臺落點與朝向 |

| 踏板菇 | 破碎點、平臺落點與朝向 |

| 曲遷菇 | 飛行軌跡、傳送時間窗口內的傳送落點 |

| 靈藥菇 | 破碎點與治療作用半徑 |

| 炸藥 | 最終位置（考慮引信時間）與爆炸作用半徑 |

| 反重炮 / 治療飛鏢 | 射線命中落點與軌跡 |

| 籃球 / 傳送籃球 | 即時預測顯示首次撞擊落點；精確物理預覽完整模擬真實彈跳直至靜止（傳送籃球命中地形即觸發傳送時顯示傳送點） |

| 棋子（全部 C_*） | 落地後的落點與碰撞箱 |

| 其它特殊投擲物 | 具有破碎生成 / 粘附 / 碰撞觸發等特殊效果的道具，均提供通用落點 + 碰撞箱預測 |

繩索炮 / 鎖鏈發射器 / 發射類

• 繩索炮：按住精確預覽鍵（默認鼠標右鍵）時，用遊戲真實的繩索預製體與真實關節鏈重演一次完整發射：錨點飛出 → 抵達後生成繩索 → 逐幀放出。繩索形狀由幾十個關節的動力學決定，因此只提供精確模式。
• 鎖鏈發射器：按住左鍵使用時顯示鎖鏈落點、長度與真實下垂形態。
• 發射類（反重炮、治療飛鏢）：按住左鍵使用時顯示精確命中點與軌跡。

兩套預測

① 即時解析預測（蓄力時自動顯示，每幀重算，單次約 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 的思路，實現完全獨立重寫並大幅增強。