@hytopia.com/examples 1.0.2 → 1.0.3

package/frontiers-rpg-game/src/GameManager.ts

@@ -0,0 +1,30 @@
+import { WorldManager } from 'hytopia';
+import type GameRegion from './GameRegion';
+
+// Regions
+import StalkhavenRegion from './regions/StalkhavenRegion';
+
+export default class GameManager {
+  public static readonly instance = new GameManager();
+
+  private _regions: Map<string, GameRegion> = new Map(); // tag -> region
+  private _startRegion: GameRegion;
+
+  public get startRegion(): GameRegion { return this._startRegion; }
+
+  public getRegion(tag: string): GameRegion | undefined {
+    return this._regions.get(tag);
+  }
+
+  public loadRegions(): void {
+    // Stalkhaven, Main City (Start)
+    const stalkhavenRegion = new StalkhavenRegion();
+    this._regions.set(stalkhavenRegion.tag!, stalkhavenRegion);
+    this._startRegion = stalkhavenRegion;
+
+    // Other regions...
+
+    // Set Stalkhaven as the region/world players automatically join when they connect to the game.
+    WorldManager.instance.setDefaultWorld(stalkhavenRegion.world);
+  }
+}

package/frontiers-rpg-game/src/GameRegion.ts

@@ -0,0 +1,53 @@
+import {
+  DefaultPlayerEntity,
+  ErrorHandler,
+  Player,
+  PlayerEvent,
+  World,
+  WorldManager,
+  WorldOptions,
+  Vector3Like,
+} from 'hytopia';
+
+export type GameRegionOptions = {
+  spawnPoint?: Vector3Like,
+} & Omit<WorldOptions, 'id'>;
+
+export default class GameRegion {
+  private _isSetup: boolean = false;
+  private _spawnPoint: Vector3Like;
+  private readonly _world: World;
+
+  public constructor(options: GameRegionOptions) {
+    this._spawnPoint = options.spawnPoint ?? { x: 0, y: 10, z: 0 };
+
+    this._world = WorldManager.instance.createWorld(options);
+    this._world.on(PlayerEvent.JOINED_WORLD, ({ player }) => this._onPlayerJoin(player));
+    this._world.on(PlayerEvent.LEFT_WORLD, ({ player }) => this._onPlayerLeave(player));
+
+    this._setup();
+  }
+
+  public get name(): string { return this._world.name; }
+  public get spawnPoint(): Vector3Like { return this._spawnPoint; }
+  public get tag(): string | undefined { return this._world.tag; }
+  public get world(): World { return this._world; }
+
+  protected _setup(): void { // intended to be overridden by subclasses
+    if (this._isSetup) {
+      return ErrorHandler.warning(`GameRegion.setup(): ${this.name} already setup.`);
+    }
+
+    this._isSetup = true;
+  }
+
+  protected _onPlayerJoin(player: Player) {
+    (new DefaultPlayerEntity({ player })).spawn(this._world, this._spawnPoint);
+  }
+
+  protected _onPlayerLeave(player: Player) {
+    this._world.entityManager.getPlayerEntitiesByPlayer(player).forEach(entity => {
+      entity.despawn()
+  });
+  }
+}

package/frontiers-rpg-game/src/entities/BaseEntity.ts

