three-player-controller 0.3.1 → 0.3.3

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/README.md

@@ -73,6 +73,7 @@ export function playerController(): {
     reset: (pos?: THREE.Vector3) => void;
     update: (dt?: number) => void;
     destroy: () => void;
+    getposition: () => THREE.Vector3;
 };
 ```
 
@@ -88,6 +89,8 @@ export function playerController(): {
   每帧调用。
 - `destroy()`  
   销毁控制器。
+- `getposition()`  
+  获取人物当前位置。
 
 ---
 
@@ -139,6 +142,9 @@ type PlayerControllerOptions = {
     minCamDistance?: number;
     maxCamDistance?: number;
     colliderMeshUrl?: string;
+    isShowMobileControls?: boolean;
+    thirdMouseMode?: number;
+    enableZoom?: boolean;
 };
 ```
 
@@ -161,6 +167,7 @@ type PlayerControllerOptions = {
 | `colliderMeshUrl`                                            |                  `string` | 自制碰撞体模型路径，默认`""`                                                                                                                           |
 | `isShowMobileControls`                                       |                 `boolean` | 移动端运行时，是否自动显示移动端控制器，默认`true`                                                                                                     |
 | `thirdMouseMode`                                             |            `[0, 1, 2, 3]` | 第三人称视角下的不同鼠标控制模式 ，默认`1`(0: 隐藏鼠标控制朝向及视角，1: 隐藏鼠标仅控制视角，2: 显示鼠标拖拽控制朝向及视角, 3: 显示鼠标拖拽仅控制视角) |
+| `enableZoom`                                                 |                 `boolean` | 第三人称模式下是否允许缩放，默认`false`                                                                                                                |
 
 ---
 

package/dist/index.d.mts

@@ -29,6 +29,7 @@ type PlayerControllerOptions = {
     colliderMeshUrl?: string;
     isShowMobileControls?: boolean;
     thirdMouseMode?: 0 | 1 | 2 | 3;
+    enableZoom?: boolean;
 };
 declare function playerController(): {
     init: (opts: PlayerControllerOptions, callback?: () => void) => Promise<void>;

package/dist/index.d.ts

@@ -29,6 +29,7 @@ type PlayerControllerOptions = {
     colliderMeshUrl?: string;
     isShowMobileControls?: boolean;
     thirdMouseMode?: 0 | 1 | 2 | 3;
+    enableZoom?: boolean;
 };
 declare function playerController(): {
     init: (opts: PlayerControllerOptions, callback?: () => void) => Promise<void>;

package/dist/index.js

@@ -60,7 +60,6 @@ var PlayerController = class {
   constructor() {
     // ==================== 基本配置与参数 ====================
     this.loader = new import_GLTFLoader.GLTFLoader();
-    // 0: 普通 1: 飞行 2: 车辆
     // ==================== 玩家基本属性 ====================
     this.playerRadius = 45;
     this.playerHeight = 180;
@@ -351,6 +350,7 @@ var PlayerController = class {
     this._maxCamDistance = (opts.maxCamDistance ?? 440) * s;
     this.orginMaxCamDistance = this._maxCamDistance;
     this.thirdMouseMode = opts.thirdMouseMode ?? 1;
+    this.enableZoom = opts.enableZoom ?? false;
     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();
     if (this.isShowMobileControls) {
@@ -561,6 +561,7 @@ var PlayerController = class {
       this.player.attach(this.camera);
       this.camera.position.set(0, 40 * this.playerModel.scale, 30 * this.playerModel.scale);
       this.camera.rotation.set(0, Math.PI, 0);
+      this.controls.enableZoom = false;
     } else {
       this.scene.attach(this.camera);
       const worldPos = this.player.position.clone();
@@ -569,6 +570,7 @@ var PlayerController = class {
       const offset = new THREE.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);
+      this.controls.enableZoom = this.enableZoom;
     }
     this.setPointerLock();
   }
@@ -582,6 +584,8 @@ var PlayerController = class {
   setPointerLock() {
     if ((this.thirdMouseMode === 0 || this.thirdMouseMode === 1) && !this.isFirstPerson || this.isFirstPerson) {
       document.body.requestPointerLock();
+    } else {
+      document.exitPointerLock();
     }
   }
   /**
@@ -603,9 +607,10 @@ var PlayerController = class {
    * 设置控制器
    */
   setControls() {
-    this.controls.enabled = !(this.thirdMouseMode === 0 || this.thirdMouseMode === 1);
+    this.controls.enableZoom = this.enableZoom;
     this.controls.rotateSpeed = this.mouseSensity * 0.05;
     this.controls.maxPolarAngle = Math.PI * (300 / 360);
+    this.controls.mouseButtons = { LEFT: 0, MIDDLE: 1, RIGHT: 2 };
   }
   /**
    * 重置控制器
@@ -648,6 +653,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碰撞体构建
    */
@@ -663,7 +723,7 @@ var PlayerController = class {
       }
       return geom;
     };
-    const collected = [];
+    let collected = [];
     if (meshUrl === "") {
       if (this.collider) {
         this.scene.remove(this.collider);
@@ -684,45 +744,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];
@@ -912,28 +934,30 @@ var PlayerController = class {
       this.controls.target.copy(lookTarget);
       this.camera.position.add(lookTarget);
       this.controls.update();
-      this._personToCam.subVectors(this.camera.position, this.player.position);
-      const origin = this.player.position.clone().add(new THREE.Vector3(0, 0, 0));
-      const direction = this._personToCam.clone().normalize();
-      const desiredDist = this._personToCam.length();
-      this._raycasterPersonToCam.set(origin, direction);
-      this._raycasterPersonToCam.far = desiredDist;
-      const intersects2 = this._raycasterPersonToCam.intersectObject(this.collider, false);
-      if (intersects2.length > 0) {
-        const hit = intersects2[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;
+      if (!this.enableZoom) {
+        this._personToCam.subVectors(this.camera.position, this.player.position);
+        const origin = this.player.position.clone().add(new THREE.Vector3(0, 0, 0));
+        const direction = this._personToCam.clone().normalize();
+        const desiredDist = this._personToCam.length();
+        this._raycasterPersonToCam.set(origin, direction);
+        this._raycasterPersonToCam.far = desiredDist;
+        const intersects2 = this._raycasterPersonToCam.intersectObject(this.collider, false);
+        if (intersects2.length > 0) {
+          const hit = intersects2[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);
         }
-        const targetCamPos = origin.clone().add(direction.clone().multiplyScalar(safeDist));
-        this.camera.position.lerp(targetCamPos, this._camCollisionLerp);
       }
     }
     if (this.player.position.y < this.boundingBoxMinY - 1) {