hytopia 0.1.98 → 0.2.0

package/examples/zombies-fps/classes/guns/AK47Entity.ts

@@ -0,0 +1,43 @@
+import { Quaternion } from 'hytopia';
+import PistolEntity from './PistolEntity';
+import type { GunEntityOptions } from '../GunEntity';
+import type { PlayerEntity, QuaternionLike, Vector3Like } from 'hytopia';
+
+// fire behavior is very similar to a pistol, so we inherit from it.
+export default class AK47Entity extends PistolEntity {
+  public constructor(options: Partial<GunEntityOptions> = {}) {
+    super({
+      ammo: options.ammo ?? 30,
+      damage: options.damage ?? 3,
+      fireRate: options.fireRate ?? 10,
+      iconImageUri: options.iconImageUri ?? 'icons/ak-47.png',
+      idleAnimation: options.idleAnimation ?? 'idle_gun_both',
+      name: options.name ?? 'AK-47',
+      maxAmmo: options.maxAmmo ?? 30,
+      modelUri: options.modelUri ?? 'models/items/ak-47.glb',
+      reloadAudioUri: options.reloadAudioUri ?? 'audio/sfx/rifle-reload.mp3',
+      reloadTimeMs: options.reloadTimeMs ?? 1500,
+      shootAnimation: options.shootAnimation ?? 'shoot_gun_both',
+      shootAudioUri: options.shootAudioUri ?? 'audio/sfx/rifle-shoot.mp3',
+      ...options,
+    });
+  }
+
+  public override getMuzzleFlashPositionRotation(): { position: Vector3Like, rotation: QuaternionLike } {
+    return {
+      position: { x: 0, y: 0.01, z: -1.25 },
+      rotation: Quaternion.fromEuler(0, 90, 0),
+    };
+  }
+
+  public override shoot() {
+    if (!this.parent) {
+      return;
+    }
+
+    super.shoot();
+
+    const parentPlayerEntity = this.parent as PlayerEntity;
+    parentPlayerEntity.player.input.ml = true; // prevent cancel for auto fire.
+  }
+}

package/examples/zombies-fps/classes/guns/AR15Entity.ts

@@ -0,0 +1,32 @@
+import { Quaternion } from 'hytopia';
+import PistolEntity from './PistolEntity';
+import type { GunEntityOptions } from '../GunEntity';
+import type { PlayerEntity, QuaternionLike, Vector3Like } from 'hytopia';
+
+// fire behavior is very similar to a pistol, so we inherit from it.
+export default class AR15Entity extends PistolEntity {
+  public constructor(options: Partial<GunEntityOptions> = {}) {
+    super({
+      ammo: options.ammo ?? 30,
+      damage: options.damage ?? 4,
+      fireRate: options.fireRate ?? 15,
+      iconImageUri: options.iconImageUri ?? 'icons/ar-15.png',
+      idleAnimation: options.idleAnimation ?? 'idle_gun_both',
+      name: options.name ?? 'AR-15',
+      maxAmmo: options.maxAmmo ?? 30,
+      modelUri: options.modelUri ?? 'models/items/ar-15.glb',
+      reloadAudioUri: options.reloadAudioUri ?? 'audio/sfx/rifle-reload.mp3',
+      reloadTimeMs: options.reloadTimeMs ?? 1500,
+      shootAnimation: options.shootAnimation ?? 'shoot_gun_both',
+      shootAudioUri: options.shootAudioUri ?? 'audio/sfx/rifle-shoot.mp3',
+      ...options,
+    });
+  }
+
+  public override getMuzzleFlashPositionRotation(): { position: Vector3Like, rotation: QuaternionLike } {
+    return {
+      position: { x: 0.01, y: 0.03, z: -1.42 },
+      rotation: Quaternion.fromEuler(0, 90, 0),
+    };
+  }
+}

package/examples/zombies-fps/classes/guns/AutoPistolEntity.ts