@@ -0,0 +1,103 @@
+import {
+  Entity,
+  EntityOptions,
+  MoveOptions,
+  PathfindingEntityController,
+  PathfindingOptions,
+  Quaternion,
+  RigidBodyType,
+  Vector3Like,
+} from 'hytopia';
+
+export type BaseEntityOptions = {
+  controller?: PathfindingEntityController;
+  facingAngle?: number;
+  facingPosition?: Vector3Like;
+  idleAnimations?: string[];
+  idleAnimationSpeed?: number;
+  moveAnimations?: string[];
+  moveAnimationSpeed?: number;
+  moveSpeed?: number;
+  pushable?: boolean;
+} & EntityOptions;
+
+export type WanderOptions = {
+  idleMinMs: number;
+  idleMaxMs: number;
+  moveOptions?: MoveOptions;
+  pathfindOptions?: PathfindingOptions;
+}
+
+export default class BaseEntity extends Entity {
+  private _moveSpeed: number;
+  private _wanderAccumulatorMs: number = 0;
+  
+  public constructor(options: BaseEntityOptions) {
+    super({
+      ...options,
+      controller: new PathfindingEntityController(),
+      rigidBodyOptions: {
+        ...options.rigidBodyOptions,
+        type: RigidBodyType.DYNAMIC,
+        enabledRotations: { x: false, y: true, z: false },
+        rotation: Quaternion.fromEuler(0, options.facingAngle ?? 0, 0),
+        additionalMass: !options.pushable ? 1000 : 0,
+      }
+    });
+
+    this._moveSpeed = options.moveSpeed ?? 2;
+
+    this.pathfindingController.idleLoopedAnimations = options.idleAnimations ?? [];
+    this.pathfindingController.idleLoopedAnimationsSpeed = options.idleAnimationSpeed ?? undefined;
+    this.pathfindingController.moveLoopedAnimations = options.moveAnimations ?? [];
+    this.pathfindingController.moveLoopedAnimationsSpeed = options.moveAnimationSpeed ?? undefined;
+
+    if (options.facingPosition) {
+      this.pathfindingController.face(options.facingPosition, this._moveSpeed);
+    }
+  }
+
+  public get idleAnimations(): string[] { return this.pathfindingController.idleLoopedAnimations; }
+  public get idleAnimationsSpeed(): number | undefined { return this.pathfindingController.idleLoopedAnimationsSpeed; }
+  public get moveAnimations(): string[] { return this.pathfindingController.moveLoopedAnimations; }
+  public get moveAnimationsSpeed(): number | undefined { return this.pathfindingController.moveLoopedAnimationsSpeed; }
+  public get moveSpeed(): number { return this._moveSpeed; }
+  public get pathfindingController(): PathfindingEntityController { return this.controller as PathfindingEntityController; }
+
+  public faceTowards(target: Vector3Like, faceSpeed: number) {
+    this.pathfindingController.face(target, faceSpeed);
+  }
+
+  public jump(height: number) {
+    this.pathfindingController.jump(height);
+  }
+
+  public pathfindTo(target: Vector3Like, speed: number = this._moveSpeed, options?: PathfindingOptions) {
+    this.pathfindingController.pathfind(target, speed, options);
+  }
+
+  public moveTo(target: Vector3Like, speed: number = this._moveSpeed, options?: MoveOptions) {
+    this.pathfindingController.move(target, speed, options);
+  }
+
+  public stopMoving() {
+    // reset & cancels all movements.
+    this.pathfindingController.pathfind(this.position, 1);
+  }
+
+  public wander(targets: Vector3Like[], speed: number = this._moveSpeed, options?: WanderOptions) {
+    const randomIndex = Math.floor(Math.random() * targets.length);
+    const target = targets[randomIndex];
+    this.pathfindTo(target, speed, {
+      debug: true,
+      maxFall: 5,
+      maxJump: 0,
+      maxOpenSetIterations: 400,
+      waypointTimeoutMs: 500,
+      pathfindCompleteCallback: () => {
+        setTimeout(() => this.wander(targets, speed, options), 2000);
+      }
+    });
+    console.log('wandering to', target);
+  }
+}

package/frontiers-rpg-game/src/entities/npcs/AdventurerEntity.ts

@@ -0,0 +1,13 @@
+import BaseEntity, { BaseEntityOptions } from '../BaseEntity';
+
+export default class AdventurerEntity extends BaseEntity {
+  public constructor(options?: BaseEntityOptions) {
+    super({
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/npcs/adventurer.gltf',
+      modelScale: 0.75,
+      name: 'Adventurer',
+      ...options,
+    });
+  }
+}

package/frontiers-rpg-game/src/entities/npcs/BankerEntity.ts

