playcanvas 2.10.4 → 2.10.5

package/build/playcanvas.prf.js

@@ -1,6 +1,6 @@
 /**
  * @license
- * PlayCanvas Engine v2.10.4 revision 7904b1a (PROFILE)
+ * PlayCanvas Engine v2.10.5 revision 8959e32 (PROFILE)
  * Copyright 2011-2025 PlayCanvas Ltd. All rights reserved.
  *
  * This source code is licensed under the MIT license found in the
@@ -296,8 +296,8 @@
 			"@swc/helpers - typeof";
 			return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 	}
-	var version = '2.10.4';
-	var revision = '7904b1a';
+	var version = '2.10.5';
+	var revision = '8959e32';
 	function extend(target, ex) {
 			for(var prop in ex){
 					var copy = ex[prop];

package/build/playcanvas.prf.mjs

@@ -1,6 +1,6 @@
 /**
  * @license
- * PlayCanvas Engine v2.10.4 revision 7904b1a (PROFILE)
+ * PlayCanvas Engine v2.10.5 revision 8959e32 (PROFILE)
  * Copyright 2011-2025 PlayCanvas Ltd. All rights reserved.
  *
  * This source code is licensed under the MIT license found in the
@@ -29,8 +29,8 @@ const TRACEID_TEXTURES = 'Textures';
 const TRACEID_RENDER_QUEUE = 'RenderQueue';
 const TRACEID_GPU_TIMINGS = 'GpuTimings';
 
-const version = '2.10.4';
-const revision = '7904b1a';
+const version = '2.10.5';
+const revision = '8959e32';
 function extend(target, ex) {
 		for(const prop in ex){
 				const copy = ex[prop];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playcanvas",
-  "version": "2.10.4",
+  "version": "2.10.5",
   "author": "PlayCanvas <support@playcanvas.com>",
   "homepage": "https://playcanvas.com",
   "description": "PlayCanvas WebGL game engine",

package/scripts/esm/first-person-controller.mjs

@@ -1,6 +1,5 @@
 import {
     math,
-    CameraComponent,
     InputFrame,
     KeyboardMouseSource,
     DualGestureSource,
@@ -67,11 +66,10 @@ class FirstPersonController extends Script {
     static scriptName = 'firstPersonController';
 
     /**
-     * @type {CameraComponent}
+     * @type {boolean}
      * @private
      */
-    // @ts-ignore
-    _camera;
+    _ready = false;
 
     /**
      * @type {RigidBodyComponent}
@@ -171,6 +169,15 @@ class FirstPersonController extends Script {
      */
     _gamePadTurnSpeed = 30;
 
+    /**
+     * @attribute
+     * @title Camera
+     * @description The camera entity that will be used for looking around.
+     * @type {Entity}
+     */
+    // @ts-ignore
+    camera;
+
     /**
      * @attribute
      * @title Look Sensitivity
@@ -238,9 +245,8 @@ class FirstPersonController extends Script {
     joystickEventName = 'joystick';
 
     initialize() {
-        // check camera
-        if (!this._camera) {
-            throw new Error('FirstPersonController requires a camera component');
+        if (!this.camera) {
+            throw new Error('FirstPersonController: Camera entity is required.');
         }
 
         // check collision and rigidbody
@@ -279,22 +285,8 @@ class FirstPersonController extends Script {
         });
 
         this.on('destroy', this.destroy, this);
-    }
 
-    /**
-     * @attribute
-     * @title Camera
-     * @description The camera entity that will be used for looking around.
-     * @type {Entity}
-     */
-    set camera(entity) {
-        if (entity.camera instanceof CameraComponent) {
-            this._camera = entity.camera;
-        }
-    }
-
-    get camera() {
-        return this._camera;
+        this._ready = true;
     }
 
     /**
@@ -303,6 +295,7 @@ class FirstPersonController extends Script {
      * @description Radial thickness of inner dead zone of the virtual joysticks. This dead zone ensures the virtual joysticks report a value of 0 even if a touch deviates a small amount from the initial touch.
      * @type {number}
      * @range [0, 0.4]
+     * @default 0.3
      */
     set mobileDeadZone(value) {
         this._mobileDeadZone = value ?? this._mobileDeadZone;
@@ -317,6 +310,7 @@ class FirstPersonController extends Script {
      * @title Mobile Turn Speed
      * @description Maximum turn speed in degrees per second
      * @type {number}
+     * @default 30
      */
     set mobileTurnSpeed(value) {
         this._mobileTurnSpeed = value ?? this._mobileTurnSpeed;
@@ -331,6 +325,7 @@ class FirstPersonController extends Script {
      * @title Mobile Radius
      * @description The radius of the virtual joystick in CSS pixels.
      * @type {number}
+     * @default 50
      */
     set mobileRadius(value) {
         this._mobileRadius = value ?? this._mobileRadius;
@@ -345,6 +340,7 @@ class FirstPersonController extends Script {
      * @title Mobile Double Tap Interval
      * @description The time in milliseconds between two taps of the right virtual joystick for a double tap to register. A double tap will trigger a cc:jump.
      * @type {number}
+     * @default 300
      */
     set mobileDoubleTapInterval(value) {
         this._mobileDoubleTapInterval = value ?? this._mobileDoubleTapInterval;
@@ -360,6 +356,7 @@ class FirstPersonController extends Script {
      * @description Radial thickness of inner dead zone of pad's joysticks. This dead zone ensures that all pads report a value of 0 for each joystick axis when untouched.
      * @type {number}
      * @range [0, 0.4]
+     * @default 0.1
      */
     set gamePadDeadZoneLow(value) {
         this._gamePadDeadZoneLow = value ?? this._gamePadDeadZoneLow;
@@ -375,6 +372,7 @@ class FirstPersonController extends Script {
      * @description Radial thickness of outer dead zone of pad's joysticks. This dead zone ensures that all pads can reach the -1 and 1 limits of each joystick axis.
      * @type {number}
      * @range [0, 0.4]
+     * @default 0.1
      */
     set gamePadDeadZoneHigh(value) {
         this._gamePadDeadZoneHigh = value ?? this._gamePadDeadZoneHigh;
@@ -389,6 +387,7 @@ class FirstPersonController extends Script {
      * @title GamePad Turn Speed
      * @description Maximum turn speed in degrees per second
      * @type {number}
+     * @default 30
      */
     set gamePadTurnSpeed(value) {
         this._gamePadTurnSpeed = value ?? this._gamePadTurnSpeed;
@@ -418,7 +417,7 @@ class FirstPersonController extends Script {
         // rotate
         this._angles.add(v.set(-rotate[1], -rotate[0], 0));
         this._angles.x = math.clamp(this._angles.x, -90, 90);
-        this.camera.entity.setLocalEulerAngles(this._angles);
+        this.camera.setLocalEulerAngles(this._angles);
 
         // move
         rotation.setFromEulerAngles(0, this._angles.y, 0);
@@ -438,6 +437,10 @@ class FirstPersonController extends Script {
      * @param {number} dt - The delta time.
      */
     update(dt) {
+        if (!this._ready) {
+            return;
+        }
+
         const { keyCode } = KeyboardMouseSource;
         const { buttonCode } = GamepadSource;