hytopia 0.3.6 → 0.3.7

package/examples/hygrounds/classes/weapons/ShotgunEntity.ts

@@ -0,0 +1,84 @@
+import { Quaternion, Vector3Like, QuaternionLike } from 'hytopia';
+import GunEntity from '../GunEntity';
+import type { GunEntityOptions } from '../GunEntity';
+import type GamePlayerEntity from '../GamePlayerEntity';
+
+const DEFAULT_SHOTGUN_OPTIONS: GunEntityOptions = {
+  ammo: 4,
+  damage: 12,         // Per pellet (7 pellets = 84 max damage)
+  fireRate: 0.8,
+  heldHand: 'both',
+  iconImageUri: 'icons/shotgun.png',
+  idleAnimation: 'idle_gun_both',
+  mlAnimation: 'shoot_gun_both',
+  name: 'Shotgun',
+  maxAmmo: 4,
+  totalAmmo: 24,
+  modelUri: 'models/items/shotgun.glb',
+  modelScale: 1.2,
+  range: 8,
+  reloadAudioUri: 'audio/sfx/shotgun-reload.mp3',
+  reloadTimeMs: 3000,
+  shootAudioUri: 'audio/sfx/shotgun-shoot.mp3',
+};
+
+export default class ShotgunEntity extends GunEntity {
+  public constructor(options: Partial<GunEntityOptions> = {}) {
+    super({ ...DEFAULT_SHOTGUN_OPTIONS, ...options });
+  }
+
+  public override shoot(): void {
+    if (!this.parent || !this.processShoot()) return;
+
+    super.shoot();
+    
+    // Cancel input since shotgun requires click-to-shoot
+    (this.parent as GamePlayerEntity).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.05, y: 0.05 },  // Upper right
+      { x: -0.05, y: 0.05 }, // Upper left
+      { x: 0.07, y: 0 },   // Right
+      { x: -0.07, y: 0 },  // Left
+      { x: 0.05, y: -0.05 }, // Lower right
+      { x: -0.05, y: -0.05 } // 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/hygrounds/gameConfig.ts

@@ -0,0 +1,398 @@
+import { Quaternion } from 'hytopia';
+
+export const BEDROCK_BLOCK_ID = 2;
+
+export const BLOCK_ID_BREAK_DAMAGE: Record<string | number, number> = {
+  1: 50, // bricks
+  4: 50, // cobblestone
+  6: 70, // diamond block
+  7: 70, // diamond ore
+  8: 10, // dirt
+  14: 10, // glass
+  15: 70, // gold ore
+  16: 10, // grass
+  17: 10, // gravel
+  19: 100, // infected shadowrock core
+  20: 100, // infected shadowrock
+  24: 50, // mossy cobblestone
+  27: 10, // oak leaves
+  30: 10, // sand
+  36: 100, // stone bricks
+  37: 40, // stone (also build block)
+  default: 30, // default for all other blocks
+}
+
+export const BLOCK_ID_MATERIALS: Record<string | number, number> = {
+  1: 4, // bricks
+  2: 0, // bedrock
+  6: 10, // diamond block
+  7: 10, // diamond ore,
+  8: 0, // dirt
+  14: 0, // glass
+  15: 8, // gold ore,
+  16: 0, // grass
+  19: 8, // infected shadowrock core
+  20: 8, // infected shadowrock
+  22: 0, // lava
+  23: 2, // log
+  28: 2, // oak planks
+  36: 5, // stone bricks
+  42: 0, // water flow
+  43: 0, // water still
+  default: 1, // default for all other blocks
+};
+
+export const BUILD_BLOCK_ID = 37; // stone
+
+export const CHEST_DROP_INTERVAL_MS = 20 * 1000; // 20 seconds
+
+export const CHEST_DROP_REGION_AABB = {
+  min: { x: -45, y: 100, z: -45 },
+  max: { x: 45, y: 100, z: 45 },
+};
+
+export const CHEST_SPAWNS_AT_START = 15;
+
+export const CHEST_MAX_DROP_ITEMS = 2;
+
+export const CHEST_OPEN_DESPAWN_MS = 20 * 1000; // 20 seconds
+
+export const CHEST_DROP_ITEMS = [
+  {
+    itemId: 'ak47',
+    pickWeight: 0.4,
+  },
+  {
+    itemId: 'auto-shotgun',
+    pickWeight: 0.5,
+  },
+  {
+    itemId: 'bolt-action-sniper',
+    pickWeight: 0.6,
+  },
+  {
+    itemId: 'light-machine-gun',
+    pickWeight: 0.3,
+  },
+  {
+    itemId: 'medpack',
+    pickWeight: 1,
+  },
+  {
+    itemId: 'mining-drill',
+    pickWeight: 0.4,
+  },
+  {
+    itemId: 'pistol',
+    pickWeight: 1,
+  },
+  {
+    itemId: 'rocket-launcher',
+    pickWeight: 0.2,
+  },
+  {
+    itemId: 'shotgun',
+    pickWeight: 0.5,
+  },
+  {
+    itemId: 'shield-potion',
+    pickWeight: 1,
+  },
+]
+
+export const CHEST_SPAWNS = [
+  {
+    position: { x: -14, y: 2, z: -16 },
+    rotation: Quaternion.fromEuler(0, -90, 0),
+  },
+  {
+    position: { x: -14, y: 2, z: -25 },
+    rotation: Quaternion.fromEuler(0, 90, 0),
+  },
+  {
+    position: { x: -36, y: 2, z: -34.5},
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+  {
+    position: { x: -30.5, y: 6, z: -33 },
+    rotation: Quaternion.fromEuler(0, -90, 0),
+  },
+  {
+    position: { x: -8, y: 2, z: -40 },
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+  {
+    position: { x: 38, y: 2, z: -18 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+  },
+  {
+    position: { x: 47, y: 2, z: -33 },
+    rotation: Quaternion.fromEuler(0, 90, 0),
+  },
+  {
+    position: { x: 41, y: 5, z: -46.5 },
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+  {
+    position: { x: 39.5, y: 4, z: 9 },
+    rotation: Quaternion.fromEuler(0, 90, 0),
+  },
+  {
+    position: { x: -2.5, y: 3, z: 13 },
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+  {
+    position: { x: 5.5, y: 3, z: 13 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+  },
+  {
+    position: { x: -2.5, y: 3, z: 8 },
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+  {
+    position: { x: 5.5, y: 3, z: 8 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+  },
+  {
+    position: { x: 35, y: 15, z: 34.5 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+  },
+  {
+    position: { x: 33.5, y: 3, z: 29 },
+    rotation: Quaternion.fromEuler(0, 90, 0),
+  },
+  {
+    position: { x: 40.5, y: 3, z: 31 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+  },
+  {
+    position: { x: 45, y: 3, z: 45 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+  },
+  {
+    position: { x: 9, y: 3, z: 40 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+  },
+  {
+    position: { x: -22.5, y: 3, z: 44 },
+    rotation: Quaternion.fromEuler(0, -90, 0),
+  },
+  {
+    position: { x: -14, y: 3, z: 42.5 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+  },
+  {
+    position: { x: -18, y: 8, z: 45 },
+    rotation: Quaternion.fromEuler(0, -90, 0),
+  },
+  {
+    position: { x: -22.5, y: 8, z: 46 },
+    rotation: Quaternion.fromEuler(0, -90, 0),
+  },
+  {
+    position: { x: -33.5, y: 3, z: 47 },
+    rotation: Quaternion.fromEuler(0, -90, 0),
+  },
+  {
+    position: { x: -44.5, y: 3, z: 23.5 },
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+  {
+    position: { x: -29, y: 3, z: 14 },
+    rotation: Quaternion.fromEuler(0, 90, 0),
+  },
+  {
+    position: { x: -32, y: 3, z: 21 },
+    rotation: Quaternion.fromEuler(0, -90, 0),
+  },
+  {
+    position: { x: -36, y: 3, z: 5.5 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+  },
+  {
+    position: { x: -12, y: 15, z: 27 },
+    rotation: Quaternion.fromEuler(0, 90, 0),
+  },
+  {
+    position: { x: -33.5, y: 20, z: 5.5 },
+    rotation: Quaternion.fromEuler(0, 90, 0),
+  },
+  {
+    position: { x: -24, y: 3, z: -8 },
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+  {
+    position: { x: -15.5, y: 3, z: 0 },
+    rotation: Quaternion.fromEuler(0, -90, 0),
+  },
+  {
+    position: { x: -14, y: 3, z: 5 },
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+  {
+    position: { x: 10, y: 3, z: -16 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+  },
+  {
+    position: { x: 18, y: 15, z: 4 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+  },
+  {
+    position: { x: -5.5, y: 3, z: 11.5 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+  },
+  {
+    position: { x: -12, y: 9, z: 3.5 },
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+  {
+    position: { x: 4, y: 9, z: 8 },
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+  {
+    position: { x: 17, y: 3, z: 16.5 },
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+  {
+    position: { x: 25, y: 3, z: 3.5 },
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+  {
+    position: { x: 24, y: 3, z: -13.5 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+  },
+  {
+    position: { x: 26.5, y: 3, z: -46.5 },
+    rotation: Quaternion.fromEuler(0, 90, 0),
+  },
+  {
+    position: { x: -44, y: 3, z: -46 },
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+  {
+    position: { x: 11, y: 9, z: -40 },
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+  {
+    position: { x: 3, y: 6, z: -19 },
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+  {
+    position: { x: 0.5, y: 3, z: -43.5 },
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+  {
+    position: { x: -42.5, y: 3, z: -18.5 },
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+  {
+    position: { x: -32.5, y: 3, z: -46.5 },
+    rotation: Quaternion.fromEuler(0, 90, 0),
+  },
+  {
+    position: { x: 40, y: 15, z: -18 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+  },
+  {
+    position: { x: 13, y: 3, z: 1 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+  },
+  {
+    position: { x: 7, y: 5, z: 36.5 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+  },
+  {
+    position: { x: -14, y: 9, z: -21 },
+    rotation: Quaternion.fromEuler(0, 0, 0),
+  },
+  {
+    position: { x: -33, y: 15, z: -35.5 },
+    rotation: Quaternion.fromEuler(0, 90, 0),
+  },
+  {
+    position: { x: -28, y: 15, z: -35.5 },
+    rotation: Quaternion.fromEuler(0, 90, 0),
+  },
+  {
+    position: { x: -23, y: 3, z: 2.5 },
+    rotation: Quaternion.fromEuler(0, 90, 0),
+  },
+  {
+    position: { x: -6, y: 5, z: 22 },
+    rotation: Quaternion.fromEuler(0, 180, 0),
+  },
+];
+
+export const GAME_DURATION_MS = 10 * 60 * 1000; // 10 minutes
+
+export const ITEM_DESPAWN_TIME_MS = 30 * 1000; // 30 seconds
+
+export const ITEM_SPAWNS = [
+  { position: { x: -21.5, y: 2, z: -17 } },
+  { position: { x: -28.5, y: 7, z: -35.5 } },
+  { position: { x: -19.5, y: 2, z: -46.5 } },
+  { position: { x: -37.5, y: 2, z: -3.5 } },
+  { position: { x: -31.5, y: 2, z: 16.5 } },
+  { position: { x: -18.5, y: 2, z: 40.5 } },
+  { position: { x: 1.5, y: 2, z: 11.5 } },
+  { position: { x: 7.5, y: 10, z: 36.5 } },
+  { position: { x: 20.5, y: 2, z: 44.5 } },
+  { position: { x: 37.5, y: 2, z: 38.5 } },
+  { position: { x: 44.5, y: 2, z: -3.5 } },
+  { position: { x: 37.5, y: 2, z: -17.5 } },
+  { position: { x: 40.5, y: 10, z: -41.5 } },
+  { position: { x: 3.5, y: 10, z: -31.5 } },
+  { position: { x: -30.5, y: 10, z: 41.5 } },
+];
+
+export const ITEM_SPAWN_ITEMS = [
+  {
+    itemId: 'ak47',
+    pickWeight: 0.05,
+  },
+  {
+    itemId: 'auto-shotgun',
+    pickWeight: 0.05,
+  },
+  {
+    itemId: 'bolt-action-sniper',
+    pickWeight: 0.05,
+  },
+  {
+    itemId: 'light-machine-gun',
+    pickWeight: 0.05,
+  },
+  {
+    itemId: 'medpack',
+    pickWeight: 1,
+  },
+  {
+    itemId: 'mining-drill',
+    pickWeight: 0.05,
+  },
+  {
+    itemId: 'pistol',
+    pickWeight: 1,
+  },
+  {
+    itemId: 'rocket-launcher',
+    pickWeight: 0.03,
+  },
+  {
+    itemId: 'shotgun',
+    pickWeight: 0.08,
+  },
+  {
+    itemId: 'shield-potion',
+    pickWeight: 1,
+  },
+];
+
+export const ITEM_SPAWNS_AT_START = 8;
+
+export const MINIMUM_PLAYERS_TO_START = 2;
+
+export const SPAWN_REGION_AABB = {
+  min: { x: -45, y: 30, z: -45 },
+  max: { x: 45, y: 35, z: 45 },
+};

package/examples/hygrounds/index.ts

@@ -0,0 +1,40 @@
+import {
+  startServer,
+  PlayerEvent,
+} from 'hytopia';
+
+import GameManager from './classes/GameManager';
+
+import worldMap from './assets/map.json';
+
+startServer(world => {
+  // Load the game map
+  world.loadMap(worldMap);
+
+  // Set lighting
+  world.setAmbientLightIntensity(0.8);
+  world.setDirectionalLightIntensity(5);
+
+  GameManager.instance.setupGame(world);
+
+  // Handle player joining the game
+  world.on(PlayerEvent.JOINED_WORLD, ({ player }) => {
+    GameManager.instance.spawnPlayerEntity(player);
+    GameManager.instance.playerCount++;
+  });
+
+  // Handle player leaving the game
+  world.on(PlayerEvent.LEFT_WORLD, ({ player }) => {
+    // Clean up player entities
+    world.entityManager
+      .getPlayerEntitiesByPlayer(player)
+      .forEach(entity => entity.despawn());
+
+    GameManager.instance.playerCount--;
+  });
+});
+
+
+/*
+- fix zoom of SMG
+*/

package/examples/hygrounds/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "zombies-fps",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@hytopia.com/assets": "latest",
+    "hytopia": "latest"
+  }
+}

package/package.json

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

package/server.api.json

@@ -26358,6 +26358,27 @@
               "releaseTag": "Public",
               "name": "FIRST_PERSON"
             },
+            {
+              "kind": "EnumMember",
+              "canonicalReference": "server!PlayerCameraMode.SPECTATOR:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "SPECTATOR = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "2"
+                }
+              ],
+              "initializerTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "name": "SPECTATOR"
+            },
             {
               "kind": "EnumMember",
               "canonicalReference": "server!PlayerCameraMode.THIRD_PERSON:member",

package/server.d.ts

@@ -3367,7 +3367,8 @@ export declare interface PlayerCameraEventPayloads {
 /** The mode of the camera. @public */
 export declare enum PlayerCameraMode {
     FIRST_PERSON = 0,
-    THIRD_PERSON = 1
+    THIRD_PERSON = 1,
+    SPECTATOR = 2
 }
 
 /** The camera orientation state of a Player. @public */