@@ -0,0 +1,13 @@
+import BaseEntity, { BaseEntityOptions } from '../BaseEntity';
+
+export default class BankerEntity extends BaseEntity {
+  public constructor(options?: BaseEntityOptions) {
+    super({
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/npcs/banker.gltf',
+      modelScale: 0.75,
+      name: 'Banker',
+      ...options,
+    });
+  }
+}

package/frontiers-rpg-game/src/entities/npcs/BlacksmithEntity.ts

@@ -0,0 +1,13 @@
+import BaseEntity, { BaseEntityOptions } from '../BaseEntity';
+
+export default class BlacksmithEntity extends BaseEntity {
+  public constructor(options?: BaseEntityOptions) {
+    super({
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/npcs/blacksmith.gltf',
+      modelScale: 0.75,
+      name: 'Blacksmith',
+      ...options,
+    });
+  }
+}

package/frontiers-rpg-game/src/entities/npcs/CapfolkElderEntity.ts

@@ -0,0 +1,17 @@
+import BaseEntity, { BaseEntityOptions } from '../BaseEntity';
+
+export default class CapfolkElderEntity extends BaseEntity {
+  public constructor(options?: BaseEntityOptions) {
+    super({
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/npcs/mushroom-elder.gltf',
+      modelScale: 0.6,
+      moveAnimations: [ 'walk' ],
+      moveAnimationSpeed: 2,
+      moveSpeed: 3,
+      name: 'Capfolk Elder',
+      pushable: false,
+      ...options,
+    });
+  }
+}

package/frontiers-rpg-game/src/entities/npcs/CapfolkKnightEntity.ts

@@ -0,0 +1,17 @@
+import BaseEntity, { BaseEntityOptions } from '../BaseEntity';
+
+export default class CapfolkKnightEntity extends BaseEntity {
+  public constructor(options?: BaseEntityOptions) {
+    super({
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/npcs/mushroom-knight.gltf',
+      modelScale: 0.5 + Math.random() * 0.2,
+      moveAnimations: [ 'walk' ],
+      moveAnimationSpeed: 2,
+      moveSpeed: 3,
+      name: 'Capfolk Knight',
+      pushable: false,
+      ...options,
+    });
+  }
+}

package/frontiers-rpg-game/src/entities/npcs/CapfolkVillagerEntity.ts

@@ -0,0 +1,17 @@
+import BaseEntity, { BaseEntityOptions } from '../BaseEntity';
+
+export default class CapfolkBoyEntity extends BaseEntity {
+  public constructor(options?: BaseEntityOptions) {
+    super({
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/npcs/mushroom-boy.gltf',
+      modelScale: 0.5 + Math.random() * 0.15,
+      moveAnimations: [ 'walk' ],
+      moveAnimationSpeed: 2,
+      moveSpeed: 3,
+      name: 'Capfolk Boy',
+      pushable: false,
+      ...options,
+    });
+  }
+}

package/frontiers-rpg-game/src/entities/npcs/FarmerEntity.ts

@@ -0,0 +1,13 @@
+import BaseEntity, { BaseEntityOptions } from '../BaseEntity';
+
+export default class BankerEntity extends BaseEntity {
+  public constructor(options?: BaseEntityOptions) {
+    super({
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/npcs/farmer2.gltf',
+      modelScale: 0.75,
+      name: 'Farmer',
+      ...options,
+    });
+  }
+}

package/frontiers-rpg-game/src/entities/npcs/MerchantEntity.ts

@@ -0,0 +1,13 @@
+import BaseEntity, { BaseEntityOptions } from '../BaseEntity';
+
+export default class MerchantEntity extends BaseEntity {
+  public constructor(options?: BaseEntityOptions) {
+    super({
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/npcs/merchant.gltf',
+      modelScale: 0.75,
+      name: 'Merchant',
+      ...options,
+    });
+  }
+}

package/frontiers-rpg-game/src/regions/StalkhavenRegion.ts