@@ -0,0 +1,36 @@
+import { Quaternion } from 'hytopia';
+import PistolEntity from './PistolEntity';
+import type { GunEntityOptions } from '../GunEntity';
+import type { PlayerEntity, QuaternionLike, Vector3Like } from 'hytopia';
+
+export default class AutoPistolEntity extends PistolEntity {
+  public constructor(options: Partial<GunEntityOptions> = {}) {
+    super({
+      ammo: options.ammo ?? 20,
+      fireRate: options.fireRate ?? 7,
+      iconImageUri: options.iconImageUri ?? 'icons/auto-pistol.png',
+      name: options.name ?? 'Auto Pistol',
+      maxAmmo: options.maxAmmo ?? 20,
+      modelUri: options.modelUri ?? 'models/items/auto-pistol.glb',
+      ...options,
+    });
+  }
+
+  public override getMuzzleFlashPositionRotation(): { position: Vector3Like, rotation: QuaternionLike } {
+    return {
+      position: { x: 0.01, y: 0.1, z: -0.35 },
+      rotation: Quaternion.fromEuler(0, 90, 0),
+    };
+  }
+
+  public override shoot() {
+    if (!this.parent) {
+      return;
+    }
+
+    super.shoot();
+
+    const parentPlayerEntity = this.parent as PlayerEntity;
+    parentPlayerEntity.player.input.ml = true; // prevent cancel for auto fire.
+  }
+}

package/examples/zombies-fps/classes/guns/AutoShotgunEntity.ts

@@ -0,0 +1,37 @@
+import { Quaternion } from 'hytopia';
+import ShotgunEntity from './ShotgunEntity';
+import type { GunEntityOptions } from '../GunEntity';
+import type { PlayerEntity, QuaternionLike, Vector3Like } from 'hytopia';
+
+export default class AutoShotgunEntity extends ShotgunEntity {
+  public constructor(options: Partial<GunEntityOptions> = {}) {
+    super({
+      ammo: options.ammo ?? 6,
+      fireRate: options.fireRate ?? 2,
+      iconImageUri: options.iconImageUri ?? 'icons/auto-shotgun.png',
+      name: options.name ?? 'Auto Shotgun',
+      maxAmmo: options.maxAmmo ?? 4,
+      modelUri: options.modelUri ?? 'models/items/auto-shotgun.glb',
+      reloadTimeMs: options.reloadTimeMs ?? 2500,
+      ...options,
+    });
+  }
+
+  public override getMuzzleFlashPositionRotation(): { position: Vector3Like, rotation: QuaternionLike } {
+    return {
+      position: { x: 0.015, y: 0, z: -1 },
+      rotation: Quaternion.fromEuler(0, 90, 0),
+    };
+  }
+
+  public override shoot() {
+    if (!this.parent) {
+      return;
+    }
+
+    super.shoot();
+
+    const parentPlayerEntity = this.parent as PlayerEntity;
+    parentPlayerEntity.player.input.ml = true; // prevent cancel for auto fire.
+  }
+}

package/examples/zombies-fps/classes/guns/PistolEntity.ts

