视角拓展

视角拓展 为 Survivalcraft 带来全新视角体验的模组 一、模组概述 视角拓展（MultiPerspective） 是一款为 生存战争 打造的多视角相机模组，在原版第一人称与第三人称视角之外，新增三种精心设计的视角模式： 越肩视角 、 真实第一人称视角 和 正交视角 。 无论你是追求沉浸感的生存玩家、想要欣赏角色模型的建造者，还是偏好 RTS 风格俯瞰全局的策略型玩家，本模组都能为你提供最合适的观察方式。每种视角均经过深度定制，配备独立的交互逻辑、防穿模算法和参数调节系统，确保在全新视角下依然拥有流畅、精准的游戏体验。 信息 详情 模组名称 视角拓展（MultiPerspective） 作者 九个芒果 API 版本 1.9.0.2+ 开源地址 https://gitee.com/ninemangos/multi perspective 二、新增视角系统详解 2.1 越肩视角（Over the Shoulder Perspective） 越肩视角将摄像头从角色眼睛位置偏移至后上方，呈现经典的第三人称越肩构图。完全复用第一人称的控制逻辑，仅改变摄像头位置，确保瞄准、移动等操作与原版手感一致。 核心亮点 智能防穿模系统 ：采用五射线碰撞检测（中心 + 四角），根据肩侧方向分配检测权重，碰撞时相机自动回弹并朝中轴线偏移，避免穿入墙壁。双层平滑架构确保穿模修正快速响应、恢复过程缓慢自然，杜绝画面抖动。 瞄准视角回正 ：手持可瞄准物品并按下瞄准键时，相机自动平滑过渡至瞄准偏移位置，松开后恢复用户自定义偏移。左肩和右肩分别维护独立的瞄准回正开关。 左右肩独立配置 ：左肩和右肩分别维护三轴偏移量（左右 / 上下 / 前后），切换肩侧时自动加载对应配置，互不干扰。 快捷键操作 按键 功能 CapsLock 切换左肩 / 右肩视角 ↑ / ↓ 调整上下偏移（长按连续调节） ← / → 调整左右偏移（长按连续调节） Shift + ↑ / Shift + ↓ 调整前后偏移（长按连续调节） 自定义方法 ：在游戏内 设置 → 控制 页面中点击「越肩视角：设置」按钮，可调整所有偏移量、防穿模参数、玩家半透明选项等。偏移量上限为 ±2.5 格。 注意事项 越肩视角下十字准星始终可见，瞄准逻辑与第一人称完全一致。 方向键调整偏移时采用防抖保存机制（停止操作 0.5 秒后自动保存），切换肩侧时立即保存。 在极窄空间内，防穿模系统会将相机压缩至最小距离（默认 0.5 格），此时视野可能受限，属于正常行为。 2.2 真实第一人称视角（Realistic First Person Perspective） 真实第一人称视角在原版第一人称的基础上， 显示完整的玩家角色模型 。摄像头沿视线方向略微前移，避免低头时被自身模型遮挡视线，带来更具沉浸感的游戏体验。 核心亮点 完整角色模型可见 ：与原版第一人称隐藏身体不同，本视角始终渲染完整的角色模型，让你在行走、奔跑、游泳时都能看到自己的动作。 零学习成本 ：控制方式与原版第一人称完全相同，无需适应任何操作变化，即切即用。 智能摄像头前移 ：摄像头沿视线方向前移 0.12 格、上移 0.36 格，在低头操作时避免模型遮挡视线，同时保持第一人称的沉浸感。 快捷键操作 本视角无需额外快捷键，所有操作与原版第一人称完全一致。通过游戏内相机切换键切换至「真实第一人称」即可。 自定义方法 ：本视角参数为固定值，无需额外配置。 注意事项 本视角下十字准星始终可见，瞄准逻辑与原版第一人称完全一致。 原版第一人称的手持物品渲染（ComponentFirstPersonModel）在本视角下被禁用，改为显示完整角色模型手持物品的效果。 摄像头前移量较小，在极端视角（如紧贴墙壁低头）下仍可能出现模型轻微遮挡，可切换至原版第一人称规避。 2.3 正交视角（Orthographic Perspective） 正交视角采用 正交投影 替代透视投影，消除近大远小的视觉效果，呈现等轴测风格的俯瞰画面。配合专属的 RTS 交互系统、方块剔除算法和弹道计算，打造独特的策略游戏体验。 核心亮点 RTS 风格交互系统 ：鼠标光标直接指向世界中的方块和生物，所见即所得。左键攻击高亮目标，右键放置 / 交互 / 投掷。支持「相机相对移动」模式，WASD 方向随相机角度旋转，玩家自动朝行走方向转向。 智能方块剔除 ：参考 Minecraft Dungeons Perspective 的 GenericCuller3 算法，自动剔除遮挡视野的头顶方块。圆柱 + 圆锥双重检测，相机附近方块强制剔除，确保俯视时视野清晰。剔除参数（范围、距离、角度）均可自定义。 弹道瞄准系统 ：正交视角下投掷物品时，根据目标位置、投掷速度和重力自动计算弹道仰角，实现「光标指哪打哪」。瞄准时显示抛物线轨迹预览，精确规划投掷路径。 取景框高亮 ：方块高亮采用四角 L 形取景框样式，生物高亮采用红色包围盒，视觉反馈清晰直观。粘性高亮机制确保鼠标快速移动时不会丢失目标。 自由视角旋转 ：支持鼠标中键拖拽实时旋转视角，方向键左右 90° 旋转， CapsLock 一键吸附等轴测 45° 角度，方向键上下缩放可视范围。 快捷键操作 按键 功能 鼠标中键拖拽 自由旋转视角（俯角限制 10° 80°） ← / → 逆时针 / 顺时针旋转 90°（平滑过渡） ↑ / ↓ 缩小 / 放大可视范围（长按连续调节） CapsLock 吸附至等轴测 45° 标准角度 鼠标左键 攻击高亮目标 鼠标右键 放置 / 交互 / 投掷 自定义方法 ：在游戏内 设置 → 控制 页面中点击「正交视角：设置」按钮，可调整可视范围、RTS 风格移动开关、武器无法挖掘开关、方块剔除参数等。 注意事项 正交视角暂时不支持手机端操作 正交模式下十字准星自动隐藏，瞄准图标替换为透明纹理，不干扰 RTS 视角操作。 正交模式下攻击射程扩展至 8 格（原版 5 格），方块操作距离限制为 6 格，以适应俯视角的交互需求。 「武器无法挖掘」选项默认开启，防止正交视角下武器误触挖掘方块，可在设置中关闭。 方块剔除系统在退出正交视角时会自动恢复被剔除的方块，切换过程可能产生短暂的区块重新生成延迟。 雾效距离会根据可视范围（OrthoSize）动态缩放，避免远处物体被过度雾化。 正交模式下鼠标光标不可见，通过鼠标相对移动量追踪虚拟光标位置。若鼠标操作异常，请检查是否有其他程序占用鼠标。 三、视角切换方式 在游戏内通过原版相机切换键（默认 V键 ）循环切换以下视角： 第一人称 → 第三人称 → 越肩视角 → 真实第一人称 → 正交视角 → ... 四、设置系统 模组提供完善的设置界面，所有参数持久化存储于 MultiPerspectiveSettings.xml 文件中。 越肩视角设置项 设置项 默认值 说明 左肩左右偏移 0.4 负值 = 左偏 左肩上下偏移 0 正值 = 上偏 左肩前后偏移 1.8 负值 = 后偏 左肩瞄准回正 开启 瞄准时自动回正视角 右肩左右偏移 0.4 正值 = 右偏 右肩上下偏移 0 正值 = 上偏 右肩前后偏移 1.8 负值 = 后偏 右肩瞄准回正 开启 瞄准时自动回正视角 修正速度 12.0 穿模修正的响应速度 恢复速度 5.0 穿模恢复的过渡速度 碰撞半径 0.1 相机碰撞检测的等效半径 回弹强度 0.1 碰撞时朝中轴线的偏移强度 最小距离 0.5 碰撞时相机距眼睛的最小距离 玩家半透明 开启 相机靠近角色时角色渐变透明 半透明不透明度 0.3 角色最透明时的不透明度 半透明触发距离 1.5 开始渐变透明的距离 正交视角设置项 设置项 默认值 说明 可视范围 16.0 正交投影的可视半高（2 20） RTS风格移动 开启 WASD 方向随相机角度旋转 武器无法挖掘 开启 防止武器误触挖掘方块 剔除范围 6.0 圆柱剔除半径（方块数） 相机前方剔除距离 8.0 相机附近强制剔除的距离 圆锥收缩剔除角度 45.0° 靠近玩家端收窄的圆锥半角 五、技术特性 双层平滑架构 ：越肩视角的偏移量 Lerp（层 1）与碰撞修正 Lerp（层 2）分离，用户调整与穿模修正互不干扰。 多射线加权碰撞检测 ：五条射线（中心 + 四角）根据肩侧方向分配权重，偏移侧权重更高，非偏移侧权重更低，实现肩侧感知的碰撞响应。 线程安全方块剔除 ：剔除系统采用 volatile 标志 + lock 保护位置数据，确保主线程与地形更新线程的安全协作。 双投影矩阵 ：正交视角使用渲染投影矩阵（近裁面 0.1）和剔除投影矩阵（近裁面动态计算），避免玩家附近物体被误剔除。 弹道方程反算 ：正交视角投掷时，根据弹道方程 a·tan²(θ) + b·tan(θ) + c = 0 反算仰角，优先使用低弹道解获得更自然的轨迹。 性能优化 ：正交视角常用设置项使用强类型缓存，避免每帧字典查找；碰撞检测在无碰撞时仅使用中心射线快速路径。 六、结束语 使用建议 ： 首次使用建议先在安全区域熟悉各视角的操作方式，尤其是正交视角的 RTS 交互。 越肩视角的偏移量可通过方向键实时调整，找到最适合自己的视角后设置会自动保存。 正交视角的方块剔除参数需要根据实际场景微调，建筑密集区域可适当增大剔除范围。 感谢使用视角拓展模组，祝你游戏愉快！