@@ -0,0 +1,77 @@
+import { Quaternion } from 'hytopia';
+
+import GameRegion from '../GameRegion';
+import stalkhavenMap from '../../assets/maps/stalkhaven.json';
+
+import AdventurerEntity from '../entities/npcs/AdventurerEntity';
+import BankerEntity from '../entities/npcs/BankerEntity';
+import BlacksmithEntity from '../entities/npcs/BlacksmithEntity';
+import FarmerEntity from '../entities/npcs/FarmerEntity';
+import MerchantEntity from '../entities/npcs/MerchantEntity';
+import CapfolkVillagerEntity from '../entities/npcs/CapfolkVillagerEntity';
+import CapfolkElderEntity from '../entities/npcs/CapfolkElderEntity';
+import CapfolkKnightEntity from '../entities/npcs/CapfolkKnightEntity';
+
+export default class StalkhavenRegion extends GameRegion {
+  public constructor() {
+    super({
+      name: 'Stalkhaven',
+      map: stalkhavenMap,
+      skyboxUri: 'skyboxes/partly-cloudy',
+      spawnPoint: { x: 1, y: 5, z: 40 },
+    });
+  }
+
+  protected override _setup(): void {
+    super._setup();
+
+    (new AdventurerEntity({ facingAngle: 90 })).spawn(this.world, { x: 30, y: 2, z: 22 });
+    (new BankerEntity({ facingAngle: 90 })).spawn(this.world, { x: 12, y: 3, z: 41 });
+    (new BlacksmithEntity({ facingAngle: -120 })).spawn(this.world, { x: -25.5, y: 3, z: -12.5 });
+    (new CapfolkElderEntity({ facingAngle: 180 })).spawn(this.world, { x: -13.5, y: 2, z: -30 });
+    (new FarmerEntity({ facingAngle: -90 })).spawn(this.world, { x: -32, y: 3, z: 1 });
+    (new MerchantEntity({ facingAngle: 90 })).spawn(this.world, { x: 13, y: 3, z: 26.5 });
+
+    (new CapfolkVillagerEntity({ facingAngle: -30 })).spawn(this.world, { x: -1.5, y: 2, z: 45.5 });
+    (new CapfolkVillagerEntity({ facingAngle: 15 })).spawn(this.world, { x: 3, y: 2, z: 45.5 });
+    (new CapfolkKnightEntity({ modelScale: 0.7 })).spawn(this.world, { x: 0.75, y: 2, z: 45 });
+
+
+    const wonderDestinations = [
+      { x: -16.5, y: 1.5, z: -30 },   // church 1
+      { x: -12.5, y: 1.5, z: -27 },   // church 2
+      { x: -14,   y: 1.5, z: -24 },   // church 3  
+      { x: -27,   y: 1.5, z: -22.5 }, // cemetary 1
+      { x: -22,   y: 1.5, z: -12 },   // blacksmith
+      { x: -11, y: 1.5, z: -12.5 },  // town square 1
+      { x: 2, y: 1.5, z: -10.5 },  // town square 2
+      { x: 12.5, y: 1.5, z: 3 },  // town square 3
+      { x: -10, y: 1.5, z: -15 },  // town square 4
+      { x: 10.5, y: 1.5, z: 26.5 },  // merchant
+      { x: 9, y: 1.5, z: 41 },  // banker
+      { x: 22, y: 1.5, z: 41 },  // well 1
+      { x: 30, y: 1.5, z: 42 },  // well 2
+      { x: 28, y: 1.5, z: 36 },  // well 3
+      { x: 32, y: 1.5, z: 40 },  // well 4
+      { x: 28, y: 1.5, z: 25 },  // inn 1
+      { x: 29, y: 1.5, z: 18.5 },  // inn 2
+      { x: 26, y: 1.5, z: 16.5 },  // inn 3
+      { x: 22, y: 1.5, z: 9.5 },  // inn garden
+      { x: 28, y: 1.5, z: -6 },  // market 1
+      { x: 27, y: 1.5, z: -20 },  // market 2
+      { x: 29.5, y: 1.5, z: -29 },  // market 3
+      { x: 28, y: 1.5, z: -32 },  // market 3
+      { x: 16, y: 1.5, z: -25 },  // market 4
+      { x: 17, y: 1.5, z: -15 },  // market 5
+    ];
+
+    for (let i = 0; i < 20; i++) {
+      const spawnPoint = wonderDestinations[Math.floor(Math.random() * wonderDestinations.length)];
+      const villager = new CapfolkVillagerEntity();
+      villager.spawn(this.world, spawnPoint);
+      setTimeout(() => {
+        villager.wander(wonderDestinations, 1 + Math.random() * 3);
+      }, 5000);
+    }
+  }
+}

