@directivegames/genesys.sdk 3.2.2 → 3.2.5

package/src/templates/src/templates/sideScroller/src/player.ts

@@ -1,125 +1,125 @@
-import * as ENGINE from 'genesys.js';
-import * as THREE from 'three';
-
-import { CAMERA_SETTINGS, PLAYER_MOVEMENT } from './const.js';
-
-// ============================================================================
-// PLAYER PAWN
-// ============================================================================
-
-// The side-scroller player pawn class using animated character.
-@ENGINE.GameClass()
-export class SideScrollerPlayer extends ENGINE.ThirdPersonCharacterPawn {
-  camera: THREE.PerspectiveCamera;
-  characterMesh: ENGINE.GLTFMeshComponent | null = null;
-  smoothedCameraHeight: number | null = null;
-  smoothedLookAtHeight: number | null = null;
-
-  constructor(options: Omit<ENGINE.ThirdPersonCharacterPawnOptions, 'movementComponent' | 'camera' | 'rootComponent'>) {
-    // Create directional movement component for side-scrolling
-    const movementComponent = new ENGINE.DirectionalCharacterMovementComponent({
-      ...ENGINE.DirectionalCharacterMovementComponent.DEFAULT_OPTIONS,
-      direction: ENGINE.CharacterMovementDirection.LeftRight, // Move left and right
-      autoMove: false, // Player controls movement manually
-      jumpSpeed: PLAYER_MOVEMENT.JUMP_SPEED,
-      maxSpeed: PLAYER_MOVEMENT.MAX_SPEED,
-      maxMidAirJumps: PLAYER_MOVEMENT.MAX_MID_AIR_JUMPS, // Allow double jump
-      // Physics and movement settings for platformer feel
-      accelerationLambda: PLAYER_MOVEMENT.ACCELERATION_LAMBDA,
-      decelerationLambda: PLAYER_MOVEMENT.DECELERATION_LAMBDA,
-      midAirAccelerationLambda: PLAYER_MOVEMENT.MID_AIR_ACCELERATION_LAMBDA,
-      midAirDecelerationLambda: PLAYER_MOVEMENT.MID_AIR_DECELERATION_LAMBDA,
-    });
-
-    // Physics options for the player
-    const physicsOptions: ENGINE.ComponentPhysicsOptions = {
-      enabled: true,
-      motionType: ENGINE.PhysicsMotionType.KinematicVelocityBased,
-      collisionProfile: ENGINE.DefaultCollisionProfile.Character,
-      generateCollisionEvents: true,
-    };
-
-    // Create root component with physics (invisible capsule for collision)
-    const rootComponent = new ENGINE.MeshComponent({
-      geometry: new THREE.CapsuleGeometry(
-        ENGINE.CHARACTER_WIDTH / 2,
-        ENGINE.CHARACTER_HEIGHT - ENGINE.CHARACTER_WIDTH
-      ),
-      material: new THREE.MeshStandardMaterial({
-        color: 0xffff00,
-        visible: false, // Make invisible since we'll have the animated character mesh
-        transparent: true,
-        opacity: 0.5
-      }),
-      physicsOptions,
-    });
-
-    super({
-      ...options,
-      // Use default character model from engine assets
-      modelUrl: '@engine/assets/character/mannequinG.glb',
-      configUrl: '@engine/assets/character/config/mannequin-anim.json',
-      meshPosition: new THREE.Vector3(0, -ENGINE.CHARACTER_HEIGHT / 2, 0),
-      meshRotation: new THREE.Euler(0, Math.PI, 0), // Face right initially
-      meshScale: new THREE.Vector3(1, 1, 1),
-      movementComponent,
-      camera: null, // Do not attach the camera to the player directly
-      rootComponent,
-      enableDirectionalLightFollowing: true,
-    });
-
-    // Enable shadow casting for the character
-    this.rootComponent.castShadow = true;
-    this.camera = new THREE.PerspectiveCamera(CAMERA_SETTINGS.FOV, 1, CAMERA_SETTINGS.NEAR, CAMERA_SETTINGS.FAR);
-  }
-
-  public override async doBeginPlay(): Promise<void> {
-    await super.doBeginPlay();
-    this.getWorld()?.setOverrideCamera(this.camera);
-  }
-
-  public override tickPrePhysics(deltaTime: number): void {
-    super.tickPrePhysics(deltaTime);
-
-    // manually update the camera position
-    const desiredCameraPosition = this.rootComponent.localToWorld(new THREE.Vector3(
-      CAMERA_SETTINGS.POSITION.x,
-      CAMERA_SETTINGS.POSITION.y,
-      CAMERA_SETTINGS.POSITION.z
-    ));
-    const desiredCameraLookAt = this.rootComponent.localToWorld(new THREE.Vector3(
-      CAMERA_SETTINGS.LOOK_AT.x,
-      CAMERA_SETTINGS.LOOK_AT.y,
-      CAMERA_SETTINGS.LOOK_AT.z
-    ));
-    this.smoothedCameraHeight ??= desiredCameraPosition.y;
-    this.smoothedLookAtHeight ??= desiredCameraLookAt.y;
-
-    this.smoothedCameraHeight = THREE.MathUtils.damp(this.smoothedCameraHeight, desiredCameraPosition.y, CAMERA_SETTINGS.DAMP_FACTOR, deltaTime);
-    this.smoothedLookAtHeight = THREE.MathUtils.damp(this.smoothedLookAtHeight, desiredCameraLookAt.y, CAMERA_SETTINGS.DAMP_FACTOR, deltaTime);
-
-    this.camera.position.x = desiredCameraPosition.x;
-    this.camera.position.y = this.smoothedCameraHeight;
-    this.camera.position.z = desiredCameraPosition.z;
-
-    this.camera.lookAt(new THREE.Vector3(
-      desiredCameraLookAt.x,
-      this.smoothedLookAtHeight,
-      desiredCameraLookAt.z
-    ));
-
-    // change the direction of the character mesh based on the movement direction
-    this.characterMesh ??= this.getComponent(ENGINE.GLTFMeshComponent);
-    if (this.characterMesh && this.movementComponent) {
-      const movementComponent = this.movementComponent as ENGINE.DirectionalCharacterMovementComponent;
-      const velocity = movementComponent.getVelocities();
-      if (velocity.right > 0.1) {
-        // Moving right - face right (90 degrees)
-        this.characterMesh.rotation.set(0, Math.PI / 2, 0);
-      } else if (velocity.right < -0.1) {
-        // Moving left - face left (-90 degrees)
-        this.characterMesh.rotation.set(0, -Math.PI / 2, 0);
-      }
-    }
-  }
-}
+import * as ENGINE from '@directivegames/genesys.js';
+import * as THREE from 'three';
+
+import { CAMERA_SETTINGS, PLAYER_MOVEMENT } from './const.js';
+
+// ============================================================================
+// PLAYER PAWN
+// ============================================================================
+
+// The side-scroller player pawn class using animated character.
+@ENGINE.GameClass()
+export class SideScrollerPlayer extends ENGINE.ThirdPersonCharacterPawn {
+  camera: THREE.PerspectiveCamera;
+  characterMesh: ENGINE.GLTFMeshComponent | null = null;
+  smoothedCameraHeight: number | null = null;
+  smoothedLookAtHeight: number | null = null;
+
+  constructor(options: Omit<ENGINE.ThirdPersonCharacterPawnOptions, 'movementComponent' | 'camera' | 'rootComponent'>) {
+    // Create directional movement component for side-scrolling
+    const movementComponent = new ENGINE.DirectionalCharacterMovementComponent({
+      ...ENGINE.DirectionalCharacterMovementComponent.DEFAULT_OPTIONS,
+      direction: ENGINE.CharacterMovementDirection.LeftRight, // Move left and right
+      autoMove: false, // Player controls movement manually
+      jumpSpeed: PLAYER_MOVEMENT.JUMP_SPEED,
+      maxSpeed: PLAYER_MOVEMENT.MAX_SPEED,
+      maxMidAirJumps: PLAYER_MOVEMENT.MAX_MID_AIR_JUMPS, // Allow double jump
+      // Physics and movement settings for platformer feel
+      accelerationLambda: PLAYER_MOVEMENT.ACCELERATION_LAMBDA,
+      decelerationLambda: PLAYER_MOVEMENT.DECELERATION_LAMBDA,
+      midAirAccelerationLambda: PLAYER_MOVEMENT.MID_AIR_ACCELERATION_LAMBDA,
+      midAirDecelerationLambda: PLAYER_MOVEMENT.MID_AIR_DECELERATION_LAMBDA,
+    });
+
+    // Physics options for the player
+    const physicsOptions: ENGINE.ComponentPhysicsOptions = {
+      enabled: true,
+      motionType: ENGINE.PhysicsMotionType.KinematicVelocityBased,
+      collisionProfile: ENGINE.DefaultCollisionProfile.Character,
+      generateCollisionEvents: true,
+    };
+
+    // Create root component with physics (invisible capsule for collision)
+    const rootComponent = new ENGINE.MeshComponent({
+      geometry: new THREE.CapsuleGeometry(
+        ENGINE.CHARACTER_WIDTH / 2,
+        ENGINE.CHARACTER_HEIGHT - ENGINE.CHARACTER_WIDTH
+      ),
+      material: new THREE.MeshStandardMaterial({
+        color: 0xffff00,
+        visible: false, // Make invisible since we'll have the animated character mesh
+        transparent: true,
+        opacity: 0.5
+      }),
+      physicsOptions,
+    });
+
+    super({
+      ...options,
+      // Use default character model from engine assets
+      modelUrl: '@engine/assets/character/mannequinG.glb',
+      configUrl: '@engine/assets/character/config/mannequin-anim.json',
+      meshPosition: new THREE.Vector3(0, -ENGINE.CHARACTER_HEIGHT / 2, 0),
+      meshRotation: new THREE.Euler(0, Math.PI, 0), // Face right initially
+      meshScale: new THREE.Vector3(1, 1, 1),
+      movementComponent,
+      camera: null, // Do not attach the camera to the player directly
+      rootComponent,
+      enableDirectionalLightFollowing: true,
+    });
+
+    // Enable shadow casting for the character
+    this.rootComponent.castShadow = true;
+    this.camera = new THREE.PerspectiveCamera(CAMERA_SETTINGS.FOV, 1, CAMERA_SETTINGS.NEAR, CAMERA_SETTINGS.FAR);
+  }
+
+  public override async doBeginPlay(): Promise<void> {
+    await super.doBeginPlay();
+    this.getWorld()?.setOverrideCamera(this.camera);
+  }
+
+  public override tickPrePhysics(deltaTime: number): void {
+    super.tickPrePhysics(deltaTime);
+
+    // manually update the camera position
+    const desiredCameraPosition = this.rootComponent.localToWorld(new THREE.Vector3(
+      CAMERA_SETTINGS.POSITION.x,
+      CAMERA_SETTINGS.POSITION.y,
+      CAMERA_SETTINGS.POSITION.z
+    ));
+    const desiredCameraLookAt = this.rootComponent.localToWorld(new THREE.Vector3(
+      CAMERA_SETTINGS.LOOK_AT.x,
+      CAMERA_SETTINGS.LOOK_AT.y,
+      CAMERA_SETTINGS.LOOK_AT.z
+    ));
+    this.smoothedCameraHeight ??= desiredCameraPosition.y;
+    this.smoothedLookAtHeight ??= desiredCameraLookAt.y;
+
+    this.smoothedCameraHeight = THREE.MathUtils.damp(this.smoothedCameraHeight, desiredCameraPosition.y, CAMERA_SETTINGS.DAMP_FACTOR, deltaTime);
+    this.smoothedLookAtHeight = THREE.MathUtils.damp(this.smoothedLookAtHeight, desiredCameraLookAt.y, CAMERA_SETTINGS.DAMP_FACTOR, deltaTime);
+
+    this.camera.position.x = desiredCameraPosition.x;
+    this.camera.position.y = this.smoothedCameraHeight;
+    this.camera.position.z = desiredCameraPosition.z;
+
+    this.camera.lookAt(new THREE.Vector3(
+      desiredCameraLookAt.x,
+      this.smoothedLookAtHeight,
+      desiredCameraLookAt.z
+    ));
+
+    // change the direction of the character mesh based on the movement direction
+    this.characterMesh ??= this.getComponent(ENGINE.GLTFMeshComponent);
+    if (this.characterMesh && this.movementComponent) {
+      const movementComponent = this.movementComponent as ENGINE.DirectionalCharacterMovementComponent;
+      const velocity = movementComponent.getVelocities();
+      if (velocity.right > 0.1) {
+        // Moving right - face right (90 degrees)
+        this.characterMesh.rotation.set(0, Math.PI / 2, 0);
+      } else if (velocity.right < -0.1) {
+        // Moving left - face left (-90 degrees)
+        this.characterMesh.rotation.set(0, -Math.PI / 2, 0);
+      }
+    }
+  }
+}

