hytopia 0.14.33 → 0.14.35

package/bin/scripts.js

@@ -34,8 +34,8 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
   
   // Execute the appropriate command
   const commandHandlers = {
-    'build': () => build(false),
-    'build-dev': () => build(true),
+    'build': () => build(false, process.argv[3]),
+    'build-dev': () => build(true, process.argv[3]),
     'help': displayHelp,
     'init': init,
     'init-mcp': initMcp,
@@ -74,15 +74,17 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
  */
 async function start() {
   const projectRoot = process.cwd();
-  const entryFile = path.join(projectRoot, 'index.mjs');
-  const buildCmd = 'hytopia build-dev';
+  const inputFile = process.argv[3] || 'index.ts';
+  const outputFile = inputFile.replace(/\.ts$/, '.mjs');
+  const entryFile = path.join(projectRoot, outputFile);
+  const buildCmd = `hytopia build-dev ${inputFile}`;
   const runCmd = `"${process.execPath}" --enable-source-maps "${entryFile}"`;
 
   // Start nodemon to watch for changes, rebuild, then run the server
   nodemon({
     watch: ['.'],
     ext: 'js,ts,html',
-    ignore: ['node_modules/**', '.git/**', '*.zip', 'index.mjs', 'assets/**'],
+    ignore: ['node_modules/**', '.git/**', '*.zip', outputFile, 'assets/**'],
     exec: `${buildCmd} && ${runCmd}`,
     delay: 100,
   })
@@ -469,10 +471,11 @@ async function packageProject() {
 // ================================================================================
 
 
-async function build(devMode = false) {
-  let envFlags = devMode ? '' : '--minify-whitespace --minify-syntax';
+async function build(devMode = false, inputFile = 'index.ts') {
+  const outputFile = inputFile.replace(/\.ts$/, '.mjs');
+  const envFlags = devMode ? '' : '--minify-whitespace --minify-syntax';
 
-  execSync(`npx --yes bun build --target=node --env=disable --format=esm ${envFlags} --sourcemap=inline --external=@fails-components/webtransport --external=@fails-components/webtransport-transport-http3-quiche --outfile=index.mjs index.ts`, { stdio: 'inherit' });
+  execSync(`npx --yes bun build --target=node --env=disable --format=esm ${envFlags} --sourcemap=inline --external=@fails-components/webtransport --external=@fails-components/webtransport-transport-http3-quiche --outfile=${outputFile} ${inputFile}`, { stdio: 'inherit' });
 }
 
 /**
@@ -612,9 +615,9 @@ function displayHelp() {
   console.log('Commands:');
   console.log('  help, -h, --help            Show this help');
   console.log('  version, -v, --version      Show CLI version');
-  console.log('  build                       Build the project (Generates ESM index.mjs)');
-  console.log('  build-dev                   Build the project in development mode (Generates ESM index.mjs with local dependencies externalized)');
-  console.log('  start                       Start a HYTOPIA project server (Node.js & watch)');
+  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('  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.');
@@ -624,5 +627,6 @@ function displayHelp() {
   console.log('');
   console.log('Examples:');
   console.log('  hytopia init --template zombies-fps');
+  console.log('  hytopia start playground.ts');
   console.log('  hytopia upgrade-project 0.8.12');
 }

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, 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)<!-- -->, WebServerEventPayloads, [WorldEventPayloads](./server.worldeventpayloads.md)<!-- -->, [WorldLoopEventPayloads](./server.worldloopeventpayloads.md)<!-- -->, [WorldManagerEventPayloads](./server.worldmanagereventpayloads.md)
 

package/docs/server.md

@@ -236,28 +236,6 @@ Manages the game and associated worlds and systems.
 A high-performance Map-like data structure optimized for frequent iteration.
 
 
-</td></tr>
-<tr><td>
-
-[Light](./server.light.md)
-
-
-</td><td>
-
-Represents a light in a world. Lights can be point lights or spotlights.
-
-
-</td></tr>
-<tr><td>
-
-[LightManager](./server.lightmanager.md)
-
-
-</td><td>
-
-Manages Light instances in a world.
-
-
 </td></tr>
 <tr><td>
 
@@ -695,28 +673,6 @@ Event types an Entity instance can emit. See [EntityEventPayloads](./server.enti
 Event types a GameServer instance can emit to the global event router. See [GameServerEventPayloads](./server.gameservereventpayloads.md) for the payloads.
 
 
-</td></tr>
-<tr><td>
-
-[LightEvent](./server.lightevent.md)
-
-
-</td><td>
-
-Event types a Light instance can emit. See [LightEventPayloads](./server.lighteventpayloads.md) for the payloads.
-
-
-</td></tr>
-<tr><td>
-
-[LightType](./server.lighttype.md)
-
-
-</td><td>
-
-The types a Light can be.
-
-
 </td></tr>
 <tr><td>
 
@@ -1176,28 +1132,6 @@ The options for a kinematic position rigid body.
 The options for a kinematic velocity rigid body.
 
 
-</td></tr>
-<tr><td>
-
-[LightEventPayloads](./server.lighteventpayloads.md)
-
-
-</td><td>
-
-Event payloads for Light emitted events.
-
-
-</td></tr>
-<tr><td>
-
-[LightOptions](./server.lightoptions.md)
-
-
-</td><td>
-
-Options for creating a Light instance.
-
-
 </td></tr>
 <tr><td>
 

package/docs/server.particleemitter.colorintensityend.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; [ParticleEmitter](./server.particleemitter.md) &gt; [colorIntensityEnd](./server.particleemitter.colorintensityend.md)
+
+## ParticleEmitter.colorIntensityEnd property
+
+The color intensity of an emitted particle at the end of its lifetime.
+
+**Signature:**
+
+```typescript
+get colorIntensityEnd(): number | undefined;
+```

package/docs/server.particleemitter.colorintensityendvariance.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; [ParticleEmitter](./server.particleemitter.md) &gt; [colorIntensityEndVariance](./server.particleemitter.colorintensityendvariance.md)
+
+## ParticleEmitter.colorIntensityEndVariance property
+
+The color intensity variance of an emitted particle at the end of its lifetime.
+
+**Signature:**
+
+```typescript
+get colorIntensityEndVariance(): number | undefined;
+```

package/docs/server.particleemitter.colorintensitystart.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; [ParticleEmitter](./server.particleemitter.md) &gt; [colorIntensityStart](./server.particleemitter.colorintensitystart.md)
+
+## ParticleEmitter.colorIntensityStart property
+
+The color intensity of an emitted particle at the start of its lifetime.
+
+**Signature:**
+
+```typescript
+get colorIntensityStart(): number | undefined;
+```

package/docs/server.particleemitter.colorintensitystartvariance.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; [ParticleEmitter](./server.particleemitter.md) &gt; [colorIntensityStartVariance](./server.particleemitter.colorintensitystartvariance.md)
+
+## ParticleEmitter.colorIntensityStartVariance property
+
+The color intensity variance of an emitted particle at the start of its lifetime.
+
+**Signature:**
+
+```typescript
+get colorIntensityStartVariance(): number | undefined;
+```

package/docs/server.particleemitter.md

@@ -195,6 +195,90 @@ The color of an emitted particle at the end of its lifetime.
 The color variance of an emitted particle at the end of its lifetime.
 
 
+</td></tr>
+<tr><td>
+
+[colorIntensityEnd](./server.particleemitter.colorintensityend.md)
+
+
+</td><td>
+
+`readonly`
+
+
+</td><td>
+
+number \| undefined
+
+
+</td><td>
+
+The color intensity of an emitted particle at the end of its lifetime.
+
+
+</td></tr>
+<tr><td>
+
+[colorIntensityEndVariance](./server.particleemitter.colorintensityendvariance.md)
+
+
+</td><td>
+
+`readonly`
+
+
+</td><td>
+
+number \| undefined
+
+
+</td><td>
+
+The color intensity variance of an emitted particle at the end of its lifetime.
+
+
+</td></tr>
+<tr><td>
+
+[colorIntensityStart](./server.particleemitter.colorintensitystart.md)
+
+
+</td><td>
+
+`readonly`
+
+
+</td><td>
+
+number \| undefined
+
+
+</td><td>
+
+The color intensity of an emitted particle at the start of its lifetime.
+
+
+</td></tr>
+<tr><td>
+
+[colorIntensityStartVariance](./server.particleemitter.colorintensitystartvariance.md)
+
+
+</td><td>
+
+`readonly`
+
+
+</td><td>
+
+number \| undefined
+
+
+</td><td>
+
+The color intensity variance of an emitted particle at the start of its lifetime.
+
+
 </td></tr>
 <tr><td>
 
@@ -915,6 +999,62 @@ Sets the color of an emitted particle at the end of its lifetime.
 Sets the color variance of an emitted particle at the end of its lifetime.
 
 
+</td></tr>
+<tr><td>
+
+[setColorIntensityEnd(colorIntensityEnd)](./server.particleemitter.setcolorintensityend.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Sets the color intensity of an emitted particle at the end of its lifetime.
+
+
+</td></tr>
+<tr><td>
+
+[setColorIntensityEndVariance(colorIntensityEndVariance)](./server.particleemitter.setcolorintensityendvariance.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Sets the color intensity variance of an emitted particle at the end of its lifetime.
+
+
+</td></tr>
+<tr><td>
+
+[setColorIntensityStart(colorIntensityStart)](./server.particleemitter.setcolorintensitystart.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Sets the color intensity of an emitted particle at the start of its lifetime.
+
+
+</td></tr>
+<tr><td>
+
+[setColorIntensityStartVariance(colorIntensityStartVariance)](./server.particleemitter.setcolorintensitystartvariance.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Sets the color intensity variance of an emitted particle at the start of its lifetime.
+
+
 </td></tr>
 <tr><td>
 

package/docs/server.particleemitter.setcolorintensityend.md

@@ -0,0 +1,53 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [ParticleEmitter](./server.particleemitter.md) &gt; [setColorIntensityEnd](./server.particleemitter.setcolorintensityend.md)
+
+## ParticleEmitter.setColorIntensityEnd() method
+
+Sets the color intensity of an emitted particle at the end of its lifetime.
+
+**Signature:**
+
+```typescript
+setColorIntensityEnd(colorIntensityEnd: number): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+colorIntensityEnd
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+The color intensity at the end of lifetime. Values greater than 1 create HDR/bloom effects.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+

package/docs/server.particleemitter.setcolorintensityendvariance.md

@@ -0,0 +1,53 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [ParticleEmitter](./server.particleemitter.md) &gt; [setColorIntensityEndVariance](./server.particleemitter.setcolorintensityendvariance.md)
+
+## ParticleEmitter.setColorIntensityEndVariance() method
+
+Sets the color intensity variance of an emitted particle at the end of its lifetime.
+
+**Signature:**
+
+```typescript
+setColorIntensityEndVariance(colorIntensityEndVariance: number): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+colorIntensityEndVariance
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+The color intensity variance at the end of lifetime.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+

package/docs/server.particleemitter.setcolorintensitystart.md

@@ -0,0 +1,53 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [ParticleEmitter](./server.particleemitter.md) &gt; [setColorIntensityStart](./server.particleemitter.setcolorintensitystart.md)
+
+## ParticleEmitter.setColorIntensityStart() method
+
+Sets the color intensity of an emitted particle at the start of its lifetime.
+
+**Signature:**
+
+```typescript
+setColorIntensityStart(colorIntensityStart: number): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+colorIntensityStart
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+The color intensity at the start of lifetime. Values greater than 1 create HDR/bloom effects.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+

package/docs/server.particleemitter.setcolorintensitystartvariance.md

@@ -0,0 +1,53 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [ParticleEmitter](./server.particleemitter.md) &gt; [setColorIntensityStartVariance](./server.particleemitter.setcolorintensitystartvariance.md)
+
+## ParticleEmitter.setColorIntensityStartVariance() method
+
+Sets the color intensity variance of an emitted particle at the start of its lifetime.
+
+**Signature:**
+
+```typescript
+setColorIntensityStartVariance(colorIntensityStartVariance: number): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+colorIntensityStartVariance
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+The color intensity variance at the start of lifetime.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+

package/docs/server.particleemitterevent.md

@@ -127,6 +127,62 @@ SET\_COLOR\_END\_VARIANCE
 </td><td>
 
 
+</td></tr>
+<tr><td>
+
+SET\_COLOR\_INTENSITY\_END
+
+
+</td><td>
+
+`"PARTICLE_EMITTER.SET_COLOR_INTENSITY_END"`
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+SET\_COLOR\_INTENSITY\_END\_VARIANCE
+
+
+</td><td>
+
+`"PARTICLE_EMITTER.SET_COLOR_INTENSITY_END_VARIANCE"`
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+SET\_COLOR\_INTENSITY\_START
+
+
+</td><td>
+
+`"PARTICLE_EMITTER.SET_COLOR_INTENSITY_START"`
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+SET\_COLOR\_INTENSITY\_START\_VARIANCE
+
+
+</td><td>
+
+`"PARTICLE_EMITTER.SET_COLOR_INTENSITY_START_VARIANCE"`
+
+
+</td><td>
+
+
 </td></tr>
 <tr><td>
 

package/docs/server.particleemittereventpayloads._particle_emitter.set_color_intensity_end_.md

@@ -0,0 +1,16 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [ParticleEmitterEventPayloads](./server.particleemittereventpayloads.md) &gt; ["PARTICLE\_EMITTER.SET\_COLOR\_INTENSITY\_END"](./server.particleemittereventpayloads._particle_emitter.set_color_intensity_end_.md)
+
+## ParticleEmitterEventPayloads."PARTICLE\_EMITTER.SET\_COLOR\_INTENSITY\_END" property
+
+Emitted when the color intensity of an emitted particle at the end of its lifetime is set.
+
+**Signature:**
+
+```typescript
+[ParticleEmitterEvent.SET_COLOR_INTENSITY_END]: {
+        particleEmitter: ParticleEmitter;
+        colorIntensityEnd: number;
+    };
+```

package/docs/server.particleemittereventpayloads._particle_emitter.set_color_intensity_end_variance_.md

@@ -0,0 +1,16 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [ParticleEmitterEventPayloads](./server.particleemittereventpayloads.md) &gt; ["PARTICLE\_EMITTER.SET\_COLOR\_INTENSITY\_END\_VARIANCE"](./server.particleemittereventpayloads._particle_emitter.set_color_intensity_end_variance_.md)
+
+## ParticleEmitterEventPayloads."PARTICLE\_EMITTER.SET\_COLOR\_INTENSITY\_END\_VARIANCE" property
+
+Emitted when the color intensity variance of an emitted particle at the end of its lifetime is set.
+
+**Signature:**
+
+```typescript
+[ParticleEmitterEvent.SET_COLOR_INTENSITY_END_VARIANCE]: {
+        particleEmitter: ParticleEmitter;
+        colorIntensityEndVariance: number;
+    };
+```