package/hole-in-wall-game/index.ts

@@ -15,6 +15,7 @@ import {
   World,
   CollisionGroup,
   PlayerEntity,
+  DefaultPlayerEntityController,
 } from 'hytopia';
 
 import GAME_WALL_SHAPES from './wall-shapes';
@@ -93,7 +94,7 @@ function onPlayerJoin(world: World, player: Player) {
   const playerEntity = new DefaultPlayerEntity({
     player,
     name: 'Player',
-    modelUri: 'models/players/soldier-player.gltf',
+    modelUri: 'models/players/player.gltf',
   });
 
   playerEntity.spawn(world, GAME_CONFIG.POSITIONS.PLAYER_SPAWN);
@@ -113,6 +114,8 @@ function onPlayerJoin(world: World, player: Player) {
       killPlayer(playerEntity);
     }
   });
+
+  (playerEntity.controller as DefaultPlayerEntityController).canSwim = () => false;
 }
 
 function onPlayerLeave(world: World, player: Player) {

package/hole-in-wall-game/package.json

@@ -10,8 +10,8 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@hytopia.com/assets": "^0.2.21",
-    "hytopia": "^0.5.20"
+    "@hytopia.com/assets": "latest",
+    "hytopia": "latest"
   },
   "trustedDependencies": [
     "mediasoup",

package/hygrounds/classes/GamePlayerEntity.ts

@@ -84,6 +84,7 @@ export default class GamePlayerEntity extends DefaultPlayerEntity {
       player,
       name: 'Player',
       modelUri: 'models/players/soldier-player.gltf',
+      modelScale: 0.5,
     });
     
     this._setupPlayerController();
