hytopia 0.11.1 → 0.12.0-prerelease-1

package/bin/scripts.js

@@ -474,7 +474,7 @@ async function packageProject() {
 async function build(devMode = false) {
   let envFlags = devMode ? '' : '--minify --sourcemap=inline';
 
-  execSync(`npx --yes bun build --target=node --env=disable --format=esm ${envFlags} --outfile=index.mjs index.ts`, { stdio: 'inherit' });
+  execSync(`npx --yes bun build --target=node --env=disable --format=esm ${envFlags} --external=@fails-components/webtransport-transport-http3-quiche --outfile=index.mjs index.ts`, { stdio: 'inherit' });
 }
 
 /**

package/boilerplate/index.ts

@@ -130,7 +130,7 @@ startServer(world => {
    */
   
   new Audio({
-    uri: 'audio/music/hytopia-main.mp3',
+    uri: 'audio/music/hytopia-main-theme.mp3',
     loop: true,
     volume: 0.1,
   }).play(world);

package/docs/server.blocktexturemetadata.md

@@ -0,0 +1,21 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [BlockTextureMetadata](./server.blocktexturemetadata.md)
+
+## BlockTextureMetadata type
+
+Block texture metadata including UVs and rendering hints.
+
+**Signature:**
+
+```typescript
+export type BlockTextureMetadata = {
+    u0: number;
+    v0: number;
+    u1: number;
+    v1: number;
+    averageRGB: [number, number, number];
+    isTransparent: boolean;
+    needsAlphaTest: boolean;
+};
+```

package/docs/server.blocktextureregistry.generateeverystart.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [BlockTextureRegistry](./server.blocktextureregistry.md) &gt; [generateEveryStart](./server.blocktextureregistry.generateeverystart.md)
+
+## BlockTextureRegistry.generateEveryStart property
+
+Whether to always generate the atlas on server start.
+
+**Signature:**
+
+```typescript
+generateEveryStart: boolean;
+```

package/docs/server.blocktextureregistry.getblocktexturemetadata.md

@@ -0,0 +1,56 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [BlockTextureRegistry](./server.blocktextureregistry.md) &gt; [getBlockTextureMetadata](./server.blocktextureregistry.getblocktexturemetadata.md)
+
+## BlockTextureRegistry.getBlockTextureMetadata() method
+
+Retrieves metadata for a block texture. Returns array for cubemaps (6 faces) or standard textures (1 face).
+
+**Signature:**
+
+```typescript
+getBlockTextureMetadata(textureUri: string): BlockTextureMetadata[] | undefined;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+textureUri
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+The URI of the texture (e.g., 'blocks/stone.png' or 'blocks/grass').
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+[BlockTextureMetadata](./server.blocktexturemetadata.md)<!-- -->\[\] \| undefined
+
+Array of texture metadata, or undefined if not found.
+

package/docs/server.blocktextureregistry.hasblocktexture.md

@@ -0,0 +1,56 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [BlockTextureRegistry](./server.blocktextureregistry.md) &gt; [hasBlockTexture](./server.blocktextureregistry.hasblocktexture.md)
+
+## BlockTextureRegistry.hasBlockTexture() method
+
+Checks if a block texture is registered in the atlas.
+
+**Signature:**
+
+```typescript
+hasBlockTexture(textureUri: string): boolean;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+textureUri
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+The URI of the texture (e.g., 'blocks/stone.png' or 'blocks/grass' for cubemaps).
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+boolean
+
+Whether the texture is registered.
+

package/docs/server.blocktextureregistry.instance.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [BlockTextureRegistry](./server.blocktextureregistry.md) &gt; [instance](./server.blocktextureregistry.instance.md)
+
+## BlockTextureRegistry.instance property
+
+The global BlockTextureRegistry instance as a singleton.
+
+**Signature:**
+
+```typescript
+static readonly instance: BlockTextureRegistry;
+```

package/docs/server.blocktextureregistry.md

@@ -0,0 +1,145 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [BlockTextureRegistry](./server.blocktextureregistry.md)
+
+## BlockTextureRegistry class
+
+Manages block textures and block texture atlas generation of the game.
+
+**Signature:**
+
+```typescript
+export default class BlockTextureRegistry 
+```
+
+## Remarks
+
+The BlockTextureRegistry is created internally as a global singletone accessible with the static property `BlockTextureRegistry.instance`<!-- -->.
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `BlockTextureRegistry` class.
+
+## Example
+
+
+```typescript
+import { BlockTextureRegistry } from 'hytopia';
+
+const blockTextureRegistry = BlockTextureRegistry.instance;
+const metadata = blockTextureRegistry.getBlockTextureMetadata('blocks/stone.png');
+```
+
+## Properties
+
+<table><thead><tr><th>
+
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[generateEveryStart](./server.blocktextureregistry.generateeverystart.md)
+
+
+</td><td>
+
+
+</td><td>
+
+boolean
+
+
+</td><td>
+
+Whether to always generate the atlas on server start.
+
+
+</td></tr>
+<tr><td>
+
+[instance](./server.blocktextureregistry.instance.md)
+
+
+</td><td>
+
+`static`
+
+`readonly`
+
+
+</td><td>
+
+[BlockTextureRegistry](./server.blocktextureregistry.md)
+
+
+</td><td>
+
+The global BlockTextureRegistry instance as a singleton.
+
+
+</td></tr>
+</tbody></table>
+
+## Methods
+
+<table><thead><tr><th>
+
+Method
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[getBlockTextureMetadata(textureUri)](./server.blocktextureregistry.getblocktexturemetadata.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Retrieves metadata for a block texture. Returns array for cubemaps (6 faces) or standard textures (1 face).
+
+
+</td></tr>
+<tr><td>
+
+[hasBlockTexture(textureUri)](./server.blocktextureregistry.hasblocktexture.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Checks if a block texture is registered in the atlas.
+
+
+</td></tr>
+</tbody></table>
+

package/docs/server.eventpayloads.md

@@ -9,7 +9,7 @@ The payloads for all events in the game server.
 **Signature:**
 
 ```typescript
-export interface EventPayloads extends AudioEventPayloads, BaseEntityControllerEventPayloads, BlockTypeEventPayloads, BlockTypeRegistryEventPayloads, ChatEventPayloads, ChunkLatticeEventPayloads, ConnectionEventPayloads, EntityEventPayloads, GameServerEventPayloads, ParticleEmitterEventPayloads, PlayerCameraEventPayloads, PlayerEventPayloads, PlayerManagerEventPayloads, PlayerUIEventPayloads, SceneUIEventPayloads, SimulationEventPayloads, SocketEventPayloads, LightEventPayloads, WebServerEventPayloads, WorldEventPayloads, WorldLoopEventPayloads, WorldManagerEventPayloads 
+export interface EventPayloads extends AudioEventPayloads, BaseEntityControllerEventPayloads, BlockTypeEventPayloads, BlockTypeRegistryEventPayloads, ChatEventPayloads, ChunkLatticeEventPayloads, ConnectionEventPayloads, EntityEventPayloads, GameServerEventPayloads, ParticleEmitterEventPayloads, PlayerCameraEventPayloads, PlayerEventPayloads, PlayerManagerEventPayloads, PlayerUIEventPayloads, SceneUIEventPayloads, SimulationEventPayloads, LightEventPayloads, WebServerEventPayloads, WorldEventPayloads, WorldLoopEventPayloads, WorldManagerEventPayloads 
 ```
-**Extends:** [AudioEventPayloads](./server.audioeventpayloads.md)<!-- -->, [BaseEntityControllerEventPayloads](./server.baseentitycontrollereventpayloads.md)<!-- -->, [BlockTypeEventPayloads](./server.blocktypeeventpayloads.md)<!-- -->, [BlockTypeRegistryEventPayloads](./server.blocktyperegistryeventpayloads.md)<!-- -->, [ChatEventPayloads](./server.chateventpayloads.md)<!-- -->, [ChunkLatticeEventPayloads](./server.chunklatticeeventpayloads.md)<!-- -->, ConnectionEventPayloads, [EntityEventPayloads](./server.entityeventpayloads.md)<!-- -->, [GameServerEventPayloads](./server.gameservereventpayloads.md)<!-- -->, [ParticleEmitterEventPayloads](./server.particleemittereventpayloads.md)<!-- -->, [PlayerCameraEventPayloads](./server.playercameraeventpayloads.md)<!-- -->, [PlayerEventPayloads](./server.playereventpayloads.md)<!-- -->, [PlayerManagerEventPayloads](./server.playermanagereventpayloads.md)<!-- -->, [PlayerUIEventPayloads](./server.playeruieventpayloads.md)<!-- -->, [SceneUIEventPayloads](./server.sceneuieventpayloads.md)<!-- -->, [SimulationEventPayloads](./server.simulationeventpayloads.md)<!-- -->, SocketEventPayloads, [LightEventPayloads](./server.lighteventpayloads.md)<!-- -->, WebServerEventPayloads, [WorldEventPayloads](./server.worldeventpayloads.md)<!-- -->, [WorldLoopEventPayloads](./server.worldloopeventpayloads.md)<!-- -->, [WorldManagerEventPayloads](./server.worldmanagereventpayloads.md)
+**Extends:** [AudioEventPayloads](./server.audioeventpayloads.md)<!-- -->, [BaseEntityControllerEventPayloads](./server.baseentitycontrollereventpayloads.md)<!-- -->, [BlockTypeEventPayloads](./server.blocktypeeventpayloads.md)<!-- -->, [BlockTypeRegistryEventPayloads](./server.blocktyperegistryeventpayloads.md)<!-- -->, [ChatEventPayloads](./server.chateventpayloads.md)<!-- -->, [ChunkLatticeEventPayloads](./server.chunklatticeeventpayloads.md)<!-- -->, ConnectionEventPayloads, [EntityEventPayloads](./server.entityeventpayloads.md)<!-- -->, [GameServerEventPayloads](./server.gameservereventpayloads.md)<!-- -->, [ParticleEmitterEventPayloads](./server.particleemittereventpayloads.md)<!-- -->, [PlayerCameraEventPayloads](./server.playercameraeventpayloads.md)<!-- -->, [PlayerEventPayloads](./server.playereventpayloads.md)<!-- -->, [PlayerManagerEventPayloads](./server.playermanagereventpayloads.md)<!-- -->, [PlayerUIEventPayloads](./server.playeruieventpayloads.md)<!-- -->, [SceneUIEventPayloads](./server.sceneuieventpayloads.md)<!-- -->, [SimulationEventPayloads](./server.simulationeventpayloads.md)<!-- -->, [LightEventPayloads](./server.lighteventpayloads.md)<!-- -->, WebServerEventPayloads, [WorldEventPayloads](./server.worldeventpayloads.md)<!-- -->, [WorldLoopEventPayloads](./server.worldloopeventpayloads.md)<!-- -->, [WorldManagerEventPayloads](./server.worldmanagereventpayloads.md)
 

package/docs/server.gameserver.blocktextureregistry.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [GameServer](./server.gameserver.md) &gt; [blockTextureRegistry](./server.gameserver.blocktextureregistry.md)
+
+## GameServer.blockTextureRegistry property
+
+The block texture registry for the game server.
+
+**Signature:**
+
+```typescript
+get blockTextureRegistry(): BlockTextureRegistry;
+```

package/docs/server.gameserver.md

@@ -43,6 +43,27 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
+[blockTextureRegistry](./server.gameserver.blocktextureregistry.md)
+
+
+</td><td>
+
+`readonly`
+
+
+</td><td>
+
+[BlockTextureRegistry](./server.blocktextureregistry.md)
+
+
+</td><td>
+
+The block texture registry for the game server.
+
+
+</td></tr>
+<tr><td>
+
 [instance](./server.gameserver.instance.md)
 
 

package/docs/server.md

@@ -49,6 +49,17 @@ Manages audio instances in a world.
 Represents a block in a world.
 
 
+</td></tr>
+<tr><td>
+
+[BlockTextureRegistry](./server.blocktextureregistry.md)
+
+
+</td><td>
+
+Manages block textures and block texture atlas generation of the game.
+
+
 </td></tr>
 <tr><td>
 
@@ -1499,17 +1510,6 @@ Description
 The default rigid body options for a model entity when EntityOptions.rigidBodyOptions is not provided.
 
 
-</td></tr>
-<tr><td>
-
-[PORT](./server.port.md)
-
-
-</td><td>
-
-The port the server will run on. You can override this in your .env by setting PORT. When deployed in production to HYTOPIA servers, any .env value will be ignored and 8080 will be used.
-
-
 </td></tr>
 <tr><td>
 
@@ -1539,6 +1539,17 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
+[BlockTextureMetadata](./server.blocktexturemetadata.md)
+
+
+</td><td>
+
+Block texture metadata including UVs and rendering hints.
+
+
+</td></tr>
+<tr><td>
+
 [ColliderOptions](./server.collideroptions.md)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hytopia",
-  "version": "0.11.1",
+  "version": "0.12.0-prerelease-1",
   "description": "The HYTOPIA SDK makes it easy for developers to create massively multiplayer games using JavaScript or TypeScript.",
   "type": "module",
   "main": "./server.mjs",
@@ -56,6 +56,7 @@
   },
   "homepage": "https://github.com/hytopiagg/sdk#readme",
   "dependencies": {
+    "@fails-components/webtransport-transport-http3-quiche": "1.4.4",
     "@gltf-transform/cli": "4.2.1",
     "archiver": "7.0.1",
     "bun": "1.3.0",