@directivegames/genesys.sdk 3.2.2

package/src/templates/src/templates/fps/src/game.ts

@@ -0,0 +1,39 @@
+import * as ENGINE from 'genesys.js';
+import * as THREE from 'three';
+
+import { FPSPlayer } from './player.js';
+
+import './auto-imports.js';
+
+class MyGame extends ENGINE.BaseGameLoop {
+  private pawn: FPSPlayer | 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);
+
+    // now create the pawn
+    this.pawn = new FPSPlayer({ 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 MyGame(container, {
+    ...ENGINE.BaseGameLoop.DEFAULT_OPTIONS,
+    gameId
+  });
+  return game;
+}

package/src/templates/src/templates/fps/src/player.ts

@@ -0,0 +1,69 @@
+import * as ENGINE from 'genesys.js';
+import * as THREE from 'three';
+
+import { DefaultWeapon } from './weapon.js';
+
+/**
+ * Options for the FPSPlayer class.
+ * Currently empty, can be extended if needed.
+ */
+export interface FPSPlayerOptions extends ENGINE.PawnOptions {
+}
+
+/**
+ * A FPS player class.
+ *
+ * Key points:
+ * - No need to provide rootComponent, movementComponent and camera, they are created internally
+ * - The pawn is set to be transient so it's never saved in the level
+ * - The directional light follows the player for consistent shadows
+ * - The weapon is created and attached to the camera
+ *
+ */
+@ENGINE.GameClass()
+export class FPSPlayer extends ENGINE.Pawn<FPSPlayerOptions> {
+  // No need to provide rootComponent, movementComponent and camera, they are created internally
+  constructor(options: Omit<FPSPlayerOptions, 'rootComponent' | 'movementComponent' | 'camera'>) {
+    // simple camera component - contains a perspective camera by default
+    const camera = new THREE.PerspectiveCamera(ENGINE.CAMERA_FOV, 1, ENGINE.CAMERA_NEAR, ENGINE.CAMERA_FAR);
+    // set proper camera height for first person view
+    camera.position.set(0, ENGINE.CHARACTER_HEIGHT * 0.4, 0);
+
+    // create the weapon and attach it to the camera
+    const weapon = new DefaultWeapon();
+    camera.add(weapon);
+
+    // use a simple capsule geometry as the root component
+    const rootComponent = new ENGINE.MeshComponent({
+      geometry: ENGINE.GameBuilder.createDefaultPawnCapsuleGeometry(),
+      material: new THREE.MeshStandardMaterial({ color: ENGINE.Color.YELLOW }),
+      physicsOptions: {
+        enabled: true,
+        // KinematicVelocityBased is required to use the physics character controller
+        motionType: ENGINE.PhysicsMotionType.KinematicVelocityBased,
+        collisionProfile: ENGINE.DefaultCollisionProfile.Pawn,
+        generateCollisionEvents: true,
+      }
+    });
+    // hide the mesh in first person view
+    rootComponent.getMesh().visible = false;
+
+    // create the movement component
+    const movementComponent = new ENGINE.CharacterMovementComponent({
+      ...ENGINE.CharacterMovementComponent.DEFAULT_OPTIONS,
+      movementType: ENGINE.CharacterMovementType.FirstPerson,
+    });
+
+    super({
+      ...options,
+      rootComponent,
+      movementComponent,
+      // make sure the directional light follows the player for consistent shadows
+      enableDirectionalLightFollowing: true,
+      camera
+    });
+
+    // set the pawn to be transient so it's never saved in the level
+    this.setTransient(true);
+  }
+}

package/src/templates/src/templates/fps/src/weapon.ts

@@ -0,0 +1,54 @@
+import * as ENGINE from 'genesys.js';
+import * as THREE from 'three';
+
+/**
+ * A default weapon class.
+ *
+ * Key points:
+ * - Inherits from the ProjectileWeaponComponent class
+ * - All the weapon options are configured in the constructor so no need to configure by the user
+ */
+@ENGINE.GameClass()
+export class DefaultWeapon extends ENGINE.ProjectileWeaponComponent {
+  constructor() {
+    super({
+      // firing params
+      fireInterval: 0.1,
+      isSingleFire: false,
+      // configure the weapon model
+      modelPath: '@project/assets/models/SM_Rifle.glb',
+      modelTransform: {
+        position: new THREE.Vector3(0.1, -0.1, -0.25),
+        rotation: new THREE.Euler(0, THREE.MathUtils.degToRad(-90), 0),
+      },
+      // tweak the projectile spawn offset so it matches the muzzle position
+      projectileSpawnOffset: new THREE.Vector3(0.8, -0.6, -2),
+      // add a crosshair
+      crosshairOptions: {
+        size: 10,
+        color: 'white',
+        style: 'dot'
+      },
+      // add weapon sounds
+      fireSoundUrl: '@engine/assets/sounds/game-gun-short.mp3',
+      // enable recoil
+      recoilOptions: {
+        weaponRecoilDistance: 0.05,
+        weaponRecoilDuration: 0.05,
+        weaponRecoilRotation: 0,
+      },
+      // configure the projectile
+      projectileOptions: {
+        velocity: 100,
+        range: 500,
+        lifeSpan: 3,
+        useOverlapCheck: false,
+        destroyOnHit: false,
+        gravityScale: 0,
+        geometry: new THREE.SphereGeometry(0.1),
+        material: new THREE.MeshStandardMaterial({ color: ENGINE.Color.YELLOW })
+      }
+    });
+    this.setTransient(true);
+  }
+}

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

@@ -0,0 +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": "f7e33ae7d5ac74f9",
+              "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/freeCamera/src/game.ts

@@ -0,0 +1,39 @@
+
+import * as ENGINE from 'genesys.js';
+import * as THREE from 'three';
+
+import { FreeCameraPlayer } from './player.js';
+import './auto-imports.js';
+
+class MyGame extends ENGINE.BaseGameLoop {
+  private pawn: FreeCameraPlayer | 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, 0);
+
+    // create the pawn with simple movement mechanics
+    this.pawn = new FreeCameraPlayer({ 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 MyGame(container, {
+    ...ENGINE.BaseGameLoop.DEFAULT_OPTIONS,
+    gameId
+  });
+  return game;
+}

package/src/templates/src/templates/freeCamera/src/player.ts

@@ -0,0 +1,45 @@
+import * as ENGINE from 'genesys.js';
+import * as THREE from 'three';
+
+
+/**
+ * Options for the FreeCameraPlayer class.
+ * Currently empty, can be extended if needed.
+ */
+export interface FreeCameraPlayerOptions extends ENGINE.PawnOptions {
+}
+
+/**
+ * A free camera player class.
+ *
+ * Key points:
+ * - No need to provide movementComponent and camera, they are created internally
+ * - The pawn is set to be transient so it's never saved in the level
+ * - The directional light follows the player for consistent shadows
+ *
+ */
+@ENGINE.GameClass()
+export class FreeCameraPlayer extends ENGINE.Pawn<FreeCameraPlayerOptions> {
+  constructor(options: Omit<FreeCameraPlayerOptions, 'camera' | 'movementComponent'>) {
+    // simple perspective camera
+    const camera = new THREE.PerspectiveCamera(ENGINE.CAMERA_FOV, 1, ENGINE.CAMERA_NEAR, ENGINE.CAMERA_FAR);
+    // simple movement component, do not use the character controller
+    const movementComponent = new ENGINE.CharacterMovementComponent({
+      ...ENGINE.CharacterMovementComponent.DEFAULT_OPTIONS,
+      // disable the character controller
+      characterControllerOptions: null,
+    });
+
+    // construct the pawn
+    super({
+      ...options,
+      camera,
+      movementComponent,
+      // make sure the directional light follows the player for consistent shadows
+      enableDirectionalLightFollowing: true,
+    });
+
+    // set the pawn to be transient so it's never saved in the level
+    this.setTransient(true);
+  }
+}

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

@@ -0,0 +1,122 @@
+{
+  "$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": "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": "f7e33ae7d5ac74f9",
+              "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/sideScroller/src/const.ts

@@ -0,0 +1,46 @@
+// Player Movement Configuration
+export const PLAYER_MOVEMENT = {
+  JUMP_SPEED: 20,
+  MAX_SPEED: 8,
+  MAX_MID_AIR_JUMPS: 1,
+  ACCELERATION_LAMBDA: 15,
+  DECELERATION_LAMBDA: 10,
+  MID_AIR_ACCELERATION_LAMBDA: 8,
+  MID_AIR_DECELERATION_LAMBDA: 2,
+} as const;
+
+// Camera Settings
+export const CAMERA_SETTINGS = {
+  FOV: 60,
+  NEAR: 0.1,
+  FAR: 1000,
+  DAMP_FACTOR: 10,
+  POSITION: { x: 0, y: 1, z: 8 },
+  LOOK_AT: { x: 0, y: 0, z: 0 },
+} as const;
+
+// Level Generation Configuration
+export const LEVEL_CONFIG = {
+  DEPTH: 3,
+  CHUNK_SIZE: 50,
+  CHUNKS_AHEAD: 2,
+  CHUNKS_BEHIND: 2,
+  PLATFORM_HEIGHT_RANGE: { min: 1, max: 2 },
+  PLATFORM_WIDTH_RANGE: { min: 3, max: 6 },
+  OBSTACLE_HEIGHT_RANGE: { min: 3, max: 6 },
+  OBSTACLE_WIDTH_RANGE: { min: 1.5, max: 3.0 },
+  CHUNK_MARGIN: 0,
+  MIN_SPACING: 4,
+  DEBUG_VISUALIZATION_HEIGHT: 6,
+  DEBUG_VISUALIZATION_OPACITY: 0.3,
+  DEBUG_VISUALIZATION_COLOR: 0x00ff00,
+  GROUND_HEIGHT: 0.1,
+  GROUND_Y_POSITION: -0.05,
+} as const;
+
+// Material colors
+export const COLORS = {
+  PLATFORM: 0x90ee90, // Light green
+  OBSTACLE: 0xff4444, // Red
+  GROUND: 0x8b4513,   // Brown
+} as const;