@directivegames/genesys.sdk 3.2.2 → 3.2.5

package/src/templates/src/templates/vehicle/src/base-vehicle.ts

@@ -1,145 +1,145 @@
-import * as ENGINE from 'genesys.js';
-import * as THREE from 'three';
-
-import { VehiclePlayer } from './player.js';
-
-/**
- * Base vehicle class that provides common vehicle functionality
- *
- * Key points:
- * - Handles camera setup with follow component for smooth third-person view
- * - Manages player interaction (enter/exit vehicle with proximity detection)
- * - Provides E key input handler for vehicle exit
- * - Calculates safe exit position when player leaves vehicle
- * - Automatically switches possession between player and vehicle
- *
- */
-export abstract class BaseVehicle extends ENGINE.Pawn {
-  protected readonly interactionDistance = 5;
-  protected nearbyPlayer: ENGINE.Pawn | null = null;
-  protected enteredPlayer: ENGINE.Pawn | null = null;
-
-  protected override doBeginPlay(): void {
-    super.doBeginPlay();
-    this.setupCamera();
-    this.setupVicinityCheck();
-    this.setupExitHandler();
-  }
-
-  protected setupCamera(): void {
-    // create a follow component for smooth camera movement
-    const followComponent = new ENGINE.FollowComponent({
-      positionOffset: new THREE.Vector3(0, 4, 10),
-      positionDamping: 0.02,
-      lookAtOffset: new THREE.Vector3(0, 0, 0),
-      target: this.rootComponent,
-      useCameraLookAtConvention: true,
-    });
-    this.rootComponent.add(followComponent);
-
-    // create a camera and add it to the follow component
-    const camera = new THREE.PerspectiveCamera(ENGINE.CAMERA_FOV, 1, ENGINE.CAMERA_NEAR, ENGINE.CAMERA_FAR);
-    followComponent.add(camera);
-  }
-
-  protected setupVicinityCheck(): void {
-    // Check every frame for nearby players using tick delegate
-    this.onTickPostPhysics.add(() => {
-      this.checkForNearbyPlayer();
-    });
-  }
-
-  protected checkForNearbyPlayer(): void {
-    const players = this.world!.getActors(VehiclePlayer);
-
-    let foundNearbyPlayer = false;
-    for (const player of players) {
-      const distance = this.rootComponent.position.distanceTo(player.rootComponent.position);
-      if (distance <= this.interactionDistance) {
-        this.nearbyPlayer = player;
-        foundNearbyPlayer = true;
-        break;
-      }
-    }
-
-    if (!foundNearbyPlayer) {
-      this.nearbyPlayer = null;
-    }
-  }
-
-  public canBeEntered(): boolean {
-    return this.nearbyPlayer !== null;
-  }
-
-  public getNearbyPlayer(): ENGINE.Pawn | null {
-    return this.nearbyPlayer;
-  }
-
-  protected setupExitHandler(): void {
-    // Add E key input handler for vehicle exit
-    this.onKeyDown.add((e: KeyboardEvent) => {
-      if (e.key.toLowerCase() === 'e' && this.enteredPlayer) {
-        this.exitVehicle();
-        return true;
-      } else if (e.key.toLowerCase() === 'f') {
-        if (this.movementComponent instanceof ENGINE.VehicleMovementComponent) {
-          this.movementComponent.flipVehicle(false);
-        }
-        return true;
-      }
-      return false;
-    });
-  }
-
-  public setEnteredPlayer(player: ENGINE.Pawn | null): void {
-    this.enteredPlayer = player;
-  }
-
-  protected exitVehicle(): void {
-    if (!this.enteredPlayer) return;
-
-    // Calculate exit position (to the side of the vehicle)
-    const exitPosition = this.calculateExitPosition();
-
-    // Get the current player controller
-    const controller = this.getPlayerController();
-
-    if (controller) {
-      // Move player to exit position
-      this.enteredPlayer.rootComponent.position.copy(exitPosition);
-
-      // Make player face the same direction as the vehicle (yaw only)
-      this.enteredPlayer.rootComponent.rotation.x = 0;
-      this.enteredPlayer.rootComponent.rotation.z = 0;
-      this.enteredPlayer.rootComponent.rotation.y = this.rootComponent.rotation.y;
-
-      // Restore player visibility and physics
-      this.enteredPlayer.rootComponent.visible = true;
-      // Only the root component has physics, do not propagate to children
-      this.enteredPlayer.rootComponent.setPhysicsEnabled(true, false);
-
-      // Switch possession back to player
-      controller.unpossess();
-      controller.possess(this.enteredPlayer);
-
-      // Clear entered player reference
-      this.enteredPlayer = null;
-    }
-  }
-
-  protected calculateExitPosition(): THREE.Vector3 {
-    // Calculate a position to the right side of the vehicle
-    const vehiclePosition = this.rootComponent.position.clone();
-    const vehicleRotation = this.rootComponent.rotation;
-
-    // Create a vector pointing to the right of the vehicle
-    const rightVector = new THREE.Vector3(1, 0, 0);
-    rightVector.applyEuler(vehicleRotation);
-
-    // Position the player 2 units to the right and slightly forward
-    const exitOffset = rightVector.multiplyScalar(2);
-    exitOffset.y = 1; // Raise slightly above ground
-
-    return vehiclePosition.add(exitOffset);
-  }
-}
+import * as ENGINE from '@directivegames/genesys.js';
+import * as THREE from 'three';
+
+import { VehiclePlayer } from './player.js';
+
+/**
+ * Base vehicle class that provides common vehicle functionality
+ *
+ * Key points:
+ * - Handles camera setup with follow component for smooth third-person view
+ * - Manages player interaction (enter/exit vehicle with proximity detection)
+ * - Provides E key input handler for vehicle exit
+ * - Calculates safe exit position when player leaves vehicle
+ * - Automatically switches possession between player and vehicle
+ *
+ */
+export abstract class BaseVehicle extends ENGINE.Pawn {
+  protected readonly interactionDistance = 5;
+  protected nearbyPlayer: ENGINE.Pawn | null = null;
+  protected enteredPlayer: ENGINE.Pawn | null = null;
+
+  protected override doBeginPlay(): void {
+    super.doBeginPlay();
+    this.setupCamera();
+    this.setupVicinityCheck();
+    this.setupExitHandler();
+  }
+
+  protected setupCamera(): void {
+    // create a follow component for smooth camera movement
+    const followComponent = new ENGINE.FollowComponent({
+      positionOffset: new THREE.Vector3(0, 4, 10),
+      positionDamping: 0.02,
+      lookAtOffset: new THREE.Vector3(0, 0, 0),
+      target: this.rootComponent,
+      useCameraLookAtConvention: true,
+    });
+    this.rootComponent.add(followComponent);
+
+    // create a camera and add it to the follow component
+    const camera = new THREE.PerspectiveCamera(ENGINE.CAMERA_FOV, 1, ENGINE.CAMERA_NEAR, ENGINE.CAMERA_FAR);
+    followComponent.add(camera);
+  }
+
+  protected setupVicinityCheck(): void {
+    // Check every frame for nearby players using tick delegate
+    this.onTickPostPhysics.add(() => {
+      this.checkForNearbyPlayer();
+    });
+  }
+
+  protected checkForNearbyPlayer(): void {
+    const players = this.world!.getActors(VehiclePlayer);
+
+    let foundNearbyPlayer = false;
+    for (const player of players) {
+      const distance = this.rootComponent.position.distanceTo(player.rootComponent.position);
+      if (distance <= this.interactionDistance) {
+        this.nearbyPlayer = player;
+        foundNearbyPlayer = true;
+        break;
+      }
+    }
+
+    if (!foundNearbyPlayer) {
+      this.nearbyPlayer = null;
+    }
+  }
+
+  public canBeEntered(): boolean {
+    return this.nearbyPlayer !== null;
+  }
+
+  public getNearbyPlayer(): ENGINE.Pawn | null {
+    return this.nearbyPlayer;
+  }
+
+  protected setupExitHandler(): void {
+    // Add E key input handler for vehicle exit
+    this.onKeyDown.add((e: KeyboardEvent) => {
+      if (e.key.toLowerCase() === 'e' && this.enteredPlayer) {
+        this.exitVehicle();
+        return true;
+      } else if (e.key.toLowerCase() === 'f') {
+        if (this.movementComponent instanceof ENGINE.VehicleMovementComponent) {
+          this.movementComponent.flipVehicle(false);
+        }
+        return true;
+      }
+      return false;
+    });
+  }
+
+  public setEnteredPlayer(player: ENGINE.Pawn | null): void {
+    this.enteredPlayer = player;
+  }
+
+  protected exitVehicle(): void {
+    if (!this.enteredPlayer) return;
+
+    // Calculate exit position (to the side of the vehicle)
+    const exitPosition = this.calculateExitPosition();
+
+    // Get the current player controller
+    const controller = this.getPlayerController();
+
+    if (controller) {
+      // Move player to exit position
+      this.enteredPlayer.rootComponent.position.copy(exitPosition);
+
+      // Make player face the same direction as the vehicle (yaw only)
+      this.enteredPlayer.rootComponent.rotation.x = 0;
+      this.enteredPlayer.rootComponent.rotation.z = 0;
+      this.enteredPlayer.rootComponent.rotation.y = this.rootComponent.rotation.y;
+
+      // Restore player visibility and physics
+      this.enteredPlayer.rootComponent.visible = true;
+      // Only the root component has physics, do not propagate to children
+      this.enteredPlayer.rootComponent.setPhysicsEnabled(true, false);
+
+      // Switch possession back to player
+      controller.unpossess();
+      controller.possess(this.enteredPlayer);
+
+      // Clear entered player reference
+      this.enteredPlayer = null;
+    }
+  }
+
+  protected calculateExitPosition(): THREE.Vector3 {
+    // Calculate a position to the right side of the vehicle
+    const vehiclePosition = this.rootComponent.position.clone();
+    const vehicleRotation = this.rootComponent.rotation;
+
+    // Create a vector pointing to the right of the vehicle
+    const rightVector = new THREE.Vector3(1, 0, 0);
+    rightVector.applyEuler(vehicleRotation);
+
+    // Position the player 2 units to the right and slightly forward
+    const exitOffset = rightVector.multiplyScalar(2);
+    exitOffset.y = 1; // Raise slightly above ground
+
+    return vehiclePosition.add(exitOffset);
+  }
+}

