hytopia 0.3.8 → 0.3.10

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/docs/server.rigidbody.createandaddchildcollider.md

@@ -9,7 +9,7 @@ Creates and adds a child collider to the rigid body for the simulation it belong
 **Signature:**
 
 ```typescript
-createAndAddChildCollider(colliderOptions: ColliderOptions): Collider;
+createAndAddChildCollider(colliderOptions: ColliderOptions): Collider | null;
 ```
 
 ## Parameters
@@ -49,9 +49,9 @@ The options for the child collider to add.
 </tbody></table>
 **Returns:**
 
-[Collider](./server.collider.md)
+[Collider](./server.collider.md) \| null
 
-The child collider that was added to the rigid body.
+The child collider that was added to the rigid body, or null if failed.
 
 ## Remarks
 

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

@@ -25,7 +25,7 @@
 
 <!-- Leaderboard -->
 <div class="leaderboard">
-  <div class="leaderboard-title">HyGrounds Deathmatch</div>
+  <div class="leaderboard-title">Deathmatch</div>
   <div class="leaderboard-timer">0:00</div>
   <div class="leaderboard-players-count">Players: 0</div>
   <div class="leaderboard-header">
@@ -61,6 +61,26 @@
   </div>
 </div>
 
+<div class="mobile-buttons-container">
+  <div id="mobile-reload-button" class="mobile-button">
+    <img src="{{CDN_ASSETS_URL}}/icons/mobile-reload.png" />
+  </div>  
+  
+  <div id="mobile-interact-button" class="mobile-button">E</div>
+  
+  <div id="mobile-jump-button" class="mobile-button">
+    <img src="{{CDN_ASSETS_URL}}/icons/mobile-jump.png" />
+  </div>
+  
+  <div id="mobile-attack-button" class="mobile-button">
+    <img src="{{CDN_ASSETS_URL}}/icons/mobile-shoot.png" />
+  </div>
+  
+  <div id="mobile-place-block-button" class="mobile-button">
+    <img src="{{CDN_ASSETS_URL}}/icons/mobile-place-block.png" />
+  </div>
+</div>
+
 <div class="materials-counter">
   <img src="{{CDN_ASSETS_URL}}/icons/block.png" alt="Materials Icon" class="materials-icon">
   <span class="materials-amount">0</span>
@@ -504,6 +524,73 @@
       timerInterval = setInterval(updateTimer, 1000);
     }
   });
+
+  // Mobile UI Controls
+  const inventorySlots = document.querySelectorAll('.inventory-slot');
+
+  inventorySlots.forEach((slot, index) => {
+    slot.addEventListener('click', () => {
+      hytopia.sendData({
+        type: 'inventory-select',
+        index: index,
+      })
+    });
+  });
+
+  const mobileInteractButton = document.getElementById('mobile-interact-button');
+  mobileInteractButton.addEventListener('touchstart', () => {
+    mobileInteractButton.classList.add('active');
+    hytopia.pressInput('e', true);
+  });
+
+  mobileInteractButton.addEventListener('touchend', () => {
+    mobileInteractButton.classList.remove('active');
+    hytopia.pressInput('e', false);
+  });
+
+  const mobileReloadButton = document.getElementById('mobile-reload-button');
+  mobileReloadButton.addEventListener('touchstart', () => {
+    mobileReloadButton.classList.add('active');
+    hytopia.pressInput('r', true);
+  });
+
+  mobileReloadButton.addEventListener('touchend', () => {
+    mobileReloadButton.classList.remove('active');
+    hytopia.pressInput('r', false);
+  });
+
+  const mobileJumpButton = document.getElementById('mobile-jump-button');
+  mobileJumpButton.addEventListener('touchstart', () => {
+    mobileJumpButton.classList.add('active');
+    hytopia.pressInput(' ', true);
+  });
+
+  mobileJumpButton.addEventListener('touchend', () => {
+    mobileJumpButton.classList.remove('active');
+    hytopia.pressInput(' ', false);
+  });
+
+  const mobileAttackButton = document.getElementById('mobile-attack-button');
+  mobileAttackButton.addEventListener('touchstart', () => {
+    mobileAttackButton.classList.add('active');
+    hytopia.pressInput('ml', true);
+  }, { passive: true });
+
+  mobileAttackButton.addEventListener('touchend', () => {
+    mobileAttackButton.classList.remove('active');
+    hytopia.pressInput('ml', false);
+  }, { passive: true });
+
+  const mobilePlaceBlockButton = document.getElementById('mobile-place-block-button');
+  mobilePlaceBlockButton.addEventListener('touchstart', () => {
+    mobilePlaceBlockButton.classList.add('active');
+    hytopia.pressInput('mr', true);
+  });
+
+  mobilePlaceBlockButton.addEventListener('touchend', () => {
+    mobilePlaceBlockButton.classList.remove('active');
+    hytopia.pressInput('mr', false);
+  });
 </script>
 
 <!-- UI Styles -->