package/src/templates/src/templates/thirdPerson/assets/default.genesys-scene

@@ -1,166 +1,166 @@
-{
-  "$version": 0,
-  "class": "ENGINE.World",
-  "uuid": "c0ae85792bc3b946",
-  "ctor": {
-    "backgroundColor": 3026478,
-    "navigationOptions": {
-      "engine": "recast-navigation",
-      "debug": false,
-      "generateOnStartUp": false
-    },
-    "physicsOptions": {
-      "gravity": [
-        0,
-        -9.81,
-        0,
-        "v"
-      ],
-      "engine": "rapier"
-    },
-    "useManifold": true
-  },
-  "actors": [
-    {
-      "uuid": "9a86d389088b361c",
-      "class": "ENGINE.Actor",
-      "properties": {
-        "editorData": {
-          "displayName": "Directional Light",
-          "hidden": false
-        }
-      },
-      "ctor": {
-        "rootComponent": {
-          "class": "ENGINE.DirectionalLightComponent",
-          "uuid": "cfe05433-9edc-4dfe-a535-c71f33e92d78",
-          "ctor": {
-            "color": 16777215,
-            "intensity": 1,
-            "castShadow": true,
-            "shadowMapSize": 2048,
-            "shadowBias": 0,
-            "shadowNormalBias": 0,
-            "shadowNear": 0.1,
-            "shadowFar": 100
-          },
-          "properties": {
-            "position": [
-              10,
-              50,
-              -10,
-              "v"
-            ],
-            "castShadow": true
-          }
-        }
-      }
-    },
-    {
-      "uuid": "9d428f2a16e5374a",
-      "class": "ENGINE.Actor",
-      "properties": {
-        "editorData": {
-          "displayName": "Ground",
-          "hidden": false
-        }
-      },
-      "ctor": {
-        "rootComponent": {
-          "class": "ENGINE.MeshComponent",
-          "uuid": "71caea24-62d7-4e45-a76e-4c7519de2c3c",
-          "ctor": {
-            "geometry": {
-              "class": "THREE.BoxGeometry",
-              "ctor": [
-                500,
-                0.1,
-                500
-              ]
-            },
-            "material": {
-              "@external": "DefaultMaterial"
-            },
-            "uvScaleTilesPerUnit": 0.2,
-            "physicsOptions": {
-              "enabled": true,
-              "motionType": "static",
-              "collisionProfile": "BlockAll"
-            }
-          },
-          "properties": {
-            "position": [
-              0,
-              -0.9,
-              0,
-              "v"
-            ],
-            "receiveShadow": true
-          }
-        }
-      }
-    },
-    {
-      "uuid": "b87cbc5e60a2e54c",
-      "class": "ENGINE.PlayerStart",
-      "properties": {
-        "editorData": {
-          "displayName": "Player Start",
-          "hidden": false
-        }
-      },
-      "ctor": {
-        "rootComponent": {
-          "class": "ENGINE.SceneComponent",
-          "uuid": "b4d5f8f7-2512-45e1-9157-c7ff6772402d",
-          "ctor": {},
-          "properties": {
-            "position": [
-              0,
-              0.9,
-              0,
-              "v"
-            ]
-          }
-        }
-      }
-    },
-    {
-      "uuid": "0ba1f4677e8370d1",
-      "class": "ENGINE.Actor",
-      "properties": {
-        "editorData": {
-          "displayName": "Skybox",
-          "hidden": false
-        }
-      },
-      "ctor": {
-        "rootComponent": {
-          "class": "ENGINE.SceneComponent",
-          "uuid": "195e88df-73ff-4f4b-82ae-7fb58671463d",
-          "ctor": {},
-          "properties": {},
-          "children": [
-            {
-              "class": "ENGINE.SkyboxComponent",
-              "uuid": "a6cea5af-a972-4031-97b4-cd9218198a2f",
-              "ctor": {
-                "textureUrl": "@engine/assets/textures/skybox/citrus_orchard_road_puresky_2k.hdr",
-                "width": 2048,
-                "height": 1024,
-                "bottomColor": "#E6F3FF",
-                "middleColor": "#4A90E2",
-                "topColor": "#0F1B3C",
-                "envMapIntensity": 1
-              },
-              "properties": {}
-            }
-          ]
-        }
-      }
-    }
-  ],
-  "properties": {
-    "editorData": {}
-  }
+{
+  "$version": 0,
+  "class": "ENGINE.World",
+  "uuid": "c0ae85792bc3b946",
+  "ctor": {
+    "backgroundColor": 3026478,
+    "navigationOptions": {
+      "engine": "recast-navigation",
+      "debug": false,
+      "generateOnStartUp": false
+    },
+    "physicsOptions": {
+      "gravity": [
+        0,
+        -9.81,
+        0,
+        "v"
+      ],
+      "engine": "rapier"
+    },
+    "useManifold": true
+  },
+  "actors": [
+    {
+      "uuid": "9a86d389088b361c",
+      "class": "ENGINE.Actor",
+      "properties": {
+        "editorData": {
+          "displayName": "Directional Light",
+          "hidden": false
+        }
+      },
+      "ctor": {
+        "rootComponent": {
+          "class": "ENGINE.DirectionalLightComponent",
+          "uuid": "cfe05433-9edc-4dfe-a535-c71f33e92d78",
+          "ctor": {
+            "color": 16777215,
+            "intensity": 1,
+            "castShadow": true,
+            "shadowMapSize": 2048,
+            "shadowBias": 0,
+            "shadowNormalBias": 0,
+            "shadowNear": 0.1,
+            "shadowFar": 100
+          },
+          "properties": {
+            "position": [
+              10,
+              50,
+              -10,
+              "v"
+            ],
+            "castShadow": true
+          }
+        }
+      }
+    },
+    {
+      "uuid": "9d428f2a16e5374a",
+      "class": "ENGINE.Actor",
+      "properties": {
+        "editorData": {
+          "displayName": "Ground",
+          "hidden": false
+        }
+      },
+      "ctor": {
+        "rootComponent": {
+          "class": "ENGINE.MeshComponent",
+          "uuid": "71caea24-62d7-4e45-a76e-4c7519de2c3c",
+          "ctor": {
+            "geometry": {
+              "class": "THREE.BoxGeometry",
+              "ctor": [
+                500,
+                0.1,
+                500
+              ]
+            },
+            "material": {
+              "@external": "DefaultMaterial"
+            },
+            "uvScaleTilesPerUnit": 0.2,
+            "physicsOptions": {
+              "enabled": true,
+              "motionType": "static",
+              "collisionProfile": "BlockAll"
+            }
+          },
+          "properties": {
+            "position": [
+              0,
+              -0.9,
+              0,
+              "v"
+            ],
+            "receiveShadow": true
+          }
+        }
+      }
+    },
+    {
+      "uuid": "b87cbc5e60a2e54c",
+      "class": "ENGINE.PlayerStart",
+      "properties": {
+        "editorData": {
+          "displayName": "Player Start",
+          "hidden": false
+        }
+      },
+      "ctor": {
+        "rootComponent": {
+          "class": "ENGINE.SceneComponent",
+          "uuid": "b4d5f8f7-2512-45e1-9157-c7ff6772402d",
+          "ctor": {},
+          "properties": {
+            "position": [
+              0,
+              0.9,
+              0,
+              "v"
+            ]
+          }
+        }
+      }
+    },
+    {
+      "uuid": "0ba1f4677e8370d1",
+      "class": "ENGINE.Actor",
+      "properties": {
+        "editorData": {
+          "displayName": "Skybox",
+          "hidden": false
+        }
+      },
+      "ctor": {
+        "rootComponent": {
+          "class": "ENGINE.SceneComponent",
+          "uuid": "195e88df-73ff-4f4b-82ae-7fb58671463d",
+          "ctor": {},
+          "properties": {},
+          "children": [
+            {
+              "class": "ENGINE.SkyboxComponent",
+              "uuid": "a6cea5af-a972-4031-97b4-cd9218198a2f",
+              "ctor": {
+                "textureUrl": "@engine/assets/textures/skybox/citrus_orchard_road_puresky_2k.hdr",
+                "width": 2048,
+                "height": 1024,
+                "bottomColor": "#E6F3FF",
+                "middleColor": "#4A90E2",
+                "topColor": "#0F1B3C",
+                "envMapIntensity": 1
+              },
+              "properties": {}
+            }
+          ]
+        }
+      }
+    }
+  ],
+  "properties": {
+    "editorData": {}
+  }
 }

package/src/templates/src/templates/thirdPerson/src/game.ts

@@ -1,39 +1,39 @@
-
-import * as ENGINE from 'genesys.js';
-import * as THREE from 'three';
-
-import { ThirdPersonPlayer } from './player.js';
-import './auto-imports.js';
-
-class ThirdPersonGame extends ENGINE.BaseGameLoop {
-  private pawn: ThirdPersonPlayer | null = null;
-  private controller: ENGINE.PlayerController | null = null;
-
-  protected override createLoadingScreen(): ENGINE.ILoadingScreen | null {
-    // enable the default loading screen
-    return new ENGINE.DefaultLoadingScreen();
-  }
-
-  protected override async preStart(): Promise<void> {
-    // default spawn location
-    const position = new THREE.Vector3(0, ENGINE.CHARACTER_HEIGHT / 2, 0);
-
-    // create the pawn
-    this.pawn = new ThirdPersonPlayer({ position });
-
-    // create the controller and possess the pawn
-    this.controller = new ENGINE.PlayerController();
-    this.controller.possess(this.pawn);
-
-    // add both to the world
-    this.world.addActors(this.pawn, this.controller);
-  }
-}
-
-export function main(container: HTMLElement, gameId: string): ENGINE.IGameLoop {
-  const game = new ThirdPersonGame(container, {
-    ...ENGINE.BaseGameLoop.DEFAULT_OPTIONS,
-    gameId
-  });
-  return game;
-}
+
+import * as ENGINE from '@directivegames/genesys.js';
+import * as THREE from 'three';
+
+import { ThirdPersonPlayer } from './player.js';
+import './auto-imports.js';
+
+class ThirdPersonGame extends ENGINE.BaseGameLoop {
+  private pawn: ThirdPersonPlayer | null = null;
+  private controller: ENGINE.PlayerController | null = null;
+
+  protected override createLoadingScreen(): ENGINE.ILoadingScreen | null {
+    // enable the default loading screen
+    return new ENGINE.DefaultLoadingScreen();
+  }
+
+  protected override async preStart(): Promise<void> {
+    // default spawn location
+    const position = new THREE.Vector3(0, ENGINE.CHARACTER_HEIGHT / 2, 0);
+
+    // create the pawn
+    this.pawn = new ThirdPersonPlayer({ position });
+
+    // create the controller and possess the pawn
+    this.controller = new ENGINE.PlayerController();
+    this.controller.possess(this.pawn);
+
+    // add both to the world
+    this.world.addActors(this.pawn, this.controller);
+  }
+}
+
+export function main(container: HTMLElement, gameId: string): ENGINE.IGameLoop {
+  const game = new ThirdPersonGame(container, {
+    ...ENGINE.BaseGameLoop.DEFAULT_OPTIONS,
+    gameId
+  });
+  return game;
+}