@pmndrs/viverse 0.2.20 → 0.2.22

package/dist/camera.js

@@ -1,4 +1,4 @@
-import { Vector3, Euler, Ray, Quaternion } from 'three';
+import { Vector3, Euler, Ray } from 'three';
 import { clamp } from 'three/src/math/MathUtils.js';
 import { RotatePitchAction, RotateYawAction, ZoomAction } from './action/index.js';
 export const FirstPersonCharacterCameraBehavior = {
@@ -11,7 +11,7 @@ const sphericalOffset = new Vector3();
 const characterWorldPosition = new Vector3();
 const euler = new Euler();
 const rayHelper = new Ray();
-const quaternionHelper = new Quaternion();
+const upAxisHelper = new Vector3(0, 1, 0);
 export class CharacterCameraBehavior {
     rotationPitch = (-20 * Math.PI) / 180;
     rotationYaw = 0;
@@ -71,8 +71,10 @@ export class CharacterCameraBehavior {
         }
         //compute character->camera delta through offset
         this.computeCharacterBaseOffset(chracterBaseOffsetHelper, options.characterBaseOffset);
-        target.getWorldQuaternion(quaternionHelper);
-        chracterBaseOffsetHelper.applyQuaternion(quaternionHelper);
+        // Rotate the offset by the camera yaw (camera-relative), not the character's body
+        // facing: an over-the-shoulder offset then tracks the view instead of swimming with
+        // the character, and a purely vertical offset (default / first-person) is unchanged.
+        chracterBaseOffsetHelper.applyAxisAngle(upAxisHelper, this.rotationYaw);
         target.getWorldPosition(characterWorldPosition);
         characterWorldPosition.add(chracterBaseOffsetHelper);
         camera.getWorldPosition(deltaHelper);
@@ -131,8 +133,10 @@ export class CharacterCameraBehavior {
         sphericalOffset.applyEuler(camera.rotation);
         // Get target position with offset (reuse helper vector)
         this.computeCharacterBaseOffset(chracterBaseOffsetHelper, options.characterBaseOffset);
-        target.getWorldQuaternion(quaternionHelper);
-        chracterBaseOffsetHelper.applyQuaternion(quaternionHelper);
+        // Rotate the offset by the camera yaw (camera-relative), not the character's body
+        // facing: an over-the-shoulder offset then tracks the view instead of swimming with
+        // the character, and a purely vertical offset (default / first-person) is unchanged.
+        chracterBaseOffsetHelper.applyAxisAngle(upAxisHelper, this.rotationYaw);
         target.getWorldPosition(characterWorldPosition);
         characterWorldPosition.add(chracterBaseOffsetHelper);
         // Set camera position relative to target

package/dist/model/index.js

@@ -24,7 +24,7 @@ export async function loadCharacterModel(url, type, boneRotationOffset, castShad
         //prepare loading the default model
         type = 'gltf';
         url = (await import('../assets/mannequin.js')).url;
-        boneRotationOffset = new Quaternion().setFromEuler(new Euler(Math.PI, 0, Math.PI / 2, 'ZYX'));
+        boneRotationOffset = new Quaternion().setFromEuler(new Euler(Math.PI / 2, 0, Math.PI / 2, 'ZYX'));
     }
     if (type == null) {
         if (url.endsWith('.gltf') || url.endsWith('.glb')) {

package/package.json

@@ -21,7 +21,7 @@
   "peerDependencies": {
     "three": "*"
   },
-  "version": "0.2.20",
+  "version": "0.2.22",
   "type": "module",
   "dependencies": {
     "@pixiv/three-vrm": "^3.4.2",