@@ -737,7 +824,7 @@
     right: 20px;
     display: flex;
     gap: 10px;
-    z-index: 99;
+    z-index: 999;
   }
 
   .inventory-slot {
@@ -1028,7 +1115,9 @@
     background: rgba(0, 0, 0, 0.7);
     border-radius: 5px;
     padding: 10px;
-    width: 200px;
+    width: 15%;
+    max-width: 200px;
+    max-height: 40%;
     font-family: 'Arial', sans-serif;
     color: white;
     box-shadow: 0 0 10px rgba(0, 0, 0, 0.5);
@@ -1119,4 +1208,131 @@
     max-width: 160px;
     text-overflow: ellipsis;
   }
+
+  .mobile-buttons-container {
+    display: none;
+  }
+
+  /* Mobile UI */
+  body.mobile .hud {
+    left: 50%;
+    transform: translateX(-50%);
+    bottom: 35px;
+    right: auto;
+  }
+
+  body.mobile .inventory-hud {
+    bottom: 30px;
+  }
+
+  body.mobile .inventory-slot {
+    width: 45px;
+    height: 45px;
+  }
+
+  body.mobile .slot-number {
+    font-size: 12px;
+    top: -16px;
+  }
+
+  body.mobile .slot-name {
+    font-size: 8px;
+    bottom: -14px;
+  }
+
+  body.mobile .slot-quantity {
+    font-size: 10px;
+  }
+
+  body.mobile .shield-bar,
+  body.mobile .health-bar {
+    width: 120px;
+    height: 16px;
+  }
+
+  body.mobile .shield-text,
+  body.mobile .health-text {
+    font-size: 0.7em;
+  }
+
+  body.mobile .shield-icon,
+  body.mobile .health-icon {
+    width: 10px;
+    height: 10px;
+  }
+
+  body.mobile .leaderboard-title {
+    font-size: 14px;
+  }
+
+  body.mobile .leaderboard-timer {
+    font-size: 12px;
+  }
+
+  body.mobile .leaderboard-players-count {
+    font-size: 12px;
+  }
+
+  body.mobile .leaderboard-header {
+    font-size: 10px;
+  }
+
+  body.mobile .leaderboard-player {
+    font-size: 10px;
+  }
+
+  body.mobile .materials-counter {
+    right: 20px;
+    bottom: 115px;
+    font-size: 12px;
+  }
+
+  body.mobile .floating-number {
+    font-size: 14px;
+  }
+
+  body.mobile div > canvas { /* hide three debugger panels */
+    display: none !important;
+  }
+
+  body.mobile .mobile-buttons-container {
+    display: flex;
+    gap: 10px;
+    position: fixed;
+    bottom: 113px;
+    right: 118px;
+    user-select: none;
+  }
+
+  body.mobile .mobile-button {
+    background-color: rgba(0, 0, 0, 0.5);
+    border-radius: 50%;
+    align-items: center;
+    justify-content: center;
+    display: flex;
+    width: 45px;
+    height: 45px;
+    -webkit-tap-highlight-color: transparent;
+    touch-action: manipulation;
+    user-select: none;
+    transition: all 0.15s cubic-bezier(0.4, 0, 0.2, 1);
+    will-change: transform, background-color;
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
+    font-family: 'Inter', sans-serif;
+    font-size: 14px;
+    font-weight: bold;
+    color: rgba(255, 255, 255, 0.8);
+    text-shadow: 1px 1px 2px rgba(0, 0, 0, 0.8);
+  }
+
+  body.mobile .mobile-button.active {
+    transform: scale(0.92);
+    background-color: rgba(0, 0, 0, 0.75);
+    box-shadow: 0 1px 4px rgba(0, 0, 0, 0.3);
+  }
+
+  body.mobile .mobile-button img {
+    width: 25px;
+    height: 25px;
+  }
 </style>

