hytopia 0.8.6-devtrace-1 → 0.8.6-devtrace-allocs

package/docs/server.lightmanager.getalllights.md

@@ -9,8 +9,45 @@ Retrieves all spawned Light instances for the world.
 **Signature:**
 
 ```typescript
-getAllLights(): Light[];
+getAllLights(tickAllocated?: boolean): Light[];
 ```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+tickAllocated
+
+
+</td><td>
+
+boolean
+
+
+</td><td>
+
+_(Optional)_ Whether to use the tick allocator to allocate the returned array of Light instances. The allocated array will be collected and released at the end of the current tick if true. Only use this if you know what you're doing.
+
+
+</td></tr>
+</tbody></table>
+
 **Returns:**
 
 [Light](./server.light.md)<!-- -->\[\]

package/docs/server.lightmanager.md

@@ -98,7 +98,7 @@ Retrieves all spawned Light instances attached to a specific entity.
 </td></tr>
 <tr><td>
 
-[getAllLights()](./server.lightmanager.getalllights.md)
+[getAllLights(tickAllocated)](./server.lightmanager.getalllights.md)
 
 
 </td><td>

package/docs/server.md

@@ -445,6 +445,28 @@ A simple entity controller with basic movement functions.
 Represents the physics simulation for a world.
 
 
+</td></tr>
+<tr><td>
+
+[Telemetry](./server.telemetry.md)
+
+
+</td><td>
+
+Manages performance telemetry and error tracking through your Sentry.io account.
+
+
+</td></tr>
+<tr><td>
+
+[TickAllocator](./server.tickallocator.md)
+
+
+</td><td>
+
+High-performance tick-scoped allocator for temporary objects, arrays, and buffers. All allocations are automatically bulk-released when reset() is called.
+
+
 </td></tr>
 <tr><td>
 
