模块目录

通过 Rapier 碰撞批量解算多个运动学移动请求，返回是否着地/碰撞结果。

把本地载具控制转成通用运动：六轴平移、四向转向、独立机体偏航、可选侧倾、瞬时或加速响应；覆盖飞行器/水上/太空/陆地载具。

把调用方给的位置和姿态帧应用到物体模型变换，可配 mesh 前向、可选保持 basis-up 对齐。

把飞行运动状态应用到飞机视觉变换（位置、偏航、俯仰、翻滚）。

把飞行员的转向/油门/加速本地控制转成固定翼飞机运动。

共享的着地角色移动基类：位置、速度、偏航/俯仰、冲刺、下蹲、跳跃、重力、resolver 意图生成与提交。

把世界空间「移动/朝向目标点」转成角色移动；推荐配 PositionFollowCameraRig。

把世界空间左右前后移动 + 逆/顺时针旋转输入转成角色移动；推荐配 PositionFollowCameraRig。

把相对朝向的前后移动、左右横移、左右转向输入转成角色移动；推荐配 PoseFollowCameraRig。

把本地前后左右移动 + 鼠标视角偏航/俯仰增量转成角色移动；配 FirstPersonCameraRig（第一人称）或 PoseFollowCameraRig（第三人称追尾）。

给动态车物理加漂移响应：检测打滑并改变车控行为。

用 Rapier 批量解算多个动态车物理，返回同步车态。

把驾驶控制（转向/油门/倒车/刹车/手刹/加速）转成动态车控制意图，供全轮物理仿真。

为 Rapier 车辆控制器构建 basis-aware 的动态车配置数据。

把车运动状态应用到视觉变换（车身姿态 + 车轮动画）。

把驾驶控制转成轻量街机车运动，含基础地形高度/法线跟随。

把方向倾斜控制转成平滑的板面旋转和玩法坡度值。

把贪吃蛇转向/生长输入转成网格方向和身体段状态。

调整平面移动意图，让 actor 避开附近 agent 同时保持原行进方向。

网格棋盘寻路与可达格计算，支持阻挡格、环绕/有界边缘。

把角色位置/当前路点/速度上限转成平面移动意图（方向、期望速度、路点、距离）。

追踪路线进度，达到到达距离后推进路点，报告当前路点、进度、转角轮廓。

把路点/载具姿态/速度/转角轮廓转成 AI 车控（油门、倒车、刹车、左右转、加速）。

维护射击 agent 的战术状态（待机/巡逻/追击/攻击/死亡）。

具体相机的基类：平滑、basis-aware 姿态行为。

以固定世界-basis 偏移和固定视角跟随目标位置并看向目标。

以姿态相对偏移和姿态相对注视点跟随目标位置和 targetFrame，视角随目标转动。

跟随目标眼位与当前前向，产生锁定 actor 的第一人称视角。

目标周围临时自由视角旋转，停止输入后回中。

把屏幕/相机瞄准或显式射线瞄准解算成命中位置、瞄准方向、匹配目标、发射到命中方向。

管理团队战斗玩家状态、血/护甲变化、死亡事件、胜者判定、重置。

管理飞行玩家状态、地形坠毁检查、触地事件、完成状态、重置。

管理检查点圈速赛状态、倒计时起跑、玩家进度、完成圈、名次、赛事事件、重置。

管理贪吃蛇玩家/道具状态、撞墙、撞自己、撞其他蛇、道具拾取、死亡事件、重置。

调度并生成敌人波次，升级生成压力，清完当前波推进下一波。

管理枪/导弹武器选择、弹药、冷却、枪管过热、导弹锁定、开火决策（发射位置/方向/速度）。

管理活跃弹丸对象，移除失活弹丸，返回命中事件。

确定性伪随机数生成器（uniform、整数区间、步进区间、choice）。

稳定数值运动与归一化的标量操作。

系统时钟与手动可控时钟助手（一致的毫秒/秒时间戳）。

把向量输入归一化成安全的 three 向量和 basis-aware 平面方向。

核心：定义玩法方向如何映射到世界轴，维持 basis-aware 的移动、高度、罗盘、帧数学一致性。

把共享 UI 状态渲染成 DOM HUD 元素。

世界位置/朝向映射到小地图坐标。

随时间维护可见与待显通知状态。

在相对朝向的雷达空间渲染附近目标。

通过 localStorage 安全持久化用户设置。

可观察的 UI 状态更新，带稳定快照。

把飞行/武器/导航/计分/警告状态渲染成座舱式 HUD。

把比赛进度和对手渲染成赛道感知小地图。

移除并释放 three 对象层级（geometry/material 资源）。

竞技场场景（障碍 + 墙），支持出生点采样与障碍查询，创建显式 Rapier 碰撞体。

自然场景（地形 + 树/石/草），支持地形高度查询，创建显式地形/树/石 Rapier 碰撞体。

赛道场景（道路地形 + 检查点标记 + 护栏），支持出生姿态采样，创建显式地形/护栏 Rapier 碰撞体。

棋盘场景（格子 + 灯光），提供格/世界坐标助手，暴露网格边界。

从地形采样器输出构建顶点着色地形网格与对应 Rapier trimesh 碰撞体。

地形采样器类，暴露 heightAt/normalAt/colorAt/sample；含草原、群岛、道路（道路压平）地形。

在 basis-aware 平面世界区域四周构建物理边界墙碰撞体。

在可选允许区域内采样平面出生点、排除阻挡区，支持矩形/圆/多边形/走廊形状契约。

共享的 basis-aware 平面几何与地形助手。

更新拾取物世界态：视觉动画、拾取判定盒、拾取检查。

更新弹丸世界态：线性或追踪运动、命中检查、视觉更新、过期。

从玩家移动、姿态、瞄准、后坐更新第一人称武器表现。

更新实体上方的世界空间浮动血条表现。

为飞行 actor 构建飞机视觉模型。

为自然环境构建植物视觉模型与材质（树干、针叶/阔叶冠、枝桩、草叶）。

为自然环境构建岩石视觉模型与材质（地面岩石、随机形变不规则岩石网格）。

为弹药/血/甲拾取物构建视觉模型。

为子弹/导弹构建弹丸视觉模型与更新助手。

为竞速和原型载具构建轻量车视觉模型。

从飞机油门与加速状态渲染喷气尾焰强度。

为点击/目标反馈渲染渐隐地面标记。

从着地载具运动渲染贴地轮胎痕。

为武器开火与命中渲染短时视觉反馈。