package/examples/hygrounds/classes/GamePlayerEntity.ts

@@ -9,6 +9,7 @@ import {
   QuaternionLike,
   World,
   PlayerEntityController,
+  PlayerUIEvent,
 } from 'hytopia';
 
 import ChestEntity from './ChestEntity';
@@ -337,6 +338,15 @@ export default class GamePlayerEntity extends PlayerEntity {
   private _setupPlayerUI(): void {
     this.nametagSceneUI.setViewDistance(8); // lessen view distance so you only see player names when close
     this.player.ui.load('ui/index.html');
+
+    // Handle inventory selection from mobile UI
+    this.player.ui.on(PlayerUIEvent.DATA, (payload) => {
+      const { data } = payload;
+
+      if (data.type === 'inventory-select') {
+        this.setActiveInventorySlotIndex(data.index);
+      }
+    });
   }
 
   private _setupPlayerCamera(): void {

package/examples/hygrounds/classes/GunEntity.ts

@@ -244,6 +244,10 @@ export default abstract class GunEntity extends ItemEntity {
   }
 
   public updateAmmoIndicatorUI(reloading: boolean = false): void {
+    if (!this.parent) {
+      return;
+    }
+
     const player = this.parent as GamePlayerEntity;
 
     player.player.ui.sendData(reloading ? {

package/examples/hygrounds/classes/ItemEntity.ts

@@ -90,6 +90,7 @@ export default class ItemEntity extends Entity {
       this.parent.dropActiveInventoryItem();
       setTimeout(() => {
         this.despawn();
+        this.stopDespawnTimer();
       }, 0);
     }
 
@@ -167,7 +168,9 @@ export default class ItemEntity extends Entity {
     if (this._despawnTimer) return;
 
     this._despawnTimer = setTimeout(() => {
-      this.despawn();
+      if (this.isSpawned) {
+        this.despawn();
+      }
     }, ITEM_DESPAWN_TIME_MS);
   }
 

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

@@ -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

@@ -11,8 +11,8 @@ const DEFAULT_AUTO_SNIPER_OPTIONS: GunEntityOptions = {
   idleAnimation: 'idle_gun_both',
   mlAnimation: 'shoot_gun_both',
   name: 'Auto Sniper',
-  maxAmmo: 1,
-  totalAmmo: 12,
+  maxAmmo: 10,
+  totalAmmo: 20,
   scopeZoom: 5,
   modelUri: 'models/items/auto-sniper.glb',
   modelScale: 1.3,

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

@@ -16,7 +16,7 @@ const DEFAULT_LIGHT_MACHINE_GUN_OPTIONS: GunEntityOptions = {
   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/SubmachineGunEntity.ts

@@ -16,7 +16,7 @@ const DEFAULT_SUBMACHINE_GUN_OPTIONS: GunEntityOptions = {
   scopeZoom: 1.35,
   modelUri: 'models/items/submachine-gun.glb',
   modelScale: 1.3,
-  range: 35,
+  range: 40,
   reloadAudioUri: 'audio/sfx/rifle-reload.mp3',
   reloadTimeMs: 1500,
   shootAudioUri: 'audio/sfx/pistol-shoot.mp3',

package/examples/hygrounds/gameConfig.ts

@@ -60,11 +60,11 @@ export const CHEST_OPEN_DESPAWN_MS = 20 * 1000; // 20 seconds
 export const CHEST_DROP_ITEMS = [
   {
     itemId: 'ak47',
-    pickWeight: 0.5,
+    pickWeight: 0.7,
   },
   {
     itemId: 'auto-shotgun',
-    pickWeight: 0.5,
+    pickWeight: 0.6,
   },
   {
     itemId: 'auto-sniper',
@@ -76,43 +76,43 @@ export const CHEST_DROP_ITEMS = [
   },
   {
     itemId: 'gravity-potion',
-    pickWeight: 0.4,
+    pickWeight: 0.3,
   },
   {
     itemId: 'light-machine-gun',
-    pickWeight: 0.5,
+    pickWeight: 0.6,
   },
   {
     itemId: 'medpack',
-    pickWeight: 1,
+    pickWeight: 1.2,
   },
   {
     itemId: 'mining-drill',
-    pickWeight: 0.5,
+    pickWeight: 0.8,
   },
   {
     itemId: 'pistol',
-    pickWeight: 1,
+    pickWeight: 1.5,
   },
   {
     itemId: 'revolver',
-    pickWeight: 0.5,
+    pickWeight: 0.9,
   },
   {
     itemId: 'rocket-launcher',
-    pickWeight: 0.4,
+    pickWeight: 0.3,
   },
   {
     itemId: 'shotgun',
-    pickWeight: 0.5,
+    pickWeight: 0.8,
   },
   {
     itemId: 'shield-potion',
-    pickWeight: 1,
+    pickWeight: 1.2,
   },
   {
     itemId: 'submachine-gun',
-    pickWeight: 0.5,
+    pickWeight: 1.0,
   },
 ]
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hytopia",
-  "version": "0.3.8",
+  "version": "0.3.10",
   "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

@@ -27166,7 +27166,7 @@
             {
               "kind": "Method",
               "canonicalReference": "server!PlayerEntityController#tickWithPlayerInput:member(1)",
-              "docComment": "/**\n * Ticks the player movement for the entity controller, overriding the default implementation.\n *\n * @param entity - The entity to tick.\n *\n * @param input - The current input state of the player.\n *\n * @param cameraOrientation - The current camera orientation state of the player.\n *\n * @param deltaTimeMs - The delta time in milliseconds since the last tick.\n */\n",
+              "docComment": "/**\n * 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.\n *\n * @param entity - The entity to tick.\n *\n * @param input - The current input state of the player.\n *\n * @param cameraOrientation - The current camera orientation state of the player.\n *\n * @param deltaTimeMs - The delta time in milliseconds since the last tick.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -31498,7 +31498,7 @@
             {
               "kind": "Method",
               "canonicalReference": "server!RigidBody#createAndAddChildCollider:member(1)",
-              "docComment": "/**\n * Creates and adds a child collider to the rigid body for the simulation it belongs to.\n *\n * @remarks\n *\n * If the rigid body is not simulated, the collider will be added to the rigid body as a pending child collider and also simulated when the rigid body is simulated.\n *\n * @param colliderOptions - The options for the child collider to add.\n *\n * @returns The child collider that was added to the rigid body.\n */\n",
+              "docComment": "/**\n * Creates and adds a child collider to the rigid body for the simulation it belongs to.\n *\n * @remarks\n *\n * If the rigid body is not simulated, the collider will be added to the rigid body as a pending child collider and also simulated when the rigid body is simulated.\n *\n * @param colliderOptions - The options for the child collider to add.\n *\n * @returns The child collider that was added to the rigid body, or null if failed.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -31518,6 +31518,10 @@
                   "text": "Collider",
                   "canonicalReference": "server!Collider:class"
                 },
+                {
+                  "kind": "Content",
+                  "text": " | null"
+                },
                 {
                   "kind": "Content",
                   "text": ";"
@@ -31526,7 +31530,7 @@
               "isStatic": false,
               "returnTypeTokenRange": {
                 "startIndex": 3,
-                "endIndex": 4
+                "endIndex": 5
               },
               "releaseTag": "Public",
               "isProtected": false,

package/server.d.ts

@@ -1084,6 +1084,8 @@ export declare class Collider extends EventRouter {
 
 
 
+    private _requireUnsimulated;
+    private _requireNotRemoved;
 
 }
 
@@ -3511,7 +3513,9 @@ export declare class PlayerEntityController extends BaseEntityController {
     spawn(entity: Entity): void;
     /**
      * Ticks the player movement for the entity controller,
-     * overriding the default implementation.
+     * 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.
      *
      * @param entity - The entity to tick.
      * @param input - The current input state of the player.
@@ -4252,9 +4256,9 @@ export declare class RigidBody extends EventRouter {
      * and also simulated when the rigid body is simulated.
      *
      * @param colliderOptions - The options for the child collider to add.
-     * @returns The child collider that was added to the rigid body.
+     * @returns The child collider that was added to the rigid body, or null if failed.
      */
-    createAndAddChildCollider(colliderOptions: ColliderOptions): Collider;
+    createAndAddChildCollider(colliderOptions: ColliderOptions): Collider | null;
     /**
      * Creates and adds multiple child colliders to the rigid body for the simulation it belongs to.
      * @param colliderOptions - The options for the child colliders to add to the rigid body.