three-player-controller 0.3.0 → 0.3.2

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 three-player-controller author
+Copyright (c) 2026 屈航
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/index.d.mts

@@ -38,6 +38,17 @@ declare function playerController(): {
     destroy: () => void;
     setInput: (i: any) => void;
     getposition: () => THREE.Vector3;
+    loadVehicleModel: (params: {
+        url: string;
+        position: THREE.Vector3;
+        scale?: number;
+        animations: {
+            openDoorAnim?: string;
+            wheelsTurnAnim?: string;
+            turnLeftAnim?: string;
+            turnRightAnim?: string;
+        };
+    }) => Promise<void>;
 };
 declare function onAllEvent(): void;
 declare function offAllEvent(): void;

package/dist/index.d.ts

@@ -38,6 +38,17 @@ declare function playerController(): {
     destroy: () => void;
     setInput: (i: any) => void;
     getposition: () => THREE.Vector3;
+    loadVehicleModel: (params: {
+        url: string;
+        position: THREE.Vector3;
+        scale?: number;
+        animations: {
+            openDoorAnim?: string;
+            wheelsTurnAnim?: string;
+            turnLeftAnim?: string;
+            turnRightAnim?: string;
+        };
+    }) => Promise<void>;
 };
 declare function onAllEvent(): void;
 declare function offAllEvent(): void;

package/dist/index.js

@@ -60,7 +60,7 @@ var PlayerController = class {
   constructor() {
     // ==================== 基本配置与参数 ====================
     this.loader = new import_GLTFLoader.GLTFLoader();
-    // 0: 隐藏鼠标控制朝向及视角，1: 隐藏鼠标仅控制视角，2: 显示鼠标拖拽控制朝向及视角, 3: 显示鼠标拖拽仅控制视角
+    // 0: 普通 1: 飞行 2: 车辆
     // ==================== 玩家基本属性 ====================
     this.playerRadius = 45;
     this.playerHeight = 180;
@@ -74,6 +74,7 @@ var PlayerController = class {
     this.collider = null;
     this.visualizer = null;
     this.person = null;
+    this.vehicle = null;
     // ==================== 状态开关 ====================
     this.playerIsOnGround = false;
     this.isupdate = true;
@@ -236,6 +237,9 @@ var PlayerController = class {
             this.playPersonAnimationByName("jumping");
           }
           break;
+        case "KeyE":
+          this.setDrive();
+          break;
       }
     };
     /**
@@ -503,6 +507,50 @@ var PlayerController = class {
     this.reset();
     this.player.rotateY(this.playerModel.rotateY ?? 0);
   }
+  // ==================== 车辆模型相关 ====================
+  /**
+   * 加载车辆模型与动画
+   */
+  async loadVehicleModel(params) {
+    try {
+      const { url, position, scale = 1 } = params;
+      const gltf = await this.loader.loadAsync(url);
+      this.vehicle = gltf.scene;
+      this.vehicle.scale.set(scale, scale, scale);
+      this.vehicle.position.copy(position);
+      this.vehicle.traverse((child) => {
+        if (child.isMesh) {
+          child.castShadow = true;
+          child.receiveShadow = true;
+        }
+      });
+      this.scene.add(this.vehicle);
+      const animations = gltf.animations ?? [];
+      this.vehicleActions = /* @__PURE__ */ new Map();
+      this.vehicleMixer = new THREE.AnimationMixer(this.vehicle);
+      const animationMappings = [
+        [params.animations?.openDoorAnim ?? "", "open_door"],
+        [params.animations?.wheelsTurnAnim ?? "", "wheels_turn"],
+        [params.animations?.turnLeftAnim ?? "", "turn_left"],
+        [params.animations?.turnRightAnim ?? "", "turn_right"]
+      ];
+      const findClip = (name) => animations.find((a) => a.name === name);
+      for (const [clipName, actionName] of animationMappings) {
+        const clip = findClip(clipName);
+        if (!clip) continue;
+        const action = this.vehicleMixer.clipAction(clip);
+        action.setLoop(THREE.LoopOnce, 1);
+        action.clampWhenFinished = true;
+        action.setEffectiveTimeScale(2);
+        action.enabled = true;
+        action.setEffectiveWeight(0);
+        this.vehicleActions.set(actionName, action);
+      }
+      console.log("\u5F00\u95E8\u52A8\u753B", this.vehicleActions.get("open_door"));
+    } catch (error) {
+      console.error("\u52A0\u8F7D\u8F66\u8F86\u6A21\u578B\u5931\u8D25:", error);
+    }
+  }
   // ==================== 相机与视角控制 ====================
   /**
    * 第一/三人称视角切换
@@ -524,6 +572,10 @@ var PlayerController = class {
     }
     this.setPointerLock();
   }
+  setDrive() {
+    this.controllerMode = 2;
+    this.person?.attach(this.vehicle);
+  }
   /**
    * 设置指针锁定
    */
@@ -596,6 +648,61 @@ var PlayerController = class {
     }
   }
   // ==================== 物理与碰撞检测 ====================
