three-player-controller 0.3.7 → 0.3.8

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // src/playerController.ts
-import * as THREE3 from "three";
+import * as THREE4 from "three";
 import { acceleratedRaycast, MeshBVH, MeshBVHHelper } from "three-mesh-bvh";
 import { RoundedBoxGeometry } from "three/examples/jsm/geometries/RoundedBoxGeometry.js";
 import { DRACOLoader } from "three/examples/jsm/loaders/DRACOLoader.js";
@@ -21,6 +21,231 @@ var vehicle_default = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAMgAAADICAY
 // assets/imgs/view.png
 var view_default = "data:image/png;base64,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";
 
+// src/utils/mobileControls.ts
+var MobileControls = class {
+  constructor(setInput, controls) {
+    // 摇杆状态
+    this.nippleModule = null;
+    this.joystickManager = null;
+    this.prevJoyState = { dirX: 0, dirY: 0, shift: false };
+    // DOM 元素
+    this.joystickZoneEl = null;
+    this.lookAreaEl = null;
+    this.jumpBtnEl = null;
+    this.flyBtnEl = null;
+    this.viewBtnEl = null;
+    this.vehicleBtnEl = null;
+    // 触摸状态
+    this.lookPointerId = null;
+    this.isLookDown = false;
+    this.lastTouchX = 0;
+    this.lastTouchY = 0;
+    // 触摸按下
+    this.onPointerDown = (e) => {
+      if (e.pointerType !== "touch") return;
+      this.isLookDown = true;
+      this.lookPointerId = e.pointerId;
+      this.lastTouchX = e.clientX;
+      this.lastTouchY = e.clientY;
+      this.lookAreaEl?.setPointerCapture?.(e.pointerId);
+      e.preventDefault();
+    };
+    // 触摸移动
+    this.onPointerMove = (e) => {
+      if (!this.isLookDown || e.pointerId !== this.lookPointerId) return;
+      const dx = e.clientX - this.lastTouchX;
+      const dy = e.clientY - this.lastTouchY;
+      this.lastTouchX = e.clientX;
+      this.lastTouchY = e.clientY;
+      this.setInput({ lookDeltaX: dx, lookDeltaY: dy });
+      e.preventDefault();
+    };
+    // 触摸抬起
+    this.onPointerUp = (e) => {
+      if (e.pointerId !== this.lookPointerId) return;
+      this.isLookDown = false;
+      this.lookPointerId = null;
+      this.lookAreaEl?.releasePointerCapture?.(e.pointerId);
+    };
+    this.setInput = setInput;
+    this.controls = controls;
+  }
+  // 初始化移动端控制
+  async init() {
+    this.controls.maxPolarAngle = Math.PI * (300 / 360);
+    this.controls.touches = { ONE: null, TWO: null };
+    this.nippleModule = await import("nipplejs");
+    const nipple = this.nippleModule?.default;
+    const JOY_SIZE = 120;
+    const container = document.body;
+    this.joystickZoneEl = document.createElement("div");
+    this.joystickZoneEl.id = "joy-zone";
+    Object.assign(this.joystickZoneEl.style, {
+      position: "absolute",
+      left: "16px",
+      bottom: "16px",
+      width: `${JOY_SIZE + 40}px`,
+      height: `${JOY_SIZE + 40}px`,
+      touchAction: "none",
+      zIndex: "999",
+      pointerEvents: "auto",
+      WebkitUserSelect: "none",
+      userSelect: "none"
+    });
+    container.appendChild(this.joystickZoneEl);
+    this.blockTouch(this.joystickZoneEl);
+    this.joystickManager = nipple.create({
+      zone: this.joystickZoneEl,
+      mode: "static",
+      position: { left: `${(JOY_SIZE + 40) / 2}px`, bottom: `${(JOY_SIZE + 40) / 2}px` },
+      color: "#ffffff",
+      size: JOY_SIZE,
+      multitouch: true,
+      maxNumberOfNipples: 1
+    });
+    this.joystickManager.on("move", (_evt, data) => {
+      if (!data) return;
+      const rawX = data.vector?.x ?? 0;
+      const rawY = data.vector?.y ?? 0;
+      const distance = data.distance ?? 0;
+      const deadzone = 0.5;
+      const dirX = rawX > deadzone ? 1 : rawX < -deadzone ? -1 : 0;
+      const dirY = rawY > deadzone ? 1 : rawY < -deadzone ? -1 : 0;
+      const isSprinting = distance >= JOY_SIZE / 2;
+      const prev = this.prevJoyState;
+      if (dirX === prev.dirX && dirY === prev.dirY && isSprinting === prev.shift) return;
+      this.prevJoyState = { dirX, dirY, shift: isSprinting };
+      this.setInput({ moveX: dirX, moveY: dirY, shift: isSprinting });
+    });
+    this.joystickManager.on("end", () => {
+      const prev = this.prevJoyState;
+      if (prev.dirX !== 0 || prev.dirY !== 0 || prev.shift) {
+        this.prevJoyState = { dirX: 0, dirY: 0, shift: false };
+        this.setInput({ moveX: 0, moveY: 0, shift: false });
+      }
+    });
+    this.lookAreaEl = document.createElement("div");
+    Object.assign(this.lookAreaEl.style, {
+      position: "absolute",
+      right: "0",
+      bottom: "0",
+      width: "50%",
+      height: "100%",
+      zIndex: "998",
+      touchAction: "none",
+      WebkitUserSelect: "none",
+      userSelect: "none"
+    });
+    container.appendChild(this.lookAreaEl);
+    this.blockTouch(this.lookAreaEl);
+    this.lookAreaEl.addEventListener("pointerdown", this.onPointerDown, { passive: false });
+    this.lookAreaEl.addEventListener("pointermove", this.onPointerMove, { passive: false });
+    this.lookAreaEl.addEventListener("pointerup", this.onPointerUp, { passive: false });
+    this.lookAreaEl.addEventListener("pointercancel", this.onPointerUp, { passive: false });
+    this.jumpBtnEl = this.createBtn(container, 14, 14, jump_default);
+    this.flyBtnEl = this.createBtn(container, 14, 14 + 80, fly_default);
+    this.viewBtnEl = this.createBtn(container, 14, 14 + 200, view_default);
+    this.vehicleBtnEl = this.createBtn(container, 14 + 100, 14 + 120, vehicle_default);
+    this.vehicleBtnEl.style.display = "none";
+    this.jumpBtnEl.addEventListener("touchstart", (e) => {
+      e.preventDefault();
+      this.setInput({ jump: true });
+    }, { passive: false });
+    this.jumpBtnEl.addEventListener("touchend", (e) => {
+      e.preventDefault();
+      this.setInput({ jump: false });
+    }, { passive: false });
+    this.jumpBtnEl.addEventListener("touchcancel", (e) => {
+      e.preventDefault();
+      this.setInput({ jump: false });
+    }, { passive: false });
+    this.flyBtnEl.addEventListener("touchstart", (e) => {
+      e.preventDefault();
+      this.setInput({ toggleFly: true });
+    }, { passive: false });
+    this.viewBtnEl.addEventListener("touchstart", (e) => {
+      e.preventDefault();
+      this.setInput({ toggleView: true });
+    }, { passive: false });
+    this.vehicleBtnEl.addEventListener("touchstart", (e) => {
+      e.preventDefault();
+      this.setInput({ toggleVehicle: true });
+    }, { passive: false });
+  }
+  // 销毁移动端控制
+  destroy() {
+    try {
+      this.joystickManager?.destroy?.();
+      this.joystickManager = null;
+      if (this.lookAreaEl) {
+        this.lookAreaEl.removeEventListener("pointerdown", this.onPointerDown);
+        this.lookAreaEl.removeEventListener("pointermove", this.onPointerMove);
+        this.lookAreaEl.removeEventListener("pointerup", this.onPointerUp);
+        this.lookAreaEl.removeEventListener("pointercancel", this.onPointerUp);
+      }
+      [this.joystickZoneEl, this.lookAreaEl, this.jumpBtnEl, this.flyBtnEl, this.viewBtnEl, this.vehicleBtnEl].forEach((el) => el?.parentElement?.removeChild(el));
+      this.joystickZoneEl = this.lookAreaEl = this.jumpBtnEl = this.flyBtnEl = this.viewBtnEl = this.vehicleBtnEl = null;
+    } catch (e) {
+      console.warn("\u9500\u6BC1\u79FB\u52A8\u7AEF\u63A7\u5236\u65F6\u51FA\u9519\uFF1A", e);
+    }
+  }
+  // 同步车辆按钮显隐
+  syncVehicleBtn(show) {
+    if (this.vehicleBtnEl) this.vehicleBtnEl.style.display = show ? "block" : "none";
+  }
+  // 同步控制模式按钮
+  syncControllerModeBtn(mode) {
+    if (!this.flyBtnEl || !this.jumpBtnEl) return;
+    if (mode === 0) {
+      this.flyBtnEl.style.display = "block";
+      this.jumpBtnEl.style.backgroundImage = `linear-gradient(rgba(0,0,0,0.5),rgba(0,0,0,0.5)),url("${jump_default}")`;
+    } else {
+      this.flyBtnEl.style.display = "none";
+      this.jumpBtnEl.style.backgroundImage = `url(${break_default})`;
+    }
+  }
+  // 阻止默认触摸
+  blockTouch(el) {
+    ["touchstart", "touchmove", "touchend", "touchcancel"].forEach((name) => {
+      el.addEventListener(name, (e) => e.preventDefault(), { passive: false });
+    });
+  }
+  // 创建圆形按钮
+  createBtn(container, rightPx, bottomPx, bgUrl) {
+    const btn = document.createElement("button");
+    Object.assign(btn.style, {
+      position: "absolute",
+      right: `${rightPx}px`,
+      bottom: `${bottomPx}px`,
+      width: "56px",
+      height: "56px",
+      zIndex: "1000",
+      borderRadius: "50%",
+      border: "2px solid black",
+      padding: "20px",
+      opacity: "0.95",
+      touchAction: "none",
+      fontSize: "14px",
+      userSelect: "none",
+      overflow: "hidden",
+      boxSizing: "border-box",
+      backgroundColor: "transparent",
+      backgroundRepeat: "no-repeat, no-repeat",
+      backgroundPosition: "center center, center center",
+      backgroundSize: "100% 100%, 80% 80%",
+      backgroundImage: `linear-gradient(rgba(0,0,0,0.5),rgba(0,0,0,0.5)),url("${bgUrl}")`
+    });
+    container.appendChild(btn);
+    ["touchstart", "touchend", "touchcancel"].forEach((name) => {
+      btn.addEventListener(name, (e) => e.preventDefault(), { passive: false });
+    });
+    return btn;
+  }
+};
+
+// src/utils/vehicleLoader.ts
+import * as THREE3 from "three";
+
 // src/utils/pathPlanner.ts
 import * as THREE from "three";
 var PathNode = class {
@@ -34,6 +259,7 @@ var PathNode = class {
     this.parent = null;
     this.position = position.clone();
   }
+  // 判断节点相等
   equals(other) {
     return this.position.distanceTo(other.position) < 0.01;
   }
@@ -42,10 +268,12 @@ var PriorityQueue = class {
   constructor() {
     this.elements = [];
   }
+  // 入队并排序
   enqueue(item, priority) {
     this.elements.push({ priority, item });
     this.elements.sort((a, b) => a.priority - b.priority);
   }
+  // 出队最小优先级
   dequeue() {
     return this.elements.shift()?.item;
   }
@@ -55,6 +283,7 @@ var PriorityQueue = class {
   contains(item, compareFn) {
     return this.elements.some((e) => compareFn(e.item, item));
   }
+  // 更新节点优先级
   update(item, newPriority, compareFn) {
     const index = this.elements.findIndex((e) => compareFn(e.item, item));
     if (index !== -1) {
@@ -68,22 +297,15 @@ var PathPlanner = class {
     this.debugLines = [];
     this.debugPoints = [];
     this.obstacleChecker = obstacleChecker;
-    this.config = {
-      debugEnabled: false,
-      scale: 1,
-      ...config
-    };
+    this.config = { debugEnabled: false, scale: 1, ...config };
   }
-  // 计算启发式距离
+  // 启发式距离
   heuristic(a, b) {
     return a.distanceTo(b);
   }
-  // A*路径规划算法
+  // A* 寻路主入口
   findPath(start, goal) {
-    const startTime = performance.now();
-    if (!this.obstacleChecker.isBlocked(start, goal)) {
-      return [goal];
-    }
+    if (!this.obstacleChecker.isBlocked(start, goal)) return [goal];
     const navigationPoints = this.obstacleChecker.getNavigationNodes(start, goal);
     const allNodes = [new PathNode(start), new PathNode(goal), ...navigationPoints.map((p) => new PathNode(p))];
     if (allNodes.length < 2) {
@@ -97,45 +319,35 @@ var PathPlanner = class {
     startNode.f = startNode.h;
     const openList = new PriorityQueue();
     const closedSet = /* @__PURE__ */ new Set();
-    openList.enqueue(startNode, startNode.f);
     const nodeEquals = (a, b) => a.equals(b);
+    openList.enqueue(startNode, startNode.f);
     while (!openList.isEmpty()) {
       const current = openList.dequeue();
       if (!current) break;
       if (current.equals(goalNode)) {
         const path = this.reconstructPath(current);
-        const endTime = performance.now();
-        if (this.config.debugEnabled) {
-          this.visualizePath([start, ...path]);
-        }
+        if (this.config.debugEnabled) this.visualizePath([start, ...path]);
         return path;
       }
       closedSet.add(current);
       for (const neighbor of allNodes) {
         if (closedSet.has(neighbor)) continue;
-        if (this.obstacleChecker.isBlocked(current.position, neighbor.position)) {
-          continue;
-        }
+        if (this.obstacleChecker.isBlocked(current.position, neighbor.position)) continue;
         const tentativeG = current.g + current.position.distanceTo(neighbor.position);
         if (tentativeG < neighbor.g) {
           neighbor.parent = current;
           neighbor.g = tentativeG;
           neighbor.h = this.heuristic(neighbor.position, goalNode.position);
           neighbor.f = neighbor.g + neighbor.h;
-          if (openList.contains(neighbor, nodeEquals)) {
-            openList.update(neighbor, neighbor.f, nodeEquals);
-          } else {
-            openList.enqueue(neighbor, neighbor.f);
-          }
+          if (openList.contains(neighbor, nodeEquals)) openList.update(neighbor, neighbor.f, nodeEquals);
+          else openList.enqueue(neighbor, neighbor.f);
         }
       }
     }
-    console.warn("A*\u672A\u627E\u5230\u8DEF\u5F84\uFF0C\u4F7F\u7528\u76F4\u7EBF\u8DEF\u5F84");
+    console.warn("A* \u672A\u627E\u5230\u8DEF\u5F84\uFF0C\u4F7F\u7528\u76F4\u7EBF\u8DEF\u5F84");
     return [goal];
   }
-  /**
-   * 重建路径
-   */
+  // 重建路径
   reconstructPath(endNode) {
     const path = [];
     let current = endNode;
@@ -143,14 +355,10 @@ var PathPlanner = class {
       path.unshift(current.position.clone());
       current = current.parent;
     }
-    if (path.length > 0) {
-      path.shift();
-    }
+    if (path.length > 0) path.shift();
     return this.smoothPath(path);
   }
-  /**
-   * 路径平滑
-   */
+  // 路径平滑优化
   smoothPath(path) {
     if (path.length <= 2) return path;
     const smoothed = [path[0]];
@@ -168,38 +376,28 @@ var PathPlanner = class {
     }
     return smoothed;
   }
-  /**
-   * 可视化路径
-   */
+  // 可视化路径
   visualizePath(path) {
     if (!this.config.scene || !this.config.debugEnabled) return;
     this.clearVisualization();
     const scale = this.config.scale || 1;
     if (path.length > 1) {
-      const points = path.map((p) => p.clone());
-      const geometry = new THREE.BufferGeometry().setFromPoints(points);
-      const material = new THREE.LineBasicMaterial({
-        color: 65280,
-        linewidth: 3
-      });
-      const line = new THREE.Line(geometry, material);
+      const geometry = new THREE.BufferGeometry().setFromPoints(path.map((p) => p.clone()));
+      const line = new THREE.Line(geometry, new THREE.LineBasicMaterial({ color: 65280, linewidth: 3 }));
       this.config.scene.add(line);
       this.debugLines.push(line);
     }
     path.forEach((point, index) => {
-      const geometry = new THREE.SphereGeometry(20 * scale);
-      const material = new THREE.MeshBasicMaterial({
-        color: index === path.length - 1 ? 16711680 : 65280
-      });
-      const sphere = new THREE.Mesh(geometry, material);
+      const sphere = new THREE.Mesh(
+        new THREE.SphereGeometry(20 * scale),
+        new THREE.MeshBasicMaterial({ color: index === path.length - 1 ? 16711680 : 65280 })
+      );
       sphere.position.copy(point);
       this.config.scene.add(sphere);
       this.debugPoints.push(sphere);
     });
   }
-  /**
-   * 清除路径可视化
-   */
+  // 清除路径可视化
   clearVisualization() {
     if (!this.config.scene) return;
     this.debugLines.forEach((line) => {
@@ -215,15 +413,11 @@ var PathPlanner = class {
     });
     this.debugPoints = [];
   }
-  /**
-   * 更新配置
-   */
+  // 更新配置
   updateConfig(config) {
     this.config = { ...this.config, ...config };
   }
-  /**
-   * 销毁
-   */
+  // 销毁规划器
   dispose() {
     this.clearVisualization();
   }
@@ -243,7 +437,7 @@ function createVehicleController(world, chassisBody, wheels, wheelsInfo) {
     vehicle.setWheelAxleCs(index, wheel.axleCs);
     vehicle.setWheelSuspensionRestLength(index, wheel.suspensionRestLength);
     vehicle.setWheelRadius(index, wheel.radius);
-    vehicle.setWheelMaxSuspensionTravel(index, wheel.suspensionRestLength * 1);
+    vehicle.setWheelMaxSuspensionTravel(index, wheel.suspensionRestLength);
     vehicle.setWheelSuspensionStiffness(index, 250);
     vehicle.setWheelSuspensionCompression(index, 6);
     vehicle.setWheelSuspensionRelaxation(index, 6);
@@ -255,8 +449,8 @@ function createVehicleController(world, chassisBody, wheels, wheelsInfo) {
     vehicle.setWheelSideFrictionStiffness(index, 2);
   });
   const up = new THREE2.Vector3(0, 1, 0);
-  const _wheelSteeringQuat = new THREE2.Quaternion();
-  const _wheelRotationQuat = new THREE2.Quaternion();
+  const wheelSteeringQuat = new THREE2.Quaternion();
+  const wheelRotationQuat = new THREE2.Quaternion();
   function updateWheelVisuals() {
     for (const [index, wheelObj] of wheels.entries()) {
       if (!wheelObj) continue;
@@ -267,9 +461,9 @@ function createVehicleController(world, chassisBody, wheels, wheelsInfo) {
         const steering = vehicle.wheelSteering(index) ?? 0;
         const rotationRad = vehicle.wheelRotation(index) ?? 0;
         wheelObj.position.y = connection - suspension;
-        _wheelSteeringQuat.setFromAxisAngle(up, steering);
-        _wheelRotationQuat.setFromAxisAngle(wheelAxleCs, rotationRad);
-        wheelObj.quaternion.copy(_wheelSteeringQuat).multiply(_wheelRotationQuat);
+        wheelSteeringQuat.setFromAxisAngle(up, steering);
+        wheelRotationQuat.setFromAxisAngle(wheelAxleCs, rotationRad);
+        wheelObj.quaternion.copy(wheelSteeringQuat).multiply(wheelRotationQuat);
       } catch (e) {
       }
     }
@@ -280,37 +474,247 @@ function createVehicleController(world, chassisBody, wheels, wheelsInfo) {
     } catch {
     }
   }
+  return { vehicle, updateWheelVisuals, destroy };
+}
+
+// src/utils/vehicleLoader.ts
+function getBbox(object) {
+  const bbox = new THREE3.Box3().setFromObject(object);
+  const center = new THREE3.Vector3();
+  const size = new THREE3.Vector3();
+  bbox.getCenter(center);
+  bbox.getSize(size);
+  return { bbox, center, size };
+}
+function createObstacleChecker(vehicleGroup, bbox, scale, playerScale) {
+  return {
+    // 射线检测路径是否被车辆遮挡
+    isBlocked(start, end) {
+      const vehiclePos = vehicleGroup.position;
+      const vehicleQuat = vehicleGroup.quaternion;
+      const center = new THREE3.Vector3();
+      const size = new THREE3.Vector3();
+      bbox.getCenter(center);
+      bbox.getSize(size);
+      center.applyQuaternion(vehicleQuat).add(vehiclePos);
+      const halfSize = size.clone().multiplyScalar(0.5 * scale);
+      const corners = [];
+      for (let x = -1; x <= 1; x += 2)
+        for (let y = -1; y <= 1; y += 2)
+          for (let z = -1; z <= 1; z += 2)
+            corners.push(
+              new THREE3.Vector3(halfSize.x * x, halfSize.y * y, halfSize.z * z).applyQuaternion(vehicleQuat).add(center)
+            );
+      const expandedBBox = new THREE3.Box3();
+      corners.forEach((c) => expandedBBox.expandByPoint(c));
+      expandedBBox.expandByScalar(100 * playerScale);
+      const direction = new THREE3.Vector3().subVectors(end, start);
+      const length = direction.length();
+      const ray = new THREE3.Ray(start, direction.normalize());
+      const intersects = ray.intersectBox(expandedBBox, new THREE3.Vector3());
+      return intersects !== null && start.distanceTo(intersects) < length;
+    },
+    // 生成绕行导航节点
+    getNavigationNodes(start, _goal) {
+      const nodes = [];
+      const vehiclePos = vehicleGroup.position;
+      const vehicleQuat = vehicleGroup.quaternion;
+      const bboxSize = new THREE3.Vector3();
+      bbox.getSize(bboxSize);
+      const fwd = new THREE3.Vector3(0, 0, 1).applyQuaternion(vehicleQuat);
+      const right = new THREE3.Vector3(1, 0, 0).applyQuaternion(vehicleQuat);
+      const halfLen = bboxSize.z / 2 * scale;
+      const halfWidth = bboxSize.x / 2 * scale;
+      const groundY = start.y;
+      for (const margin of [300 * playerScale, 500 * playerScale]) {
+        nodes.push(vehiclePos.clone().add(fwd.clone().multiplyScalar(halfLen + margin)).add(right.clone().multiplyScalar(-halfWidth - margin)).setY(groundY));
+        nodes.push(vehiclePos.clone().add(fwd.clone().multiplyScalar(halfLen + margin)).add(right.clone().multiplyScalar(halfWidth + margin)).setY(groundY));
+        nodes.push(vehiclePos.clone().add(fwd.clone().multiplyScalar(-halfLen - margin)).add(right.clone().multiplyScalar(-halfWidth - margin)).setY(groundY));
+        nodes.push(vehiclePos.clone().add(fwd.clone().multiplyScalar(-halfLen - margin)).add(right.clone().multiplyScalar(halfWidth + margin)).setY(groundY));
+      }
+      return nodes;
+    }
+  };
+}
+async function loadVehicleModel(opts, ctx) {
+  const { loader, scene, world, RAPIER, vehicleParams, vehicleLength, playerScale } = ctx;
+  const scale = opts.scale ?? 1;
+  const chassisRatio = opts.chassisRatio ?? 0.2;
+  const suspensionRestLengthRatio = opts.suspensionRestLengthRatio ?? 0.2;
+  const speedMultiplier = opts.speedMultiplier ?? 1;
+  vehicleParams.power.accelerateForce = 50 * scale;
+  vehicleParams.power.brakeForce = 200 * scale;
+  vehicleParams.power.maxSpeed = 1e4 * scale;
+  vehicleParams.followVehicleDirection = opts.followVehicleDirection ?? true;
+  const vehicleModel = await loader.loadAsync(opts.url);
+  const { size: originalSize } = getBbox(vehicleModel.scene);
+  const modelScale = vehicleLength / Math.max(originalSize.x, originalSize.y, originalSize.z);
+  const vehicleMixer = new THREE3.AnimationMixer(vehicleModel.scene);
+  const vehicleActions = /* @__PURE__ */ new Map();
+  const animations = vehicleModel.animations ?? [];
+  const openDoorClip = animations.find((a) => a.name === (opts.animations?.openDoorAnim ?? ""));
+  if (openDoorClip) {
+    const action = vehicleMixer.clipAction(openDoorClip);
+    action.setLoop(THREE3.LoopOnce, 1);
+    action.clampWhenFinished = true;
+    action.setEffectiveTimeScale(openDoorClip.duration);
+    action.enabled = true;
+    action.setEffectiveWeight(0);
+    vehicleActions.set("openDoor", action);
+  }
+  const wheelObjects = [];
+  for (const name of opts.wheelsNames) {
+    let found = false;
+    vehicleModel.scene.traverse((child) => {
+      if (child.name === name && !found) {
+        wheelObjects.push(child);
+        found = true;
+      }
+    });
+    if (!found) console.warn(`\u672A\u627E\u5230\u8F6E\u5B50: ${name}`);
+  }
+  const tempGroup = new THREE3.Group();
+  scene.add(tempGroup);
+  vehicleModel.scene.scale.multiplyScalar(modelScale * scale);
+  vehicleModel.scene.rotateY(vehicleParams.model.rotation);
+  const { size, bbox, center } = getBbox(vehicleModel.scene);
+  vehicleModel.scene.position.set(-center.x, -center.y, -center.z);
+  tempGroup.add(vehicleModel.scene);
+  tempGroup.updateMatrixWorld(true);
+  let wheelRadius = 0, wheelWidth = 0, suspensionRestLength = 0, chassisHeight = 0, wheelSizeInit = false;
+  const wheelsInfo = [];
+  for (const wheel of wheelObjects) {
+    const worldPos = new THREE3.Vector3();
+    const worldQuat = new THREE3.Quaternion();
+    const worldScale = new THREE3.Vector3();
+    wheel.getWorldPosition(worldPos);
+    wheel.getWorldQuaternion(worldQuat);
+    wheel.getWorldScale(worldScale);
+    if (!wheelSizeInit) {
+      const { size: ws } = getBbox(wheel);
+      wheelRadius = Number((Math.max(ws.x, ws.y, ws.z) / 2).toFixed(2));
+      wheelWidth = Number(Math.min(ws.x, ws.y, ws.z).toFixed(2));
+      suspensionRestLength = Number((wheelRadius * 2 * suspensionRestLengthRatio).toFixed(2));
+      chassisHeight = Number((wheelRadius * 2 * chassisRatio).toFixed(2));
+      wheelSizeInit = true;
+    }
+    wheelsInfo.push({ axleCs: new THREE3.Vector3(0, 0, -1), position: worldPos, quaternion: worldQuat, scale: worldScale, radius: wheelRadius, width: wheelWidth, suspensionRestLength, object: wheel });
+  }
+  tempGroup.remove(vehicleModel.scene);
+  scene.remove(tempGroup);
+  const vehicleGroup = new THREE3.Group();
+  scene.add(vehicleGroup);
+  vehicleGroup.add(vehicleModel.scene);
+  vehicleGroup.updateMatrixWorld(true);
+  const wheelWrappers = [];
+  for (let i = 0; i < wheelsInfo.length; i++) {
+    const wheel = wheelsInfo[i];
+    const wheelWrapper = new THREE3.Group();
+    wheelWrapper.position.copy(vehicleGroup.worldToLocal(wheel.position.clone()));
+    const wheelObj = wheel.object;
+    wheelObj.parent?.remove(wheelObj);
+    wheelObj.position.set(0, 0, 0);
+    wheelObj.quaternion.copy(wheel.quaternion);
+    wheelObj.scale.copy(wheel.scale);
+    wheelObj.updateMatrixWorld();
+    wheelWrapper.add(wheelObj);
+    vehicleGroup.add(wheelWrapper);
+    wheelWrappers.push(wheelWrapper);
+  }
+  const halfExtents = size.clone().multiplyScalar(0.5);
+  halfExtents.y -= chassisHeight / 2;
+  vehicleModel.scene.position.y -= chassisHeight / 2;
+  halfExtents.x *= 0.95;
+  halfExtents.z *= 0.95;
+  const chassisBody = world.createRigidBody(
+    RAPIER.RigidBodyDesc.dynamic().setTranslation(opts.position.x, opts.position.y, opts.position.z).setLinearDamping(vehicleParams.chassis.linearDamping).setAngularDamping(vehicleParams.chassis.angularDamping).setCanSleep(true).setAdditionalMass(10)
+  );
+  world.createCollider(RAPIER.ColliderDesc.cuboid(halfExtents.x, halfExtents.y, halfExtents.z), chassisBody);
+  if (vehicleParams.debug.showPhysicsBox) {
+    vehicleGroup.add(new THREE3.Mesh(
+      new THREE3.BoxGeometry(halfExtents.x * 2, halfExtents.y * 2, halfExtents.z * 2),
+      new THREE3.MeshBasicMaterial({ color: 16711680, wireframe: true, transparent: true, opacity: 0.3 })
+    ));
+  }
+  vehicleGroup.position.copy(opts.position);
+  vehicleGroup.updateMatrixWorld(true);
+  const { vehicle, updateWheelVisuals } = createVehicleController(world, chassisBody, wheelWrappers, wheelsInfo);
   return {
-    vehicle,
+    vehicleGroup,
+    chassisBody,
+    vehicleController: vehicle,
     updateWheelVisuals,
-    destroy
+    vehicleMixer,
+    vehicleActions,
+    vehiclIsOpenDoor: false,
+    vehicleBBox: bbox.clone(),
+    pathPlanner: new PathPlanner(
+      createObstacleChecker(vehicleGroup, bbox, scale, playerScale),
+      { debugEnabled: false, scene, scale: playerScale }
+    ),
+    scale,
+    boardingPoint: opts.boardingPoint,
+    seatOffset: opts.seatOffset ?? new THREE3.Vector3(),
+    enterVehicleTime: 1.5,
+    chassisRatio,
+    suspensionRestLengthRatio,
+    size: { l: Math.max(size.x, size.z), w: Math.min(size.x, size.z), h: size.y },
+    speedMultiplier
   };
 }
 
 // src/playerController.ts
-THREE3.Mesh.prototype.raycast = acceleratedRaycast;
+THREE4.Mesh.prototype.raycast = acceleratedRaycast;
 var controllerInstance = null;
-var clock = new THREE3.Clock();
+var clock = new THREE4.Clock();
+function isMobileDevice() {
+  return /Android|iPhone|iPad|iPod|Mobile/i.test(navigator.userAgent);
+}
 var PlayerController = class {
   constructor() {
-    // ==================== 基本配置与参数 ====================
+    // ==================== 场景引用 ====================
     this.loader = new GLTFLoader();
-    this.controllerMode = 0;
-    // 0: 人物 1: 车辆
+    // 物理参数
+    this.gravity = -2400;
+    this.jumpHeight = 600;
+    this.playerSpeed = 300;
+    this.playerFlySpeed = 2100;
+    this.curPlayerSpeed = 0;
+    // 交互参数
+    this.mouseSensitivity = 5;
+    this.thirdMouseMode = 1;
+    this.enableZoom = false;
+    this.playerFlyEnabled = true;
+    this.isShowMobileControls = true;
     this.enableOverShoulderView = false;
-    this.isChangeControllerTransitionTimer = null;
-    // ==================== 玩家基本属性 ====================
+    // ==================== 玩家胶囊体 ====================
     this.playerCapsuleRadius = 45;
-    this.playerCapsuleRadiusRatio = 1;
     this.playerCapsuleHeight = 180;
-    // 玩家参考身高
+    this.playerCapsuleRadiusRatio = 1;
     this.isFirstPerson = false;
     this.boundingBoxMinY = 0;
-    // ==================== 测试参数 ====================
-    this.displayPlayer = false;
-    this.displayCollider = false;
-    this.displayVisualizer = false;
-    // ==================== 场景对象 ====================
+    // ==================== 运行状态 ====================
+    this.controllerMode = 0;
+    // 0:人物  1:车辆
+    this.playerIsOnGround = false;
+    this.isupdate = true;
+    this.isFlying = false;
+    this.isChangeControllerTransitionTimer = null;
+    // ==================== 输入按键 ====================
+    this.fwdPressed = false;
+    this.bkdPressed = false;
+    this.lftPressed = false;
+    this.rgtPressed = false;
+    this.spacePressed = false;
+    this.ctPressed = false;
+    this.shiftPressed = false;
+    // ==================== 相机参数 ====================
+    this.camCollisionLerp = 0.18;
+    this.camEpsilon = 35;
+    this.minCamDistance = 100;
+    this.maxCamDistance = 440;
+    this.orginMaxCamDistance = 440;
+    // ==================== 场景碰撞体 ====================
     this.collider = null;
     this.visualizer = null;
     this.person = null;
@@ -318,150 +722,78 @@ var PlayerController = class {
     this.collected = [];
     this.dynamicCollider = null;
     this.dynamicCollected = [];
-    // ==================== 多车辆相关 ====================
+    // ==================== 车辆系统 ====================
     this.vehicles = [];
-    // 所有已加载车辆
     this.activeVehicle = null;
-    // 当前驾驶/交互的车辆
     this.vehicleLength = 6;
-    // 车辆参考长度
-    this.wheelSteeringQuat = new THREE3.Quaternion();
-    this.wheelRotationQuat = new THREE3.Quaternion();
     this.RAPIER = null;
     this.world = null;
-    // 全局车辆共享参数
+    this.wheelSteeringQuat = new THREE4.Quaternion();
+    this.wheelRotationQuat = new THREE4.Quaternion();
+    this.camBehindDir = new THREE4.Vector3(0, 0, 1);
     this.vehicleParams = {
-      debug: {
-        showPhysicsBox: false
-      },
-      chassis: {
-        linearDamping: 0.5,
-        angularDamping: 0.5
-      },
-      model: {
-        rotation: -Math.PI / 2
-      },
-      power: {
-        accelerateForce: 50,
-        // 推进
-        brakeForce: 200,
-        // 刹车
-        maxSpeed: 1e4
-        // 最大速度
-      },
-      steering: {
-        maxSteerAngle: Math.PI / 4,
-        steerSpeed: 0.5,
-        steerReturnSpeed: 1
-      },
+      debug: { showPhysicsBox: false },
+      chassis: { linearDamping: 0.5, angularDamping: 0.5 },
+      model: { rotation: -Math.PI / 2 },
+      power: { accelerateForce: 50, brakeForce: 200, maxSpeed: 1e4 },
+      steering: { maxSteerAngle: Math.PI / 4, steerSpeed: 0.5, steerReturnSpeed: 1 },
       followVehicleDirection: true
     };
-    this.camBehindDir = new THREE3.Vector3(0, 0, 1);
-    // ==================== 上车相关 ====================
+    // ==================== 上车流程 ====================
     this.isMovingToBoardingPoint = false;
     this.boardingWaypoints = [];
     this.currentWaypointIndex = 0;
     this.boardingTargetDir = null;
     this.boardingMoveSpeed = 300;
     this.boardingRotateSpeed = 10;
-    this.flip180Quat = new THREE3.Quaternion().setFromAxisAngle(
-      new THREE3.Vector3(0, 1, 0),
-      Math.PI
-    );
-    this.closeVehicleDoorTimer = null;
     this.boardingPointWorld = null;
     this.isBoardingAnimPlaying = false;
     this.closeDoorTriggered = false;
     this.isExitAnimPlaying = false;
     this.closeExitDoorTriggered = false;
-    // ==================== 状态开关 ====================
-    this.playerIsOnGround = false;
-    this.isupdate = true;
-    this.isFlying = false;
-    // ==================== 输入状态 ====================
-    this.fwdPressed = false;
-    this.bkdPressed = false;
-    this.lftPressed = false;
-    this.rgtPressed = false;
-    this.spacePressed = false;
-    this.ctPressed = false;
-    this.shiftPressed = false;
-    // ==================== 移动端输入 ====================
-    this.prevJoyState = { dirX: 0, dirY: 0, shift: false };
-    this.nippleModule = null;
-    this.joystickManager = null;
-    this.joystickZoneEl = null;
-    this.lookAreaEl = null;
-    this.jumpBtnEl = null;
-    this.flyBtnEl = null;
-    this.viewBtnEl = null;
-    this.vehicleBtnEl = null;
-    this.lookPointerId = null;
-    this.isLookDown = false;
-    this.lastTouchX = 0;
-    this.lastTouchY = 0;
-    this.nearCheckLocal = new THREE3.Vector3();
-    this.nearCheckWorld = new THREE3.Vector3();
-    this.isNearVehicle = false;
-    // ==================== 第三人称相机参数 ====================
-    this._camCollisionLerp = 0.18;
-    this._camEpsilon = 0.35;
-    this.minCamDistance = 1;
-    this.maxCamDistance = 4.4;
-    this.orginMaxCamDistance = 4.4;
-    // ==================== 物理/运动 ====================
-    this.playerVelocity = new THREE3.Vector3();
-    this.upVector = new THREE3.Vector3(0, 1, 0);
-    // ==================== 临时复用向量/矩阵 ====================
-    this.tempVector = new THREE3.Vector3();
-    this.tempVector2 = new THREE3.Vector3();
-    this.tempBox = new THREE3.Box3();
-    this.tempMat = new THREE3.Matrix4();
-    this.tempSegment = new THREE3.Line3();
+    this.closeVehicleDoorTimer = null;
+    this.flip180Quat = new THREE4.Quaternion().setFromAxisAngle(new THREE4.Vector3(0, 1, 0), Math.PI);
     this.recheckAnimTimer = null;
-    // ==================== 相机朝向/移动复用向量 ====================
-    this.camDir = new THREE3.Vector3();
-    this.moveDir = new THREE3.Vector3();
-    this.targetQuat = new THREE3.Quaternion();
-    this.targetMat = new THREE3.Matrix4();
+    this.allAnimations = [];
+    // ==================== 移动端控制 ====================
+    this.mobileControls = null;
+    this.nearCheckLocal = new THREE4.Vector3();
+    this.nearCheckWorld = new THREE4.Vector3();
+    this.isNearVehicle = false;
+    // ==================== 调试显示 ====================
+    this.displayPlayer = false;
+    this.displayCollider = false;
+    this.displayVisualizer = false;
+    // ==================== 方向常量 ====================
     this.rotationSpeed = 10;
-    this.DIR_FWD = new THREE3.Vector3(0, 0, -1);
-    this.DIR_BKD = new THREE3.Vector3(0, 0, 1);
-    this.DIR_LFT = new THREE3.Vector3(-1, 0, 0);
-    this.DIR_RGT = new THREE3.Vector3(1, 0, 0);
-    this.DIR_UP = new THREE3.Vector3(0, 1, 0);
+    this.DIR_FWD = new THREE4.Vector3(0, 0, -1);
+    this.DIR_BKD = new THREE4.Vector3(0, 0, 1);
+    this.DIR_LFT = new THREE4.Vector3(-1, 0, 0);
+    this.DIR_RGT = new THREE4.Vector3(1, 0, 0);
+    this.DIR_UP = new THREE4.Vector3(0, 1, 0);
+    // ==================== 复用向量 ====================
+    this.upVector = new THREE4.Vector3(0, 1, 0);
+    this.playerVelocity = new THREE4.Vector3();
+    this.camDir = new THREE4.Vector3();
+    this.moveDir = new THREE4.Vector3();
+    this.targetQuat = new THREE4.Quaternion();
+    this.targetMat = new THREE4.Matrix4();
+    this.tempVector = new THREE4.Vector3();
+    this.tempVector2 = new THREE4.Vector3();
+    this.tempBox = new THREE4.Box3();
+    this.tempMat = new THREE4.Matrix4();
+    this.tempSegment = new THREE4.Line3();
     // ==================== 射线检测 ====================
-    this._personToCam = new THREE3.Vector3();
-    this._originTmp = new THREE3.Vector3();
-    this._raycaster = new THREE3.Raycaster(
-      new THREE3.Vector3(),
-      new THREE3.Vector3(0, -1, 0)
-    );
-    this._raycasterPersonToCam = new THREE3.Raycaster(
-      new THREE3.Vector3(),
-      new THREE3.Vector3()
-    );
-    this.centerRay = new THREE3.Raycaster();
-    this.centerMouse = new THREE3.Vector2();
-    // ==================== 物理与碰撞检测 ====================
-    this.ensureAttributesMinimal = (geom) => {
-      if (!geom.attributes.position) return null;
-      if (!geom.attributes.normal) geom.computeVertexNormals();
-      if (!geom.attributes.uv) {
-        const count = geom.attributes.position.count;
-        const dummyUV = new Float32Array(count * 2);
-        geom.setAttribute("uv", new THREE3.BufferAttribute(dummyUV, 2));
-      }
-      return geom;
-    };
+    this.personToCam = new THREE4.Vector3();
+    this.originTmp = new THREE4.Vector3();
+    this.raycaster = new THREE4.Raycaster(new THREE4.Vector3(), new THREE4.Vector3(0, -1, 0));
+    this.raycasterPersonToCam = new THREE4.Raycaster(new THREE4.Vector3(), new THREE4.Vector3());
+    this.centerRay = new THREE4.Raycaster();
+    this.centerMouse = new THREE4.Vector2();
+    // 按键动画同步
     this.setAnimationByPressed = () => {
       this.maxCamDistance = this.orginMaxCamDistance;
-      if (this.isMovingToBoardingPoint) {
-        this.isMovingToBoardingPoint = false;
-        this.boardingWaypoints = [];
-        this.currentWaypointIndex = 0;
-        this.boardingTargetDir = null;
-      }
+      this.cancelBoarding();
       if (this.isExitAnimPlaying) {
         this.isExitAnimPlaying = false;
         this.closeExitDoorTriggered = false;
@@ -489,15 +821,11 @@ var PlayerController = class {
           return;
         }
         if (this.fwdPressed) {
-          this.playPersonAnimationByName(
-            this.shiftPressed ? "running" : "walking"
-          );
+          this.playPersonAnimationByName(this.shiftPressed ? "running" : "walking");
           return;
         }
         if (!this.isFirstPerson && (this.lftPressed || this.rgtPressed || this.bkdPressed)) {
-          this.playPersonAnimationByName(
-            this.shiftPressed ? "running" : "walking"
-          );
+          this.playPersonAnimationByName(this.shiftPressed ? "running" : "walking");
           return;
         }
         if (this.lftPressed) {
@@ -513,19 +841,16 @@ var PlayerController = class {
           return;
         }
       }
-      if (this.recheckAnimTimer !== null) {
-        clearTimeout(this.recheckAnimTimer);
-      }
+      if (this.recheckAnimTimer !== null) clearTimeout(this.recheckAnimTimer);
       this.recheckAnimTimer = setTimeout(() => {
         this.setAnimationByPressed();
         this.recheckAnimTimer = null;
       }, 200);
     };
     // ==================== 事件处理 ====================
-    this._boundOnKeydown = async (e) => {
-      if (e.ctrlKey && ["KeyW", "KeyA", "KeyS", "KeyD"].includes(e.code)) {
-        e.preventDefault();
-      }
+    // 键盘按下事件
+    this.boundOnKeydown = async (e) => {
+      if (e.ctrlKey && ["KeyW", "KeyA", "KeyS", "KeyD"].includes(e.code)) e.preventDefault();
       switch (e.code) {
         case "KeyW":
         case "ArrowUp":
@@ -554,17 +879,11 @@ var PlayerController = class {
           this.controls.mouseButtons = { LEFT: 2, MIDDLE: 1, RIGHT: 0 };
           break;
         case "Space":
-          if (this.isMovingToBoardingPoint) {
-            this.isMovingToBoardingPoint = false;
-            this.boardingWaypoints = [];
-            this.currentWaypointIndex = 0;
-            this.boardingTargetDir = null;
-          }
+          this.cancelBoarding();
           this.spacePressed = true;
-          if (this.controllerMode == 1) return;
+          if (this.controllerMode === 1) return;
           if (!this.playerIsOnGround || this.isFlying) return;
-          const next = this.personActions?.get("jumping");
-          if (next && this.actionState === next) return;
+          if (this.personActions?.get("jumping") === this.actionState) return;
           this.playPersonAnimationByName("jumping");
           this.playerVelocity.y = this.jumpHeight;
           this.playerIsOnGround = false;
@@ -576,25 +895,21 @@ var PlayerController = class {
           this.changeView();
           break;
         case "KeyF":
-          if (this.controllerMode == 0 && this.playerFlyEnabled) {
+          if (this.controllerMode === 0 && this.playerFlyEnabled) {
             this.isFlying = !this.isFlying;
             this.setAnimationByPressed();
-            if (!this.isFlying && !this.playerIsOnGround) {
-              this.playPersonAnimationByName("jumping");
-            }
+            if (!this.isFlying && !this.playerIsOnGround) this.playPersonAnimationByName("jumping");
           }
           break;
         case "KeyE":
           if (this.isFlying) return;
-          if (this.controllerMode == 0) {
-            this.enterVehicle();
-          } else {
-            this.exitVehicle();
-          }
+          if (this.controllerMode === 0) this.enterVehicle();
+          else this.exitVehicle();
           break;
       }
     };
-    this._boundOnKeyup = (e) => {
+    // 键盘抬起事件
+    this.boundOnKeyup = (e) => {
       switch (e.code) {
         case "KeyW":
         case "ArrowUp":
@@ -630,192 +945,112 @@ var PlayerController = class {
           break;
       }
     };
-    this._mouseMove = (e) => {
-      if (document.pointerLockElement !== document.body) return;
-      this.setToward(e.movementX, e.movementY, 1e-4);
-    };
-    this._mouseClick = (_e) => {
-      this.setPointerLock();
-    };
-    // ==================== 移动端控制 ====================
-    this.onPointerDown = (e) => {
-      if (e.pointerType !== "touch") return;
-      this.isLookDown = true;
-      this.lookPointerId = e.pointerId;
-      this.lastTouchX = e.clientX;
-      this.lastTouchY = e.clientY;
-      this.lookAreaEl?.setPointerCapture?.(e.pointerId);
-      e.preventDefault();
-    };
-    this.onPointerMove = (e) => {
-      if (!this.isLookDown || e.pointerId !== this.lookPointerId) return;
-      const dx = e.clientX - this.lastTouchX;
-      const dy = e.clientY - this.lastTouchY;
-      this.lastTouchX = e.clientX;
-      this.lastTouchY = e.clientY;
-      this.setInput({ lookDeltaX: dx, lookDeltaY: dy });
-      e.preventDefault();
-    };
-    this.onPointerUp = (e) => {
-      if (e.pointerId !== this.lookPointerId) return;
-      this.isLookDown = false;
-      this.lookPointerId = null;
-      this.lookAreaEl?.releasePointerCapture?.(e.pointerId);
+    this.mouseMove = (e) => {
+      if (document.pointerLockElement === document.body) this.setToward(e.movementX, e.movementY, 1e-4);
     };
-    this._raycaster.firstHitOnly = true;
-    this._raycasterPersonToCam.firstHitOnly = true;
+    this.mouseClick = () => this.setPointerLock();
+    this.raycaster.firstHitOnly = true;
+    this.raycasterPersonToCam.firstHitOnly = true;
   }
-  // ==================== 初始化相关方法 ====================
+  // ==================== 初始化 ====================
+  // 初始化控制器
   async init(opts, callback) {
+    const m = opts.playerModel;
+    const s = m.scale ?? 1;
     this.scene = opts.scene;
     this.camera = opts.camera;
     this.camera.rotation.order = "YXZ";
     this.controls = opts.controls;
-    this.playerModel = opts.playerModel;
-    this.initPos = opts.initPos ?? new THREE3.Vector3(0, 0, 0);
-    this.mouseSensity = opts.mouseSensity ?? 5;
-    const s = this.playerModel.scale;
-    this.gravity = (opts.playerModel.gravity ?? -2400) * s;
-    this.jumpHeight = (opts.playerModel.jumpHeight ?? 600) * s;
-    this.playerSpeed = (opts.playerModel.speed ?? 300) * s;
-    this.playerFlySpeed = (opts.playerModel.flySpeed ?? 2100) * s;
+    this.playerModel = m;
+    this.initPos = opts.initPos ? new THREE4.Vector3(opts.initPos.x, opts.initPos.y, opts.initPos.z) : new THREE4.Vector3(0, 0, 0);
+    const pm = this.playerModel;
+    this.gravity = (pm.gravity ?? this.gravity) * s;
+    this.jumpHeight = (pm.jumpHeight ?? this.jumpHeight) * s;
+    this.playerSpeed = (pm.speed ?? this.playerSpeed) * s;
+    this.playerFlySpeed = (pm.flySpeed ?? this.playerFlySpeed) * s;
     this.curPlayerSpeed = this.playerSpeed;
-    this.playerModel.rotateY = opts.playerModel.rotateY ?? 0;
-    this.playerFlyEnabled = opts.playerModel.flyEnabled ?? true;
-    this._camCollisionLerp = 0.18;
-    this._camEpsilon = 35 * s;
-    this.minCamDistance = (opts.minCamDistance ?? 100) * s;
-    this.maxCamDistance = (opts.maxCamDistance ?? 440) * s;
+    this.playerFlyEnabled = pm.flyEnabled ?? this.playerFlyEnabled;
+    this.playerCapsuleRadiusRatio = pm.capsuleRadiusRatio ?? this.playerCapsuleRadiusRatio;
+    this.mouseSensitivity = opts.mouseSensitivity ?? this.mouseSensitivity;
+    this.thirdMouseMode = opts.thirdMouseMode ?? this.thirdMouseMode;
+    this.enableZoom = opts.enableZoom ?? this.enableZoom;
+    this.minCamDistance = (opts.minCamDistance ?? this.minCamDistance) * s;
+    this.maxCamDistance = (opts.maxCamDistance ?? this.maxCamDistance) * s;
     this.orginMaxCamDistance = this.maxCamDistance;
-    this.thirdMouseMode = opts.thirdMouseMode ?? 1;
-    this.enableZoom = opts.enableZoom ?? false;
-    this.playerCapsuleRadiusRatio = opts.playerModel.capsuleRadiusRatio ?? 1;
-    const isMobileDevice = () => navigator.maxTouchPoints && navigator.maxTouchPoints > 0 || "ontouchstart" in window || /Mobi|Android|iPhone|iPad|iPod/i.test(navigator.userAgent);
-    this.isShowMobileControls = (opts.isShowMobileControls ?? true) && isMobileDevice();
+    this.camEpsilon = this.camEpsilon * s;
+    this.isShowMobileControls = (opts.isShowMobileControls ?? this.isShowMobileControls) && isMobileDevice();
+    this.enableOverShoulderView = opts.enableOverShoulderView ?? this.enableOverShoulderView;
     if (this.isShowMobileControls) {
-      await this.initMobileControls();
+      this.mobileControls = new MobileControls((i) => this.setInput(i), this.controls);
+      await this.mobileControls.init();
     }
     await this.createBVH(opts.colliderMeshUrl);
     await this.loadPersonGLB();
     this.onAllEvent();
     this.setCameraPos();
     this.setControls();
-    if (callback) callback();
-    this.enableOverShoulderView = opts.enableOverShoulderView ?? false;
     this.setOverShoulderView(this.enableOverShoulderView);
+    callback?.();
   }
+  // 过肩视角切换
   setOverShoulderView(enable) {
-    if (!enable || this.controllerMode == 1) {
+    if (!enable || this.controllerMode === 1) {
       this.camera.clearViewOffset();
       return;
     }
     const w = window.innerWidth;
     const h = window.innerHeight;
-    this.camera.setViewOffset(
-      w,
-      h,
-      -w * -0.15,
-      0,
-      w,
-      h
-    );
+    this.camera.setViewOffset(w, h, -w * -0.15, 0, w, h);
   }
+  // 初始化加载器
   async initLoader() {
     const dracoLoader = new DRACOLoader();
     dracoLoader.setDecoderPath("https://unpkg.com/three@0.180.0/examples/jsm/libs/draco/gltf/");
     dracoLoader.setDecoderConfig({ type: "js" });
     this.loader.setDRACOLoader(dracoLoader);
   }
+  // 初始化物理引擎
   async initRapier() {
     if (this.RAPIER) return;
     this.RAPIER = await import("@dimforge/rapier3d-compat");
     await this.RAPIER.init();
-    const gravity = new this.RAPIER.Vector3(0, -9.81, 0);
-    this.world = new this.RAPIER.World(gravity);
+    this.world = new this.RAPIER.World(new this.RAPIER.Vector3(0, -9.81, 0));
     this.world.maxCcdSubsteps = 2;
-    const addGeometryAsTrimesh = (RAPIER, world, geom) => {
-      let geometry = geom.index ? geom.clone().toNonIndexed() : geom.clone();
-      const posAttr = geometry.attributes.position;
-      const vertexCount = posAttr.count;
-      if (vertexCount % 3 !== 0) {
-        console.warn("\u9876\u70B9\u6570\u4E0D\u662F3\u7684\u500D\u6570\uFF0C\u4E09\u89D2\u5F62\u53EF\u80FD\u4E0D\u5B8C\u6574");
-      }
-      const vertices = new Float32Array(vertexCount * 3);
-      const tmp = new THREE3.Vector3();
-      for (let i = 0; i < vertexCount; i++) {
-        tmp.fromBufferAttribute(posAttr, i);
-        vertices[i * 3 + 0] = tmp.x;
-        vertices[i * 3 + 1] = tmp.y;
-        vertices[i * 3 + 2] = tmp.z;
+    const addTrimesh = (RAPIER, world, geom) => {
+      let g = geom.index ? geom.clone().toNonIndexed() : geom.clone();
+      const pos = g.attributes.position;
+      const count = pos.count;
+      const verts = new Float32Array(count * 3);
+      const tmp = new THREE4.Vector3();
+      for (let i = 0; i < count; i++) {
+        tmp.fromBufferAttribute(pos, i);
+        verts[i * 3] = tmp.x;
+        verts[i * 3 + 1] = tmp.y;
+        verts[i * 3 + 2] = tmp.z;
       }
-      const indices = vertexCount > 65535 ? new Uint32Array(vertexCount) : new Uint16Array(vertexCount);
-      for (let i = 0; i < vertexCount; i++) indices[i] = i;
-      const bodyDesc = RAPIER.RigidBodyDesc.fixed();
-      const body = world.createRigidBody(bodyDesc);
-      const colliderDesc = RAPIER.ColliderDesc.trimesh(vertices, indices).setRestitution(0).setFriction(0.8);
-      world.createCollider(colliderDesc, body);
+      const indices = count > 65535 ? new Uint32Array(count) : new Uint16Array(count);
+      for (let i = 0; i < count; i++) indices[i] = i;
+      const body = world.createRigidBody(RAPIER.RigidBodyDesc.fixed());
+      world.createCollider(
+        RAPIER.ColliderDesc.trimesh(verts, indices).setRestitution(0).setFriction(0.8),
+        body
+      );
     };
-    for (const g of this.collected) {
-      addGeometryAsTrimesh(this.RAPIER, this.world, g);
-    }
-    const groundDesc = this.RAPIER.RigidBodyDesc.fixed();
-    const groundBody = this.world.createRigidBody(groundDesc);
+    for (const g of this.collected) addTrimesh(this.RAPIER, this.world, g);
+    const groundBody = this.world.createRigidBody(this.RAPIER.RigidBodyDesc.fixed());
     groundBody.userData = { outOfBounds: true };
   }
-  // ==================== 玩家模型相关方法 ====================
+  // ==================== 玩家模型 ====================
+  // 加载玩家模型
   async loadPersonGLB() {
     try {
-      const gltf = await this.loader.loadAsync(
-        this.playerModel.url
-      );
+      const gltf = await this.loader.loadAsync(this.playerModel.url);
       this.person = gltf.scene;
-      const { size } = this.getBbox(this.person);
-      const ratio = this.playerCapsuleHeight / size.y;
-      const modelScale = ratio;
-      this.playerCapsuleRadius = Number(Math.min(size.x, size.z).toFixed(0)) * modelScale * this.playerCapsuleRadiusRatio;
-      this.playerCapsuleHeight = Number(size.y.toFixed(0)) * modelScale;
-      const scale = this.playerModel.scale;
-      const material = new THREE3.MeshStandardMaterial({
-        color: new THREE3.Color(1, 0, 0),
-        shadowSide: THREE3.DoubleSide,
-        depthTest: false,
-        transparent: true,
-        opacity: this.displayPlayer ? 0.5 : 0,
-        wireframe: true,
-        depthWrite: false
-      });
-      const r = this.playerCapsuleRadius * scale;
-      const h = this.playerCapsuleHeight * scale;
-      this.player = new THREE3.Mesh(
-        new RoundedBoxGeometry(r * 2, h, r * 2, 1, 75),
-        material
-      );
-      this.player.geometry.translate(0, -h * 0.25, 0);
-      this.player.capsuleInfo = {
-        radius: r,
-        segment: new THREE3.Line3(
-          new THREE3.Vector3(),
-          new THREE3.Vector3(0, -h * 0.5, 0)
-        )
-      };
-      this.player.name = "capsule";
-      this.scene.add(this.player);
-      this.reset();
-      this.player.rotateY(this.playerModel.rotateY ?? 0);
-      this.person.scale.multiplyScalar(modelScale * scale);
-      this.person.position.set(0, -h * 0.75, 0);
-      this.person.traverse((child) => {
-        if (child.name == this.playerModel?.headObjName) {
-          this.personHead = child;
-        }
-      });
-      this.player.add(this.person);
-      this.reset();
-      this.personMixer = new THREE3.AnimationMixer(this.person);
+      this.personMixer = new THREE4.AnimationMixer(this.person);
       const animations = gltf.animations ?? [];
-      console.log("animations", animations);
+      this.allAnimations = animations;
       this.personActions = /* @__PURE__ */ new Map();
-      const animationMappings = [
+      const mappings = [
         [this.playerModel.idleAnim, "idle"],
         [this.playerModel.walkAnim, "walking"],
         [this.playerModel.leftWalkAnim || this.playerModel.walkAnim, "left_walking"],
@@ -828,43 +1063,30 @@ var PlayerController = class {
         [this.playerModel.enterCarAnim || this.playerModel.idleAnim, "enterCar"],
         [this.playerModel.exitCarAnim || this.playerModel.idleAnim, "exitCar"]
       ];
-      const findClip = (name) => animations.find((a) => a.name === name);
-      for (const [clipName, actionName] of animationMappings) {
-        const clip = findClip(clipName);
+      for (const [clipName, actionName] of mappings) {
+        const clip = animations.find((a) => a.name === clipName);
         if (!clip) continue;
         const action = this.personMixer.clipAction(clip);
         if (actionName === "jumping") {
-          action.setLoop(THREE3.LoopOnce, 1);
+          action.setLoop(THREE4.LoopOnce, 1);
           action.clampWhenFinished = true;
           action.setEffectiveTimeScale(1.2);
         } else {
-          action.setLoop(THREE3.LoopRepeat, Infinity);
-          action.clampWhenFinished = false;
+          action.setLoop(THREE4.LoopRepeat, Infinity);
           action.setEffectiveTimeScale(1);
         }
         action.enabled = true;
         action.setEffectiveWeight(0);
         this.personActions.set(actionName, action);
       }
-      this.idleAction = this.personActions.get("idle");
-      this.walkAction = this.personActions.get("walking");
-      this.leftWalkAction = this.personActions.get("left_walking");
-      this.rightWalkAction = this.personActions.get("right_walking");
-      this.backwardAction = this.personActions.get("walking_backward");
-      this.jumpAction = this.personActions.get("jumping");
-      this.runAction = this.personActions.get("running");
-      this.flyidleAction = this.personActions.get("flyidle");
-      this.flyAction = this.personActions.get("flying");
-      this.idleAction.setEffectiveWeight(1);
-      this.idleAction.play();
-      this.actionState = this.idleAction;
+      this.personActions.get("idle").setEffectiveWeight(1);
+      this.personActions.get("idle").play();
+      this.actionState = this.personActions.get("idle");
       this.personMixer.addEventListener("finished", (ev) => {
-        const finishedAction = ev.action;
-        if (finishedAction === this.jumpAction) {
+        const done = ev.action;
+        if (done === this.personActions.get("jumping")) {
           if (this.fwdPressed) {
-            this.playPersonAnimationByName(
-              this.shiftPressed ? "running" : "walking"
-            );
+            this.playPersonAnimationByName(this.shiftPressed ? "running" : "walking");
             return;
           }
           if (this.bkdPressed) {
@@ -877,26 +1099,56 @@ var PlayerController = class {
           }
           this.playPersonAnimationByName("idle");
         }
-        if (finishedAction === this.personActions?.get("enterCar")) {
-          this.onEnterCarAnimFinished();
-        }
-        if (finishedAction === this.personActions?.get("exitCar")) {
-        }
+        if (done === this.personActions?.get("enterCar")) this.onEnterCarAnimFinished();
+      });
+      this.personMixer.update(0);
+      this.person.updateMatrixWorld(true);
+      const { size } = this.getBbox(this.person);
+      const modelScale = this.playerCapsuleHeight / size.y;
+      this.playerCapsuleRadius = Number(Math.min(size.x, size.z).toFixed(0)) * modelScale * this.playerCapsuleRadiusRatio;
+      this.playerCapsuleHeight = Number(size.y.toFixed(0)) * modelScale;
+      const s = this.playerModel.scale;
+      const r = this.playerCapsuleRadius * s;
+      const h = this.playerCapsuleHeight * s;
+      this.player = new THREE4.Mesh(
+        new RoundedBoxGeometry(r * 2, h, r * 2, 1, 75),
+        new THREE4.MeshStandardMaterial({
+          color: new THREE4.Color(1, 0, 0),
+          shadowSide: THREE4.DoubleSide,
+          depthTest: false,
+          transparent: true,
+          opacity: this.displayPlayer ? 0.5 : 0,
+          wireframe: true,
+          depthWrite: false
+        })
+      );
+      this.player.geometry.translate(0, -h * 0.25, 0);
+      this.player.capsuleInfo = {
+        radius: r,
+        segment: new THREE4.Line3(new THREE4.Vector3(), new THREE4.Vector3(0, -h * 0.5, 0))
+      };
+      this.player.name = "capsule";
+      this.scene.add(this.player);
+      this.reset();
+      this.player.rotateY(this.playerModel.rotateY ?? 0);
+      this.person.scale.multiplyScalar(modelScale * s);
+      this.person.position.set(0, -h * 0.75, 0);
+      this.person.traverse((child) => {
+        if (child.name === this.playerModel?.headObjName) this.personHead = child;
       });
-    } catch (error) {
-      console.error("\u52A0\u8F7D\u73A9\u5BB6\u6A21\u578B\u5931\u8D25:", error);
+      this.player.add(this.person);
+      this.reset();
+    } catch (e) {
+      console.error("\u52A0\u8F7D\u73A9\u5BB6\u6A21\u578B\u5931\u8D25:", e);
     }
   }
+  // 切换玩家模型
   async switchPlayerModel(newPlayerModel) {
     const savedPos = this.player.position.clone();
     const savedQuat = this.player.quaternion.clone();
     const wasFirstPerson = this.isFirstPerson;
-    if (wasFirstPerson) {
-      this.scene.attach(this.camera);
-    }
-    if (this.player) {
-      this.scene.remove(this.player);
-    }
+    if (wasFirstPerson) this.scene.attach(this.camera);
+    if (this.player) this.scene.remove(this.player);
     if (this.person) {
       this.player.remove(this.person);
       this.person = null;
@@ -915,45 +1167,76 @@ var PlayerController = class {
     this.playerSpeed *= ratio;
     this.playerFlySpeed *= ratio;
     this.curPlayerSpeed *= ratio;
-    this._camEpsilon *= ratio;
+    this.camEpsilon *= ratio;
     this.minCamDistance *= ratio;
     this.maxCamDistance *= ratio;
     this.orginMaxCamDistance *= ratio;
     await this.loadPersonGLB();
     this.player.position.copy(savedPos);
     this.player.quaternion.copy(savedQuat);
-    if (wasFirstPerson) {
-      this.setFirstPersonCamera();
-    }
+    if (wasFirstPerson) this.setFirstPersonCamera();
     this.setDebug(this.displayCollider);
   }
+  // 播放动画
   playPersonAnimationByName(name, fade = 0.18) {
     if (!this.personActions || this.ctPressed) return;
     const next = this.personActions.get(name);
     if (!next || this.actionState === next) return;
-    const duration = next.getClip().duration;
     const prev = this.actionState;
     next.reset();
     next.setEffectiveWeight(1);
-    if (name == "enterCar" || name == "exitCar") {
+    if (name === "enterCar" || name === "exitCar") {
+      const duration = next.getClip().duration;
       const enterTime = this.activeVehicle?.enterVehicleTime ?? 1.5;
       next.setEffectiveTimeScale(duration / enterTime);
-      next.setLoop(THREE3.LoopOnce, 1);
+      next.setLoop(THREE4.LoopOnce, 1);
       next.clampWhenFinished = true;
     }
     next.play();
     if (prev && prev !== next) {
       prev.fadeOut(fade);
       next.fadeIn(fade);
-    } else {
-      next.fadeIn(fade);
-    }
+    } else next.fadeIn(fade);
     this.actionState = next;
   }
-  // ==================== 车辆模型相关 ====================
-  /**
-   * 加载车辆模型
-   */
+  // 注册自定义动画
+  registerAnimation(key, clipName, opts) {
+    if (!this.personMixer || !this.personActions) return;
+    const mixer = this.personMixer;
+    const clip = this.allAnimations.find((c) => c.name === clipName);
+    if (!clip) {
+      console.warn(`\u627E\u4E0D\u5230 "${clipName}" \u52A8\u753B`);
+      return;
+    }
+    const action = mixer.clipAction(clip);
+    const timeScale = opts?.duration ? clip.duration / opts.duration : opts?.timeScale ?? 1;
+    action.setLoop(opts?.loop === false ? THREE4.LoopOnce : THREE4.LoopRepeat, Infinity);
+    action.clampWhenFinished = opts?.clampWhenFinished ?? false;
+    action.setEffectiveTimeScale(timeScale);
+    action.enabled = true;
+    action.setEffectiveWeight(0);
+    this.personActions.set(key, action);
+    if (opts?.onFinished) {
+      this.personMixer.addEventListener("finished", (ev) => {
+        if (ev.action === action) opts.onFinished();
+      });
+    }
+  }
+  // 外部播放动画
+  playAnimation(key, opts) {
+    if (!this.personActions) return;
+    if (!this.personActions.has(key)) {
+      console.warn(`playAnimation: "${key}" \u672A\u6CE8\u518C`);
+      return;
+    }
+    if (opts?.force) {
+      const action = this.personActions.get(key);
+      action.reset();
+    }
+    this.playPersonAnimationByName(key, opts?.fade ?? 0.18);
+  }
+  // ==================== 车辆 ====================
+  // 加载车辆模型
   async loadVehicleModel(opts) {
     try {
       if (!this.playerModel.enterCarAnim) {
@@ -961,287 +1244,31 @@ var PlayerController = class {
       }
       await this.initRapier();
       if (!this.world) return;
-      const scale = opts.scale ?? 1;
-      const chassisRatio = opts.chassisRatio ?? 0.2;
-      const suspensionRestLengthRatio = opts.suspensionRestLengthRatio ?? 0.2;
-      const speedMultiplier = opts.speedMultiplier ?? 1;
-      const followVehicleDirection = opts.followVehicleDirection ?? true;
-      this.vehicleParams.power.accelerateForce = 50 * scale;
-      this.vehicleParams.power.brakeForce = 200 * scale;
-      this.vehicleParams.power.maxSpeed = 1e4 * scale;
-      this.vehicleParams.followVehicleDirection = followVehicleDirection;
-      const vehicleModel = await this.loader.loadAsync(opts.url);
-      const { size: originalSize } = this.getBbox(vehicleModel.scene);
-      const ratio = this.vehicleLength / Math.max(originalSize.x, originalSize.y, originalSize.z);
-      const modelScale = ratio;
-      const vehicleMixer = new THREE3.AnimationMixer(vehicleModel.scene);
-      const animations = vehicleModel.animations ?? [];
-      const vehicleActions = /* @__PURE__ */ new Map();
-      const findClip = (name) => animations.find((a) => a.name === name);
-      const openDoorClip = findClip(opts.animations?.openDoorAnim || "");
-      if (openDoorClip) {
-        const action = vehicleMixer.clipAction(openDoorClip);
-        action.setLoop(THREE3.LoopOnce, 1);
-        action.clampWhenFinished = true;
-        action.setEffectiveTimeScale(openDoorClip.duration);
-        action.enabled = true;
-        action.setEffectiveWeight(0);
-        vehicleActions.set("openDoor", action);
-      }
-      const wheelObjects = [];
-      for (const wheelName of opts.wheelsNames) {
-        let found = false;
-        vehicleModel.scene.traverse((child) => {
-          if (child.name === wheelName && !found) {
-            wheelObjects.push(child);
-            found = true;
-          }
-        });
-        if (!found) console.warn(`\u672A\u627E\u5230\u8F6E\u5B50: ${wheelName}`);
-      }
-      const tempGroup = new THREE3.Group();
-      this.scene.add(tempGroup);
-      vehicleModel.scene.scale.multiplyScalar(modelScale * scale);
-      vehicleModel.scene.rotateY(this.vehicleParams.model.rotation);
-      const { size, bbox, center } = this.getBbox(vehicleModel.scene);
-      vehicleModel.scene.position.set(-center.x, -center.y, -center.z);
-      tempGroup.add(vehicleModel.scene);
-      tempGroup.updateMatrixWorld(true);
-      const wheelsInfo = [];
-      let wheelRadius = 0;
-      let wheelWidth = 0;
-      let suspensionRestLength = 0;
-      let chassisHeight = 0;
-      let wheelSizeInit = false;
-      for (let i = 0; i < wheelObjects.length; i++) {
-        const wheel = wheelObjects[i];
-        const worldPos = new THREE3.Vector3();
-        const worldQuat = new THREE3.Quaternion();
-        const worldScale = new THREE3.Vector3();
-        wheel.getWorldPosition(worldPos);
-        wheel.getWorldQuaternion(worldQuat);
-        wheel.getWorldScale(worldScale);
-        if (!wheelSizeInit) {
-          const { size: ws } = this.getBbox(wheel);
-          wheelRadius = Number((Math.max(ws.x, ws.y, ws.z) / 2).toFixed(2));
-          wheelWidth = Number(Math.min(ws.x, ws.y, ws.z).toFixed(2));
-          suspensionRestLength = Number((wheelRadius * 2 * suspensionRestLengthRatio).toFixed(2));
-          chassisHeight = Number((wheelRadius * 2 * chassisRatio).toFixed(2));
-          wheelSizeInit = true;
-        }
-        wheelsInfo.push({
-          axleCs: new THREE3.Vector3(0, 0, -1),
-          position: worldPos,
-          quaternion: worldQuat,
-          scale: worldScale,
-          radius: wheelRadius,
-          width: wheelWidth,
-          suspensionRestLength,
-          object: wheel
-        });
-      }
-      tempGroup.remove(vehicleModel.scene);
-      this.scene.remove(tempGroup);
-      const vehicleGroup = new THREE3.Group();
-      this.scene.add(vehicleGroup);
-      vehicleGroup.add(vehicleModel.scene);
-      vehicleGroup.updateMatrixWorld(true);
-      const wheelWrappers = [];
-      for (let i = 0; i < wheelsInfo.length; i++) {
-        const wheel = wheelsInfo[i];
-        const localPos = vehicleGroup.worldToLocal(wheel.position.clone());
-        const wheelWrapper = new THREE3.Group();
-        wheelWrapper.position.copy(localPos);
-        const wheelObj = wheelsInfo[i].object;
-        if (wheelObj.parent) wheelObj.parent.remove(wheelObj);
-        wheelObj.position.set(0, 0, 0);
-        wheelObj.quaternion.copy(wheel.quaternion);
-        wheelObj.scale.copy(wheel.scale);
-        wheelObj.updateMatrixWorld();
-        wheelWrapper.add(wheelObj);
-        vehicleGroup.add(wheelWrapper);
-        wheelWrappers.push(wheelWrapper);
-      }
-      const halfExtents = size.clone().multiplyScalar(0.5);
-      halfExtents.y -= chassisHeight / 2;
-      vehicleModel.scene.position.y -= chassisHeight / 2;
-      halfExtents.x *= 0.95;
-      halfExtents.z *= 0.95;
-      const chassisDesc = this.RAPIER.RigidBodyDesc.dynamic().setTranslation(
-        opts.position.x,
-        opts.position.y,
-        opts.position.z
-      ).setLinearDamping(this.vehicleParams.chassis.linearDamping).setAngularDamping(this.vehicleParams.chassis.angularDamping).setCanSleep(true).setAdditionalMass(10);
-      const chassisBody = this.world.createRigidBody(chassisDesc);
-      const chassisCollider = this.RAPIER.ColliderDesc.cuboid(
-        halfExtents.x,
-        halfExtents.y,
-        halfExtents.z
-      );
-      this.world.createCollider(chassisCollider, chassisBody);
-      if (this.vehicleParams.debug.showPhysicsBox) {
-        const debugBox = new THREE3.Mesh(
-          new THREE3.BoxGeometry(
-            halfExtents.x * 2,
-            halfExtents.y * 2,
-            halfExtents.z * 2
-          ),
-          new THREE3.MeshBasicMaterial({
-            color: 16711680,
-            wireframe: true,
-            transparent: true,
-            opacity: 0.3
-          })
-        );
-        vehicleGroup.add(debugBox);
-      }
-      vehicleGroup.position.copy(opts.position);
-      vehicleGroup.updateMatrixWorld(true);
-      const { vehicle, updateWheelVisuals } = createVehicleController(
-        this.world,
-        chassisBody,
-        wheelWrappers,
-        wheelsInfo
-      );
-      const vehicleInstance = {
-        vehicleGroup,
-        chassisBody,
-        vehicleController: vehicle,
-        updateWheelVisuals,
-        vehicleMixer,
-        vehicleActions,
-        vehiclIsOpenDoor: false,
-        vehicleBBox: bbox.clone(),
-        pathPlanner: new PathPlanner(
-          this._createObstacleCheckerFor(vehicleGroup, bbox, scale),
-          {
-            debugEnabled: false,
-            scene: this.scene,
-            scale: this.playerModel.scale
-          }
-        ),
-        scale,
-        boardingPoint: opts.boardingPoint,
-        seatOffset: opts.seatOffset ?? new THREE3.Vector3(0, 0, 0),
-        enterVehicleTime: 1.5,
-        chassisRatio,
-        suspensionRestLengthRatio,
-        size: {
-          l: Math.max(size.x, size.z),
-          w: Math.min(size.x, size.z),
-          h: size.y
-        },
-        speedMultiplier
-      };
-      this.vehicles.push(vehicleInstance);
+      const instance = await loadVehicleModel(opts, {
+        loader: this.loader,
+        scene: this.scene,
+        world: this.world,
+        RAPIER: this.RAPIER,
+        vehicleParams: this.vehicleParams,
+        vehicleLength: this.vehicleLength,
+        playerScale: this.playerModel.scale
+      });
+      this.vehicles.push(instance);
       this.setControllerTransition();
-    } catch (error) {
-      console.error("\u52A0\u8F7D\u8F66\u8F86\u6A21\u578B\u5931\u8D25:", error);
+    } catch (e) {
+      console.error("\u52A0\u8F7D\u8F66\u8F86\u6A21\u578B\u5931\u8D25:", e);
     }
   }
+  // 获取包围盒
   getBbox(object) {
-    const bbox = new THREE3.Box3().setFromObject(object);
-    const center = new THREE3.Vector3();
-    const size = new THREE3.Vector3();
+    const bbox = new THREE4.Box3().setFromObject(object);
+    const center = new THREE4.Vector3();
+    const size = new THREE4.Vector3();
     bbox.getCenter(center);
     bbox.getSize(size);
     return { bbox, center, size };
   }
-  /**
-   * 为指定车辆创建障碍物检测器
-   */
-  _createObstacleCheckerFor(vehicleGroup, bbox, scale) {
-    return {
-      isBlocked: (start, end) => {
-        const vehiclePos = vehicleGroup.position;
-        const vehicleQuat = vehicleGroup.quaternion;
-        const center = new THREE3.Vector3();
-        const size = new THREE3.Vector3();
-        bbox.getCenter(center);
-        bbox.getSize(size);
-        center.applyQuaternion(vehicleQuat).add(vehiclePos);
-        const halfSize = size.clone().multiplyScalar(0.5 * scale);
-        const corners = [];
-        for (let x = -1; x <= 1; x += 2) {
-          for (let y = -1; y <= 1; y += 2) {
-            for (let z = -1; z <= 1; z += 2) {
-              const localCorner = new THREE3.Vector3(
-                halfSize.x * x,
-                halfSize.y * y,
-                halfSize.z * z
-              );
-              const worldCorner = localCorner.applyQuaternion(vehicleQuat).add(center);
-              corners.push(worldCorner);
-            }
-          }
-        }
-        const expandedBBox = new THREE3.Box3();
-        corners.forEach((corner) => expandedBBox.expandByPoint(corner));
-        expandedBBox.expandByScalar(100 * this.playerModel.scale);
-        const direction = new THREE3.Vector3().subVectors(end, start);
-        const length = direction.length();
-        direction.normalize();
-        const ray = new THREE3.Ray(start, direction);
-        const intersection = new THREE3.Vector3();
-        const intersects = ray.intersectBox(expandedBBox, intersection);
-        return intersects !== null && start.distanceTo(intersection) < length;
-      },
-      getNavigationNodes: (start, _goal) => {
-        const nodes = [];
-        const vehiclePos = vehicleGroup.position;
-        const vehicleQuat = vehicleGroup.quaternion;
-        const vehicleForward = new THREE3.Vector3(
-          0,
-          0,
-          1
-        ).applyQuaternion(vehicleQuat);
-        const vehicleRight = new THREE3.Vector3(1, 0, 0).applyQuaternion(
-          vehicleQuat
-        );
-        const bboxSize = new THREE3.Vector3();
-        bbox.getSize(bboxSize);
-        const halfLength = bboxSize.z / 2 * scale;
-        const halfWidth = bboxSize.x / 2 * scale;
-        const bypassMargin = 300 * this.playerModel.scale;
-        const extendedMargin = 500 * this.playerModel.scale;
-        const groundY = start.y;
-        for (const margin of [bypassMargin, extendedMargin]) {
-          nodes.push(
-            vehiclePos.clone().add(
-              vehicleForward.clone().multiplyScalar(halfLength + margin)
-            ).add(
-              vehicleRight.clone().multiplyScalar(-halfWidth - margin)
-            ).setY(groundY)
-          );
-          nodes.push(
-            vehiclePos.clone().add(
-              vehicleForward.clone().multiplyScalar(halfLength + margin)
-            ).add(
-              vehicleRight.clone().multiplyScalar(halfWidth + margin)
-            ).setY(groundY)
-          );
-          nodes.push(
-            vehiclePos.clone().add(
-              vehicleForward.clone().multiplyScalar(-halfLength - margin)
-            ).add(
-              vehicleRight.clone().multiplyScalar(-halfWidth - margin)
-            ).setY(groundY)
-          );
-          nodes.push(
-            vehiclePos.clone().add(
-              vehicleForward.clone().multiplyScalar(-halfLength - margin)
-            ).add(
-              vehicleRight.clone().multiplyScalar(halfWidth + margin)
-            ).setY(groundY)
-          );
-        }
-        return nodes;
-      }
-    };
-  }
-  /**
-   * 开关车门动画（操作当前 activeVehicle）
-   */
+  // 开关车门动画
   openVehicleDoor(isOpen = true) {
     const v = this.activeVehicle;
     if (!v?.vehicleActions) return;
@@ -1259,112 +1286,70 @@ var PlayerController = class {
       next.time = duration;
       v.vehiclIsOpenDoor = false;
     }
-    next.setLoop(THREE3.LoopOnce, 1);
+    next.setLoop(THREE4.LoopOnce, 1);
     next.clampWhenFinished = true;
     next.play();
   }
-  /**
-   * 上车：自动寻找最近的车辆
-   */
+  // 触发上车流程
   enterVehicle() {
-    if (this.vehicles.length === 0 || this.isMovingToBoardingPoint) return;
+    if (!this.vehicles.length || this.isMovingToBoardingPoint) return;
     let nearestVehicle = null;
     let nearestDist = Infinity;
     let nearBoardingPointWorld = null;
     for (const v2 of this.vehicles) {
-      const boardingPointLocal = v2.boardingPoint.clone().multiplyScalar(v2.scale);
-      const boardingPointWorld = new THREE3.Vector3();
-      v2.vehicleGroup.localToWorld(
-        boardingPointWorld.copy(boardingPointLocal)
-      );
-      const dist = this.player.position.distanceTo(boardingPointWorld);
+      const boardingLocal = v2.boardingPoint.clone().multiplyScalar(v2.scale);
+      const boardingWorld = v2.vehicleGroup.localToWorld(boardingLocal);
+      const dist = this.player.position.distanceTo(boardingWorld);
       if (dist < 800 * this.playerModel.scale && dist < nearestDist) {
         nearestDist = dist;
         nearestVehicle = v2;
-        nearBoardingPointWorld = boardingPointWorld;
+        nearBoardingPointWorld = boardingWorld;
       }
     }
     if (!nearestVehicle || !nearBoardingPointWorld) return;
     this.activeVehicle = nearestVehicle;
     const v = nearestVehicle;
     const vel = v.chassisBody.linvel();
-    const horizSpeed = Math.sqrt(vel.x * vel.x + vel.z * vel.z);
-    if (horizSpeed > 0.1) return;
+    if (Math.sqrt(vel.x ** 2 + vel.z ** 2) > 0.1) return;
     this.boardingPointWorld = nearBoardingPointWorld;
-    const vehicleForward = new THREE3.Vector3(0, 0, 1).applyQuaternion(v.vehicleGroup.quaternion).normalize();
-    const path = v.pathPlanner.findPath(
-      this.player.position.clone(),
-      this.boardingPointWorld
-    );
-    this.boardingWaypoints = path;
+    this.boardingWaypoints = v.pathPlanner.findPath(this.player.position.clone(), nearBoardingPointWorld);
     this.currentWaypointIndex = 0;
-    this.boardingTargetDir = vehicleForward;
+    this.boardingTargetDir = new THREE4.Vector3(0, 0, 1).applyQuaternion(v.vehicleGroup.quaternion).normalize();
     this.isMovingToBoardingPoint = true;
     this.playPersonAnimationByName("walking");
   }
-  /**
-   * 走向上车点
-   */
+  // 寻路移动到上车点
   updateMoveToBoardingPoint(delta) {
-    if (!this.isMovingToBoardingPoint || !this.boardingTargetDir || this.boardingWaypoints.length === 0) {
-      return;
-    }
+    if (!this.isMovingToBoardingPoint || !this.boardingTargetDir || !this.boardingWaypoints.length) return;
     if (this.currentWaypointIndex >= this.boardingWaypoints.length) {
       this.finalizeBoarding(delta);
       return;
     }
-    const currentWaypoint = this.boardingWaypoints[this.currentWaypointIndex];
+    const waypoint = this.boardingWaypoints[this.currentWaypointIndex];
     const currentPos = this.player.position.clone();
-    const horizontalDistance = new THREE3.Vector2(
-      currentWaypoint.x - currentPos.x,
-      currentWaypoint.z - currentPos.z
-    ).length();
-    const isLastWaypoint = this.currentWaypointIndex === this.boardingWaypoints.length - 1;
-    const waypointThreshold = isLastWaypoint ? 0 : 10 * this.playerModel.scale;
-    if (horizontalDistance > waypointThreshold) {
-      const moveDir = new THREE3.Vector3(
-        currentWaypoint.x - currentPos.x,
-        0,
-        currentWaypoint.z - currentPos.z
-      ).normalize();
-      const moveDistance = Math.min(
-        this.boardingMoveSpeed * this.playerModel.scale * delta,
-        horizontalDistance
-      );
-      this.player.position.add(moveDir.multiplyScalar(moveDistance));
-      const lookTarget = this.player.position.clone().add(moveDir);
-      this.targetMat.lookAt(
-        this.player.position,
-        lookTarget,
-        this.player.up
-      );
-      this.targetQuat.setFromRotationMatrix(this.targetMat);
-      this.targetQuat.multiply(this.flip180Quat);
-      const rotateAlpha = Math.min(1, this.boardingRotateSpeed * delta);
-      this.player.quaternion.slerp(this.targetQuat, rotateAlpha);
+    const isLast = this.currentWaypointIndex === this.boardingWaypoints.length - 1;
+    const threshold = isLast ? 0 : 10 * this.playerModel.scale;
+    const horizDist = new THREE4.Vector2(waypoint.x - currentPos.x, waypoint.z - currentPos.z).length();
+    if (horizDist > threshold) {
+      const moveDir = new THREE4.Vector3(waypoint.x - currentPos.x, 0, waypoint.z - currentPos.z).normalize();
+      this.player.position.add(moveDir.clone().multiplyScalar(Math.min(this.boardingMoveSpeed * this.playerModel.scale * delta, horizDist)));
+      this.targetMat.lookAt(this.player.position, this.player.position.clone().add(moveDir), this.player.up);
+      this.targetQuat.setFromRotationMatrix(this.targetMat).multiply(this.flip180Quat);
+      this.player.quaternion.slerp(this.targetQuat, Math.min(1, this.boardingRotateSpeed * delta));
     } else {
       this.currentWaypointIndex++;
     }
   }
-  /**
-   * 完成上车
-   */
+  // 最终对齐朝向
   finalizeBoarding(delta) {
     const v = this.activeVehicle;
     if (!this.boardingTargetDir || !v || !this.isMovingToBoardingPoint) return;
-    const currentDir = new THREE3.Vector3(0, 0, -1).applyQuaternion(this.player.quaternion).normalize();
-    const targetDir = this.boardingTargetDir.clone().normalize();
-    const angleDiff = currentDir.angleTo(targetDir);
-    if (angleDiff > 0.01) {
-      const lookTarget = this.player.position.clone().add(targetDir);
-      this.targetMat.lookAt(
-        this.player.position,
-        lookTarget,
-        this.player.up
-      );
+    const currentDir = new THREE4.Vector3(0, 0, -1).applyQuaternion(this.player.quaternion).normalize();
+    if (currentDir.angleTo(this.boardingTargetDir) > 0.01) {
+      const lookTarget = this.player.position.clone().add(this.boardingTargetDir);
+      this.targetMat.lookAt(this.player.position, lookTarget, this.player.up);
       this.targetQuat.setFromRotationMatrix(this.targetMat);
-      const rotateAlpha = Math.min(1, this.boardingRotateSpeed * delta);
-      this.player.quaternion.slerp(this.targetQuat, rotateAlpha);
+      this.player.quaternion.slerp(this.targetQuat, Math.min(1, this.boardingRotateSpeed * delta));
     } else {
       this.boardingWaypoints = [];
       this.currentWaypointIndex = 0;
@@ -1378,23 +1363,20 @@ var PlayerController = class {
       this.player.quaternion.multiply(this.flip180Quat);
     }
   }
+  // 上车动画完成
   onEnterCarAnimFinished() {
     const v = this.activeVehicle;
     if (!v || !this.isMovingToBoardingPoint) return;
     this.player.updateMatrixWorld(true);
     const offsetY = this.boardingPointWorld.y - this.player.position.y;
     this.controllerMode = 1;
-    this.syncControllerModeBtnEl();
+    this.syncMobileControllerMode();
     this.setOverShoulderView(false);
     v.vehicleGroup.attach(this.player);
-    this.player.position.add(
-      v.seatOffset.clone().multiplyScalar(v.scale).add(new THREE3.Vector3(0, offsetY, 0))
-    );
+    this.player.position.add(v.seatOffset.clone().multiplyScalar(v.scale).add(new THREE4.Vector3(0, offsetY, 0)));
     this.isMovingToBoardingPoint = false;
   }
-  /**
-   * 下车
-   */
+  // 触发下车流程
   exitVehicle() {
     const v = this.activeVehicle;
     if (!v) return;
@@ -1403,9 +1385,7 @@ var PlayerController = class {
     this.currentWaypointIndex = 0;
     this.boardingTargetDir = null;
     const vel = v.chassisBody.linvel();
-    const horizSpeed = Math.sqrt(vel.x * vel.x + vel.z * vel.z);
-    const isStationary = horizSpeed < 0.1;
-    if (isStationary) {
+    if (Math.sqrt(vel.x ** 2 + vel.z ** 2) < 0.1) {
       this.playPersonAnimationByName("exitCar");
       this.isExitAnimPlaying = true;
       this.closeExitDoorTriggered = false;
@@ -1414,95 +1394,90 @@ var PlayerController = class {
     }
     this.openVehicleDoor(true);
     this.controllerMode = 0;
-    this.syncControllerModeBtnEl();
+    this.syncMobileControllerMode();
     this.setOverShoulderView(this.enableOverShoulderView);
     this.scene.attach(this.player);
-    if (this.isFirstPerson) {
-      this.setFirstPersonCamera();
-    }
+    if (this.isFirstPerson) this.setFirstPersonCamera();
     this.setControllerTransition();
   }
-  // ==================== 相机与视角控制 ====================
+  // ==================== 相机与视角 ====================
+  // 切换第一/三人称
   changeView() {
     this.isFirstPerson = !this.isFirstPerson;
     if (this.isFirstPerson) {
-      this.setFirstPersonCamera();
+      const camWorldDir = new THREE4.Vector3();
+      this.camera.getWorldDirection(camWorldDir);
+      const flatDir = new THREE4.Vector3(camWorldDir.x, 0, camWorldDir.z).normalize();
+      if (flatDir.lengthSq() > 1e-3) {
+        const yAngle = Math.atan2(flatDir.x, flatDir.z);
+        this.player.rotation.set(0, yAngle + Math.PI, 0);
+      }
+      const vertAngle = Math.asin(THREE4.MathUtils.clamp(-camWorldDir.y, -1, 1));
+      this.setFirstPersonCamera(vertAngle);
       this.setOverShoulderView(false);
     } else {
       this.controls.enabled = true;
       this.scene.attach(this.camera);
-      const worldPos = this.player.position.clone();
-      const dir = new THREE3.Vector3(0, 0, -1).applyQuaternion(
-        this.player.quaternion
-      );
+      const dir = new THREE4.Vector3(0, 0, -1).applyQuaternion(this.player.quaternion);
       const angle = Math.atan2(dir.z, dir.x);
-      const offset = new THREE3.Vector3(
-        Math.cos(angle) * 400 * this.playerModel.scale,
-        200 * this.playerModel.scale,
-        Math.sin(angle) * 400 * this.playerModel.scale
-      );
-      this.camera.position.copy(worldPos).add(offset);
-      this.controls.target.copy(worldPos);
+      const s = this.playerModel.scale;
+      this.camera.position.copy(this.player.position).add(new THREE4.Vector3(Math.cos(angle) * 400 * s, 200 * s, Math.sin(angle) * 400 * s));
+      this.controls.target.copy(this.player.position);
       this.controls.enableZoom = this.enableZoom;
       this.setOverShoulderView(this.enableOverShoulderView);
     }
     this.setPointerLock();
   }
-  setFirstPersonCamera() {
+  // 设置第一人称相机
+  setFirstPersonCamera(vertAngle = 0) {
     this.controls.enabled = false;
     if (this.personHead) {
-      this.personHead?.attach(this.camera);
+      this.personHead.attach(this.camera);
       this.camera.position.set(0, 10, 20);
     } else {
       this.player.attach(this.camera);
-      this.camera.position.set(
-        0,
-        40 * this.playerModel.scale,
-        30 * this.playerModel.scale
-      );
+      this.camera.position.set(0, 40 * this.playerModel.scale, 30 * this.playerModel.scale);
     }
-    this.camera.rotation.set(0, Math.PI, 0);
+    this.camera.rotation.set(
+      THREE4.MathUtils.clamp(vertAngle, -1.1, 1.4),
+      Math.PI,
+      0
+    );
     this.controls.enableZoom = false;
   }
+  // 设置鼠标锁定
   setPointerLock() {
+    if (!document.body.requestPointerLock) return;
     if ((this.thirdMouseMode === 0 || this.thirdMouseMode === 1) && !this.isFirstPerson || this.isFirstPerson) {
       document.body.requestPointerLock();
     } else {
       document.exitPointerLock();
     }
   }
+  // 初始相机位置
   setCameraPos() {
     requestAnimationFrame(() => {
-      if (this.isFirstPerson) {
-        this.person.add(this.camera);
-        this.camera.position.set(
-          0,
-          40 * this.playerModel.scale,
-          30 * this.playerModel.scale
-        );
-      } else {
-        const worldPos = this.player.position.clone();
-        const dir = new THREE3.Vector3(0, 0, -1).applyQuaternion(
-          this.player.quaternion
-        );
+      if (!this.isFirstPerson) {
+        const dir = new THREE4.Vector3(0, 0, -1).applyQuaternion(this.player.quaternion);
         const angle = Math.atan2(dir.z, dir.x);
-        const offset = new THREE3.Vector3(
-          Math.cos(angle) * 400 * this.playerModel.scale,
-          200 * this.playerModel.scale,
-          Math.sin(angle) * 400 * this.playerModel.scale
-        );
-        this.camera.position.copy(worldPos).add(offset);
+        const s = this.playerModel.scale;
+        this.camera.position.copy(this.player.position).add(new THREE4.Vector3(Math.cos(angle) * 400 * s, 200 * s, Math.sin(angle) * 400 * s));
         this.controls.enableZoom = this.enableZoom;
+      } else {
+        this.person.add(this.camera);
+        this.camera.position.set(0, 40 * this.playerModel.scale, 30 * this.playerModel.scale);
       }
       this.camera.updateProjectionMatrix();
     });
   }
+  // 初始化轨道控制
   setControls() {
     this.controls.enableZoom = this.enableZoom;
-    this.controls.rotateSpeed = this.mouseSensity * 0.05;
+    this.controls.rotateSpeed = this.mouseSensitivity * 0.05;
     this.controls.maxPolarAngle = Math.PI * (300 / 360);
     this.controls.mouseButtons = { LEFT: 0, MIDDLE: 1, RIGHT: 2 };
   }
+  // 重置轨道控制
   resetControls() {
     if (!this.controls) return;
     this.controls.enabled = true;
@@ -1512,214 +1487,131 @@ var PlayerController = class {
     this.controls.enableZoom = true;
     this.controls.mouseButtons = { LEFT: 0, MIDDLE: 1, RIGHT: 2 };
   }
+  // 视角旋转处理
   setToward(dx, dy, speed) {
-    if (this.controllerMode == 0) {
+    const sens = this.mouseSensitivity;
+    if (this.controllerMode === 0) {
       if (this.isFirstPerson) {
         if (this.isMovingToBoardingPoint) return;
-        const yaw = -dx * speed * this.mouseSensity;
-        const pitch = -dy * speed * this.mouseSensity;
-        this.player.rotateY(yaw);
-        this.camera.rotation.x = THREE3.MathUtils.clamp(
-          this.camera.rotation.x + pitch,
-          -1.1,
-          1.4
-        );
+        this.player.rotateY(-dx * speed * sens);
+        this.camera.rotation.x = THREE4.MathUtils.clamp(this.camera.rotation.x + -dy * speed * sens, -1.1, 1.4);
       } else {
-        const sensitivity = this.mouseSensity;
-        const deltaX = -dx * speed * sensitivity;
-        const deltaY = -dy * speed * sensitivity;
-        const target = this.player.position.clone();
-        const distance = this.camera.position.distanceTo(target);
-        const currentPosition = this.camera.position.clone().sub(target);
-        let theta = Math.atan2(currentPosition.x, currentPosition.z);
-        let phi = Math.acos(currentPosition.y / distance);
-        theta += deltaX;
-        phi += deltaY;
-        phi = Math.max(0.1, Math.min(Math.PI - 0.1, phi));
-        const newX = distance * Math.sin(phi) * Math.sin(theta);
-        const newY = distance * Math.cos(phi);
-        const newZ = distance * Math.sin(phi) * Math.cos(theta);
-        this.camera.position.set(
-          target.x + newX,
-          target.y + newY,
-          target.z + newZ
-        );
-        this.camera.lookAt(target);
+        this.orbitCamera(this.player.position, -dx * speed * sens, -dy * speed * sens);
       }
     } else {
       const v = this.activeVehicle;
       if (!v) return;
       if (this.isFirstPerson) {
-        const yaw = -dx * speed * this.mouseSensity;
-        const pitch = -dy * speed * this.mouseSensity;
-        this.camera.rotation.y = THREE3.MathUtils.clamp(
-          this.camera.rotation.y + yaw,
-          Math.PI * (3 / 4),
-          Math.PI * (5 / 4)
-        );
-        this.camera.rotation.x = THREE3.MathUtils.clamp(
-          this.camera.rotation.x + pitch,
-          0,
-          Math.PI * (1 / 3)
-        );
+        this.camera.rotation.y = THREE4.MathUtils.clamp(this.camera.rotation.y + -dx * speed * sens, Math.PI * (3 / 4), Math.PI * (5 / 4));
+        this.camera.rotation.x = THREE4.MathUtils.clamp(this.camera.rotation.x + -dy * speed * sens, 0, Math.PI * (1 / 3));
       } else {
-        const sensitivity = this.mouseSensity;
-        const deltaX = -dx * speed * sensitivity;
-        const deltaY = -dy * speed * sensitivity;
-        const target = v.vehicleGroup.position.clone();
-        const distance = this.camera.position.distanceTo(target);
-        const currentPosition = this.camera.position.clone().sub(target);
-        let theta = Math.atan2(currentPosition.x, currentPosition.z);
-        let phi = Math.acos(currentPosition.y / distance);
-        theta += deltaX;
-        phi += deltaY;
-        phi = Math.max(0.1, Math.min(Math.PI - 0.1, phi));
-        const newX = distance * Math.sin(phi) * Math.sin(theta);
-        const newY = distance * Math.cos(phi);
-        const newZ = distance * Math.sin(phi) * Math.cos(theta);
-        this.camera.position.set(
-          target.x + newX,
-          target.y + newY,
-          target.z + newZ
-        );
-        this.camera.lookAt(target);
+        this.orbitCamera(v.vehicleGroup.position, -dx * speed * sens, -dy * speed * sens);
       }
     }
   }
+  // 球面轨道旋转
+  orbitCamera(target, deltaX, deltaY) {
+    const distance = this.camera.position.distanceTo(target);
+    const cur = this.camera.position.clone().sub(target);
+    let theta = Math.atan2(cur.x, cur.z) + deltaX;
+    let phi = Math.acos(THREE4.MathUtils.clamp(cur.y / distance, -1, 1)) + deltaY;
+    phi = Math.max(0.1, Math.min(Math.PI - 0.1, phi));
+    this.camera.position.set(
+      target.x + distance * Math.sin(phi) * Math.sin(theta),
+      target.y + distance * Math.cos(phi),
+      target.z + distance * Math.sin(phi) * Math.cos(theta)
+    );
+    this.camera.lookAt(target);
+  }
+  // ==================== 碰撞体构建 ====================
+  // 补全几何属性
+  ensureAttributesMinimal(geom) {
+    if (!geom.attributes.position) return null;
+    if (!geom.attributes.normal) geom.computeVertexNormals();
+    if (!geom.attributes.uv) {
+      const count = geom.attributes.position.count;
+      geom.setAttribute("uv", new THREE4.BufferAttribute(new Float32Array(count * 2), 2));
+    }
+    return geom;
+  }
+  // 统一几何属性格式
   unifiedAttribute(collected) {
     const attrMap = /* @__PURE__ */ new Map();
     const attrConflict = /* @__PURE__ */ new Set();
-    const requiredAttrs = /* @__PURE__ */ new Set(["position", "normal", "uv"]);
-    for (const g of collected) {
-      const attrNames2 = Object.keys(g.attributes);
-      for (const name of attrNames2) {
-        if (!requiredAttrs.has(name)) {
-          g.deleteAttribute(name);
-        }
-      }
-    }
+    const required = /* @__PURE__ */ new Set(["position", "normal", "uv"]);
+    for (const g of collected)
+      for (const name of Object.keys(g.attributes))
+        if (!required.has(name)) g.deleteAttribute(name);
     for (const g of collected) {
       for (const name of Object.keys(g.attributes)) {
         const attr = g.attributes[name];
         const ctor = attr.array.constructor;
-        const itemSize = attr.itemSize;
-        const normalized = attr.normalized;
         if (!attrMap.has(name)) {
-          attrMap.set(name, {
-            itemSize,
-            arrayCtor: ctor,
-            examples: 1,
-            normalized
-          });
+          attrMap.set(name, { itemSize: attr.itemSize, arrayCtor: ctor, examples: 1, normalized: attr.normalized });
         } else {
           const m = attrMap.get(name);
-          if (m.itemSize !== itemSize || m.arrayCtor !== ctor || m.normalized !== normalized) {
-            attrConflict.add(name);
-          } else {
-            m.examples++;
-          }
+          if (m.itemSize !== attr.itemSize || m.arrayCtor !== ctor || m.normalized !== attr.normalized) attrConflict.add(name);
+          else m.examples++;
         }
       }
     }
-    if (attrConflict.size) {
-      for (const g of collected) {
-        for (const name of Array.from(attrConflict)) {
-          if (g.attributes[name]) g.deleteAttribute(name);
-        }
-      }
-      for (const name of attrConflict) attrMap.delete(name);
+    for (const name of attrConflict) {
+      for (const g of collected) if (g.attributes[name]) g.deleteAttribute(name);
+      attrMap.delete(name);
     }
-    const attrNames = Array.from(attrMap.keys());
-    for (const g of collected) {
-      const count = g.attributes.position.count;
-      for (const name of attrNames) {
+    for (const [name, meta] of attrMap) {
+      for (const g of collected) {
         if (!g.attributes[name]) {
-          const meta = attrMap.get(name);
-          const len = count * meta.itemSize;
-          const array = new meta.arrayCtor(len);
-          g.setAttribute(
-            name,
-            new THREE3.BufferAttribute(
-              array,
-              meta.itemSize,
-              meta.normalized
-            )
-          );
+          const count = g.attributes.position.count;
+          g.setAttribute(name, new THREE4.BufferAttribute(new meta.arrayCtor(count * meta.itemSize), meta.itemSize, meta.normalized));
         }
       }
     }
     return collected;
   }
+  // 构建静态 BVH
   async createBVH(meshUrl = "") {
     await this.initLoader();
+    const collectMesh = (mesh) => {
+      try {
+        let geom = mesh.geometry.clone();
+        geom.applyMatrix4(mesh.matrixWorld);
+        if (geom.index) geom = geom.toNonIndexed();
+        const safe = this.ensureAttributesMinimal(geom);
+        if (safe) this.collected.push(safe);
+      } catch (e) {
+        console.warn("\u5904\u7406\u7F51\u683C\u65F6\u51FA\u9519\uFF1A", mesh, e);
+      }
+    };
     if (meshUrl === "") {
       if (this.collider) {
         this.scene.remove(this.collider);
         this.collider = null;
       }
       this.scene.traverse((c) => {
-        const mesh = c;
-        if (mesh?.isMesh && mesh.geometry && c.name !== "capsule") {
-          try {
-            let geom = mesh.geometry.clone();
-            geom.applyMatrix4(mesh.matrixWorld);
-            if (geom.index) geom = geom.toNonIndexed();
-            const safe = this.ensureAttributesMinimal(geom);
-            if (safe) this.collected.push(safe);
-          } catch (e) {
-            console.warn("\u5904\u7406\u7F51\u683C\u65F6\u51FA\u9519\uFF1A", mesh, e);
-          }
-        }
+        const m = c;
+        if (m?.isMesh && m.geometry && c.name !== "capsule") collectMesh(m);
       });
-      if (!this.collected.length) return;
-      this.collected = this.unifiedAttribute(this.collected);
     } else {
       const gltf = await this.loader.loadAsync(meshUrl);
-      const obj = gltf.scene.children[0];
-      if (obj && obj?.geometry) {
-        const mesh = obj;
-        let geom = mesh.geometry.clone();
-        geom.applyMatrix4(mesh.matrixWorld);
-        if (geom.index) geom = geom.toNonIndexed();
-        const safe = this.ensureAttributesMinimal(geom);
-        if (safe) this.collected.push(safe);
+      const root = gltf.scene.children[0];
+      if (root?.geometry) {
+        collectMesh(root);
       } else {
-        obj.traverse((c) => {
-          const mesh = c;
-          if (mesh?.isMesh && mesh.geometry && c.name !== "capsule") {
-            try {
-              let geom = mesh.geometry.clone();
-              geom.applyMatrix4(mesh.matrixWorld);
-              if (geom.index) geom = geom.toNonIndexed();
-              const safe = this.ensureAttributesMinimal(geom);
-              if (safe) this.collected.push(safe);
-            } catch (e) {
-              console.warn("\u5904\u7406\u7F51\u683C\u65F6\u51FA\u9519\uFF1A", mesh, e);
-            }
-          }
+        root?.traverse((c) => {
+          if (c?.isMesh && c.geometry && c.name !== "capsule") collectMesh(c);
         });
-        if (!this.collected.length) return;
-        this.collected = this.unifiedAttribute(this.collected);
       }
     }
-    const merged = BufferGeometryUtils.mergeGeometries(
-      this.collected,
-      false
-    );
+    if (!this.collected.length) return;
+    this.collected = this.unifiedAttribute(this.collected);
+    const merged = BufferGeometryUtils.mergeGeometries(this.collected, false);
     if (!merged) {
       console.error("\u5408\u5E76\u51E0\u4F55\u5931\u8D25");
       return;
     }
     merged.boundsTree = new MeshBVH(merged, { maxDepth: 100 });
-    this.collider = new THREE3.Mesh(
-      merged,
-      new THREE3.MeshBasicMaterial({
-        opacity: 0.5,
-        transparent: true,
-        wireframe: true,
-        depthTest: true
-      })
-    );
+    this.collider = new THREE4.Mesh(merged, new THREE4.MeshBasicMaterial({ opacity: 0.5, transparent: true, wireframe: true, depthTest: true }));
     if (this.displayCollider) this.scene.add(this.collider);
     if (this.displayVisualizer) {
       if (this.visualizer) this.scene.remove(this.visualizer);
@@ -1728,165 +1620,108 @@ var PlayerController = class {
     }
     this.boundingBoxMinY = this.collider.geometry.boundingBox.min.y;
   }
+  // 构建动态 BVH
   createDynamicBVH(objects = []) {
     if (this.dynamicCollider) {
       this.scene.remove(this.dynamicCollider);
       this.dynamicCollider = null;
     }
     this.dynamicCollected = [];
-    objects.forEach((object) => {
-      object.traverse((c) => {
-        const mesh = c;
-        if (mesh?.isMesh && mesh.geometry && c.name !== "capsule") {
-          try {
-            let geom = mesh.geometry.clone();
-            geom.applyMatrix4(mesh.matrixWorld);
-            if (geom.index) geom = geom.toNonIndexed();
-            const safe = this.ensureAttributesMinimal(geom);
-            if (safe) this.dynamicCollected.push(safe);
-          } catch (e) {
-            console.warn("\u5904\u7406\u7F51\u683C\u65F6\u51FA\u9519\uFF1A", mesh, e);
-          }
+    objects.forEach((obj) => obj.traverse((c) => {
+      const m = c;
+      if (m?.isMesh && m.geometry && c.name !== "capsule") {
+        try {
+          let geom = m.geometry.clone();
+          geom.applyMatrix4(m.matrixWorld);
+          if (geom.index) geom = geom.toNonIndexed();
+          const safe = this.ensureAttributesMinimal(geom);
+          if (safe) this.dynamicCollected.push(safe);
+        } catch (e) {
+          console.warn("\u5904\u7406\u7F51\u683C\u65F6\u51FA\u9519\uFF1A", m, e);
         }
-      });
-    });
+      }
+    }));
     if (!this.dynamicCollected.length) return;
     this.dynamicCollected = this.unifiedAttribute(this.dynamicCollected);
-    const merged = BufferGeometryUtils.mergeGeometries(
-      this.dynamicCollected,
-      false
-    );
+    const merged = BufferGeometryUtils.mergeGeometries(this.dynamicCollected, false);
     if (!merged) {
       console.error("\u5408\u5E76\u51E0\u4F55\u5931\u8D25");
       return;
     }
     merged.boundsTree = new MeshBVH(merged);
-    this.dynamicCollider = new THREE3.Mesh(
-      merged,
-      new THREE3.MeshBasicMaterial({
-        opacity: 0.5,
-        transparent: true,
-        wireframe: true,
-        depthTest: true
-      })
-    );
+    this.dynamicCollider = new THREE4.Mesh(merged, new THREE4.MeshBasicMaterial({ opacity: 0.5, transparent: true, wireframe: true, depthTest: true }));
     if (this.displayCollider) this.scene.add(this.dynamicCollider);
   }
-  getAngleWithYAxis(normal) {
-    const yAxis = { x: 0, y: 1, z: 0 };
-    const dotProduct = normal.x * yAxis.x + normal.y * yAxis.y + normal.z * yAxis.z;
-    const normalMagnitude = Math.sqrt(
-      normal.x * normal.x + normal.y * normal.y + normal.z * normal.z
-    );
-    const cosTheta = dotProduct / normalMagnitude;
-    return Math.acos(cosTheta);
-  }
-  // ==================== 设置控制器过渡 ====================
+  // ==================== 控制器过渡 ====================
+  // 车辆切换过渡
   setControllerTransition() {
     if (this.isChangeControllerTransitionTimer) {
       clearTimeout(this.isChangeControllerTransitionTimer);
       this.isChangeControllerTransitionTimer = null;
     }
-    let vGroups = [];
-    for (const v of this.vehicles) {
-      vGroups.push(v.vehicleGroup);
-    }
+    const vGroups = this.vehicles.map((v) => v.vehicleGroup);
     this.createDynamicBVH(vGroups);
     this.isChangeControllerTransitionTimer = setTimeout(() => {
       this.isChangeControllerTransitionTimer = null;
-      for (const v of this.vehicles) {
-        this.clearVehicleVelocity(v);
-      }
+      this.vehicles.forEach((v) => this.clearVehicleVelocity(v));
       this.createDynamicBVH(vGroups);
     }, 3e3);
   }
-  // 清除车辆速度
+  // 清零车辆速度
   clearVehicleVelocity(v) {
     if (!v || !this.world || !this.RAPIER) return;
     const { chassisBody, vehicleController } = v;
     const ZERO = new this.RAPIER.Vector3(0, 0, 0);
     chassisBody.setLinvel(ZERO, true);
     chassisBody.setAngvel(ZERO, true);
-    const BIG_BRAKE = 1e6;
     for (let i = 0; i < 4; i++) {
       vehicleController.setWheelEngineForce(i, 0);
-      vehicleController.setWheelBrake(i, BIG_BRAKE);
+      vehicleController.setWheelBrake(i, 1e6);
     }
     vehicleController.updateVehicle(1 / 60);
     this.world.timestep = 1 / 60;
     this.world.step();
     chassisBody.setLinvel(ZERO, true);
     chassisBody.setAngvel(ZERO, true);
-    for (let i = 0; i < 4; i++) {
-      vehicleController.setWheelBrake(i, 0);
-    }
+    for (let i = 0; i < 4; i++) vehicleController.setWheelBrake(i, 0);
   }
   // ==================== 循环更新 ====================
+  // 主循环更新
   async update(delta = clock.getDelta()) {
     if (!this.isupdate || !this.player || !this.collider) return;
     delta = Math.min(delta, 1 / 40);
-    if (this.controllerMode == 1) {
+    if (this.controllerMode === 1) {
       this.updateVehicle(delta);
     } else {
       this.updatePlayer(delta);
-      if (this.isChangeControllerTransitionTimer)
-        this.updateVehicleInertia(delta);
+      if (this.isChangeControllerTransitionTimer) this.updateVehicleInertia(delta);
     }
   }
-  /**
-   * 更新当前驾驶的车辆
-   */
+  // 车辆帧更新
   updateVehicle(delta) {
     const v = this.activeVehicle;
     if (!v || !this.world) return;
     const { vehicleController, chassisBody, vehicleGroup } = v;
     const rotation = chassisBody.rotation();
-    const quat = new THREE3.Quaternion(
-      rotation.x,
-      rotation.y,
-      rotation.z,
-      rotation.w
-    );
-    const forward = new THREE3.Vector3(1, 0, 0).applyQuaternion(quat);
+    const quat = new THREE4.Quaternion(rotation.x, rotation.y, rotation.z, rotation.w);
+    const forward = new THREE4.Vector3(1, 0, 0).applyQuaternion(quat);
     const slopeAngle = Math.asin(forward.y);
-    let factor = 1;
-    if (slopeAngle < -0.05 && this.fwdPressed) factor = -Math.sin(slopeAngle) * 10;
+    const factor = slopeAngle < -0.05 && this.fwdPressed ? -Math.sin(slopeAngle) * 10 : 1;
     const accelerateForce = this.vehicleParams.power.accelerateForce * v.speedMultiplier;
     const maxSpeed = this.vehicleParams.power.maxSpeed * v.speedMultiplier;
-    const engineForce = (Number(this.fwdPressed) * accelerateForce - Number(this.bkdPressed) * accelerateForce) * factor;
-    vehicleController.setWheelEngineForce(0, engineForce);
-    vehicleController.setWheelEngineForce(1, engineForce);
-    vehicleController.setWheelEngineForce(2, engineForce);
-    vehicleController.setWheelEngineForce(3, engineForce);
+    const engineForce = (Number(this.fwdPressed) - Number(this.bkdPressed)) * accelerateForce * factor;
+    for (let i = 0; i < 4; i++) vehicleController.setWheelEngineForce(i, engineForce);
     const wheelBrake = Number(this.spacePressed) * this.vehicleParams.power.brakeForce * delta;
-    vehicleController.setWheelBrake(0, wheelBrake);
-    vehicleController.setWheelBrake(1, wheelBrake);
-    vehicleController.setWheelBrake(2, wheelBrake);
-    vehicleController.setWheelBrake(3, wheelBrake);
+    for (let i = 0; i < 4; i++) vehicleController.setWheelBrake(i, wheelBrake);
     const currentSteering = vehicleController.wheelSteering(0) || 0;
-    const steerDirection = Number(this.lftPressed) - Number(this.rgtPressed);
-    let steerSpeed;
-    if (steerDirection === 0) {
-      steerSpeed = this.vehicleParams.steering.steerReturnSpeed || 0.15;
-    } else {
-      steerSpeed = this.vehicleParams.steering.steerSpeed || 0.08;
-    }
-    const steerLerpFactor = 1 - Math.pow(1 - steerSpeed, delta);
-    const targetSteering = this.vehicleParams.steering.maxSteerAngle * steerDirection;
-    const steering = THREE3.MathUtils.lerp(
-      currentSteering,
-      targetSteering,
-      steerLerpFactor
-    );
+    const steerDir = Number(this.lftPressed) - Number(this.rgtPressed);
+    const steerSpeed = steerDir === 0 ? this.vehicleParams.steering.steerReturnSpeed : this.vehicleParams.steering.steerSpeed;
+    const steering = THREE4.MathUtils.lerp(currentSteering, this.vehicleParams.steering.maxSteerAngle * steerDir, 1 - Math.pow(1 - steerSpeed, delta));
     vehicleController.setWheelSteering(0, steering);
     vehicleController.setWheelSteering(1, steering);
-    if ((this.rgtPressed || this.lftPressed) && this.shiftPressed) {
-      vehicleController.setWheelSideFrictionStiffness(2, 0.5);
-      vehicleController.setWheelSideFrictionStiffness(3, 0.5);
-    } else {
-      vehicleController.setWheelSideFrictionStiffness(2, 2);
-      vehicleController.setWheelSideFrictionStiffness(3, 2);
-    }
+    const driftFriction = (this.rgtPressed || this.lftPressed) && this.shiftPressed ? 0.5 : 2;
+    vehicleController.setWheelSideFrictionStiffness(2, driftFriction);
+    vehicleController.setWheelSideFrictionStiffness(3, driftFriction);
     this.updateVehicleInertia(delta);
     if (!this.isFirstPerson) {
       const lookTarget = vehicleGroup.position.clone();
@@ -1895,99 +1730,49 @@ var PlayerController = class {
       this.camera.position.add(lookTarget);
       this.controls.update();
       const velocity = chassisBody.linvel();
-      const currentSpeed = Math.sqrt(
-        velocity.x * velocity.x + velocity.y * velocity.y + velocity.z * velocity.z
-      );
+      const currentSpeed = new THREE4.Vector3(velocity.x, velocity.y, velocity.z).length();
       const speedRatio = Math.min(currentSpeed / maxSpeed, 1);
-      const baseCamDistance = v.size.l * 0.8;
-      const maxCamDistanceLimit = v.size.l * 5;
-      const targetDistance = THREE3.MathUtils.lerp(
-        baseCamDistance,
-        maxCamDistanceLimit,
-        speedRatio
-      );
-      this._personToCam.subVectors(
-        this.camera.position,
-        vehicleGroup.position
-      );
-      const origin = vehicleGroup.position.clone().add(new THREE3.Vector3(0, 0, 0));
-      const direction = this._personToCam.clone().normalize();
-      const desiredDist = targetDistance;
-      this._raycasterPersonToCam.set(origin, direction);
-      this._raycasterPersonToCam.far = desiredDist;
-      const intersects = this._raycasterPersonToCam.intersectObject(
-        this.collider,
-        false
-      );
-      if (intersects.length > 0) {
-        const hit = intersects[0];
-        const safeDist = Math.max(
-          hit.distance - this._camEpsilon,
-          this.minCamDistance
-        );
-        const targetCamPos = origin.clone().add(direction.clone().multiplyScalar(safeDist));
-        this.camera.position.lerp(targetCamPos, this._camCollisionLerp);
+      const baseDist = v.size.l * 0.8;
+      const maxDist = v.size.l * 5;
+      const desiredDist = THREE4.MathUtils.lerp(baseDist, maxDist, speedRatio);
+      const minSafeDist = baseDist;
+      this.personToCam.subVectors(this.camera.position, vehicleGroup.position);
+      const direction = this.personToCam.clone().normalize();
+      this.raycasterPersonToCam.set(vehicleGroup.position, direction);
+      this.raycasterPersonToCam.far = desiredDist;
+      const hits = this.raycasterPersonToCam.intersectObject(this.collider, false);
+      if (hits.length > 0) {
+        const safeDist = Math.max(hits[0].distance - this.camEpsilon, minSafeDist);
+        this.camera.position.lerp(vehicleGroup.position.clone().add(direction.clone().multiplyScalar(safeDist)), this.camCollisionLerp);
       } else {
-        this._raycasterPersonToCam.far = maxCamDistanceLimit;
-        const intersectsMaxDis = this._raycasterPersonToCam.intersectObject(
-          this.collider,
-          false
-        );
-        let safeDist = desiredDist;
-        if (intersectsMaxDis.length) {
-          const hitMax = intersectsMaxDis[0];
-          safeDist = Math.min(
-            desiredDist,
-            hitMax.distance - this._camEpsilon
-          );
-        }
-        const targetCamPos = origin.clone().add(direction.clone().multiplyScalar(safeDist));
-        this.camera.position.lerp(targetCamPos, this._camCollisionLerp);
+        this.raycasterPersonToCam.far = maxDist;
+        const maxHits = this.raycasterPersonToCam.intersectObject(this.collider, false);
+        const safeDist = maxHits.length > 0 ? Math.min(desiredDist, maxHits[0].distance - this.camEpsilon) : desiredDist;
+        this.camera.position.lerp(vehicleGroup.position.clone().add(direction.clone().multiplyScalar(safeDist)), this.camCollisionLerp);
       }
       if ((this.fwdPressed || this.bkdPressed) && this.vehicleParams.followVehicleDirection) {
         const vel = chassisBody.linvel();
-        const velHorizontal = new THREE3.Vector3(vel.x, vel.y, vel.z);
-        const velSpeed = velHorizontal.length();
-        if (velSpeed > 0.3) {
-          const targetBehindDir = velHorizontal.clone().normalize().negate();
-          this.camBehindDir.lerp(targetBehindDir, this._camCollisionLerp).normalize();
-          const camHeightOffset = v.size.h;
-          const targetCamPos = lookTarget.clone().add(
-            this.camBehindDir.clone().multiplyScalar(desiredDist)
-          ).add(new THREE3.Vector3(0, camHeightOffset, 0));
-          this.camera.position.lerp(
-            targetCamPos,
-            this._camCollisionLerp
-          );
+        const velVec = new THREE4.Vector3(vel.x, vel.y, vel.z);
+        if (velVec.length() > 0.3) {
+          this.camBehindDir.lerp(velVec.normalize().negate(), this.camCollisionLerp).normalize();
+          const targetCamPos = lookTarget.clone().add(this.camBehindDir.clone().multiplyScalar(desiredDist)).add(new THREE4.Vector3(0, v.size.h, 0));
+          this.camera.position.lerp(targetCamPos, this.camCollisionLerp);
           this.controls.update();
         }
       }
     }
     const vehicleUp = this.upVector.clone().applyQuaternion(vehicleGroup.quaternion);
-    const angleWithUp = vehicleUp.angleTo(this.upVector);
-    if (angleWithUp > Math.PI / 2) {
-      const size = new THREE3.Vector3();
+    if (vehicleUp.angleTo(this.upVector) > Math.PI / 2) {
+      const size = new THREE4.Vector3();
       v.vehicleBBox?.getSize(size);
-      const translation2 = chassisBody.translation();
-      chassisBody.setTranslation(
-        new this.RAPIER.Vector3(
-          translation2.x,
-          translation2.y + size.y,
-          translation2.z
-        ),
-        true
-      );
-      chassisBody.setRotation(
-        new this.RAPIER.Quaternion(0, 0, 0, 1),
-        true
-      );
+      const t = chassisBody.translation();
+      chassisBody.setTranslation(new this.RAPIER.Vector3(t.x, t.y + size.y, t.z), true);
+      chassisBody.setRotation(new this.RAPIER.Quaternion(0, 0, 0, 1), true);
       chassisBody.setLinvel(new this.RAPIER.Vector3(0, 0, 0), true);
       chassisBody.setAngvel(new this.RAPIER.Vector3(0, 0, 0), true);
     }
   }
-  /**
-   * 更新所有车辆物理和位置
-   */
+  // 物理步进 & 同步
   updateVehicleInertia(delta) {
     if (!this.world) return;
     this.world.timestep = delta;
@@ -1996,41 +1781,21 @@ var PlayerController = class {
       const { vehicleController, chassisBody, vehicleGroup, updateWheelVisuals } = v;
       vehicleController.updateVehicle(delta);
       if (chassisBody.isSleeping()) continue;
-      const velocity = chassisBody.linvel();
-      const currentSpeed = Math.sqrt(
-        velocity.x * velocity.x + velocity.y * velocity.y + velocity.z * velocity.z
-      );
-      const maxSpeed = this.vehicleParams.power.maxSpeed * v.speedMultiplier;
-      if (currentSpeed > maxSpeed) {
-        const s = maxSpeed / currentSpeed;
-        chassisBody.setLinvel(
-          new this.RAPIER.Vector3(
-            velocity.x * s,
-            velocity.y * s,
-            velocity.z * s
-          ),
-          true
-        );
+      const vel = chassisBody.linvel();
+      const speed = new THREE4.Vector3(vel.x, vel.y, vel.z).length();
+      const max = this.vehicleParams.power.maxSpeed * v.speedMultiplier;
+      if (speed > max) {
+        const s = max / speed;
+        chassisBody.setLinvel(new this.RAPIER.Vector3(vel.x * s, vel.y * s, vel.z * s), true);
       }
-      const translation = chassisBody.translation();
-      const rotationSync = chassisBody.rotation();
-      vehicleGroup.position.set(
-        translation.x,
-        translation.y,
-        translation.z
-      );
-      vehicleGroup.quaternion.set(
-        rotationSync.x,
-        rotationSync.y,
-        rotationSync.z,
-        rotationSync.w
-      );
-      if (updateWheelVisuals) updateWheelVisuals();
+      const t = chassisBody.translation();
+      const r = chassisBody.rotation();
+      vehicleGroup.position.set(t.x, t.y, t.z);
+      vehicleGroup.quaternion.set(r.x, r.y, r.z, r.w);
+      updateWheelVisuals?.();
     }
   }
-  /**
-   * 设置人物缩放
-   */
+  // 缩放玩家比例
   setPlayerScale(newScale) {
     if (newScale <= 0) return;
     const ratio = newScale / this.playerModel.scale;
@@ -2040,7 +1805,7 @@ var PlayerController = class {
     this.playerSpeed *= ratio;
     this.playerFlySpeed *= ratio;
     this.curPlayerSpeed *= ratio;
-    this._camEpsilon *= ratio;
+    this.camEpsilon *= ratio;
     this.minCamDistance *= ratio;
     this.maxCamDistance *= ratio;
     this.orginMaxCamDistance *= ratio;
@@ -2049,38 +1814,32 @@ var PlayerController = class {
     if (this.player?.capsuleInfo) this.player.capsuleInfo.radius *= ratio;
     if (this.isFirstPerson) this.setFirstPersonCamera();
   }
-  /**
-   * 更新人物
-   */
+  // 玩家帧更新
   updatePlayer(delta) {
-    if (this.isMovingToBoardingPoint) {
-      this.updateMoveToBoardingPoint(delta);
-    }
-    if (!this.isFlying) {
-      this.player.position.addScaledVector(this.playerVelocity, delta);
-    }
+    if (this.isMovingToBoardingPoint) this.updateMoveToBoardingPoint(delta);
+    if (!this.isFlying) this.player.position.addScaledVector(this.playerVelocity, delta);
     if (this.isBoardingAnimPlaying) {
       const action = this.personActions?.get("enterCar");
-      const duration = action.getClip().duration;
-      const timeScale = action.getEffectiveTimeScale();
-      const remaining = (duration - action.time) / timeScale * 1e3;
-      if (!this.closeDoorTriggered && remaining <= 500) {
-        this.closeDoorTriggered = true;
-        this.openVehicleDoor(false);
-      }
-      if (action.time >= duration) {
-        this.isBoardingAnimPlaying = false;
-        this.closeDoorTriggered = false;
-        this.onEnterCarAnimFinished();
-        return;
+      if (action) {
+        const duration = action.getClip().duration;
+        const remaining = (duration - action.time) / action.getEffectiveTimeScale() * 1e3;
+        if (!this.closeDoorTriggered && remaining <= 500) {
+          this.closeDoorTriggered = true;
+          this.openVehicleDoor(false);
+        }
+        if (action.time >= duration) {
+          this.isBoardingAnimPlaying = false;
+          this.closeDoorTriggered = false;
+          this.onEnterCarAnimFinished();
+          return;
+        }
       }
     }
     if (this.isExitAnimPlaying) {
       const action = this.personActions?.get("exitCar");
       if (action) {
         const duration = action.getClip().duration;
-        const timeScale = action.getEffectiveTimeScale();
-        const remaining = (duration - action.time) / timeScale * 1e3;
+        const remaining = (duration - action.time) / action.getEffectiveTimeScale() * 1e3;
         if (!this.closeExitDoorTriggered && remaining <= 500) {
           this.closeExitDoorTriggered = true;
           this.openVehicleDoor(false);
@@ -2094,71 +1853,47 @@ var PlayerController = class {
     this.updateMixers(delta);
     if (this.controllerMode === 1) return;
     this.camera.getWorldDirection(this.camDir);
-    let angle = Math.atan2(this.camDir.z, this.camDir.x) + Math.PI / 2;
-    angle = 2 * Math.PI - angle;
+    const angle = 2 * Math.PI - (Math.atan2(this.camDir.z, this.camDir.x) + Math.PI / 2);
     this.moveDir.set(0, 0, 0);
     if (this.fwdPressed) this.moveDir.add(this.DIR_FWD);
     if (this.bkdPressed) this.moveDir.add(this.DIR_BKD);
     if (this.lftPressed) this.moveDir.add(this.DIR_LFT);
     if (this.rgtPressed) this.moveDir.add(this.DIR_RGT);
     if (this.isFlying) {
-      if (this.fwdPressed) this.moveDir.y = this.camDir.y;
-      else this.moveDir.y = 0;
+      this.moveDir.y = this.fwdPressed ? this.camDir.y : 0;
       if (this.spacePressed) this.moveDir.add(this.DIR_UP);
-    }
-    if (this.isFlying && this.fwdPressed) {
       this.curPlayerSpeed = this.shiftPressed ? this.playerFlySpeed * 2 : this.playerFlySpeed;
     } else {
       this.curPlayerSpeed = this.shiftPressed ? this.playerSpeed * 2 : this.playerSpeed;
     }
     this.moveDir.normalize().applyAxisAngle(this.upVector, angle);
-    this.player.position.addScaledVector(
-      this.moveDir,
-      this.curPlayerSpeed * delta
-    );
-    let playerDistanceFromGround = Infinity;
-    this._originTmp.set(
-      this.player.position.x,
-      this.player.position.y,
-      this.player.position.z
-    );
-    this._raycaster.ray.origin.copy(this._originTmp);
-    const intersects = this._raycaster.intersectObject(
-      this.collider,
-      false
-    );
-    if (intersects.length > 0) {
-      playerDistanceFromGround = this.player.position.y - intersects[0].point.y;
-      const maxH = this.playerCapsuleHeight * this.playerModel.scale * 0.9;
-      const h = this.playerCapsuleHeight * this.playerModel.scale * 0.75;
-      const minH = this.playerCapsuleHeight * this.playerModel.scale * 0.7;
-      if (!this.isFlying) {
-        if (playerDistanceFromGround >= maxH) {
-          this.playerVelocity.y += delta * this.gravity;
-          this.player.position.addScaledVector(
-            this.playerVelocity,
-            delta
-          );
-          this.playerIsOnGround = false;
-        } else if (playerDistanceFromGround >= h && playerDistanceFromGround < maxH) {
-          if (!this.spacePressed) {
-            this.playerVelocity.set(0, 0, 0);
-            this.playerIsOnGround = true;
-            this.player.position.y = intersects[0].point.y + h;
-          }
-        } else if (playerDistanceFromGround >= minH && playerDistanceFromGround < h) {
-          this.playerVelocity.set(0, 0, 0);
-          this.playerIsOnGround = true;
-          this.player.position.y = intersects[0].point.y + h;
-        } else if (playerDistanceFromGround < minH) {
+    this.player.position.addScaledVector(this.moveDir, this.curPlayerSpeed * delta);
+    this.raycaster.ray.origin.copy(this.player.position);
+    const hits = this.raycaster.intersectObject(this.collider, false);
+    if (hits.length > 0 && !this.isFlying) {
+      const dist = this.player.position.y - hits[0].point.y;
+      const s = this.playerModel.scale;
+      const maxH = this.playerCapsuleHeight * s * 0.9;
+      const h = this.playerCapsuleHeight * s * 0.75;
+      const minH = this.playerCapsuleHeight * s * 0.7;
+      if (dist >= maxH) {
+        this.playerVelocity.y += delta * this.gravity;
+        this.player.position.addScaledVector(this.playerVelocity, delta);
+        this.playerIsOnGround = false;
+      } else if (dist >= h && dist < maxH) {
+        if (!this.spacePressed) {
           this.playerVelocity.set(0, 0, 0);
-          this.player.position.set(
-            this.player.position.x,
-            intersects[0].point.y + h,
-            this.player.position.z
-          );
           this.playerIsOnGround = true;
+          this.player.position.y = hits[0].point.y + h;
         }
+      } else if (dist >= minH) {
+        this.playerVelocity.set(0, 0, 0);
+        this.playerIsOnGround = true;
+        this.player.position.y = hits[0].point.y + h;
+      } else {
+        this.playerVelocity.set(0, 0, 0);
+        this.player.position.y = hits[0].point.y + h;
+        this.playerIsOnGround = true;
       }
     }
     this.player.updateMatrixWorld();
@@ -2168,113 +1903,49 @@ var PlayerController = class {
     this.tempSegment.copy(capsuleInfo.segment);
     this.tempSegment.start.applyMatrix4(this.player.matrixWorld).applyMatrix4(this.tempMat);
     this.tempSegment.end.applyMatrix4(this.player.matrixWorld).applyMatrix4(this.tempMat);
-    this.tempBox.expandByPoint(this.tempSegment.start);
-    this.tempBox.expandByPoint(this.tempSegment.end);
+    this.tempBox.expandByPoint(this.tempSegment.start).expandByPoint(this.tempSegment.end);
     this.tempBox.expandByScalar(capsuleInfo.radius);
     if (!this.isMovingToBoardingPoint) {
-      this.collider?.geometry?.boundsTree?.shapecast({
-        intersectsBounds: (box) => box.intersectsBox(this.tempBox),
-        intersectsTriangle: (tri) => {
-          const triPoint = this.tempVector;
-          const capsulePoint = this.tempVector2;
-          const distance = tri.closestPointToSegment(
-            this.tempSegment,
-            triPoint,
-            capsulePoint
-          );
-          if (distance < capsuleInfo.radius) {
-            const normal = tri.getNormal(new THREE3.Vector3());
-            if (normal.y > 0.5 && !this.isFlying) return;
-            const depth = capsuleInfo.radius - distance;
-            const direction = capsulePoint.sub(triPoint).normalize();
-            this.tempSegment.start.addScaledVector(
-              direction,
-              depth
-            );
-            this.tempSegment.end.addScaledVector(direction, depth);
-          }
-        }
-      });
-      this.dynamicCollider?.geometry?.boundsTree?.shapecast({
-        intersectsBounds: (box) => box.intersectsBox(this.tempBox),
-        intersectsTriangle: (tri) => {
-          const triPoint = this.tempVector;
-          const capsulePoint = this.tempVector2;
-          const distance = tri.closestPointToSegment(
-            this.tempSegment,
-            triPoint,
-            capsulePoint
-          );
-          if (distance < capsuleInfo.radius) {
-            const depth = capsuleInfo.radius - distance;
-            const direction = capsulePoint.sub(triPoint).normalize();
-            this.tempSegment.start.addScaledVector(
-              direction,
-              depth
-            );
-            this.tempSegment.end.addScaledVector(direction, depth);
+      const resolveCollision = (collider) => {
+        if (!collider) return;
+        collider.geometry?.boundsTree?.shapecast({
+          intersectsBounds: (box) => box.intersectsBox(this.tempBox),
+          intersectsTriangle: (tri) => {
+            const distance = tri.closestPointToSegment(this.tempSegment, this.tempVector, this.tempVector2);
+            if (distance < capsuleInfo.radius) {
+              const normal = tri.getNormal(new THREE4.Vector3());
+              if (normal.y > 0.5 && !this.isFlying) return;
+              const dir = this.tempVector2.sub(this.tempVector).normalize();
+              const depth = capsuleInfo.radius - distance;
+              this.tempSegment.start.addScaledVector(dir, depth);
+              this.tempSegment.end.addScaledVector(dir, depth);
+            }
           }
-        }
-      });
+        });
+      };
+      resolveCollision(this.collider);
+      resolveCollision(this.dynamicCollider);
     }
-    const newPosition = this.tempVector.copy(this.tempSegment.start).applyMatrix4(this.collider.matrixWorld);
-    const deltaVector = this.tempVector2.subVectors(
-      newPosition,
-      this.player.position
-    );
-    const offset = Math.max(0, deltaVector.length() - 1e-5);
-    deltaVector.normalize().multiplyScalar(offset);
-    this.player.position.add(deltaVector);
-    if (!this.isFirstPerson && !this.isFlying) {
-      this.camDir.y = 0;
-      this.camDir.normalize();
-      this.camDir.negate();
-      this.moveDir.normalize();
-      this.moveDir.negate();
-      let lookTarget;
-      if (this.thirdMouseMode === 0 || this.thirdMouseMode === 2) {
-        if (this.moveDir.lengthSq() > 0) {
-          lookTarget = this.player.position.clone().add(this.moveDir);
-        } else {
-          lookTarget = this.player.position.clone().add(this.camDir);
+    const newPos = this.tempVector.copy(this.tempSegment.start).applyMatrix4(this.collider.matrixWorld);
+    const deltaVec = this.tempVector2.subVectors(newPos, this.player.position);
+    const offset = Math.max(0, deltaVec.length() - 1e-5);
+    this.player.position.add(deltaVec.normalize().multiplyScalar(offset));
+    if (!this.isFirstPerson) {
+      const camDirFlat = this.camDir.clone().setY(0).normalize().negate();
+      const moveDirFlat = this.moveDir.clone().normalize().negate();
+      if (!this.isFlying) {
+        if (this.thirdMouseMode === 0 || this.thirdMouseMode === 2) {
+          const lookTarget = this.player.position.clone().add(moveDirFlat.lengthSq() > 0 ? moveDirFlat : camDirFlat);
+          this.targetMat.lookAt(this.player.position, lookTarget, this.player.up);
+          this.player.quaternion.slerp(this.targetQuat.setFromRotationMatrix(this.targetMat), Math.min(1, this.rotationSpeed * delta));
+        } else if (moveDirFlat.lengthSq() > 0) {
+          this.targetMat.lookAt(this.player.position, this.player.position.clone().add(moveDirFlat), this.player.up);
+          this.player.quaternion.slerp(this.targetQuat.setFromRotationMatrix(this.targetMat), Math.min(1, this.rotationSpeed * delta));
         }
-        this.targetMat.lookAt(
-          this.player.position,
-          lookTarget,
-          this.player.up
-        );
-        this.targetQuat.setFromRotationMatrix(this.targetMat);
-        const alpha = Math.min(1, this.rotationSpeed * delta);
-        this.player.quaternion.slerp(this.targetQuat, alpha);
-      }
-      if ((this.thirdMouseMode === 1 || this.thirdMouseMode === 3) && this.moveDir.lengthSq() > 0) {
-        lookTarget = this.player.position.clone().add(this.moveDir);
-        this.targetMat.lookAt(
-          this.player.position,
-          lookTarget,
-          this.player.up
-        );
-        this.targetQuat.setFromRotationMatrix(this.targetMat);
-        const alpha = Math.min(1, this.rotationSpeed * delta);
-        this.player.quaternion.slerp(this.targetQuat, alpha);
-      }
-    }
-    if (this.isFlying) {
-      if (!this.isFirstPerson) {
-        this.camDir.y = 0;
-        this.camDir.normalize();
-        this.camDir.negate();
-        this.moveDir.normalize();
-        this.moveDir.negate();
-        const lookTarget = this.player.position.clone().add(this.fwdPressed ? this.moveDir : this.camDir);
-        this.targetMat.lookAt(
-          this.player.position,
-          lookTarget,
-          this.player.up
-        );
-        this.targetQuat.setFromRotationMatrix(this.targetMat);
-        const alpha = Math.min(1, this.rotationSpeed * delta);
-        this.player.quaternion.slerp(this.targetQuat, alpha);
+      } else {
+        const lookTarget = this.player.position.clone().add(this.fwdPressed ? moveDirFlat : camDirFlat);
+        this.targetMat.lookAt(this.player.position, lookTarget, this.player.up);
+        this.player.quaternion.slerp(this.targetQuat.setFromRotationMatrix(this.targetMat), Math.min(1, this.rotationSpeed * delta));
       }
     }
     if (!this.isFirstPerson) {
@@ -2285,131 +1956,84 @@ var PlayerController = class {
       this.camera.position.add(lookTarget);
       this.controls.update();
       if (!this.enableZoom) {
-        this._personToCam.subVectors(
-          this.camera.position,
-          this.player.position
-        );
-        const origin = this.player.position.clone();
-        const direction = this._personToCam.clone().normalize();
-        const desiredDist = this._personToCam.length();
-        this._raycasterPersonToCam.set(origin, direction);
-        this._raycasterPersonToCam.far = desiredDist;
-        const intersectsCamera = this._raycasterPersonToCam.intersectObject(
-          this.collider,
-          false
+        this.updateCameraWithRaycast(
+          this.player.position,
+          this.personToCam.subVectors(this.camera.position, this.player.position).length(),
+          this.maxCamDistance
         );
-        if (intersectsCamera.length > 0) {
-          const hit = intersectsCamera[0];
-          const safeDist = Math.max(
-            hit.distance - this._camEpsilon,
-            this.minCamDistance
-          );
-          const targetCamPos = origin.clone().add(direction.clone().multiplyScalar(safeDist));
-          this.camera.position.lerp(
-            targetCamPos,
-            this._camCollisionLerp
-          );
-        } else {
-          this._raycasterPersonToCam.far = this.maxCamDistance;
-          const intersectsMaxDis = this._raycasterPersonToCam.intersectObject(
-            this.collider,
-            false
-          );
-          let safeDist = this.maxCamDistance;
-          if (intersectsMaxDis.length) {
-            const hitMax = intersectsMaxDis[0];
-            safeDist = hitMax.distance - this._camEpsilon;
-          }
-          const targetCamPos = origin.clone().add(direction.clone().multiplyScalar(safeDist));
-          this.camera.position.lerp(
-            targetCamPos,
-            this._camCollisionLerp
-          );
-        }
       }
     }
     if (this.player.position.y < this.boundingBoxMinY - 1) {
-      this._originTmp.set(
+      this.raycaster.ray.origin.set(this.player.position.x, 1e4, this.player.position.z);
+      const fallHits = this.raycaster.intersectObject(this.collider, false);
+      this.reset(new THREE4.Vector3(
         this.player.position.x,
-        1e4,
+        fallHits.length > 0 ? fallHits[0].point.y + 5 : this.player.position.y + 15,
         this.player.position.z
-      );
-      this._raycaster.ray.origin.copy(this._originTmp);
-      const intersectsFall = this._raycaster.intersectObject(
-        this.collider,
-        false
-      );
-      if (intersectsFall.length > 0) {
-        console.log("\u73A9\u5BB6\u4E3Abug\u610F\u5916\u6389\u843D");
-        this.reset(
-          new THREE3.Vector3(
-            this.player.position.x,
-            intersectsFall[0].point.y + 5,
-            this.player.position.z
-          )
-        );
-      } else {
-        console.log("\u73A9\u5BB6\u6B63\u5E38\u6389\u843D");
-        this.reset(
-          new THREE3.Vector3(
-            this.player.position.x,
-            this.player.position.y + 15,
-            this.player.position.z
-          )
-        );
-      }
+      ));
     }
-    if (this.isShowMobileControls) {
-      if (this.vehicles.length) {
-        let near = false;
-        for (const v of this.vehicles) {
-          this.nearCheckLocal.copy(v.boardingPoint).multiplyScalar(v.scale);
-          v.vehicleGroup.localToWorld(
-            this.nearCheckWorld.copy(this.nearCheckLocal)
-          );
-          if (this.player.position.distanceTo(this.nearCheckWorld) < 800 * this.playerModel.scale) {
-            near = true;
-            this.syncVehicleBtnEl(near);
-            break;
-          }
-        }
-        if (near !== this.isNearVehicle) {
-          this.isNearVehicle = near;
-          this.syncVehicleBtnEl(near);
+    if (this.isShowMobileControls && this.vehicles.length) {
+      let near = false;
+      for (const v of this.vehicles) {
+        this.nearCheckLocal.copy(v.boardingPoint).multiplyScalar(v.scale);
+        v.vehicleGroup.localToWorld(this.nearCheckWorld.copy(this.nearCheckLocal));
+        if (this.player.position.distanceTo(this.nearCheckWorld) < 800 * this.playerModel.scale) {
+          near = true;
+          break;
         }
-      } else {
-        this.isNearVehicle = false;
-        this.syncVehicleBtnEl(false);
       }
+      if (near !== this.isNearVehicle) {
+        this.isNearVehicle = near;
+        this.mobileControls?.syncVehicleBtn(near);
+      }
+    }
+  }
+  // 相机碰撞射线
+  updateCameraWithRaycast(origin, desiredDist, maxDist) {
+    this.personToCam.subVectors(this.camera.position, origin);
+    const direction = this.personToCam.clone().normalize();
+    this.raycasterPersonToCam.set(origin, direction);
+    this.raycasterPersonToCam.far = desiredDist;
+    const hits = this.raycasterPersonToCam.intersectObject(this.collider, false);
+    if (hits.length > 0) {
+      const safeDist = Math.max(hits[0].distance - this.camEpsilon, this.minCamDistance);
+      const targetCamPos = origin.clone().add(direction.multiplyScalar(safeDist));
+      this.camera.position.lerp(targetCamPos, this.camCollisionLerp);
+    } else {
+      this.raycasterPersonToCam.far = maxDist;
+      const maxHits = this.raycasterPersonToCam.intersectObject(this.collider, false);
+      const safeDist = maxHits.length > 0 ? Math.min(maxDist, maxHits[0].distance - this.camEpsilon) : maxDist;
+      const targetCamPos = origin.clone().add(direction.multiplyScalar(safeDist));
+      this.camera.position.lerp(targetCamPos, this.camCollisionLerp);
     }
   }
-  /**
-   * 获取屏幕中心点向前射线与碰撞体的交点
-   */
+  // 屏幕中心射线
   getCenterScreenRaycastHit() {
     this.camera.updateMatrixWorld();
     this.centerRay.setFromCamera(this.centerMouse, this.camera);
-    const intersects = this.centerRay.intersectObject(this.collider, false);
-    return intersects[0];
+    return this.centerRay.intersectObject(this.collider, false)[0];
   }
-  /**
-   * 更新模型动画
-   */
+  // 获取当前人物动画名称
+  getCurrentPersonAnimationName() {
+    return this.actionState._clip.name;
+  }
+  // 更新动画混合器
   updateMixers(delta) {
-    if (this.personMixer) this.personMixer.update(delta);
-    for (const v of this.vehicles) {
-      v.vehicleMixer?.update(delta);
-    }
+    this.personMixer?.update(delta);
+    for (const v of this.vehicles) v.vehicleMixer?.update(delta);
   }
+  // 重置玩家位置
   reset(position) {
     if (!this.player) return;
     this.playerVelocity.set(0, 0, 0);
     this.player.position.copy(position ?? this.initPos);
   }
+  // 获取玩家位置
   getPosition() {
     return this.player?.position;
   }
   // ==================== 输入处理 ====================
+  // 外部输入接口
   setInput(input) {
     if (typeof input.moveX === "number") {
       this.lftPressed = input.moveX === -1;
@@ -2426,14 +2050,9 @@ var PlayerController = class {
     }
     if (typeof input.jump === "boolean") {
       if (input.jump) {
-        if (this.isMovingToBoardingPoint) {
-          this.isMovingToBoardingPoint = false;
-          this.boardingWaypoints = [];
-          this.currentWaypointIndex = 0;
-          this.boardingTargetDir = null;
-        }
+        this.cancelBoarding();
         this.spacePressed = true;
-        if (this.controllerMode == 1) return;
+        if (this.controllerMode === 1) return;
         if (!this.playerIsOnGround || this.isFlying) return;
         this.playPersonAnimationByName("jumping");
         this.playerVelocity.y = this.jumpHeight;
@@ -2442,344 +2061,91 @@ var PlayerController = class {
         this.spacePressed = false;
       }
     }
-    if (typeof input.shift === "boolean") {
-      this.shiftPressed = input.shift;
-    }
-    if (input.toggleView) {
-      this.changeView();
-    }
-    if (input.toggleFly && this.playerFlyEnabled && this.controllerMode == 0) {
+    if (typeof input.shift === "boolean") this.shiftPressed = input.shift;
+    if (input.toggleView) this.changeView();
+    if (input.toggleFly && this.playerFlyEnabled && this.controllerMode === 0) {
       this.isFlying = !this.isFlying;
       this.setAnimationByPressed();
-      if (!this.isFlying && !this.playerIsOnGround) {
-        this.playPersonAnimationByName("jumping");
-      }
+      if (!this.isFlying && !this.playerIsOnGround) this.playPersonAnimationByName("jumping");
     }
     if (input.toggleVehicle) {
-      if (this.controllerMode == 0) {
-        this.enterVehicle();
-      } else {
-        this.exitVehicle();
-      }
+      if (this.controllerMode === 0) this.enterVehicle();
+      else this.exitVehicle();
     }
   }
+  // 取消上车寻路
+  cancelBoarding() {
+    this.isMovingToBoardingPoint = false;
+    this.boardingWaypoints = [];
+    this.currentWaypointIndex = 0;
+    this.boardingTargetDir = null;
+  }
+  // 注册所有事件
   onAllEvent() {
     this.isupdate = true;
     this.setPointerLock();
-    window.addEventListener("keydown", this._boundOnKeydown);
-    window.addEventListener("keyup", this._boundOnKeyup);
-    window.addEventListener("mousemove", this._mouseMove);
-    window.addEventListener("click", this._mouseClick);
+    window.addEventListener("keydown", this.boundOnKeydown);
+    window.addEventListener("keyup", this.boundOnKeyup);
+    window.addEventListener("mousemove", this.mouseMove);
+    window.addEventListener("click", this.mouseClick);
   }
+  // 注销所有事件
   offAllEvent() {
     this.isupdate = false;
     document.exitPointerLock();
-    window.removeEventListener("keydown", this._boundOnKeydown);
-    window.removeEventListener("keyup", this._boundOnKeyup);
-    window.removeEventListener("mousemove", this._mouseMove);
-    window.removeEventListener("click", this._mouseClick);
-  }
-  async initMobileControls() {
-    this.controls.maxPolarAngle = Math.PI * (300 / 360);
-    this.controls.touches = { ONE: null, TWO: null };
-    this.nippleModule = await import("nipplejs");
-    const nipple = this.nippleModule?.default;
-    const JOY_SIZE = 120;
-    const container = document.body;
-    this.joystickZoneEl = document.createElement("div");
-    this.joystickZoneEl.id = "joy-zone";
-    Object.assign(this.joystickZoneEl.style, {
-      position: "absolute",
-      left: "16px",
-      bottom: "16px",
-      width: `${JOY_SIZE + 40}px`,
-      height: `${JOY_SIZE + 40}px`,
-      touchAction: "none",
-      zIndex: "999",
-      pointerEvents: "auto",
-      WebkitUserSelect: "none",
-      userSelect: "none"
-    });
-    container.appendChild(this.joystickZoneEl);
-    ["touchstart", "touchmove", "touchend", "touchcancel"].forEach(
-      (evtName) => {
-        this.joystickZoneEl?.addEventListener(
-          evtName,
-          (e) => e.preventDefault(),
-          {
-            passive: false
-          }
-        );
-      }
-    );
-    this.joystickManager = nipple.create({
-      zone: this.joystickZoneEl,
-      mode: "static",
-      position: {
-        left: `${(JOY_SIZE + 40) / 2}px`,
-        bottom: `${(JOY_SIZE + 40) / 2}px`
-      },
-      color: "#ffffff",
-      size: JOY_SIZE,
-      multitouch: true,
-      maxNumberOfNipples: 1
-    });
-    this.joystickManager.on("move", (_evt, data) => {
-      if (!data) return;
-      const rawX = data.vector?.x ?? 0;
-      const rawY = data.vector?.y ?? 0;
-      const distance = data.distance ?? 0;
-      const deadzone = 0.5;
-      const dirX = rawX > deadzone ? 1 : rawX < -deadzone ? -1 : 0;
-      const dirY = rawY > deadzone ? 1 : rawY < -deadzone ? -1 : 0;
-      const sprintThreshold = JOY_SIZE / 2;
-      const isSprinting = distance >= sprintThreshold;
-      const prev = this.prevJoyState || {
-        dirX: 0,
-        dirY: 0,
-        shift: false
-      };
-      if (dirX === prev.dirX && dirY === prev.dirY && isSprinting === prev.shift)
-        return;
-      this.prevJoyState = { dirX, dirY, shift: isSprinting };
-      this.setInput({ moveX: dirX, moveY: dirY, shift: isSprinting });
-    });
-    this.joystickManager.on("end", () => {
-      const prev = this.prevJoyState || {
-        dirX: 0,
-        dirY: 0,
-        shift: false
-      };
-      if (prev.dirX !== 0 || prev.dirY !== 0 || prev.shift !== false) {
-        this.prevJoyState = { dirX: 0, dirY: 0, shift: false };
-        this.setInput({ moveX: 0, moveY: 0, shift: false });
-      }
-    });
-    this.lookAreaEl = document.createElement("div");
-    Object.assign(this.lookAreaEl.style, {
-      position: "absolute",
-      right: "0",
-      bottom: "0",
-      width: "50%",
-      height: "100%",
-      zIndex: "998",
-      touchAction: "none",
-      WebkitUserSelect: "none",
-      userSelect: "none"
-    });
-    container.appendChild(this.lookAreaEl);
-    ["touchstart", "touchmove", "touchend", "touchcancel"].forEach(
-      (evtName) => {
-        this.lookAreaEl?.addEventListener(
-          evtName,
-          (e) => e.preventDefault(),
-          {
-            passive: false
-          }
-        );
-      }
-    );
-    this.lookAreaEl.addEventListener("pointerdown", this.onPointerDown, {
-      passive: false
-    });
-    this.lookAreaEl.addEventListener("pointermove", this.onPointerMove, {
-      passive: false
-    });
-    this.lookAreaEl.addEventListener("pointerup", this.onPointerUp, {
-      passive: false
-    });
-    this.lookAreaEl.addEventListener("pointercancel", this.onPointerUp, {
-      passive: false
-    });
-    const createBtn = (rightPx, bottomPx, bgUrl) => {
-      const btn = document.createElement("button");
-      const styles = {
-        position: "absolute",
-        right: `${rightPx}px`,
-        bottom: `${bottomPx}px`,
-        width: "56px",
-        height: "56px",
-        zIndex: "1000",
-        borderRadius: "50%",
-        border: "2px solid black",
-        background: "rgba(0,0,0)",
-        padding: "20px",
-        opacity: "0.95",
-        touchAction: "none",
-        fontSize: "14px",
-        userSelect: "none",
-        overflow: "hidden",
-        boxSizing: "border-box",
-        backgroundColor: "transparent",
-        backgroundRepeat: "no-repeat, no-repeat",
-        backgroundPosition: "center center, center center",
-        backgroundSize: "100% 100%, 80% 80%"
-      };
-      if (bgUrl) {
-        const overlayColor = "rgba(0,0,0,0.5)";
-        styles.backgroundImage = `linear-gradient(${overlayColor}, ${overlayColor}), url("${bgUrl}")`;
-      }
-      Object.assign(btn.style, styles);
-      container.appendChild(btn);
-      ["touchstart", "touchend", "touchcancel"].forEach((evtName) => {
-        btn.addEventListener(evtName, (e) => e.preventDefault(), {
-          passive: false
-        });
-      });
-      return btn;
-    };
-    this.jumpBtnEl = createBtn(14, 14, jump_default);
-    this.jumpBtnEl.addEventListener(
-      "touchstart",
-      (e) => {
-        e.preventDefault();
-        this.setInput({ jump: true });
-      },
-      { passive: false }
-    );
-    this.jumpBtnEl.addEventListener(
-      "touchend",
-      (e) => {
-        e.preventDefault();
-        this.setInput({ jump: false });
-      },
-      { passive: false }
-    );
-    this.jumpBtnEl.addEventListener(
-      "touchcancel",
-      (e) => {
-        e.preventDefault();
-        this.setInput({ jump: false });
-      },
-      { passive: false }
-    );
-    this.flyBtnEl = createBtn(14, 14 + 80, fly_default);
-    this.flyBtnEl.addEventListener(
-      "touchstart",
-      (e) => {
-        e.preventDefault();
-        this.setInput({ toggleFly: true });
-      },
-      { passive: false }
-    );
-    this.viewBtnEl = createBtn(14, 14 + 200, view_default);
-    this.viewBtnEl.addEventListener(
-      "touchstart",
-      (e) => {
-        e.preventDefault();
-        this.setInput({ toggleView: true });
-      },
-      { passive: false }
-    );
-    this.vehicleBtnEl = createBtn(14 + 100, 14 + 120, vehicle_default);
-    this.vehicleBtnEl.addEventListener(
-      "touchstart",
-      (e) => {
-        e.preventDefault();
-        this.setInput({ toggleVehicle: true });
-      },
-      { passive: false }
-    );
-  }
-  destroyMobileControls() {
-    try {
-      if (this.joystickManager && this.joystickManager.destroy) {
-        this.joystickManager.destroy();
-        this.joystickManager = null;
-      }
-      if (this.joystickZoneEl?.parentElement) {
-        this.joystickZoneEl.parentElement.removeChild(
-          this.joystickZoneEl
-        );
-        this.joystickZoneEl = null;
-      }
-      if (this.lookAreaEl?.parentElement) {
-        this.lookAreaEl.parentElement.removeChild(this.lookAreaEl);
-        this.lookAreaEl = null;
-      }
-      if (this.jumpBtnEl?.parentElement) {
-        this.jumpBtnEl.parentElement.removeChild(this.jumpBtnEl);
-        this.jumpBtnEl = null;
-      }
-      if (this.flyBtnEl?.parentElement) {
-        this.flyBtnEl.parentElement.removeChild(this.flyBtnEl);
-        this.flyBtnEl = null;
-      }
-      if (this.viewBtnEl?.parentElement) {
-        this.viewBtnEl.parentElement.removeChild(this.viewBtnEl);
-        this.viewBtnEl = null;
-      }
-      if (this.vehicleBtnEl?.parentElement) {
-        this.vehicleBtnEl.parentElement.removeChild(this.vehicleBtnEl);
-        this.vehicleBtnEl = null;
-      }
-      this.lookAreaEl?.removeEventListener(
-        "pointerdown",
-        this.onPointerDown
-      );
-      this.lookAreaEl?.removeEventListener(
-        "pointermove",
-        this.onPointerMove
-      );
-      this.lookAreaEl?.removeEventListener("pointerup", this.onPointerUp);
-      this.lookAreaEl?.removeEventListener(
-        "pointercancel",
-        this.onPointerUp
-      );
-    } catch (e) {
-      console.warn("\u9500\u6BC1\u79FB\u52A8\u7AEF\u6447\u6746\u63A7\u5236\u65F6\u51FA\u9519\uFF1A", e);
-    }
-  }
-  syncVehicleBtnEl(show) {
-    if (!this.vehicleBtnEl) return;
-    this.vehicleBtnEl.style.display = show ? "block" : "none";
-  }
-  syncControllerModeBtnEl() {
-    if (!this.isShowMobileControls) return;
-    if (this.controllerMode == 0) {
-      this.flyBtnEl.style.display = "block";
-      const overlayColor = "rgba(0,0,0,0.5)";
-      this.jumpBtnEl.style.backgroundImage = `linear-gradient(${overlayColor}, ${overlayColor}), url("${jump_default}")`;
-    } else {
-      this.flyBtnEl.style.display = "none";
-      const overlayColor = "rgba(0,0,0,0.5)";
-      this.jumpBtnEl.style.backgroundImage = `linear-gradient(${overlayColor}, ${overlayColor}), url("${break_default}")`;
-      this.jumpBtnEl.style.backgroundImage = `url(${break_default})`;
-    }
-  }
-  // ==================== 更新参数 ====================
-  setMouseSensitivity(mouseSensity) {
-    this.mouseSensity = mouseSensity;
-    this.controls.rotateSpeed = this.mouseSensity * 0.05;
-  }
+    window.removeEventListener("keydown", this.boundOnKeydown);
+    window.removeEventListener("keyup", this.boundOnKeyup);
+    window.removeEventListener("mousemove", this.mouseMove);
+    window.removeEventListener("click", this.mouseClick);
+  }
+  // ==================== 移动端同步 ====================
+  // 同步移动端按钮
+  syncMobileControllerMode() {
+    this.mobileControls?.syncControllerModeBtn(this.controllerMode);
+  }
+  // ==================== Setters ====================
+  // 设置鼠标灵敏度
+  setMouseSensitivity(value) {
+    this.mouseSensitivity = value;
+    this.controls.rotateSpeed = value * 0.05;
+  }
+  // 设置重力
   setGravity(gravity) {
     this.gravity = gravity * this.playerModel.scale;
   }
+  // 设置跳跃高度
   setJumpHeight(jumpHeight) {
     this.jumpHeight = jumpHeight * this.playerModel.scale;
   }
-  setPlayerSpeed(playerSpeed) {
-    this.playerSpeed = playerSpeed * this.playerModel.scale;
+  // 设置移动速度
+  setPlayerSpeed(speed) {
+    this.playerSpeed = speed * this.playerModel.scale;
     this.curPlayerSpeed = this.playerSpeed;
   }
-  setPlayerFlySpeed(playerFlySpeed) {
-    this.playerFlySpeed = playerFlySpeed * this.playerModel.scale;
+  // 设置飞行速度
+  setPlayerFlySpeed(flySpeed) {
+    this.playerFlySpeed = flySpeed * this.playerModel.scale;
   }
-  setMinCamDistance(minCamDistance) {
-    this.minCamDistance = minCamDistance * this.playerModel.scale;
+  // 设置最小相机距离
+  setMinCamDistance(dist) {
+    this.minCamDistance = dist * this.playerModel.scale;
   }
-  setMaxCamDistance(maxCamDistance) {
-    this.maxCamDistance = maxCamDistance * this.playerModel.scale;
+  // 设置最大相机距离
+  setMaxCamDistance(dist) {
+    this.maxCamDistance = dist * this.playerModel.scale;
     this.orginMaxCamDistance = this.maxCamDistance;
   }
-  setThirdMouseMode(thirdMouseMode) {
-    this.thirdMouseMode = thirdMouseMode;
+  // 设置鼠标模式
+  setThirdMouseMode(mode) {
+    this.thirdMouseMode = mode;
     this.setPointerLock();
   }
-  setEnableZoom(enableZoom) {
-    this.enableZoom = enableZoom;
-    this.controls.enableZoom = this.enableZoom;
+  // 设置滚轮缩放
+  setEnableZoom(enable) {
+    this.enableZoom = enable;
+    this.controls.enableZoom = enable;
   }
+  // 设置调试显示
   setDebug(debug) {
     if (this.collider) this.scene.remove(this.collider);
     if (debug) {
@@ -2790,6 +2156,7 @@ var PlayerController = class {
     }
   }
   // ==================== 销毁 ====================
+  // 销毁控制器
   destroy() {
     this.offAllEvent();
     if (this.player) {
@@ -2810,7 +2177,8 @@ var PlayerController = class {
       this.scene.remove(this.collider);
       this.collider = null;
     }
-    this.destroyMobileControls();
+    this.mobileControls?.destroy();
+    this.mobileControls = null;
     for (const v of this.vehicles) {
       this.scene.remove(v.vehicleGroup);
       v.pathPlanner?.dispose();
@@ -2824,31 +2192,34 @@ function playerController() {
   if (!controllerInstance) controllerInstance = new PlayerController();
   const c = controllerInstance;
   return {
-    init: (opts, callback) => c.init(opts, callback),
-    loadVehicleModel: (params) => c.loadVehicleModel(params),
-    changeView: () => c.changeView(),
-    reset: (pos) => c.reset(pos),
+    init: (opts, cb) => c.init(opts, cb),
+    loadVehicleModel: (opts) => c.loadVehicleModel(opts),
     update: (dt) => c.update(dt),
     destroy: () => c.destroy(),
+    reset: (pos) => c.reset(pos),
     setInput: (i) => c.setInput(i),
+    changeView: () => c.changeView(),
     getPosition: () => c.getPosition(),
     getCenterScreenRaycastHit: () => c.getCenterScreenRaycastHit(),
+    getCurrentPersonAnimationName: () => c.getCurrentPersonAnimationName(),
     getPerson: () => c.person,
     getActiveVehicle: () => c.activeVehicle,
     getAllVehicles: () => c.vehicles,
     switchPlayerModel: (model) => c.switchPlayerModel(model),
-    setMouseSensitivity: (mouseSensity) => c.setMouseSensitivity(mouseSensity),
-    setGravity: (gravity) => c.setGravity(gravity),
-    setJumpHeight: (jumpHeight) => c.setJumpHeight(jumpHeight),
-    setPlayerSpeed: (playerSpeed) => c.setPlayerSpeed(playerSpeed),
-    setPlayerFlySpeed: (playerFlySpeed) => c.setPlayerFlySpeed(playerFlySpeed),
-    setMinCamDistance: (minCamDistance) => c.setMinCamDistance(minCamDistance),
-    setMaxCamDistance: (maxCamDistance) => c.setMaxCamDistance(maxCamDistance),
-    setThirdMouseMode: (thirdMouseMode) => c.setThirdMouseMode(thirdMouseMode),
-    setEnableZoom: (enableZoom) => c.setEnableZoom(enableZoom),
-    setDebug: (debug) => c.setDebug(debug),
-    setOverShoulderView: (enable) => c.setOverShoulderView(enable),
-    setPlayerScale: (scale) => c.setPlayerScale(scale)
+    setPlayerScale: (scale) => c.setPlayerScale(scale),
+    setMouseSensitivity: (v) => c.setMouseSensitivity(v),
+    setGravity: (v) => c.setGravity(v),
+    setJumpHeight: (v) => c.setJumpHeight(v),
+    setPlayerSpeed: (v) => c.setPlayerSpeed(v),
+    setPlayerFlySpeed: (v) => c.setPlayerFlySpeed(v),
+    setMinCamDistance: (v) => c.setMinCamDistance(v),
+    setMaxCamDistance: (v) => c.setMaxCamDistance(v),
+    setThirdMouseMode: (v) => c.setThirdMouseMode(v),
+    setEnableZoom: (v) => c.setEnableZoom(v),
+    setDebug: (v) => c.setDebug(v),
+    setOverShoulderView: (v) => c.setOverShoulderView(v),
+    registerAnimation: (key, clipName, opts) => c.registerAnimation(key, clipName, opts),
+    playAnimation: (key, opts) => c.playAnimation(key, opts)
   };
 }
 function onAllEvent() {
@@ -2856,8 +2227,7 @@ function onAllEvent() {
   controllerInstance.onAllEvent();
 }
 function offAllEvent() {
-  if (!controllerInstance) return;
-  controllerInstance.offAllEvent();
+  controllerInstance?.offAllEvent();
 }
 export {
   offAllEvent,