@@ -370,6 +371,7 @@ export default class GamePlayerEntity extends DefaultPlayerEntity {
   }
 
   private _setupPlayerController(): void {
+    this.playerController.applyDirectionalMovementRotations = false;
     this.playerController.autoCancelMouseLeftClick = false;
 
     this.resetAnimations();

package/hygrounds/package.json

@@ -10,8 +10,8 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@hytopia.com/assets": "^0.2.21",
-    "hytopia": "^0.5.20"
+    "@hytopia.com/assets": "latest",
+    "hytopia": "latest"
   },
   "trustedDependencies": [
     "mediasoup",

package/lighting/package.json

@@ -10,8 +10,8 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@hytopia.com/assets": "^0.2.21",
-    "hytopia": "^0.5.20"
+    "@hytopia.com/assets": "latest",
+    "hytopia": "latest"
   },
   "trustedDependencies": [
     "mediasoup",

package/mobile-controls/package.json

@@ -9,8 +9,8 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@hytopia.com/assets": "^0.2.21",
-    "hytopia": "^0.5.20"
+    "@hytopia.com/assets": "latest",
+    "hytopia": "latest"
   },
   "trustedDependencies": [
     "mediasoup",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hytopia.com/examples",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "",
   "license": "ISC",
   "author": "",

package/pathfinding/index.ts

@@ -19,7 +19,6 @@ startServer(world => {
     controller: new PathfindingEntityController(),
     name: 'Zombie',
     modelUri: 'models/npcs/zombie.gltf',
-    modelLoopedAnimations: [ 'walk' ],
     modelScale: 0.5,
     rigidBodyOptions: {
       enabledRotations: { x: false, y: true, z: false },
@@ -27,6 +26,10 @@ startServer(world => {
     },
   });
 
+  const pathfindingController = zombie.controller as PathfindingEntityController;
+  pathfindingController.idleLoopedAnimations = [ 'walk' ];
+  pathfindingController.moveLoopedAnimations = [ 'run' ];
+
   // Spawn somewhere in front of the player
   zombie.spawn(world, { x: 4, y: 3, z: -6 }, Quaternion.fromEuler(0, 180, 0)); // rotate 180 degrees around Y, facing the player spawn point.
 

package/pathfinding/package.json

@@ -10,8 +10,8 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@hytopia.com/assets": "^0.2.21",
-    "hytopia": "^0.5.20"
+    "@hytopia.com/assets": "latest",
+    "hytopia": "latest"
   },
   "trustedDependencies": [
     "mediasoup",

package/payload-game/index.ts

@@ -109,6 +109,7 @@ startServer(world => { // Perform our game setup logic in the startServer init c
       player,
       name: 'Player',
       modelUri: 'models/soldier-player.gltf',
+      modelScale: 0.5,
     });
 
     
@@ -126,6 +127,7 @@ startServer(world => { // Perform our game setup logic in the startServer init c
 
     // Override default model animations
     const playerController = playerEntity.controller as DefaultPlayerEntityController;
+    playerController.applyDirectionalMovementRotations = false;
     playerController.idleLoopedAnimations = [ 'idle_lower', 'idle_gun_right' ];
     playerController.interactOneshotAnimations = [];
     playerController.walkLoopedAnimations = ['walk_lower', 'idle_gun_right' ];

package/payload-game/package.json

@@ -10,8 +10,8 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@hytopia.com/assets": "^0.2.21",
-    "hytopia": "^0.5.20"
+    "@hytopia.com/assets": "latest",
+    "hytopia": "latest"
   },
   "trustedDependencies": [
     "mediasoup",

package/player-persistence/package.json

@@ -10,8 +10,8 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@hytopia.com/assets": "^0.2.21",
-    "hytopia": "^0.5.20"
+    "@hytopia.com/assets": "latest",
+    "hytopia": "latest"
   },
   "trustedDependencies": [
     "mediasoup",

package/wall-dodge-game/index.ts

@@ -15,6 +15,7 @@ import {
   SimpleEntityController,
   World,
   Collider,
+  DefaultPlayerEntityController,
 } from 'hytopia';
 
 import worldMap from './assets/map.json';
@@ -276,6 +277,7 @@ function onPlayerJoin(world: World, player: Player) {
 
   // Spawn with a random X coordinate to spread players out a bit.
   playerEntity.spawn(world, getRandomSpawnCoordinate());
+  (playerEntity.controller as DefaultPlayerEntityController).canSwim = () => false;
 }
 
 /**

package/wall-dodge-game/package.json

@@ -10,8 +10,8 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@hytopia.com/assets": "^0.2.21",
-    "hytopia": "^0.5.20"
+    "@hytopia.com/assets": "latest",
+    "hytopia": "latest"
   },
   "trustedDependencies": [
     "mediasoup",

package/world-switching/package.json

@@ -10,8 +10,8 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@hytopia.com/assets": "^0.2.21",
-    "hytopia": "^0.5.20"
+    "@hytopia.com/assets": "latest",
+    "hytopia": "latest"
   },
   "trustedDependencies": [
     "mediasoup",

package/zombies-fps/classes/GamePlayerEntity.ts

@@ -53,10 +53,12 @@ export default class GamePlayerEntity extends DefaultPlayerEntity {
       player,
       name: 'Player',
       modelUri: 'models/players/soldier-player.gltf',
+      modelScale: 0.5,
     });
     
     // Prevent mouse left click from being cancelled, required
     // for auto-fire and semi-auto fire mechanics, etc.
+    this.playerController.applyDirectionalMovementRotations = false;
     this.playerController.autoCancelMouseLeftClick = false;
     
     // Setup player animations

package/zombies-fps/package.json

@@ -10,8 +10,8 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@hytopia.com/assets": "^0.2.21",
-    "hytopia": "^0.5.20"
+    "@hytopia.com/assets": "latest",
+    "hytopia": "latest"
   },
   "trustedDependencies": [
     "mediasoup",