package/src/templates/src/templates/vehicle/src/game.ts

@@ -1,43 +1,43 @@
-
-import * as ENGINE from 'genesys.js';
-import * as THREE from 'three';
-
-import './auto-imports.js';
-import { VehiclePlayer } from './player.js';
-import { UIHints } from './ui-hints.js';
-
-class MyGame extends ENGINE.BaseGameLoop {
-  private pawn: VehiclePlayer | 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 VehiclePlayer({ position });
-
-    // create the controller and possess the pawn
-    this.controller = new ENGINE.PlayerController();
-    this.controller.possess(this.pawn);
-
-    // create UI hints
-    const uiHints = new UIHints();
-
-    // add all actors to the world
-    this.world.addActors(this.pawn, this.controller, uiHints);
-  }
-}
-
-export function main(container: HTMLElement, gameId: string): ENGINE.IGameLoop {
-  const game = new MyGame(container, {
-    ...ENGINE.BaseGameLoop.DEFAULT_OPTIONS,
-    gameId
-  });
-  return game;
-}
+
+import * as ENGINE from '@directivegames/genesys.js';
+import * as THREE from 'three';
+
+import './auto-imports.js';
+import { VehiclePlayer } from './player.js';
+import { UIHints } from './ui-hints.js';
+
+class MyGame extends ENGINE.BaseGameLoop {
+  private pawn: VehiclePlayer | 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 VehiclePlayer({ position });
+
+    // create the controller and possess the pawn
+    this.controller = new ENGINE.PlayerController();
+    this.controller.possess(this.pawn);
+
+    // create UI hints
+    const uiHints = new UIHints();
+
+    // add all actors to the world
+    this.world.addActors(this.pawn, this.controller, uiHints);
+  }
+}
+
+export function main(container: HTMLElement, gameId: string): ENGINE.IGameLoop {
+  const game = new MyGame(container, {
+    ...ENGINE.BaseGameLoop.DEFAULT_OPTIONS,
+    gameId
+  });
+  return game;
+}