hytopia 0.3.7 → 0.3.9

package/docs/server.playerentitycontroller.md

@@ -457,7 +457,7 @@ Called when the controlled entity is spawned. In PlayerEntityController, this fu
 
 </td><td>
 
-Ticks the player movement for the entity controller, overriding the default implementation.
+Ticks the player movement for the entity controller, overriding the default implementation. If the entity to tick is a child entity, only the event will be emitted but the default movement logic will not be applied.
 
 
 </td></tr>

package/docs/server.playerentitycontroller.tickwithplayerinput.md

@@ -4,7 +4,7 @@
 
 ## PlayerEntityController.tickWithPlayerInput() method
 
-Ticks the player movement for the entity controller, overriding the default implementation.
+Ticks the player movement for the entity controller, overriding the default implementation. If the entity to tick is a child entity, only the event will be emitted but the default movement logic will not be applied.
 
 **Signature:**
 

package/examples/hygrounds/assets/models/items/.optimized/auto-sniper/auto-sniper.glb.md5

@@ -0,0 +1 @@
+eb57c9bd2558eab8508e66cebc58793ce1b660c3bc089533623b8ec937e6c33c

package/examples/hygrounds/assets/models/items/.optimized/gravity-potion/gravity-potion.glb.md5

@@ -0,0 +1 @@
+64e7588c50e1ca56989a396252683fb9e16cb8c5814237b46562983a3aa35fe4

package/examples/hygrounds/assets/models/items/.optimized/revolver/revolver.glb.md5

@@ -0,0 +1 @@
+e4d9e2e03c083b63c01b59dab34218c6aae28bbd88fcda7db44e2dcb2075a080

package/examples/hygrounds/assets/models/items/.optimized/submachine-gun/submachine-gun.glb.md5

@@ -0,0 +1 @@
+85850ccf234d28a1d2a306cc3b9dd7ec8196b759be5011e38a96ded3605e9201

package/examples/hygrounds/assets/ui/index.html

@@ -20,6 +20,9 @@
 <!-- Game Start Announcement -->
 <div class="game-start-announcement">DEATHMATCH!</div>
 
+<!-- Winner Announcement -->
+<div class="winner-announcement"></div>
+
 <!-- Leaderboard -->
 <div class="leaderboard">
   <div class="leaderboard-title">HyGrounds Deathmatch</div>
@@ -224,6 +227,17 @@
     }, 3000);
   }
 