@@ -1,23 +1,28 @@
-import {
-  Audio,
-  PlayerEntity,
-} from 'hytopia';
+import { Quaternion } from 'hytopia';
+import type { PlayerEntity, Vector3Like, QuaternionLike } from 'hytopia';
 
 import GunEntity from '../GunEntity';
 import type { GunEntityOptions } from '../GunEntity';
 
 export default class PistolEntity extends GunEntity {
-  public constructor(options: Partial<GunEntityOptions>) {
+  public constructor(options: Partial<GunEntityOptions> = {}) {
     super({
       ammo: options.ammo ?? 10,
       damage: options.damage ?? 3,
-      fireRate: options.fireRate ?? 5,
+      fireRate: options.fireRate ?? 9,
       hand: options.hand ?? 'right',
+      iconImageUri: options.iconImageUri ?? 'icons/pistol.png',
+      idleAnimation: options.idleAnimation ?? 'idle_gun_right',
+      name: options.name ?? 'Pistol',
       maxAmmo: options.maxAmmo ?? 10,
-      modelUri: 'models/items/pistol.glb',
-      modelScale: 1.3,
+      modelUri: options.modelUri ?? 'models/items/pistol.glb',
+      modelScale: options.modelScale ?? 1.3,
       parent: options.parent,
-      reloadTime: options.reloadTime ?? 1,
+      range: options.range ?? 50,
+      reloadAudioUri: options.reloadAudioUri ?? 'audio/sfx/pistol-reload.mp3',
+      reloadTimeMs: options.reloadTimeMs ?? 1250,
+      shootAnimation: options.shootAnimation ?? 'shoot_gun_right',
+      shootAudioUri: options.shootAudioUri ?? 'audio/sfx/pistol-shoot.mp3',
     });
   }
 
@@ -32,18 +37,21 @@ export default class PistolEntity extends GunEntity {
       return;
     }
 
+    // shoot the bullet
+    super.shoot();
+
     // cancel the input, pistols require click to shoot
     parentPlayerEntity.player.input.ml = false;
 
     // play shoot animation
     parentPlayerEntity.startModelOneshotAnimations([ 'shoot_gun_right' ]);
+  }
 
-    (new Audio({
-      position: parentPlayerEntity.position,
-      referenceDistance: 20,
-      uri: 'audio/sfx/pistol-shoot-1.mp3',
-      volume: 1,
-    })).play(parentPlayerEntity.world, true);
+  public override getMuzzleFlashPositionRotation(): { position: Vector3Like, rotation: QuaternionLike } {
+    return {
+      position: { x: 0.03, y: 0.1, z: -0.5 },
+      rotation: Quaternion.fromEuler(0, 90, 0),
+    };
   }
 }
 

package/examples/zombies-fps/classes/guns/ShotgunEntity.ts

@@ -0,0 +1,92 @@
+import { Quaternion } from 'hytopia';
+import type { PlayerEntity, QuaternionLike, Vector3Like } from 'hytopia';
+
+import GunEntity from '../GunEntity';
+import type { GunEntityOptions } from '../GunEntity';
+
+export default class ShotgunEntity extends GunEntity {
+  public constructor(options: Partial<GunEntityOptions> = {}) {
+    super({
+      ammo: options.ammo ?? 3,
+      damage: options.damage ?? 4, // damage per pellet
+      fireRate: options.fireRate ?? 1.3,
+      hand: options.hand ?? 'right',
+      iconImageUri: options.iconImageUri ?? 'icons/shotgun.png',
+      idleAnimation: options.idleAnimation ?? 'idle_gun_both',
+      name: options.name ?? 'Shotgun',
+      maxAmmo: options.maxAmmo ?? 3,
+      modelUri: options.modelUri ?? 'models/items/shotgun.glb',
+      modelScale: options.modelScale ?? 1.2,
+      parent: options.parent,
+      range: options.range ?? 8,
+      reloadAudioUri: options.reloadAudioUri ?? 'audio/sfx/shotgun-reload.mp3',
+      reloadTimeMs: options.reloadTimeMs ?? 1000,
+      shootAudioUri: options.shootAudioUri ?? 'audio/sfx/shotgun-shoot.mp3',
+      shootAnimation: options.shootAnimation ?? 'shoot_gun_both',
+    });
+  }
+
+  public override shoot() {
+    if (!this.parent || !this.processShoot()) {
+      return;
+    }
+
+    const parentPlayerEntity = this.parent as PlayerEntity;
+
+    if (!parentPlayerEntity.world) {
+      return;
+    }
+
+    // shoot the bullet
+    super.shoot();
+
+    // cancel the input, pistols require click to shoot
+    parentPlayerEntity.player.input.ml = false;
+  }
+
+  public override getMuzzleFlashPositionRotation(): { position: Vector3Like, rotation: QuaternionLike } {
+    return {
+      position: { x: 0.03, y: 0.1, z: -1.5 },
+      rotation: Quaternion.fromEuler(0, 90, 0),
+    };
+  }
+
+  public override shootRaycast(origin: Vector3Like, direction: Vector3Like, length: number) {
+    // Create spread pattern for shotgun pellets using angles relative to direction
+    const spreadAngles = [
+      { x: 0, y: 0 },      // Center
+      { x: 0.035, y: 0.035 },  // Upper right
+      { x: -0.035, y: 0.035 }, // Upper left
+      { x: 0.05, y: 0 },   // Right
+      { x: -0.05, y: 0 },  // Left
+      { x: 0.035, y: -0.035 }, // Lower right
+      { x: -0.035, y: -0.035 } // Lower left
+    ];
+
+    // Fire each pellet with spread applied to original direction
+    for (const angle of spreadAngles) {
+      // Calculate spread direction relative to original direction
+      const spreadDirection = {
+        x: direction.x + (direction.z * angle.x), // Add horizontal spread
+        y: direction.y + angle.y,                 // Add vertical spread
+        z: direction.z - (direction.x * angle.x)  // Maintain direction magnitude
+      };
+
+      // Normalize the spread direction to maintain consistent range
+      const magnitude = Math.sqrt(
+        spreadDirection.x * spreadDirection.x + 
+        spreadDirection.y * spreadDirection.y + 
+        spreadDirection.z * spreadDirection.z
+      );
+
+      const normalizedDirection = {
+        x: spreadDirection.x / magnitude,
+        y: spreadDirection.y / magnitude,
+        z: spreadDirection.z / magnitude
+      };
+
+      super.shootRaycast(origin, normalizedDirection, length);
+    }
+  }
+}
+