@@ -783,6 +805,17 @@ Event types a SceneUI instance can emit. See [SceneUIEventPayloads](./server.sce
 Event types a Simulation instance can emit. See [SimulationEventPayloads](./server.simulationeventpayloads.md) for the payloads.
 
 
+</td></tr>
+<tr><td>
+
+[TelemetrySpanOperation](./server.telemetryspanoperation.md)
+
+
+</td><td>
+
+Performance telemetry span operation types.
+
+
 </td></tr>
 <tr><td>
 
@@ -1261,7 +1294,7 @@ A quaternion.
 
 </td><td>
 
-A RGB color.
+A RGB color. r, g and b expect a value between 0 and 255.
 
 
 </td></tr>
@@ -1517,6 +1550,28 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
+[Array3Number](./server.array3number.md)
+
+
+</td><td>
+
+A 3-element number array.
+
+
+</td></tr>
+<tr><td>
+
+[Array4Number](./server.array4number.md)
+
+
+</td><td>
+
+A 4-element number array.
+
+
+</td></tr>
+<tr><td>
+
 [ColliderOptions](./server.collideroptions.md)
 
 
@@ -1866,6 +1921,17 @@ Additional mass properties for a RigidBody.
 The options for a rigid body.
 
 
+</td></tr>
+<tr><td>
+
+[TelemetrySpanOptions](./server.telemetryspanoptions.md)
+
+
+</td><td>
+
+Options for creating a telemetry span.
+
+
 </td></tr>
 <tr><td>
 

package/docs/server.particleemitter.burst.md

@@ -0,0 +1,54 @@
+<!-- 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; [burst](./server.particleemitter.burst.md)
+
+## ParticleEmitter.burst() method
+
+Creates a burst of particles, regardless of pause state.
+
+**Signature:**
+
+```typescript
+burst(count: number): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+count
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+The number of particles to burst.
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+void
+

package/docs/server.particleemitter.md

@@ -806,6 +806,20 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
+[burst(count)](./server.particleemitter.burst.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Creates a burst of particles, regardless of pause state.
+
+
+</td></tr>
+<tr><td>
+
 [despawn()](./server.particleemitter.despawn.md)
 
 

package/docs/server.particleemitterevent.md

@@ -32,6 +32,20 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
+BURST
+
+
+</td><td>
+
+`"PARTICLE_EMITTER.BURST"`
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
 DESPAWN
 
 

package/docs/server.particleemittereventpayloads._particle_emitter.burst_.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.BURST"](./server.particleemittereventpayloads._particle_emitter.burst_.md)
+
+## ParticleEmitterEventPayloads."PARTICLE\_EMITTER.BURST" property
+
+Emitted when a ParticleEmitter bursts the specified number of particles.
+
+**Signature:**
+
+```typescript
+[ParticleEmitterEvent.BURST]: {
+        particleEmitter: ParticleEmitter;
+        count: number;
+    };
+```

package/docs/server.particleemittereventpayloads.md

@@ -37,6 +37,25 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
+["PARTICLE\_EMITTER.BURST"](./server.particleemittereventpayloads._particle_emitter.burst_.md)
+
+
+</td><td>
+
+
+</td><td>
+
+{ particleEmitter: [ParticleEmitter](./server.particleemitter.md)<!-- -->; count: number; }
+
+
+</td><td>
+
+Emitted when a ParticleEmitter bursts the specified number of particles.
+
+
+</td></tr>
+<tr><td>
+
 ["PARTICLE\_EMITTER.DESPAWN"](./server.particleemittereventpayloads._particle_emitter.despawn_.md)
 
 

package/docs/server.particleemittermanager.getallparticleemitters.md

@@ -9,8 +9,45 @@ Retrieves all spawned ParticleEmitter instances for the world.
 **Signature:**
 
 ```typescript
-getAllParticleEmitters(): ParticleEmitter[];
+getAllParticleEmitters(tickAllocated?: boolean): ParticleEmitter[];
 ```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+tickAllocated
+
+
+</td><td>
+
+boolean
+
+
+</td><td>
+
+_(Optional)_ Whether to use the tick allocator to allocate the returned array of ParticleEmitter instances. The allocated array will be collected and released at the end of the current tick if true. Only use this if you know what you're doing.
+
+
+</td></tr>
+</tbody></table>
+
 **Returns:**
 
 [ParticleEmitter](./server.particleemitter.md)<!-- -->\[\]

package/docs/server.particleemittermanager.md

@@ -98,7 +98,7 @@ Retrieves all spawned ParticleEmitter instances attached to a specific entity.
 </td></tr>
 <tr><td>
 
-[getAllParticleEmitters()](./server.particleemittermanager.getallparticleemitters.md)
+[getAllParticleEmitters(tickAllocated)](./server.particleemittermanager.getallparticleemitters.md)
 
 
 </td><td>

package/docs/server.rgbcolor.md

@@ -4,7 +4,7 @@
 
 ## RgbColor interface
 
-A RGB color.
+A RGB color. r, g and b expect a value between 0 and 255.
 
 **Signature:**
 

package/docs/server.sceneuimanager.getallsceneuis.md

@@ -9,8 +9,45 @@ Retrieves all loaded SceneUI instances for the world.
 **Signature:**
 
 ```typescript
-getAllSceneUIs(): SceneUI[];
+getAllSceneUIs(tickAllocated?: boolean): SceneUI[];
 ```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+tickAllocated
+
+
+</td><td>
+
+boolean
+
+
+</td><td>
+
+_(Optional)_ Whether to use the tick allocator to allocate the returned array of SceneUI instances. The allocated array will be collected and released at the end of the current tick if true. Only use this if you know what you're doing.
+
+
+</td></tr>
+</tbody></table>
+
 **Returns:**
 
 [SceneUI](./server.sceneui.md)<!-- -->\[\]

package/docs/server.sceneuimanager.md

@@ -98,7 +98,7 @@ Retrieves all loaded SceneUI instances attached to a specific entity.
 </td></tr>
 <tr><td>
 
-[getAllSceneUIs()](./server.sceneuimanager.getallsceneuis.md)
+[getAllSceneUIs(tickAllocated)](./server.sceneuimanager.getallsceneuis.md)
 
 
 </td><td>

package/docs/server.telemetry.getprocessstats.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; [Telemetry](./server.telemetry.md) &gt; [getProcessStats](./server.telemetry.getprocessstats.md)
+
+## Telemetry.getProcessStats() method
+
+Gets current process memory and performance statistics.
+
+**Signature:**
+
+```typescript
+static getProcessStats(asMeasurement?: boolean): Record<string, any>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+asMeasurement
+
+
+</td><td>
+
+boolean
+
+
+</td><td>
+
+_(Optional)_ Whether to return data in Sentry measurement format with units.
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+Record&lt;string, any&gt;
+
+Process statistics including heap usage, RSS memory, and capacity metrics.
+

package/docs/server.telemetry.initializesentry.md

@@ -0,0 +1,74 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [Telemetry](./server.telemetry.md) &gt; [initializeSentry](./server.telemetry.initializesentry.md)
+
+## Telemetry.initializeSentry() method
+
+Initializes Sentry telemetry with the provided DSN.
+
+**Signature:**
+
+```typescript
+static initializeSentry(sentryDsn: string, tickTimeMsThreshold?: number): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+sentryDsn
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+The Sentry Data Source Name (DSN) for your project.
+
+
+</td></tr>
+<tr><td>
+
+tickTimeMsThreshold
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+_(Optional)_ The tick duration that must be exceeded to send a performance span to Sentry for a given tick. Defaults to 50ms.
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+void
+
+## Remarks
+
+This method configures Sentry for error tracking and performance monitoring. It sets up filtering to only send performance spans that exceed the provided threshold duration, reducing noise and costs. The initialization includes game-specific tags and process statistics attachment.
+

package/docs/server.telemetry.md

@@ -0,0 +1,126 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [Telemetry](./server.telemetry.md)
+
+## Telemetry class
+
+Manages performance telemetry and error tracking through your Sentry.io account.
+
+**Signature:**
+
+```typescript
+export default class Telemetry 
+```
+
+## Remarks
+
+The Telemetry class provides low-overhead performance monitoring and error tracking through Sentry (https://sentry.io) integration and your provided Sentry DSN. It automatically tracks critical game loop operations like physics simulation, entity updates, network synchronization, and more. The system only sends telemetry data when errors or slow-tick performance issues are detected, minimizing bandwidth and storage costs.
+
+## Example
+
+
+```typescript
+// Initialize Sentry for production telemetry
+Telemetry.initializeSentry('MY_SENTRY_PROJECT_DSN');
+
+// Wrap performance-critical code in spans
+Telemetry.startSpan({
+  operation: TelemetrySpanOperation.CUSTOM_OPERATION,
+  attributes: { // any arbitrary attributes you want to attach to the span
+    playerCount: world.playerManager.connectedPlayers.length,
+    entityCount: world.entityManager.entityCount,
+  },
+}, () => {
+  // Your performance-critical code here
+  performExpensiveOperation();
+});
+
+// Get current process statistics
+const stats = Telemetry.getProcessStats();
+console.log(`Heap usage: ${stats.jsHeapUsagePercent * 100}%`);
+```
+
+## Methods
+
+<table><thead><tr><th>
+
+Method
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[getProcessStats(asMeasurement)](./server.telemetry.getprocessstats.md)
+
+
+</td><td>
+
+`static`
+
+
+</td><td>
+
+Gets current process memory and performance statistics.
+
+
+</td></tr>
+<tr><td>
+
+[initializeSentry(sentryDsn, tickTimeMsThreshold)](./server.telemetry.initializesentry.md)
+
+
+</td><td>
+
+`static`
+
+
+</td><td>
+
+Initializes Sentry telemetry with the provided DSN.
+
+
+</td></tr>
+<tr><td>
+
+[sentry()](./server.telemetry.sentry.md)
+
+
+</td><td>
+
+`static`
+
+
+</td><td>
+
+Gets the Sentry SDK instance for advanced telemetry operations.
+
+
+</td></tr>
+<tr><td>
+
+[startSpan(options, callback)](./server.telemetry.startspan.md)
+
+
+</td><td>
+
+`static`
+
+
+</td><td>
+
+Executes a callback function within a performance monitoring span.
+
+
+</td></tr>
+</tbody></table>
+

package/docs/server.telemetry.sentry.md

@@ -0,0 +1,23 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [server](./server.md) &gt; [Telemetry](./server.telemetry.md) &gt; [sentry](./server.telemetry.sentry.md)
+
+## Telemetry.sentry() method
+
+Gets the Sentry SDK instance for advanced telemetry operations.
+
+**Signature:**
+
+```typescript
+static sentry(): typeof Sentry;
+```
+**Returns:**
+
+typeof Sentry
+
+The Sentry SDK instance.
+
+## Remarks
+
+This method provides direct access to the Sentry SDK for operations not covered by the Telemetry wrapper, such as custom error reporting, user context setting, or advanced span manipulation.
+