+  function showWinnerAnnouncement(username) {
+    const announcement = document.querySelector('.winner-announcement');
+    announcement.textContent = `${username} wins!`;
+    announcement.classList.add('active');
+    
+    // Remove the active class after animation completes
+    setTimeout(() => {
+      announcement.classList.remove('active');
+    }, 5000);
+  }
+
   hytopia.registerSceneUITemplate('item-label', (id, onState) => {
     const template = document.getElementById('item-label-template');
     const clone = template.content.cloneNode(true);
@@ -268,6 +282,11 @@
       showGameStartAnnouncement();
     }
 
+    if (type === 'announce-winner') {
+      const { username } = data;
+      showWinnerAnnouncement(username);
+    }
+
     if (type === 'ammo-indicator') {
       const { ammo, totalAmmo, show, reloading } = data;
 
@@ -540,7 +559,29 @@
   }
 
   .game-start-announcement.active {
-    animation: announcementFade 3s ease-in-out forwards;
+    animation: announcementFade 5s ease-in-out forwards;
+  }
+
+  .winner-announcement {
+    position: fixed;
+    top: 50%;
+    left: 50%;
+    transform: translate(-50%, -50%);
+    font-family: 'Inter', sans-serif;
+    font-size: 80px;
+    font-weight: bold;
+    color: #ffd700;
+    text-shadow: 0 0 15px rgba(0, 0, 0, 0.8), 0 0 30px rgba(255, 215, 0, 0.6);
+    text-transform: uppercase;
+    letter-spacing: 3px;
+    opacity: 0;
+    z-index: 1000;
+    pointer-events: none;
+    text-align: center;
+  }
+
+  .winner-announcement.active {
+    animation: winnerFade 5s ease-in-out forwards;
   }
 
   @keyframes announcementFade {
@@ -550,6 +591,15 @@
     100% { opacity: 0; transform: translate(-50%, -50%) scale(0.8); }
   }
 
+  @keyframes winnerFade {
+    0% { opacity: 0; transform: translate(-50%, -50%) scale(0.5); }
+    20% { opacity: 1; transform: translate(-50%, -50%) scale(1.2); }
+    40% { opacity: 1; transform: translate(-50%, -50%) scale(1.1); }
+    60% { opacity: 1; transform: translate(-50%, -50%) scale(1.2); }
+    80% { opacity: 1; transform: translate(-50%, -50%) scale(1); }
+    100% { opacity: 0; transform: translate(-50%, -50%) scale(0.8); }
+  }
+
   .hit-damage-container {
     position: fixed;
     top: 50%;

package/examples/hygrounds/classes/GameManager.ts

@@ -96,6 +96,8 @@ export default class GameManager {
     this._gameActive = false;
     this.world.chatManager.sendBroadcastMessage('Game over! Starting the next round in 10 seconds...', 'FF0000');
     
+    this._focusWinningPlayer();
+
     // Clear any existing restart timer
     if (this._restartTimer) {
       clearTimeout(this._restartTimer);
@@ -205,6 +207,7 @@ export default class GameManager {
       if (playerEntity instanceof GamePlayerEntity) {
         playerEntity.setActiveInventorySlotIndex(0); // reset to pickaxe at slot 0
         playerEntity.dropAllInventoryItems();
+        playerEntity.resetCamera();
         playerEntity.resetMaterials();
         playerEntity.health = 100;
         playerEntity.shield = 0;
@@ -239,6 +242,41 @@ export default class GameManager {
     this.resetLeaderboard();
   }
 
+  public _focusWinningPlayer() {
+    if (!this.world) return;
+
+    // Find player with most kills
+    let highestKills = 0;
+    let winningPlayer = '';
+    
+    this._killCounter.forEach((kills, player) => {
+      if (kills > highestKills) {
+        highestKills = kills;
+        winningPlayer = player;
+      }
+    });
+
+    // Get winning player entity
+    const winningPlayerEntity = this.world.entityManager
+      .getAllPlayerEntities()
+      .find(entity => entity.player.username === winningPlayer);
+
+    if (!winningPlayerEntity) return;
+
+    this.world.entityManager.getAllPlayerEntities().forEach(playerEntity => {
+      if (playerEntity instanceof GamePlayerEntity) {
+        if (playerEntity.player.username !== winningPlayer) { // don't change camera for the winner
+          playerEntity.focusCameraOnPlayer(winningPlayerEntity as GamePlayerEntity);
+        }
+          
+        playerEntity.player.ui.sendData({
+          type: 'announce-winner',
+          username: winningPlayer,
+        });
+      }
+    });
+  }
+
   /**
    * Syncs UI for all connected players
    */
@@ -262,7 +300,7 @@ export default class GameManager {
     this.world.chatManager.sendPlayerMessage(player, '- Search for chests and weapons to survive');
     this.world.chatManager.sendPlayerMessage(player, '- Break blocks with your pickaxe to gain materials');
     this.world.chatManager.sendPlayerMessage(player, '- Right click to spend 3 materials to place a block');
-    this.world.chatManager.sendPlayerMessage(player, '- Some weapons can zoom with "Z".');
+    this.world.chatManager.sendPlayerMessage(player, '- Some weapons zoom with "Z". Drop items with "Q"');
   }
 
   /**

package/examples/hygrounds/classes/GamePlayerEntity.ts

@@ -92,6 +92,7 @@ export default class GamePlayerEntity extends PlayerEntity {
     super.spawn(world, position, rotation);
     this._setupPlayerInventory();
     this._autoHealTicker();
+    this._outOfWorldTicker();
     this._updatePlayerUIHealth();
   }
 
@@ -121,11 +122,7 @@ export default class GamePlayerEntity extends PlayerEntity {
 
       if (attacker) {
         GameManager.instance.addKill(attacker.player.username);
-
-        // Focus on the player that killed you
-        this.player.camera.setMode(PlayerCameraMode.THIRD_PERSON);
-        this.player.camera.setAttachedToEntity(attacker);
-        this.player.camera.setModelHiddenNodes([]);
+        this.focusCameraOnPlayer(attacker);
       }
 
       this.dropAllInventoryItems();
@@ -137,16 +134,26 @@ export default class GamePlayerEntity extends PlayerEntity {
         });
 
         this.playerController.idleLoopedAnimations = [ 'sleep' ];
-        this.world.chatManager.sendPlayerMessage(this.player, 'You have died! Respawning in 10 seconds...', 'FF0000');
-        this._respawnTimer = setTimeout(() => this.respawn(), 10 * 1000);
+        this.world.chatManager.sendPlayerMessage(this.player, 'You have died! Respawning in 5 seconds...', 'FF0000');
+        this._respawnTimer = setTimeout(() => this.respawn(), 5 * 1000);
 
         if (attacker) {
-          this.world.chatManager.sendBroadcastMessage(`${attacker.player.username} killed ${this.player.username} with a ${attacker.getActiveItemName()}!`, 'FF0000');
+          if (this.player.username !== attacker.player.username) {
+            this.world.chatManager.sendBroadcastMessage(`${attacker.player.username} killed ${this.player.username} with a ${attacker.getActiveItemName()}!`, 'FF0000');
+          } else {
+            this.world.chatManager.sendBroadcastMessage(`${this.player.username} self-destructed!`, 'FF0000');
+          }
         }
       }
     }
   }
 
+  public focusCameraOnPlayer(player: GamePlayerEntity): void {
+    this.player.camera.setMode(PlayerCameraMode.THIRD_PERSON);
+    this.player.camera.setAttachedToEntity(player);
+    this.player.camera.setModelHiddenNodes([]);
+  }
+
   public dealtDamage(damage: number): void {
     this.player.ui.sendData({
       type: 'show-damage',
@@ -206,6 +213,11 @@ export default class GamePlayerEntity extends PlayerEntity {
     this.playerController.runLoopedAnimations = ['run_lower', 'run_upper'];
   }
 
+  public resetCamera(): void {
+    this._setupPlayerCamera();
+    this.player.camera.setAttachedToEntity(this);
+  }
+
   public resetMaterials(): void {
     this._materials = 0;
     this._updatePlayerUIMaterials();
@@ -238,8 +250,12 @@ export default class GamePlayerEntity extends PlayerEntity {
     this._updatePlayerUIInventoryActiveSlot();
   }
 
+  public setGravity(gravityScale: number): void {
+    this.setGravityScale(gravityScale);
+  }
+
   public takeDamage(damage: number, hitDirection: Vector3Like, attacker?: GamePlayerEntity): void {
-    if (!this.isSpawned || !this.world || !GameManager.instance.isGameActive ||  this._dead) return;
+    if (!this.isSpawned || !this.world || !GameManager.instance.isGameActive || this._dead) return;
 
     this._playDamageAudio();
 
@@ -331,7 +347,7 @@ export default class GamePlayerEntity extends PlayerEntity {
 
   private _onTickWithPlayerInput = (payload: EventPayloads[BaseEntityControllerEvent.TICK_WITH_PLAYER_INPUT]): void => {
     const { input } = payload;
-    
+
     if (this._dead) {
       return;
     }
@@ -459,7 +475,10 @@ export default class GamePlayerEntity extends PlayerEntity {
       origin,
       this.player.camera.facingDirection,
       INTERACT_RANGE,
-      { filterExcludeRigidBody: this.rawRigidBody }
+      {
+        filterExcludeRigidBody: this.rawRigidBody,
+        filterFlags: 8, // Rapier exclude sensors,
+      }
     );
 
     const hitEntity = raycastHit?.hitEntity;
@@ -552,13 +571,25 @@ export default class GamePlayerEntity extends PlayerEntity {
 
   private _autoHealTicker(): void {
     setTimeout(() => {
-      if (!this.isSpawned || this._dead) return;
+      if (!this.isSpawned) return;
 
-      if (this.health < this._maxHealth) {
+      if (this.health < this._maxHealth && !this._dead) {
         this.health += 1;
       }
 
       this._autoHealTicker();
     }, 2000);
   }
+
+  private _outOfWorldTicker(): void {
+    setTimeout(() => {
+      if (!this.isSpawned) return;
+
+      if (this.position.y < -100 && !this._dead) {
+        this.takeDamage(MAX_HEALTH + MAX_SHIELD, { x: 0, y: 0, z: -1 });
+      }
+
+      this._outOfWorldTicker();
+    }, 3000);
+  }
 }

package/examples/hygrounds/classes/GunEntity.ts

@@ -142,11 +142,7 @@ export default abstract class GunEntity extends ItemEntity {
     const direction = player.player.camera.facingDirection;
     
     return {
-      origin: {
-        x: x + (direction.x * 0.5),
-        y: y + (direction.y * 0.5) + cameraYOffset,
-        z: z + (direction.z * 0.5),
-      },
+      origin: { x, y: y + cameraYOffset, z },
       direction
     };
   }

package/examples/hygrounds/classes/ItemFactory.ts

@@ -13,9 +13,15 @@ export default class ItemFactory {
       case 'auto-shotgun':
         itemModule = await import('./weapons/AutoShotgunEntity');
         break;
+      case 'auto-sniper':
+        itemModule = await import('./weapons/AutoSniperEntity');
+        break;
       case 'bolt-action-sniper':
         itemModule = await import('./weapons/BoltActionSniperEntity');
         break;
+      case 'gravity-potion':
+        itemModule = await import('./items/GravityPotionEntity');
+        break;
       case 'light-machine-gun':
         itemModule = await import('./weapons/LightMachineGunEntity');
         break;
@@ -28,9 +34,15 @@ export default class ItemFactory {
       case 'pistol':
         itemModule = await import('./weapons/PistolEntity');
         break;
+      case 'revolver':
+        itemModule = await import('./weapons/RevolverEntity');
+        break;
       case 'rocket-launcher':
         itemModule = await import('./weapons/RocketLauncherEntity');
         break;
+        case 'submachine-gun':
+        itemModule = await import('./weapons/SubmachineGunEntity');
+        break;
       case 'shotgun':
         itemModule = await import('./weapons/ShotgunEntity');
         break;

package/examples/hygrounds/classes/items/GravityPotionEntity.ts

@@ -0,0 +1,48 @@
+import { Quaternion } from 'hytopia';
+import ItemEntity from "../ItemEntity";
+import GamePlayerEntity from '../GamePlayerEntity';
+import type { ItemEntityOptions } from "../ItemEntity";
+
+const GRAVITY_SCALE = 0.3;
+const GRAVITY_DURATION_MS = 15 * 1000; // 15 seconds
+
+const DEFAULT_GRAVITY_POTION_OPTIONS: ItemEntityOptions = {
+  heldHand: 'right',
+  iconImageUri: 'icons/gravity-potion.png',
+  idleAnimation: 'idle_gun_right',
+  mlAnimation: 'shoot_gun_right',
+  modelUri: 'models/items/gravity-potion.glb',
+  modelScale: 0.4,
+  name: 'Gravity Potion',
+  consumable: true,
+  consumeAudioUri: 'audio/sfx/potion-consume.mp3',
+  consumeTimeMs: 1000,
+  quantity: 1,
+}
+
+export default class GravityPotionEntity extends ItemEntity {
+  public constructor(options: Partial<ItemEntityOptions> = {}) {
+    super({ ...DEFAULT_GRAVITY_POTION_OPTIONS, ...options });
+  }
+
+  public override consume(): void {
+    if (!(this.parent instanceof GamePlayerEntity)) {
+      return;
+    }
+
+    const parent = this.parent as GamePlayerEntity;
+
+    // Apply gravity potion effect
+    parent.setGravity(GRAVITY_SCALE);
+    setTimeout(() => parent.setGravity(1), GRAVITY_DURATION_MS);
+
+    super.consume(); 
+  }
+
+  public override equip(): void {
+    super.equip();
+
+    this.setPosition({ x: 0, y: 0.15, z: -0.2 });
+    this.setRotation(Quaternion.fromEuler(-90, 0, 0));
+  }
+}

package/examples/hygrounds/classes/items/ShieldPotionEntity.ts

@@ -14,7 +14,7 @@ const DEFAULT_SHIELD_POTION_OPTIONS: ItemEntityOptions = {
   modelScale: 0.4,
   name: 'Shield Potion',
   consumable: true,
-  consumeAudioUri: 'audio/sfx/shield-potion-consume.mp3',
+  consumeAudioUri: 'audio/sfx/potion-consume.mp3',
   consumeTimeMs: 1000,
   quantity: 1,
 }

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

@@ -16,7 +16,7 @@ const DEFAULT_AK47_OPTIONS: GunEntityOptions = {
   scopeZoom: 2,
   modelUri: 'models/items/ak-47.glb',
   modelScale: 1.3,
-  range: 70,
+  range: 80,
   reloadAudioUri: 'audio/sfx/rifle-reload.mp3',
   reloadTimeMs: 2200,
   shootAudioUri: 'audio/sfx/rifle-shoot.mp3',

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

@@ -4,7 +4,7 @@ import type { GunEntityOptions } from '../GunEntity';
 
 const DEFAULT_AUTO_SHOTGUN_OPTIONS: GunEntityOptions = {
   ammo: 6,
-  damage: 10,         // Per pellet (7 pellets = 70 max damage)
+  damage: 11,
   fireRate: 1.5,
   heldHand: 'both',
   iconImageUri: 'icons/auto-shotgun.png',
@@ -15,7 +15,7 @@ const DEFAULT_AUTO_SHOTGUN_OPTIONS: GunEntityOptions = {
   totalAmmo: 30,
   modelUri: 'models/items/auto-shotgun.glb',
   modelScale: 1.2,
-  range: 8,
+  range: 10,
   reloadAudioUri: 'audio/sfx/shotgun-reload.mp3',
   reloadTimeMs: 3500,
   shootAudioUri: 'audio/sfx/shotgun-shoot.mp3',

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

@@ -0,0 +1,43 @@
+import { Quaternion, Vector3Like, QuaternionLike } from 'hytopia';
+import GunEntity from '../GunEntity';
+import type { GunEntityOptions } from '../GunEntity';
+
+const DEFAULT_AUTO_SNIPER_OPTIONS: GunEntityOptions = {
+  ammo: 10,
+  damage: 50,
+  fireRate: 1.5,
+  heldHand: 'both',
+  iconImageUri: 'icons/auto-sniper.png',
+  idleAnimation: 'idle_gun_both',
+  mlAnimation: 'shoot_gun_both',
+  name: 'Auto Sniper',
+  maxAmmo: 10,
+  totalAmmo: 20,
+  scopeZoom: 5,
+  modelUri: 'models/items/auto-sniper.glb',
+  modelScale: 1.3,
+  range: 100,
+  reloadAudioUri: 'audio/sfx/sniper-reload.mp3',
+  reloadTimeMs: 2200,
+  shootAudioUri: 'audio/sfx/sniper-shoot.mp3',
+};
+
+export default class AutoSniperEntity extends GunEntity {
+  public constructor(options: Partial<GunEntityOptions> = {}) {
+    super({ ...DEFAULT_AUTO_SNIPER_OPTIONS, ...options });
+  }
+
+  public override shoot(): void {
+    if (!this.parent || !this.processShoot()) return;
+
+    super.shoot();
+  }
+
+  public override getMuzzleFlashPositionRotation(): { position: Vector3Like, rotation: QuaternionLike } {
+    return {
+      position: { x: 0, y: 0.01, z: -2.7 },
+      rotation: Quaternion.fromEuler(0, 90, 0),
+    };
+  }
+}
+

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

@@ -4,7 +4,7 @@ import type { GunEntityOptions } from '../GunEntity';
 
 const DEFAULT_LIGHT_MACHINE_GUN_OPTIONS: GunEntityOptions = {
   ammo: 50,
-  damage: 15,
+  damage: 9,
   fireRate: 10,
   heldHand: 'both',
   iconImageUri: 'icons/light-machine-gun.png',
@@ -13,10 +13,10 @@ const DEFAULT_LIGHT_MACHINE_GUN_OPTIONS: GunEntityOptions = {
   name: 'Light Machine Gun',
   maxAmmo: 50,
   totalAmmo: 300,
-  scopeZoom: 1.5,
+  scopeZoom: 1.35,
   modelUri: 'models/items/light-machine-gun.glb',
   modelScale: 1.3,
-  range: 50,
+  range: 60,
   reloadAudioUri: 'audio/sfx/machine-gun-reload.mp3',
   reloadTimeMs: 4200,
   shootAudioUri: 'audio/sfx/machine-gun-shoot.mp3',

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

@@ -0,0 +1,46 @@
+import { Quaternion, Vector3Like, QuaternionLike } from 'hytopia';
+import GunEntity from '../GunEntity';
+import type { GunEntityOptions } from '../GunEntity';
+import type GamePlayerEntity from '../GamePlayerEntity';
+
+const DEFAULT_REVOLVER_OPTIONS: GunEntityOptions = {
+  ammo: 6,
+  damage: 45,
+  fireRate: 2,
+  heldHand: 'right',
+  iconImageUri: 'icons/revolver.png',
+  idleAnimation: 'idle_gun_right',
+  mlAnimation: 'shoot_gun_right',
+  name: 'Revolver',
+  maxAmmo: 6,
+  totalAmmo: 24,
+  modelUri: 'models/items/revolver.glb',
+  modelScale: 1.3,
+  range: 30,
+  reloadAudioUri: 'audio/sfx/pistol-reload.mp3',
+  reloadTimeMs: 2000,
+  shootAudioUri: 'audio/sfx/rifle-shoot.mp3',
+};
+
+export default class RevolverEntity extends GunEntity {
+  public constructor(options: Partial<GunEntityOptions> = {}) {
+    super({ ...DEFAULT_REVOLVER_OPTIONS, ...options });
+  }
+
+  public override shoot(): void {
+    if (!this.parent || !this.processShoot()) return;
+
+    super.shoot();
+    
+    // Cancel input since pistol 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.18, z: -0.7 },
+      rotation: Quaternion.fromEuler(0, 90, 0),
+    };
+  }
+}
+

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

@@ -1,4 +1,4 @@
-import { Audio, Entity, Quaternion, Vector3Like, QuaternionLike, RigidBodyType, EntityEvent, Vector3 } from 'hytopia';
+import { Audio, CollisionGroup, Entity, Quaternion, Vector3Like, QuaternionLike, RigidBodyType, EntityEvent, Vector3, Collider } from 'hytopia';
 import GunEntity from '../GunEntity';
 import { BEDROCK_BLOCK_ID } from '../../gameConfig';
 import type { GunEntityOptions } from '../GunEntity';
@@ -64,6 +64,15 @@ export default class RocketLauncherEntity extends GunEntity {
       modelScale: 0.75,
       rigidBodyOptions: {
         type: RigidBodyType.KINEMATIC_VELOCITY,
+        colliders: [
+          {
+            ...Collider.optionsFromModelUri('models/items/rocket-missile.glb', 0.75),
+            collisionGroups: {
+              belongsTo: [ CollisionGroup.ENTITY ],
+              collidesWith: [ CollisionGroup.BLOCK ],
+            }
+          },
+        ],
         linearVelocity: { 
           x: direction.x * 30,
           y: direction.y * 30,
@@ -71,7 +80,7 @@ export default class RocketLauncherEntity extends GunEntity {
         },
       }
     });
-
+    
     // Create a despawn timer if it doesn't hit
     setTimeout(() => {
       if (rocketMissileEntity.isSpawned) {

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

@@ -5,7 +5,7 @@ import type GamePlayerEntity from '../GamePlayerEntity';
 
 const DEFAULT_SHOTGUN_OPTIONS: GunEntityOptions = {
   ammo: 4,
-  damage: 12,         // Per pellet (7 pellets = 84 max damage)
+  damage: 13,
   fireRate: 0.8,
   heldHand: 'both',
   iconImageUri: 'icons/shotgun.png',