package/examples/zombies-fps/gameConfig.ts

@@ -1,4 +1,7 @@
-import { Quaternion } from 'hytopia';
+import { CollisionGroup, Quaternion } from 'hytopia';
+import type { Vector3Like } from 'hytopia';
+
+export const INVISIBLE_WALL_COLLISION_GROUP = CollisionGroup.GROUP_1;
 
 export const INVISIBLE_WALLS = [
   { // Main entrance (south door)
@@ -22,7 +25,7 @@ export const INVISIBLE_WALLS = [
     halfExtents: { x: 1, y: 5, z: 0.5 },
   },
   { // Parlor (south window)
-    position: { x: -21, y: 1, z: 16},
+    position: { x: -22, y: 1, z: 16},
     halfExtents: { x: 1, y: 5, z: 0.5 },
   },
   { // Parlor (north window)
@@ -53,73 +56,174 @@ export const INVISIBLE_WALLS = [
 
 export const PURCHASE_BARRIERS = [
   {
-    name: 'Unlock Theater Room (South)',
-    removalPrice: 100,
+    name: 'Theater Room (South)',
+    removalPrice: 300,
     position: { x: 2.5, y: 1.5, z: 15 },
     rotation: Quaternion.fromEuler(0, 0, 0),
     width: 5,
+    unlockIds: [ 'theater' ],
   },
   {
-    name: 'Unlock Parlor (South)',
-    removalPrice: 25,
+    name: 'Parlor (South)',
+    removalPrice: 75,
     position: { x: -8, y: 1.5, z: 18.5 },
     rotation: Quaternion.fromEuler(0, 90, 0),
     width: 3,
+    unlockIds: [ 'parlor' ],
   },
   {
-    name: 'Unlock Dining Hall (South)',
-    removalPrice: 50,
+    name: 'Dining Hall (South)',
+    removalPrice: 75,
     position: { x: 13, y: 1.5, z: 18.5 },
     rotation: Quaternion.fromEuler(0, 90, 0),
     width: 3,
+    unlockIds: [ 'dining' ],
   },
   {
-    name: 'Unlock Theater Room (West)',
-    removalPrice: 75,
+    name: 'Theater Room (West)',
+    removalPrice: 250,
     position: { x: -15, y: 1.5, z: 3 },
     rotation: Quaternion.fromEuler(0, 90, 0),
     width: 5,
+    unlockIds: [ 'theater', 'parlor' ],
   },
   {
-    name: 'Unlock Theater Room (East)',
-    removalPrice: 75,
+    name: 'Theater Room (East)',
+    removalPrice: 250,
     position: { x: 19, y: 1.5, z: 3 },
     rotation: Quaternion.fromEuler(0, 90, 0),
     width: 5,
+    unlockIds: [ 'theater', 'dining' ],
   },
   {
-    name: 'Unlock Art Gallery (South)',
-    removalPrice: 200,
+    name: 'Art Gallery (South)',
+    removalPrice: 500,
     position: { x: 26.5, y: 1.5, z: -2 },
     rotation: Quaternion.fromEuler(0, 0, 0),
     width: 5,
+    unlockIds: [ 'gallery', 'dining' ],
   },
   {
-    name: 'Unlock Kitchen (South)',
-    removalPrice: 200,
+    name: 'Kitchen (South)',
+    removalPrice: 500,
     position: { x: -22, y: 1.5, z: -2 },
     rotation: Quaternion.fromEuler(0, 0, 0),
     width: 5,
+    unlockIds: [ 'kitchen', 'parlor' ],
   },
   {
-    name: 'Unlock Vault',
-    removalPrice: 200,
+    name: 'Vault',
+    removalPrice: 1000,
     position: { x: 0.5, y: 1.5, z: -26 },
     rotation: Quaternion.fromEuler(0, 0, 0),
     width: 3,
+    unlockIds: [ 'vault' ],
   },
   {
-    name: 'Unlock Treasure Room (West)',
+    name: 'Treasure Room (West)',
     removalPrice: 75,
     position: { x: -15, y: 1.5, z: -19 },
     rotation: Quaternion.fromEuler(0, 90, 0),
     width: 5,
+    unlockIds: [ 'treasure', 'kitchen' ],
   },
   {
-    name: 'Unlock Treasure Room (East)',
+    name: 'Treasure Room (East)',
     removalPrice: 75,
     position: { x: 20, y: 1.5, z: -19 },
     rotation: Quaternion.fromEuler(0, 90, 0),
     width: 5,
+    unlockIds: [ 'treasure', 'gallery' ],
+  },
+]
+
+export const WEAPON_CRATES = [
+  {
+    name: 'Rusty Weapon Crate',
+    position: { x: -3, y: 1.5, z: 16.5 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+    price: 100,
+    rollableWeaponIds: [ 'pistol', 'shotgun', 'ar15' ],
+  },
+  {
+    name: 'Rusty Weapon Crate',
+    position: { x: 10.5, y: 1.5, z: 16.5 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+    price: 100,
+    rollableWeaponIds: [ 'pistol', 'shotgun', 'ar15' ],
+  },
+  {
+    name: 'Weapon Crate',
+    position: { x: -27.5, y: 1.5, z: 2.5 },
+    rotation: Quaternion.fromEuler(0, 90, 0),
+    price: 200,
+    rollableWeaponIds: [ 'shotgun', 'ar15', 'auto-pistol', ],
   },
-]
+  {
+    name: 'Weapon Crate',
+    position: { x: 22, y: 1.5, z: 7 },
+    rotation: Quaternion.fromEuler(0, -45, 0),
+    price: 200,
+    rollableWeaponIds: [ 'shotgun', 'ar15', 'auto-pistol', ],
+  },
+  {
+    name: 'Weapon Crate',
+    position: { x: -23.5, y: 1.5, z: -24.5 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+    price: 200,
+    rollableWeaponIds: [ 'shotgun', 'ar15', 'auto-pistol', ],
+  },
+  {
+    name: 'Elite Weapon Crate',
+    position: { x: 31, y: 1.5, z: -14.5 },
+    rotation: Quaternion.fromEuler(0, 45, 0),
+    price: 300,
+    rollableWeaponIds: [ 'ak47', 'ar15', 'auto-pistol', 'auto-shotgun', ],
+  },
+  {
+    name: 'Elite Weapon Crate',
+    position: { x: 2.5, y: 2.5, z: -4.5 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+    price: 300,
+    rollableWeaponIds: [ 'ak47', 'ar15', 'auto-pistol', 'auto-shotgun', ],
+  },
+  {
+    name: 'Elite Weapon Crate',
+    position: { x: 0.5, y: 1.5, z: -29.5 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+    price: 300,
+    rollableWeaponIds: [ 'ak47', 'ar15', 'auto-pistol', 'auto-shotgun', ],
+  },
+]
+
+export const ENEMY_SPAWN_POINTS: Record<string, Vector3Like[]> = {
+  start: [
+    { x: -20, y: 3, z: 34 },
+    { x: 12, y: 3, z: 36 },
+    { x: 26, y: 3, z: 20 },
+    { x: 17, y: 3, z: 13.5 },
+  ],
+  theater: [
+    { x: -13.5, y: 3, z: 10 },
+  ],
+  parlor: [
+    { x: -36, y: 3, z: 23 },
+    { x: -35, y: 3, z: -5 },
+  ],
+  dining: [
+    { x: 46, y: 3, z: 16 },
+    { x: 41, y: 3, z: -5 },
+  ],
+  gallery: [
+    { x: 35, y: 3, z: -39 },
+    { x: 12, y: 3, z: -40 },
+  ],
+  kitchen: [
+    { x: -28, y: 3, z: -32 },
+    { x: -40, y: 3, z: -5 },
+  ],
+  treasure: [
+    { x: -13, y: 3, z: -27 },
+    { x: 0, y: 3, z: -37 },
+  ],
+};

package/examples/zombies-fps/index.ts

@@ -1,46 +1,29 @@
-import { startServer, Collider, ColliderShape, CollisionGroup } from 'hytopia';
+import { startServer } from 'hytopia';
 import GamePlayerEntity from './classes/GamePlayerEntity';
-import PurchaseBarrierEntity from './classes/PurchaseBarrierEntity';
-import { INVISIBLE_WALLS, PURCHASE_BARRIERS } from './gameConfig';
 import worldMap from './assets/maps/terrain.json';
 
+import GameManager from './classes/GameManager';
+
 startServer(world => {
   // Load map.
   world.loadMap(worldMap);
 
+  //world.simulation.enableDebugRaycasting(true);
+
   // Setup lighting
-  world.setAmbientLightIntensity(0.3);
+  world.setAmbientLightIntensity(0.0001);
   world.setAmbientLightColor({ r: 255, g: 192, b: 192 });
-  world.setDirectionalLightIntensity(0.8);
-  
-  // Setup invisible walls that only enemies can pass through
-  INVISIBLE_WALLS.forEach(wall => {
-    const wallCollider = new Collider({
-      shape: ColliderShape.BLOCK,
-      halfExtents: wall.halfExtents,
-      relativePosition: wall.position, // since this is not attached to a rigid body, relative position is realtive to the world global coordinate space.
-      collisionGroups: {
-        belongsTo: [ CollisionGroup.BLOCK ],
-        collidesWith: [ CollisionGroup.PLAYER ],
-      },
-    });
-
-    wallCollider.addToSimulation(world.simulation);
-  });
-
-  // Setup purchase barriers
-  PURCHASE_BARRIERS.forEach(barrier => {
-    const purchaseBarrier = new PurchaseBarrierEntity({
-      name: barrier.name,
-      removalPrice: barrier.removalPrice,
-      width: barrier.width,
-    });
-
-    purchaseBarrier.spawn(world, barrier.position, barrier.rotation);
-  });
+  world.setDirectionalLightIntensity(0.0001);
+
+  // Setup game
+  GameManager.instance.setupGame(world);
 
   // Spawn a player entity when a player joins the game.
   world.onPlayerJoin = player => {
+    if (GameManager.instance.isStarted) {
+      return world.chatManager.sendPlayerMessage(player, 'This round has already started, please wait for the next round. You can fly around as a spectator.', 'FF0000');
+    }
+
     const playerEntity = new GamePlayerEntity(player);
 
     playerEntity.spawn(world, { x: 2, y: 10, z: 19 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hytopia",
-  "version": "0.1.98",
+  "version": "0.2.0",
   "description": "The HYTOPIA SDK makes it easy for developers to create massively multiplayer games using JavaScript or TypeScript.",
   "main": "server.js",
   "bin": {