hytopia 0.9.5 → 0.10.0-prerelease

package/bin/scripts.js

@@ -1,7 +1,5 @@
 #!/usr/bin/env node
 
-// install is deno install --reload --global --force -A npm:hytopia@dev
-
 import { execSync } from 'child_process';
 import archiver from 'archiver';
 import fs from 'fs';
@@ -9,11 +7,6 @@ import path from 'path';
 import readline from 'readline';
 import { fileURLToPath } from 'url';
 
-if (!('Deno' in globalThis)) {
-  console.error('❌ Error: HYTOPIA scripts must be run with Deno as of version SDK 0.9.0.');
-  process.exit(1);
-}
-
 // Store command-line flags
 const flags = {};
 
@@ -43,6 +36,7 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
   
   // Execute the appropriate command
   const commandHandlers = {
+    'build': build,
     'help': displayHelp,
     'init': init,
     'init-mcp': initMcp,
@@ -67,15 +61,25 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 // ================================================================================
 
 /**
- * Runs a hytopia project's index file using 
- * deno compatibility mode, allow-all permissions,
+ * Build command
+ * 
+ * Builds the server and client code for node.js
+ * 
+ * @example
+ */
+function build() {
+  execSync('npx bun build --format=esm --target=node --outfile=./index.js index.ts', { stdio: 'inherit' });
+}
+
+/**
+ * Runs a hytopia project's index file using node.js
  * and watches for changes.
  */
 function start() {
-  execSync('deno run -A --watch index.ts', {
-    stdio: 'inherit',
-    env: { ...process.env, DENO_COMPAT: '1' },
-  });
+  execSync(`
+    nodemon -q -w index.ts
+      -x "npx bun build --format=esm --target=node --outfile=./index.js index.ts && node index.js"
+  `, { stdio: 'inherit'});
 }
 
 /**
@@ -126,6 +130,9 @@ function init() {
     initFromBoilerplate(destDir);
   }
 
+  // Update SDK to latest (sets package.json requirement)
+  upgradeProject();
+
   // Copy assets into project, not overwriting existing files
   copyAssets(destDir);
 
@@ -143,45 +150,23 @@ function init() {
  */
 function installProjectDependencies() {
   // init project
-  execSync('deno init --quiet', { stdio: 'inherit' });
- 
-  // remove deno boilerplate
-  Deno.removeSync('main.ts');
-  Deno.removeSync('main_test.ts');
-
-  // create deno.json with nodeModulesDir set to auto
-  Deno.writeTextFile('deno.json', JSON.stringify({
-    nodeModulesDir: "auto",
-  }, null, 2));
+  execSync('npm init --yes', { stdio: 'inherit' });
 
   // create tsconfig.json, used by validation bundler
-  Deno.writeTextFile('tsconfig.json', JSON.stringify({
+  fs.writeFileSync('tsconfig.json', JSON.stringify({
     compilerOptions: {
       lib: ["ESNext"],
       target: "ESNext",
       module: "Preserve",
-      moduleResolution: "bundler",
-      types: ["deno.ns"],
+      moduleResolution: "node",
       verbatimModuleSyntax: true,
       strict: true,
       skipLibCheck: true
     }
   }, null, 2))
 
-  // create package.json
-  Deno.writeTextFile('package.json', JSON.stringify({
-    name: 'hytopia-project',
-    version: '1.0.0',
-    description: 'My HYTOPIA project',
-    main: 'index.ts',
-    scripts: {
-      start: 'hytopia start'
-    }
-  }, null, 2));  
-
   // install hytopia sdk and hytopia assets
-  denoAddPackage('hytopia@latest', '--quiet');
-  denoAddPackage('@hytopia.com/assets@latest', '--quiet');
+  execSync('npm install hytopia@latest @hytopia.com/assets@latest', { stdio: 'inherit' });
 }
 
 /**
@@ -190,7 +175,7 @@ function installProjectDependencies() {
 function initFromTemplate(destDir) {
   console.log(`🖨️  Initializing project with examples template "${flags.template}"...`);
 
-  denoAddPackage('@hytopia.com/examples@latest');
+  execSync('npm install @hytopia.com/examples@latest', { stdio: 'inherit' });
 
   const templateDir = path.join(destDir, 'node_modules', '@hytopia.com', 'examples', flags.template);
 
@@ -200,7 +185,7 @@ function initFromTemplate(destDir) {
     return;
   }
 
-  execSync('deno install', { stdio: 'inherit' });
+  execSync('npm install', { stdio: 'inherit' });
 }
 
 /**
@@ -353,8 +338,8 @@ function initCursorLocalMcp() {
 /**
  * Package command
  * 
- * Creates a zip file of the project directory, excluding node_modules,
- * package-lock.json, deno.lock, and deno.json files.
+ * Creates a zip file of the project directory, excluding node_modules
+ * and package-lock.json files.
  * 
  * @example
  * `hytopia package`
@@ -469,8 +454,6 @@ function packageProject() {
     '.git',
     'node_modules',
     'package-lock.json',
-    'deno.lock',
-    'deno.json',
     `${projectName}.zip` // Exclude the output file itself
   ];
   
@@ -573,13 +556,6 @@ function displayAvailableCommands(command) {
   displayHelp();
 }
 
-/**
- * Adds a package using deno add command
- */
-function denoAddPackage(packageName, flags = '') {
-  execSync(`deno add --allow-scripts --npm ${flags} ${packageName}`, { stdio: 'inherit' });
-}
-
 // ================================================================================
 // VERSION CHECK AND UPGRADE
 // ================================================================================
@@ -628,7 +604,7 @@ async function fetchLatestVersion(signal) {
 function upgradeCli() {
   const versionArg = (process.argv[3] || 'latest').trim();
   console.log(`🔄 Upgrading HYTOPIA CLI to: hytopia@${versionArg} ...`);
-  execSync(`deno install --reload --global --force -A npm:hytopia@${versionArg}`, { stdio: 'inherit' });
+  execSync(`npm install -g hytopia@${versionArg}`, { stdio: 'inherit' });
   console.log('✅ Upgrade complete. You may need to restart your shell for changes to take effect.');
 }
 
@@ -636,7 +612,7 @@ function upgradeProject() {
   const versionArg = (process.argv[3] || 'latest').trim();
   const spec = `hytopia@${versionArg}`;
   console.log(`🔄 Upgrading project HYTOPIA SDK to: ${spec} ...`);
-  execSync(`deno add --allow-scripts --npm ${spec}`, { stdio: 'inherit' });
+  execSync(`npm install ${spec}`, { stdio: 'inherit' });
   console.log('✅ Project dependency upgraded.');
 }
 
@@ -653,7 +629,7 @@ function displayHelp() {
   console.log('Commands:');
   console.log('  help, -h, --help            Show this help');
   console.log('  version, -v, --version      Show CLI version');
-  console.log('  start                       Start a HYTOPIA project server (Deno compat & watch)');
+  console.log('  start                       Start a HYTOPIA project server (Node.js & watch)');
   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.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, 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, SocketEventPayloads, 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)<!-- -->, [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)<!-- -->, SocketEventPayloads, [LightEventPayloads](./server.lighteventpayloads.md)<!-- -->, WebServerEventPayloads, [WorldEventPayloads](./server.worldeventpayloads.md)<!-- -->, [WorldLoopEventPayloads](./server.worldloopeventpayloads.md)<!-- -->, [WorldManagerEventPayloads](./server.worldmanagereventpayloads.md)
 

package/docs/server.port.md

@@ -9,5 +9,5 @@ The port the server will run on. You can override this in your .env by setting P
 **Signature:**
 
 ```typescript
-PORT: number
+PORT: string | 8080
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hytopia",
-  "version": "0.9.5",
+  "version": "0.10.0-prerelease",
   "description": "The HYTOPIA SDK makes it easy for developers to create massively multiplayer games using JavaScript or TypeScript.",
   "type": "module",
   "main": "./server.js",
@@ -70,5 +70,9 @@
   ],
   "scripts": {
     "prepublishOnly": "node ./bin/writeVersion.js"
+  },
+  "devDependencies": {
+    "bun": "^1.2.20",
+    "nodemon": "^3.1.10"
   }
 }

package/server.api.json

@@ -17519,6 +17519,15 @@
               "kind": "Content",
               "text": ", "
             },
+            {
+              "kind": "Reference",
+              "text": "SocketEventPayloads",
+              "canonicalReference": "server!~SocketEventPayloads:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ", "
+            },
             {
               "kind": "Reference",
               "text": "LightEventPayloads",
@@ -17654,6 +17663,10 @@
             {
               "startIndex": 41,
               "endIndex": 42
+            },
+            {
+              "startIndex": 43,
+              "endIndex": 44
             }
           ]
         },
@@ -40002,7 +40015,7 @@
             },
             {
               "kind": "Content",
-              "text": "number"
+              "text": "string | 8080"
             }
           ],
           "fileUrlPath": "src/networking/WebServer.ts",

package/server.d.ts

@@ -1,12 +1,17 @@
 import type { AnyPacket } from '@hytopia.com/server-protocol';
+import type { ErrorEvent as ErrorEvent_2 } from 'ws';
 import EventEmitter from 'eventemitter3';
+import http from 'http';
+import type { IncomingMessage } from 'http';
 import type { InputSchema } from '@hytopia.com/server-protocol';
 import type { LobbyMembershipDto } from '@hytopia.com/creative-lib/dist/impl/getSession';
 import protocol from '@hytopia.com/server-protocol';
 import RAPIER from '@dimforge/rapier3d-simd-compat';
 import { SdpMatrix3 } from '@dimforge/rapier3d-simd-compat';
 import * as Sentry from '@sentry/node';
+import type { Socket } from 'net';
 import type { types } from 'mediasoup';
+import { WebSocket as WebSocket_2 } from 'ws';
 
 /**
  * Represents a audio playback in a world.
@@ -2195,7 +2200,7 @@ export declare class ErrorHandler {
  *
  * @public
  */
-export declare interface EventPayloads extends AudioEventPayloads, BaseEntityControllerEventPayloads, BlockTypeEventPayloads, BlockTypeRegistryEventPayloads, ChatEventPayloads, ChunkLatticeEventPayloads, ConnectionEventPayloads, EntityEventPayloads, GameServerEventPayloads, ParticleEmitterEventPayloads, PlayerCameraEventPayloads, PlayerEventPayloads, PlayerManagerEventPayloads, PlayerUIEventPayloads, SceneUIEventPayloads, SimulationEventPayloads, LightEventPayloads, WebServerEventPayloads, WorldEventPayloads, WorldLoopEventPayloads, WorldManagerEventPayloads {
+export declare 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 {
 }
 
 /**
@@ -4962,7 +4967,7 @@ export declare interface PlayerUIEventPayloads {
  *
  * @public
  */
-export declare const PORT: number;
+export declare const PORT: string | 8080;
 
 /**
  * Represents a quaternion.