+  /**
+   * 统一属性集合
+   */
+  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);
+        }
+      }
+    }
+    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 });
+        } else {
+          const m = attrMap.get(name);
+          if (m.itemSize !== itemSize || m.arrayCtor !== ctor || m.normalized !== 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);
+    }
+    const attrNames = Array.from(attrMap.keys());
+    for (const g of collected) {
+      const count = g.attributes.position.count;
+      for (const name of attrNames) {
+        if (!g.attributes[name]) {
+          const meta = attrMap.get(name);
+          const len = count * meta.itemSize;
+          const array = new meta.arrayCtor(len);
+          g.setAttribute(name, new THREE.BufferAttribute(array, meta.itemSize, meta.normalized));
+        }
+      }
+    }
+    return collected;
+  }
   /**
    * BVH碰撞体构建
    */
@@ -611,7 +718,7 @@ var PlayerController = class {
       }
       return geom;
     };
-    const collected = [];
+    let collected = [];
     if (meshUrl === "") {
       if (this.collider) {
         this.scene.remove(this.collider);
@@ -632,45 +739,7 @@ var PlayerController = class {
         }
       });
       if (!collected.length) return;
-      const attrMap = /* @__PURE__ */ new Map();
-      const attrConflict = /* @__PURE__ */ new Set();
-      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;
-          if (!attrMap.has(name)) {
-            attrMap.set(name, { itemSize, arrayCtor: ctor, examples: 1 });
-          } else {
-            const m = attrMap.get(name);
-            if (m.itemSize !== itemSize || m.arrayCtor !== ctor) {
-              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);
-      }
-      const attrNames = Array.from(attrMap.keys());
-      for (const g of collected) {
-        const count = g.attributes.position.count;
-        for (const name of attrNames) {
-          if (!g.attributes[name]) {
-            const meta = attrMap.get(name);
-            const len = count * meta.itemSize;
-            const array = new meta.arrayCtor(len);
-            g.setAttribute(name, new THREE.BufferAttribute(array, meta.itemSize));
-          }
-        }
-      }
+      collected = this.unifiedAttribute(collected);
     } else {
       const gltf = await this.loader.loadAsync(meshUrl);
       const mesh = gltf.scene.children[0];
@@ -766,8 +835,12 @@ var PlayerController = class {
             this.player.position.addScaledVector(this.playerVelocity, delta);
             this.playerIsOnGround = true;
           } else {
-            this.playerVelocity.set(0, 0, 0);
-            this.playerIsOnGround = true;
+            if (this.spacePressed) {
+              this.playerVelocity.y += delta * this.gravity;
+            } else {
+              this.playerVelocity.set(0, 0, 0);
+              this.playerIsOnGround = true;
+            }
           }
         } else if (playerDistanceFromGround > minH && playerDistanceFromGround < h) {
           this.playerVelocity.set(0, 0, 0);
@@ -898,6 +971,7 @@ var PlayerController = class {
    */
   updateMixers(delta) {
     if (this.personMixer) this.personMixer.update(delta);
+    if (this.vehicleMixer) this.vehicleMixer.update(delta);
   }
   /**
    * 重置玩家位置
@@ -1220,7 +1294,8 @@ function playerController() {
     update: (dt) => c.update(dt),
     destroy: () => c.destroy(),
     setInput: (i) => c.setInput(i),
-    getposition: () => c.getPosition()
+    getposition: () => c.getPosition(),
+    loadVehicleModel: (params) => c.loadVehicleModel(params)
   };
 }
 function onAllEvent() {