@gg-web-engine/core 0.0.18 → 0.0.20

package/dist/2d/entities/gg-2d-entity.d.ts

@@ -3,7 +3,9 @@ import { Point2 } from '../../base/models/points';
 import { IGg2dBody, IGg2dObject } from '../interfaces';
 import { Gg2dWorld } from '../gg-2d-world';
 import { GGTickOrder } from '../../base/entities/gg-entity';
-export declare class Gg2dEntity extends GgPositionable2dEntity {
+import { RenderableEntityMixin } from '../../base/entities/mixins/renderable-entity.mixin';
+declare const Gg2dEntity_base: import("ts-mixer/dist/types/types").Class<any[], RenderableEntityMixin & GgPositionable2dEntity, typeof RenderableEntityMixin & typeof GgPositionable2dEntity, false>;
+export declare class Gg2dEntity extends Gg2dEntity_base {
     readonly object2D: IGg2dObject | null;
     readonly objectBody: IGg2dBody | null;
     readonly tickOrder = GGTickOrder.OBJECTS_BINDING;
@@ -13,8 +15,7 @@ export declare class Gg2dEntity extends GgPositionable2dEntity {
     set rotation(value: number);
     get scale(): Point2;
     set scale(value: Point2);
-    get visible(): boolean;
-    set visible(value: boolean);
+    updateVisibility(): void;
     /**
      * Synchronize physics body transform with entity (and object2d if defined)
      * */
@@ -24,3 +25,4 @@ export declare class Gg2dEntity extends GgPositionable2dEntity {
     onRemoved(): void;
     dispose(): void;
 }
+export {};

package/dist/2d/entities/gg-2d-entity.js

@@ -1,6 +1,8 @@
 import { GgPositionable2dEntity } from './gg-positionable-2d-entity';
 import { GGTickOrder } from '../../base/entities/gg-entity';
-export class Gg2dEntity extends GgPositionable2dEntity {
+import { Mixin } from 'ts-mixer';
+import { RenderableEntityMixin } from '../../base/entities/mixins/renderable-entity.mixin';
+export class Gg2dEntity extends Mixin(RenderableEntityMixin, GgPositionable2dEntity) {
     constructor(object2D, objectBody) {
         super();
         this.object2D = object2D;
@@ -60,19 +62,11 @@ export class Gg2dEntity extends GgPositionable2dEntity {
         }
         super.scale = value;
     }
-    get visible() {
-        var _a;
-        return !!((_a = this.object2D) === null || _a === void 0 ? void 0 : _a.visible);
-    }
-    set visible(value) {
+    updateVisibility() {
         if (this.object2D) {
-            this.object2D.visible = value;
-        }
-        for (const entity of this._children) {
-            if (entity instanceof Gg2dEntity) {
-                entity.visible = value;
-            }
+            this.object2D.visible = this.worldVisible;
         }
+        super.updateVisibility();
     }
     /**
      * Synchronize physics body transform with entity (and object2d if defined)

package/dist/2d/entities/gg-positionable-2d-entity.js

@@ -1,7 +1,8 @@
 import { GgPositionableEntity } from '../../base/entities/gg-positionable-entity';
+import { Pnt2 } from '../../base/math/point2';
 export class GgPositionable2dEntity extends GgPositionableEntity {
     getDefaultPosition() {
-        return { x: 0, y: 0 };
+        return Pnt2.O;
     }
     getDefaultRotation() {
         return 0;

package/dist/2d/gg-2d-world.js

@@ -9,6 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { GgWorld } from '../base/gg-world';
 import { Gg2dEntity } from './entities/gg-2d-entity';
+import { Pnt2 } from '../base/math/point2';
 export class Gg2dWorld extends GgWorld {
     constructor(visualScene, physicsWorld, consoleEnabled = false) {
         super(visualScene, physicsWorld, consoleEnabled);
@@ -28,10 +29,7 @@ export class Gg2dWorld extends GgWorld {
                 '{x: 0, y: value}, 2 arguments set the whole vector. Default value is "9.82" or "0 9.82"');
         }
     }
-    addPrimitiveRigidBody(descr, position = {
-        x: 0,
-        y: 0,
-    }, rotation = 0) {
+    addPrimitiveRigidBody(descr, position = Pnt2.O, rotation = 0) {
         const entity = new Gg2dEntity(this.visualScene.factory.createPrimitive(descr.shape), this.physicsWorld.factory.createRigidBody(descr));
         entity.position = position;
         entity.rotation = rotation;

package/dist/3d/entities/controllers/animators/camera-3d.animator.js

@@ -3,7 +3,7 @@ import { Pnt3 } from '../../../../base/math/point3';
 import { Qtrn } from '../../../../base/math/quaternion';
 import { takeUntil } from 'rxjs';
 import { lerpNumber } from '../../../../base/math/numbers';
-const defaultUp = { x: 0, y: 0, z: 1 };
+const defaultUp = Pnt3.Z;
 const defaultFov = 65;
 export class Camera3dAnimator extends AnimationMixer {
     constructor(entity, _animationFunction) {

package/dist/3d/entities/controllers/input/car-keyboard-handling.controller.d.ts

@@ -7,6 +7,7 @@ import { GgWorld } from '../../../../base/gg-world';
 export declare type CarKeyboardControllerOptions = {
     keymap: DirectionKeyboardKeymap;
     gearUpDownKeys: [string, string];
+    handbrakeKey: string;
 };
 export declare class CarKeyboardHandlingController extends GgEntity {
     protected readonly keyboard: KeyboardInput;

package/dist/3d/entities/controllers/input/car-keyboard-handling.controller.js

@@ -13,10 +13,14 @@ import { DirectionKeyboardInput, } from '../../../../base/inputs/direction.keybo
 import { GgEntity, GGTickOrder } from '../../../../base/entities/gg-entity';
 // TODO pass as settings
 // TODO smooth y?
-const TICKER_INTERVAL = 16;
+const TICKER_INTERVAL = 16; // TODO when refactored, reflect in CarKeyboardHandlingController test
 const TICKER_MAX_STEPS = 10;
 export class CarKeyboardHandlingController extends GgEntity {
-    constructor(keyboard, car, options = { keymap: 'arrows', gearUpDownKeys: ['KeyA', 'KeyZ'] }) {
+    constructor(keyboard, car, options = {
+        keymap: 'arrows',
+        gearUpDownKeys: ['KeyA', 'KeyZ'],
+        handbrakeKey: 'Space',
+    }) {
         super();
         this.keyboard = keyboard;
         this.car = car;
@@ -28,7 +32,7 @@ export class CarKeyboardHandlingController extends GgEntity {
         this.y$ = new BehaviorSubject(0);
         this.lastX = 0;
         this.switchingGearsEnabled = true;
-        this.pairTickerPipe = pipe(startWith(0), pairwise(), map(([beforeValue, afterValue]) => [this.lastX, afterValue]), switchMap(([beforeValue, afterValue]) => interval(TICKER_INTERVAL).pipe(take(TICKER_MAX_STEPS), map(count => ++count), map(count => beforeValue * ((TICKER_MAX_STEPS - count) / TICKER_MAX_STEPS) + afterValue * (count / TICKER_MAX_STEPS)), tap(x => {
+        this.pairTickerPipe = pipe(pairwise(), map(([beforeValue, afterValue]) => [this.lastX, afterValue]), switchMap(([beforeValue, afterValue]) => interval(TICKER_INTERVAL).pipe(startWith(-1), take(TICKER_MAX_STEPS), map(count => count + 2), map(count => beforeValue * ((TICKER_MAX_STEPS - count) / TICKER_MAX_STEPS) + afterValue * (count / TICKER_MAX_STEPS)), tap(x => {
             this.lastX = x;
         }))));
         this.directionsInput = new DirectionKeyboardInput(keyboard, options.keymap);
@@ -61,6 +65,14 @@ export class CarKeyboardHandlingController extends GgEntity {
                     }
                 }
             });
+            this.keyboard
+                .bind(this.options.handbrakeKey)
+                .pipe(takeUntil(this._onRemoved$))
+                .subscribe(isKeyDown => {
+                if (this.car) {
+                    this.car.handBrake = isKeyDown;
+                }
+            });
             this.directionsInput.output$.pipe(takeUntil(this._onRemoved$)).subscribe(d => {
                 moveDirection = d;
             });
@@ -78,9 +90,11 @@ export class CarKeyboardHandlingController extends GgEntity {
                 this.y$.next(y);
             });
             combineLatest([
-                this.x$.pipe(takeUntil(this._onRemoved$), distinctUntilChanged(), this.pairTickerPipe),
-                this.y$.pipe(takeUntil(this._onRemoved$), distinctUntilChanged()),
-            ]).subscribe(([x, y]) => {
+                this.x$.pipe(takeUntil(this._onRemoved$), distinctUntilChanged(), startWith(0), this.pairTickerPipe),
+                this.y$.pipe(takeUntil(this._onRemoved$), distinctUntilChanged(), startWith(0)),
+            ])
+                .pipe(takeUntil(this._onRemoved$))
+                .subscribe(([x, y]) => {
                 if (this.car) {
                     this.car.setXAxisControlValue(x);
                     this.car.setYAxisControlValue(y);

package/dist/3d/entities/controllers/input/free-camera.controller.d.ts

@@ -21,6 +21,14 @@ export declare type FreeCameraControllerOptions = {
          */
         speed: number;
     };
+    /**
+     * Flag to ignore cursor movement if pointer was not locked. By default false
+     */
+    ignoreMouseUnlessPointerLocked: boolean;
+    /**
+     * Flag to ignore keyboard events if pointer was not locked. By default false
+     */
+    ignoreKeyboardUnlessPointerLocked: boolean;
     /**
      * Options for configuring mouse input.
      */

package/dist/3d/entities/controllers/input/free-camera.controller.js

@@ -28,6 +28,8 @@ export class FreeCameraController extends GgEntity {
         keymap: 'wasd',
         movementOptions: { speed: 0.5 },
         mouseOptions: {},
+        ignoreMouseUnlessPointerLocked: false,
+        ignoreKeyboardUnlessPointerLocked: false,
     }) {
         super();
         this.keyboard = keyboard;
@@ -49,6 +51,7 @@ export class FreeCameraController extends GgEntity {
             if (this.camera.object3D.supportsFov) {
                 keys.push('KeyZ', 'KeyC');
             }
+            keys.push('ShiftLeft');
             this.directionsInput.output$.pipe(takeUntil(this._onRemoved$)).subscribe(d => {
                 controls.direction = d;
             });
@@ -58,33 +61,41 @@ export class FreeCameraController extends GgEntity {
                 controls.rest = d;
             });
             // Subscribe to mouse input for camera rotation
-            let rotationDelta = { x: 0, y: 0 };
+            let rotationDelta = Pnt2.O;
             let isTouchScreen = MouseInput.isTouchDevice();
             this.mouseInput.delta$
-                .pipe(takeUntil(this._onRemoved$), filter(() => isTouchScreen || this.mouseInput.isPointerLocked))
+                .pipe(takeUntil(this._onRemoved$), filter(() => isTouchScreen || !this.options.ignoreMouseUnlessPointerLocked || this.mouseInput.isPointerLocked))
                 .subscribe(delta => {
                 rotationDelta = Pnt2.add(rotationDelta, delta);
             });
             // Setup updating camera position and rotation based on input
             this.camera.tick$.pipe(takeUntil(this._onRemoved$)).subscribe(() => {
-                let translateVector = { x: 0, y: 0, z: 0 };
-                const [u, d, zo, zi] = controls.rest;
-                if (controls.direction.upDown !== undefined)
-                    translateVector.z = controls.direction.upDown ? -1 : 1;
-                if (controls.direction.leftRight !== undefined)
-                    translateVector.x = controls.direction.leftRight ? -1 : 1;
+                let c = controls;
+                if (this.options.ignoreKeyboardUnlessPointerLocked && !this.mouseInput.isPointerLocked) {
+                    c = { direction: {}, rest: [false, false, false, false, false] };
+                }
+                let translateVector = Object.assign({}, Pnt3.O);
+                const [u, d, zo, zi, speedBoost] = c.rest;
+                if (c.direction.upDown !== undefined)
+                    translateVector.z = c.direction.upDown ? -1 : 1;
+                if (c.direction.leftRight !== undefined)
+                    translateVector.x = c.direction.leftRight ? -1 : 1;
                 if (u != d)
                     translateVector.y = d ? -1 : 1;
                 if (zo != zi)
                     this.camera.object3D.fov += zo ? 1 : -1;
-                this.camera.position = Pnt3.add(this.camera.position, Pnt3.rot(Pnt3.scalarMult(Pnt3.norm(translateVector), this.options.movementOptions.speed), this.camera.rotation));
+                let speed = this.options.movementOptions.speed;
+                if (speedBoost) {
+                    speed *= 2.5;
+                }
+                this.camera.position = Pnt3.add(this.camera.position, Pnt3.rot(Pnt3.scalarMult(Pnt3.norm(translateVector), speed), this.camera.rotation));
                 if (rotationDelta.x != 0 || rotationDelta.y != 0) {
                     const spherical = Pnt3.toSpherical(Pnt3.rot({ x: 0, y: 0, z: -1 }, this.camera.rotation));
                     spherical.theta -= rotationDelta.x / 300;
                     spherical.phi += rotationDelta.y / 300;
                     spherical.phi = Math.max(0.000001, Math.min(Math.PI - 0.000001, spherical.phi));
-                    this.camera.rotation = Qtrn.lookAt(this.camera.position, Pnt3.add(this.camera.position, Pnt3.fromSpherical(spherical)), { x: 0, y: 0, z: 1 });
-                    rotationDelta = { x: 0, y: 0 };
+                    this.camera.rotation = Qtrn.lookAt(this.camera.position, Pnt3.add(this.camera.position, Pnt3.fromSpherical(spherical)));
+                    rotationDelta = Pnt2.O;
                 }
             });
             // start input

package/dist/3d/entities/controllers/input/orbit-camera.controller.d.ts

@@ -5,7 +5,6 @@ import { GgWorld } from '../../../../base/gg-world';
 import { MutableSpherical, Point3 } from '../../../../base/models/points';
 export declare type OrbitCameraControllerOptions = {
     mouseOptions: Partial<MouseInputOptions>;
-    target: Point3;
     orbiting: {
         sensitivityX: number;
         sensitivityY: number;
@@ -27,6 +26,13 @@ export declare class OrbitCameraController extends GgEntity {
     protected readonly options: OrbitCameraControllerOptions;
     protected readonly mouseInput: MouseInput;
     protected spherical: MutableSpherical;
+    target: Point3;
+    get radius(): number;
+    set radius(value: number);
+    get phi(): number;
+    set phi(value: number);
+    get theta(): number;
+    set theta(value: number);
     constructor(camera: Gg3dCameraEntity, options?: Partial<OrbitCameraControllerOptions>);
     onSpawned(world: GgWorld<any, any>): Promise<void>;
     onRemoved(): Promise<void>;

package/dist/3d/entities/controllers/input/orbit-camera.controller.js

@@ -15,7 +15,6 @@ import { Pnt3 } from '../../../../base/math/point3';
 import { map } from 'rxjs/operators';
 const DEFAULT_OPTIONS = {
     mouseOptions: {},
-    target: { x: 0, y: 0, z: 0 },
     orbiting: { sensitivityX: 1, sensitivityY: 1 },
     zooming: { sensitivity: 1 },
     panning: { sensitivityX: 1, sensitivityY: 1 },
@@ -26,17 +25,36 @@ export class OrbitCameraController extends GgEntity {
         super();
         this.camera = camera;
         this.tickOrder = GGTickOrder.INPUT_CONTROLLERS;
-        this.spherical = { phi: 0, radius: 0, theta: 0 };
+        this.spherical = { phi: 0, radius: 10, theta: 0 };
+        this.target = Pnt3.O;
         this.options = Object.assign(Object.assign({}, DEFAULT_OPTIONS), options);
         this.mouseInput = new MouseInput(this.options.mouseOptions);
     }
+    get radius() {
+        return this.spherical.radius;
+    }
+    set radius(value) {
+        this.spherical.radius = value;
+    }
+    get phi() {
+        return this.spherical.phi;
+    }
+    set phi(value) {
+        this.spherical.phi = Math.max(0.000001, Math.min(Math.PI - 0.000001, value));
+    }
+    get theta() {
+        return this.spherical.theta;
+    }
+    set theta(value) {
+        this.spherical.theta = value;
+    }
     onSpawned(world) {
         const _super = Object.create(null, {
             onSpawned: { get: () => super.onSpawned }
         });
         return __awaiter(this, void 0, void 0, function* () {
             yield _super.onSpawned.call(this, world);
-            this.spherical = Pnt3.toSpherical(Pnt3.sub(this.camera.position, this.options.target));
+            this.spherical = Pnt3.toSpherical(Pnt3.sub(this.camera.position, this.target));
             if (this.options.orbiting) {
                 this.mouseInput.delta$
                     .pipe(takeUntil(this._onRemoved$), filter(() => this.mouseInput.state == MouseInputState.DRAG))
@@ -61,7 +79,7 @@ export class OrbitCameraController extends GgEntity {
                     z: 0,
                 }, Math.PI / 2);
                 const viewRight = Pnt3.rotAround(targetCameraVector, Pnt3.norm(viewUp), Math.PI / 2);
-                this.options.target = Pnt3.add(this.options.target, Pnt3.add(Pnt3.scalarMult(viewUp, (-this.options.panning.sensitivityY * delta.y) / 1000), Pnt3.scalarMult(viewRight, (this.options.panning.sensitivityX * delta.x) / 1000)));
+                this.target = Pnt3.add(this.target, Pnt3.add(Pnt3.scalarMult(viewUp, (-this.options.panning.sensitivityY * delta.y) / 1000), Pnt3.scalarMult(viewRight, (this.options.panning.sensitivityX * delta.x) / 1000)));
             };
             if (this.options.panning) {
                 this.mouseInput.delta$
@@ -93,8 +111,8 @@ export class OrbitCameraController extends GgEntity {
             this.camera.tick$
                 .pipe(takeUntil(this._onRemoved$), map(() => this.spherical))
                 .subscribe(spherical => {
-                this.camera.position = Pnt3.add(this.options.target, Pnt3.fromSpherical(spherical));
-                this.camera.rotation = Qtrn.lookAt(this.camera.position, this.options.target, { x: 0, y: 0, z: 1 });
+                this.camera.position = Pnt3.add(this.target, Pnt3.fromSpherical(spherical));
+                this.camera.rotation = Qtrn.lookAt(this.camera.position, this.target);
             });
             // start input
             yield this.mouseInput.start();

package/dist/3d/entities/gg-3d-entity.d.ts

@@ -3,7 +3,9 @@ import { Point3, Point4 } from '../../base/models/points';
 import { Gg3dWorld } from '../gg-3d-world';
 import { IGg3dBody, IGg3dObject } from '../interfaces';
 import { GGTickOrder } from '../../base/entities/gg-entity';
-export declare class Gg3dEntity extends GgPositionable3dEntity {
+import { RenderableEntityMixin } from '../../base/entities/mixins/renderable-entity.mixin';
+declare const Gg3dEntity_base: import("ts-mixer/dist/types/types").Class<any[], RenderableEntityMixin & GgPositionable3dEntity, typeof RenderableEntityMixin & typeof GgPositionable3dEntity, false>;
+export declare class Gg3dEntity extends Gg3dEntity_base {
     readonly object3D: IGg3dObject | null;
     readonly objectBody: IGg3dBody | null;
     readonly tickOrder = GGTickOrder.OBJECTS_BINDING;
@@ -13,8 +15,7 @@ export declare class Gg3dEntity extends GgPositionable3dEntity {
     set rotation(value: Point4);
     get scale(): Point3;
     set scale(value: Point3);
-    get visible(): boolean;
-    set visible(value: boolean);
+    updateVisibility(): void;
     /**
      * Synchronize physics body transform with entity (and mesh if defined)
      * */
@@ -24,3 +25,4 @@ export declare class Gg3dEntity extends GgPositionable3dEntity {
     onRemoved(): void;
     dispose(): void;
 }
+export {};

package/dist/3d/entities/gg-3d-entity.js

@@ -1,6 +1,8 @@
 import { GgPositionable3dEntity } from './gg-positionable-3d-entity';
 import { GGTickOrder } from '../../base/entities/gg-entity';
-export class Gg3dEntity extends GgPositionable3dEntity {
+import { Mixin } from 'ts-mixer';
+import { RenderableEntityMixin } from '../../base/entities/mixins/renderable-entity.mixin';
+export class Gg3dEntity extends Mixin(RenderableEntityMixin, GgPositionable3dEntity) {
     constructor(object3D, objectBody = null) {
         super();
         this.object3D = object3D;
@@ -60,19 +62,11 @@ export class Gg3dEntity extends GgPositionable3dEntity {
         }
         super.scale = value;
     }
-    get visible() {
-        var _a;
-        return !!((_a = this.object3D) === null || _a === void 0 ? void 0 : _a.visible);
-    }
-    set visible(value) {
+    updateVisibility() {
         if (this.object3D) {
-            this.object3D.visible = value;
-        }
-        for (const entity of this._children) {
-            if (entity instanceof Gg3dEntity) {
-                entity.visible = value;
-            }
+            this.object3D.visible = this.worldVisible;
         }
+        super.updateVisibility();
     }
     /**
      * Synchronize physics body transform with entity (and mesh if defined)

package/dist/3d/entities/gg-3d-map-graph.entity.d.ts

@@ -6,6 +6,7 @@ import { GgPositionable3dEntity } from './gg-positionable-3d-entity';
 import { Gg3dWorld } from '../gg-3d-world';
 import { Gg3dEntity } from './gg-3d-entity';
 import { LoadOptions, LoadResultWithProps } from '../loader';
+import { RenderableEntityMixin } from '../../base/entities/mixins/renderable-entity.mixin';
 export declare type MapGraphNodeType = {
     path: string;
     position: Point3;
@@ -38,7 +39,8 @@ export declare type Gg3dMapGraphEntityOptions = {
     loadDepth: number;
     inertia: number;
 };
-export declare class Gg3dMapGraphEntity extends GgEntity {
+declare const Gg3dMapGraphEntity_base: import("ts-mixer/dist/types/types").Class<any[], RenderableEntityMixin & GgEntity, typeof RenderableEntityMixin & typeof GgEntity, false>;
+export declare class Gg3dMapGraphEntity extends Gg3dMapGraphEntity_base {
     readonly mapGraph: MapGraph;
     readonly tickOrder = GGTickOrder.POST_RENDERING;
     readonly loaderCursorEntity$: BehaviorSubject<GgPositionable3dEntity | null>;
@@ -65,3 +67,4 @@ export declare class Gg3dMapGraphEntity extends GgEntity {
     protected loadChunk(node: MapGraphNodeType): Promise<[Gg3dEntity[], LoadResultWithProps]>;
     protected disposeChunk(node: MapGraphNodeType): void;
 }
+export {};

package/dist/3d/entities/gg-3d-map-graph.entity.js

@@ -11,6 +11,9 @@ import { BehaviorSubject, NEVER, startWith, Subject, switchMap } from 'rxjs';
 import { distinctUntilChanged, map, tap, throttleTime } from 'rxjs/operators';
 import { Graph } from '../../base/data-structures/graph';
 import { GgEntity, GGTickOrder } from '../../base/entities/gg-entity';
+import { Qtrn } from '../../base/math/quaternion';
+import { RenderableEntityMixin } from '../../base/entities/mixins/renderable-entity.mixin';
+import { Mixin } from 'ts-mixer';
 export class MapGraph extends Graph {
     /**
      * Creates a new MapGraph instance from an array of elements, where each element in the array is a node in the graph.
@@ -80,7 +83,7 @@ const defaultOptions = {
     loadDepth: 5,
     inertia: 0,
 };
-export class Gg3dMapGraphEntity extends GgEntity {
+export class Gg3dMapGraphEntity extends Mixin(RenderableEntityMixin, GgEntity) {
     constructor(mapGraph, options = {}) {
         super();
         this.mapGraph = mapGraph;
@@ -148,7 +151,7 @@ export class Gg3dMapGraphEntity extends GgEntity {
     }
     loadChunk(node) {
         return __awaiter(this, void 0, void 0, function* () {
-            const loaded = yield this.world.loader.loadGgGlb(node.path, Object.assign({ position: node.position, rotation: node.rotation || { x: 0, y: 0, z: 0, w: 1 } }, node.loadOptions));
+            const loaded = yield this.world.loader.loadGgGlb(node.path, Object.assign({ position: node.position, rotation: node.rotation || Qtrn.O }, node.loadOptions));
             const entities = [
                 ...loaded.entities,
                 ...(loaded.props || [])
@@ -160,10 +163,7 @@ export class Gg3dMapGraphEntity extends GgEntity {
             ];
             this.loaded.set(node, entities);
             this.addChildren(...entities);
-            this._chunkLoaded$.next([
-                loaded,
-                { position: node.position, rotation: node.rotation || { x: 0, y: 0, z: 0, w: 1 } },
-            ]);
+            this._chunkLoaded$.next([loaded, { position: node.position, rotation: node.rotation || Qtrn.O }]);
             return [entities, loaded];
         });
     }

package/dist/3d/entities/gg-3d-raycast-vehicle.entity.d.ts

@@ -37,6 +37,11 @@ export declare type CarProperties = {
         maxRpmIncreasePerSecond: number;
         maxRpmDecreasePerSecond: number;
     };
+    brake: {
+        frontAxleForce: number;
+        rearAxleForce: number;
+        handbrakeForce: number;
+    };
     transmission: {
         isAuto: boolean;
         reverseGearRatio: number;
@@ -57,6 +62,7 @@ export declare class Gg3dRaycastVehicleEntity extends Gg3dEntity {
     protected readonly wheelLocalRotation: (Point4 | null)[];
     protected readonly wheelLocalTranslation: Point3[];
     protected readonly frontWheelsIndices: number[];
+    protected readonly rearWheelsIndices: number[];
     protected readonly tractionWheelIndices: number[];
     readonly tractionWheelRadius: number;
     protected get dynamicTractionWheelRadius(): number;
@@ -71,7 +77,6 @@ export declare class Gg3dRaycastVehicleEntity extends Gg3dEntity {
     get engineRpm(): number;
     protected get tractionForce(): number;
     private readonly _maxSteerVal;
-    private readonly brakingForce;
     get maxSteerVal(): number;
     private getMaxStableSteerVal;
     private _tailLightsOn;
@@ -84,6 +89,9 @@ export declare class Gg3dRaycastVehicleEntity extends Gg3dEntity {
     protected brake$: BehaviorSubject<number>;
     protected get brake(): number;
     protected set brake(value: number);
+    protected handBrake$: BehaviorSubject<boolean>;
+    get handBrake(): boolean;
+    set handBrake(value: boolean);
     private _gear;
     private _gear$;
     get gear(): number;

package/dist/3d/entities/gg-3d-raycast-vehicle.entity.js

@@ -17,16 +17,17 @@ export class Gg3dRaycastVehicleEntity extends Gg3dEntity {
         this.wheelLocalRotation = [];
         this.wheelLocalTranslation = [];
         this.frontWheelsIndices = [];
+        this.rearWheelsIndices = [];
         this.tractionWheelIndices = [];
         this._rpm$ = new BehaviorSubject(this.carProperties.engine.minRpm);
         // TODO should be parameters
         this._maxSteerVal = 0.35;
-        this.brakingForce = 300;
         this._tailLightsOn = false;
         // 0..1
         this._acceleration$ = new BehaviorSubject(0);
         // 0..1
         this.brake$ = new BehaviorSubject(0);
+        this.handBrake$ = new BehaviorSubject(false);
         this._gear = 0;
         this._gear$ = new BehaviorSubject(0);
         this._steeringValue = 0;
@@ -34,6 +35,9 @@ export class Gg3dRaycastVehicleEntity extends Gg3dEntity {
             if (x.isFront) {
                 this.frontWheelsIndices.push(i);
             }
+            else {
+                this.rearWheelsIndices.push(i);
+            }
             if (x.isFront && this.carProperties.typeOfDrive != 'RWD') {
                 this.tractionWheelIndices.push(i);
             }
@@ -57,8 +61,8 @@ export class Gg3dRaycastVehicleEntity extends Gg3dEntity {
                 }
                 const entity = options.wheelObject || this.wheelObject.clone();
                 const localTranslation = { x: options.tyre_width * (options.isLeft ? 1 : -1), y: 0, z: 0 };
-                const boundingBox = Box.expandByPoint(entity.getBoundings(), { x: 0, y: 0, z: 0 });
-                const scale = { x: 0, y: 0, z: 0 };
+                const boundingBox = Box.expandByPoint(entity.getBoundings(), Pnt3.O);
+                const scale = Object.assign({}, Pnt3.O);
                 for (const dir of ['x', 'y', 'z']) {
                     const wheelObjectDirection = options.wheelObjectDirection || this.wheelObjectDirection;
                     const isNormal = wheelObjectDirection.includes(dir);
@@ -202,6 +206,12 @@ export class Gg3dRaycastVehicleEntity extends Gg3dEntity {
     set brake(value) {
         this.brake$.next(value);
     }
+    get handBrake() {
+        return this.handBrake$.getValue();
+    }
+    set handBrake(value) {
+        this.handBrake$.next(value);
+    }
     get gear() {
         return this._gear;
     }
@@ -232,8 +242,8 @@ export class Gg3dRaycastVehicleEntity extends Gg3dEntity {
             this.updateEngine(delta);
             if (this.isTouchingGround) {
                 // TODO 1 - R (1000 rpm) quick switch with acceleration pedal should have the same speed as without acceleration pedal
-                let force;
-                let brakeForce = this.brake;
+                let force = 0;
+                let brake = this.brake;
                 const calculatedRpm = this.calculateRpmFromCarSpeed();
                 if (this.gear !== 0 && calculatedRpm > this.carProperties.engine.maxRpm) {
                     // engine brake, this is related to clutch, better clutch condition - bigger force
@@ -246,14 +256,17 @@ export class Gg3dRaycastVehicleEntity extends Gg3dEntity {
                             : 0.5 * (this.carProperties.engine.minRpm - calculatedRpm) * (this.gear > 0 ? 1 : -1); // released, use engine brake
                     // this functionality makes car stay still (parking gear) when speed is low
                     const speedThreshold = 3;
-                    if (Math.abs(this.getSpeed()) < speedThreshold && (this.gear == 0 || this.acceleration == 0)) {
-                        brakeForce = Math.max(brakeForce, (0.3 * (speedThreshold - this.getSpeed()) * this.brakingForce) / speedThreshold);
+                    if (Math.abs(this.getSpeed()) < speedThreshold && (this.gear == 0 || this.acceleration <= 0)) {
+                        brake = Math.max(brake, (0.3 * (speedThreshold - this.getSpeed())) / speedThreshold);
                         force = 0;
                     }
                 }
-                const forcePerWheel = force / this.tractionWheelIndices.length;
-                this.tractionWheelIndices.forEach(index => this.chassisBody.applyEngineForce(index, forcePerWheel));
-                this.wheels.forEach((w, i) => this.chassisBody.applyBrake(i, brakeForce));
+                this.tractionWheelIndices.forEach(index => this.chassisBody.applyEngineForce(index, force));
+                this.frontWheelsIndices.forEach(index => this.chassisBody.applyBrake(index, brake * this.carProperties.brake.frontAxleForce));
+                this.rearWheelsIndices.forEach(index => this.chassisBody.applyBrake(index, brake * this.carProperties.brake.rearAxleForce));
+                if (this.handBrake) {
+                    this.rearWheelsIndices.forEach(index => this.chassisBody.applyBrake(index, this.carProperties.brake.handbrakeForce));
+                }
             }
         });
         if (this.carProperties.transmission.isAuto) {
@@ -361,7 +374,7 @@ export class Gg3dRaycastVehicleEntity extends Gg3dEntity {
         }
         else {
             this.acceleration = 0;
-            this.brake = -this.brakingForce * value;
+            this.brake = -value;
         }
         this.setTailLightsOn(value < 0);
     }

package/dist/3d/entities/gg-3d-trigger.entity.js

@@ -1,4 +1,5 @@
 import { Gg3dEntity } from './gg-3d-entity';
+// FIXME it should be subclass of GgPositionable3dEntity (not renderable and bindable Gg3dEntity)
 export class Gg3dTriggerEntity extends Gg3dEntity {
     constructor(objectBody) {
         super(null, objectBody);

package/dist/3d/entities/gg-positionable-3d-entity.js

@@ -1,12 +1,13 @@
 import { GgPositionableEntity } from '../../base/entities/gg-positionable-entity';
 import { map } from 'rxjs/operators';
 import { Qtrn } from '../../base/math/quaternion';
+import { Pnt3 } from '../../base/math/point3';
 export class GgPositionable3dEntity extends GgPositionableEntity {
     getDefaultPosition() {
-        return { x: 0, y: 0, z: 0 };
+        return Pnt3.O;
     }
     getDefaultRotation() {
-        return { x: 0, y: 0, z: 0, w: 1 };
+        return Qtrn.O;
     }
     getDefaultScale() {
         return { x: 1, y: 1, z: 1 };

package/dist/3d/gg-3d-world.js

@@ -10,6 +10,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { GgWorld } from '../base/gg-world';
 import { Gg3dLoader } from './loader';
 import { Gg3dEntity } from './entities/gg-3d-entity';
+import { Qtrn } from '../base/math/quaternion';
+import { Pnt3 } from '../base/math/point3';
 export class Gg3dWorld extends GgWorld {
     constructor(visualScene, physicsWorld, consoleEnabled = false) {
         super(visualScene, physicsWorld, consoleEnabled);
@@ -30,11 +32,7 @@ export class Gg3dWorld extends GgWorld {
                 '{x: 0, y: 0, z: -value}, 3 arguments set the whole vector. Default value is "9.82" or "0 0 -9.82"');
         }
     }
-    addPrimitiveRigidBody(descr, position = {
-        x: 0,
-        y: 0,
-        z: 0,
-    }, rotation = { x: 0, y: 0, z: 0, w: 1 }) {
+    addPrimitiveRigidBody(descr, position = Pnt3.O, rotation = Qtrn.O) {
         const entity = new Gg3dEntity(this.visualScene.factory.createPrimitive(descr.shape), this.physicsWorld.factory.createRigidBody(descr));
         entity.position = position;
         entity.rotation = rotation;