REPO 路径指引器

 REPO 路径指引器

一款基于 BepInEx 开发的 R.E.P.O. 插件，能够沿着寻路网格路径，在游戏世界中渲染点状轨迹线，指引你前往当前撤离点；当全部撤离任务完成后，轨迹会自动切换指向撤离卡车。

本模组沿用游戏内「回溯点位」同款目标判定逻辑，并将路径投射至全局三维空间，无需打开地图，即可顺着轨迹轻松寻路。

快捷键（可在配置文件自定义，默认均为功能键）

F4 — 开启 / 关闭路径轨迹

F5 — 切换目标模式：自动模式（由游戏机制控制，前往当前撤离点；全部撤离完成后自动切至卡车）/ 卡车模式（强制固定指向卡车，适合中途返回存放物资）。切换后设置自动保存。

F6 — 打开自定义面板：包含 RGBA 颜色滑块、十六进制色码输入、预设配色、光点大小 / 流动速度 / 点间距实时调节滑块。

路径计算机制

路径采用全局空间缓存机制，不会每帧重复计算，性能优化优秀：

目标判定

自动模式：读取游戏内部数据，未完成撤离时指向当前撤离点，全部撤离完成后锁定卡车位置

卡车模式：强制永久指向撤离卡车

重算触发条件

仅在以下情况重新生成路径：

暂无缓存路径

目标切换（更换撤离点、切换自动 / 卡车模式）

玩家偏离缓存路径直线距离超过 3 米（默认阈值）

场景切换导致缓存失效

缓存与实时更新

调用游戏寻路接口一次性计算完整路径，储存路径拐点与弧长数据；

玩家移动时，仅实时计算自身在路径上的相对位置，固定路径点位不变，轨迹坐标稳定不漂移。

动画与渲染系统

采用对象池机制，复用 30 个简易球体模型，移除碰撞体，共用材质，通过材质属性块单独控制每个光点颜色

全局动画偏移量持续递进，实现光点匀速流动效果，间距均匀稳定，不受路径长度影响

轨迹首尾做透明度渐变过渡，隐藏衔接断层与循环衔接痕迹

路径点位采用指数平滑插值，路径刷新时平缓过渡，避免瞬移闪烁；循环收尾点位强制瞬间刷新，防止跨场景错位拉伸

自动检索加载适配着色器，统一渲染层级与透明混合模式，保证画面显示正常

自定义设置界面

F6 呼出可拖拽式窗口：

RGBA 色彩调节滑块、十六进制色码输入、实时配色预览、8 组预设颜色

光点尺寸、流动速度、点间距自定义滑块

一键重置外观参数功能

所有修改即时写入配置，滑块拖动实时生效，配色、尺寸改动画面同步刷新；

面板开启时自动解锁鼠标光标、解除视角锁定，关闭后恢复原有操作状态。

兼容性说明

纯本地客户端模组，仅读取本地游戏数据运算、独立渲染特效，无联机数据包发送、无网络同步需求

单人 / 联机完全独立使用，房主与其他玩家无需安装亦可正常游玩

仅通过反射读取游戏内部数据，不修改、不篡改游戏原生代码与寻路网格

补丁仅作用于 Unity 原生输入系统，完全不影响游戏本体核心逻辑

移植输入屏蔽逻辑，修复设置面板拖拽滑块时镜头旋转、误触开火问题；精准限制输入补丁范围，保留快捷键正常使用。

修复长路径下光点循环拉伸、位移卡顿问题，优化循环点位刷新逻辑，杜绝远距离插值错位。

新增 F6 可视化自定义面板，全参数实时调节、配色即时刷新，配置项永久保存。

新增 F5 目标切换功能，支持双模式常驻切换，目标变更即时刷新路径。

废除每帧重算机制，改用路径缓存 + 玩家相对位置计算，大幅降低性能消耗；废弃旧版定时刷新参数。

新增点位平滑缓冲动画，优化路径刷新视觉效果，修复隐藏再显示后的画面异常。

重构光点循环逻辑，统一全局偏移计算，修复光点间距错乱抖动；新增配置版本自动迁移。

实时光点流动循环动画，替换静态显示模式；优化材质渲染，降低默认光点透明度，视觉更自然。

F4 开关轨迹、寻路网格路径计算、基础光点轨迹渲染功能。

注意！！ 此mod与其他相同类型的mod有冲突，请单独使用！