hytopia 0.14.40 → 0.14.42

package/bin/scripts.js

@@ -40,6 +40,7 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
     'init': init,
     'init-mcp': initMcp,
     'package': packageProject,
+    'run': run,
     'start': start,
     'upgrade-assets-library': () => upgradeAssetsLibrary(process.argv[3] || 'latest'),
     'upgrade-cli': () => upgradeCli(process.argv[3] || 'latest'),
@@ -94,6 +95,30 @@ async function start() {
   });
 }
 
+/**
+ * Run command
+ * 
+ * Builds and runs the project once without file watching.
+ * Useful for debugging, testing, or production-like runs.
+ * 
+ * @example
+ * `hytopia run`
+ * `hytopia run playground.ts`
+ */
+async function run() {
+  const projectRoot = process.cwd();
+  const inputFile = process.argv[3] || 'index.ts';
+  const outputFile = inputFile.replace(/\.ts$/, '.mjs');
+  const entryFile = path.join(projectRoot, outputFile);
+
+  await build(true, inputFile);
+
+  execSync(`"${process.execPath}" --enable-source-maps "${entryFile}"`, {
+    stdio: 'inherit',
+    cwd: projectRoot,
+  });
+}
+
 /**
  * Version command
  * 
@@ -617,7 +642,8 @@ function displayHelp() {
   console.log('  version, -v, --version      Show CLI version');
   console.log('  build [FILE]                Build the project (Generates ESM .mjs from FILE, default: index.ts)');
   console.log('  build-dev [FILE]            Build in dev mode (Generates ESM .mjs from FILE, default: index.ts)');
-  console.log('  start [FILE]                Start a HYTOPIA project server (Node.js & watch, default: index.ts)');
+  console.log('  start [FILE]                Start a HYTOPIA project server (Node.js & nodemon watch, default: index.ts)');
+  console.log('  run [FILE]                  Run the project once without watching (default: index.ts)');
   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.');

package/docs/server.playercosmetics.md

@@ -14,7 +14,8 @@ export type PlayerCosmetics = {
         slot: string;
         item: PlayerCosmeticsEquippedItem;
     }[];
-    hairStyle: number;
+    hairModelUri?: string;
+    hairTextureUri?: string;
     skinTextureUri: string;
 };
 ```

package/package.json

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

@@ -37946,7 +37946,7 @@
             },
             {
               "kind": "Content",
-              "text": ";\n    }[];\n    hairStyle: number;\n    skinTextureUri: string;\n}"
+              "text": ";\n    }[];\n    hairModelUri?: string;\n    hairTextureUri?: string;\n    skinTextureUri: string;\n}"
             },
             {
               "kind": "Content",

package/server.d.ts

@@ -4740,7 +4740,8 @@ export declare type PlayerCosmetics = {
         slot: string;
         item: PlayerCosmeticsEquippedItem;
     }[];
-    hairStyle: number;
+    hairModelUri?: string;
+    hairTextureUri?: string;
     skinTextureUri: string;
 };