hytopia 0.11.3 → 0.11.5

package/bin/scripts.js

@@ -41,6 +41,7 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
     'init-mcp': initMcp,
     'package': packageProject,
     'start': start,
+    'upgrade-assets-library': () => upgradeAssets(process.argv[3] || 'latest'),
     'upgrade-cli': () => upgradeCli(process.argv[3] || 'latest'),
     'upgrade-project': () => upgradeProject(process.argv[3] || 'latest'),
     'version': displayVersion,
@@ -142,9 +143,6 @@ function init() {
   // Update SDK to latest (sets package.json requirement)
   upgradeProject();
 
-  // Copy assets into project, not overwriting existing files
-  copyAssets(destDir);
-
   // Display success message
   displayInitSuccessMessage();
 
@@ -210,18 +208,6 @@ function initFromBoilerplate(destDir) {
   }
 }
 
-/**
- * Copies assets to the project directory
- */
-function copyAssets(destDir) {
-  const assetsSource = path.join(destDir, 'node_modules', '@hytopia.com', 'assets');
-  const assetsDest = path.join(destDir, 'assets');
-  
-  if (!copyDirectoryContents(assetsSource, assetsDest, { recursive: true, force: false })) {
-    console.error('❌ Error: Could not copy assets from @hytopia.com/assets package');
-  }
-}
-
 /**
  * Displays success message after project initialization
  */
@@ -579,6 +565,13 @@ async function fetchLatestVersion(signal) {
   }
 }
 
+function upgradeAssetsLibrary(versionArg = 'latest') {
+  const version = versionArg.trim();
+  console.log(`🔄 Upgrading @hytopia.com/assets package to: ${version} ...`);
+  execSync(`npm install --force @hytopia.com/assets@${version}`, { stdio: 'inherit' });
+  console.log('✅ Upgrade complete.');
+}
+
 function upgradeCli(versionArg = 'latest') {
   const version = versionArg.trim();
   console.log(`🔄 Upgrading HYTOPIA CLI to: hytopia@${version} ...`);
@@ -613,8 +606,9 @@ function displayHelp() {
   console.log('  init [--template NAME]      Initialize a new project');
   console.log('  init-mcp                    Setup MCP integrations');
   console.log('  package                     Create a zip of the project for uploading to the HYTOPIA create portal.');
-  console.log('  upgrade-cli                 Upgrade the HYTOPIA CLI');
-  console.log('  upgrade-project [VERSION]   Upgrade project SDK dep (default: latest)');
+  console.log('  upgrade-assets-library [VERSION]    Upgrade the @hytopia.com/assets package (default: latest)');
+  console.log('  upgrade-cli [VERSION]       Upgrade the HYTOPIA CLI (default: latest)');
+  console.log('  upgrade-project [VERSION]   Upgrade project SDK dependency (default: latest)');
   console.log('');
   console.log('Examples:');
   console.log('  hytopia init --template zombies-fps');

package/docs/server.blocktextureregistry.generate.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; [generate](./server.blocktextureregistry.generate.md)
+
+## BlockTextureRegistry.generate property
+
+Whether to generate the atlas if needed. Defaults to `true` in development, `false` in production.
+
+**Signature:**
+
+```typescript
+generate: boolean;
+```

package/docs/server.blocktextureregistry.md

@@ -53,7 +53,7 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
-[generateEveryStart](./server.blocktextureregistry.generateeverystart.md)
+[generate](./server.blocktextureregistry.generate.md)
 
 
 </td><td>
@@ -66,7 +66,7 @@ boolean
 
 </td><td>
 
-Whether to always generate the atlas on server start.
+Whether to generate the atlas if needed. Defaults to `true` in development, `false` in production.
 
 
 </td></tr>

package/docs/server.modelregistry.md

@@ -89,26 +89,7 @@ boolean
 
 </td><td>
 
-Whether to use optimized models when they are loaded.
-
-
-</td></tr>
-<tr><td>
-
-[optimizeEveryStart](./server.modelregistry.optimizeeverystart.md)
-
-
-</td><td>
-
-
-</td><td>
-
-boolean
-
-
-</td><td>
-
-Whether to always run model optimization on server start.
+Whether to generate optimized models if needed. Defaults to `true` in development, `false` in production.
 
 
 </td></tr>

package/docs/server.modelregistry.optimize.md

@@ -4,7 +4,7 @@
 
 ## ModelRegistry.optimize property
 
-Whether to use optimized models when they are loaded.
+Whether to generate optimized models if needed. Defaults to `true` in development, `false` in production.
 
 **Signature:**
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hytopia",
-  "version": "0.11.3",
+  "version": "0.11.5",
   "description": "The HYTOPIA SDK makes it easy for developers to create massively multiplayer games using JavaScript or TypeScript.",
   "type": "module",
   "main": "./server.mjs",

package/server.api.json

@@ -4913,12 +4913,12 @@
           "members": [
             {
               "kind": "Property",
-              "canonicalReference": "server!BlockTextureRegistry#generateEveryStart:member",
-              "docComment": "/**\n * Whether to always generate the atlas on server start.\n */\n",
+              "canonicalReference": "server!BlockTextureRegistry#generate:member",
+              "docComment": "/**\n * Whether to generate the atlas if needed. Defaults to `true` in development, `false` in production.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "generateEveryStart: "
+                  "text": "generate: "
                 },
                 {
                   "kind": "Content",
@@ -4932,7 +4932,7 @@
               "isReadonly": false,
               "isOptional": false,
               "releaseTag": "Public",
-              "name": "generateEveryStart",
+              "name": "generate",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -28816,7 +28816,7 @@
             {
               "kind": "Property",
               "canonicalReference": "server!ModelRegistry#optimize:member",
-              "docComment": "/**\n * Whether to use optimized models when they are loaded.\n */\n",
+              "docComment": "/**\n * Whether to generate optimized models if needed. Defaults to `true` in development, `false` in production.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -28842,36 +28842,6 @@
               "isStatic": false,
               "isProtected": false,
               "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "server!ModelRegistry#optimizeEveryStart:member",
-              "docComment": "/**\n * Whether to always run model optimization on server start.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "optimizeEveryStart: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "boolean"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "optimizeEveryStart",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
             }
           ],
           "implementsTokenRanges": []

package/server.d.ts

@@ -597,8 +597,8 @@ export declare type BlockTextureMetadata = {
 export declare class BlockTextureRegistry {
     /** The global BlockTextureRegistry instance as a singleton. */
     static readonly instance: BlockTextureRegistry;
-    /** Whether to always generate the atlas on server start. */
-    generateEveryStart: boolean;
+    /** Whether to generate the atlas if needed. Defaults to `true` in development, `false` in production. */
+    generate: boolean;
 
 
     /**
@@ -3532,10 +3532,8 @@ export declare interface ModelEntityOptions extends BaseEntityOptions {
 export declare class ModelRegistry {
     /** The global ModelRegistry instance as a singleton. */
     static readonly instance: ModelRegistry;
-    /** Whether to use optimized models when they are loaded. */
+    /** Whether to generate optimized models if needed. Defaults to `true` in development, `false` in production. */
     optimize: boolean;
-    /** Whether to always run model optimization on server start. */
-    optimizeEveryStart: boolean;