hytopia 0.1.4 → 0.1.8

package/README.md

@@ -12,6 +12,8 @@ HYTOPIA allows you to create your own highly-sharable, immersive, massively mult
 
 ## What is this SDK?
 
+*Note: This SDK is currently in alpha development. Expect breaking changes with new version releases.*
+
 The HYTOPIA SDK makes it easy for developers to create multiplayer games on the HYTOPIA platform using JavaScript or TypeScript. 
 
 Available as a simple NPM package, this SDK provides everything you need to get started:
@@ -29,17 +31,27 @@ With these resources, you can quickly build and share immersive, voxel-style mul
 
 1. Install a compatible JavaScript runtime. We recommend [Bun (recommended)](https://bun.sh/), but [Node.js](https://nodejs.org/) and [Deno](https://deno.com/) are also supported. All examples will be given using Bun.
 
-2. Install the SDK in a new or existing project.
+2. If you're starting a new project, initialize it.
+```bash
+bun init
+```
+
+3. Install the SDK in a new or existing project.
+```bash
+bun add hytopia
+```
+
+4. Initialize boilerplate. Copies assets and an index.ts game script into your project.
 ```bash
-npm install hytopia
+bunx hytopia init
 ```
 
-2. Run a local HYTOPIA server using an example game included in the SDK. The following command will start the Zombie Arena example game on port 8080.
+5. Start the server, use --watch for hot reloads as you make changes.
 ```bash
-bun hytopia examples/zombie-arena
+bun --watch index.ts
 ```
 
-3. Visit https://play.hytopia.com - when prompted, enter the local server your game is running on, which is `http://localhost:8080`.
+4. Visit https://play.hytopia.com - when prompted, enter `localhost:8080` - this is the default port of the local server you started in the previous step.
 
 Once you're up and running, here's some other resources to go further:
 - [Game Examples](./examples)

package/bin/scripts.js

@@ -2,17 +2,45 @@
 
 const fs = require('fs');
 const path = require('path');
-const command = process.argv[2];
+const mkcert = require('mkcert');
 
-if (command === 'init') {
-  const srcDir = path.join(__dirname, '..', 'boilerplate');
-  const destDir = process.cwd();
+(async () => {
+  const command = process.argv[2];
 
-  fs.cpSync(srcDir, destDir, { recursive: true });
+  if (command === 'init') {
+    const srcDir = path.join(__dirname, '..', 'boilerplate');
+    const destDir = process.cwd();
+  
+    // Copy boilerplate
+    console.log(`Copying boilerplate to ${destDir}`);
+    fs.cpSync(srcDir, destDir, { recursive: true });
+  
+    // Generate SSL cert and allow mkcert to auto handle CA/Cert setup
+    console.log(`Generating SSL cert for local development...`);
+    const validity = 3650; // 10 years
+    const ca = await mkcert.createCA({
+      organization: 'HYTOPIA',
+      countryCode: 'US',
+      state: 'Washington',
+      locality: 'Seattle',
+      validity,
+    });
 
-  console.log('🚀 Hytopia project initialized successfully!');
-  console.log('💡 Start your development server with `bun --watch index.ts`!');
-  return;
-}
+    const cert = await mkcert.createCert({
+      ca: { key: ca.key, cert: ca.cert },
+      domains: ['localhost', '127.0.0.1'],
+      validity,
+    });
+
+    fs.writeFileSync(path.join(destDir, 'assets', 'certs', 'localhost.crt'), cert.cert);
+    fs.writeFileSync(path.join(destDir, 'assets', 'certs', 'localhost.key'), cert.key);
+
+    // Done, lfg!
+    console.log('🚀 Hytopia project initialized successfully!');
+    console.log('💡 Start your development server with `bun --watch index.ts`!');
+    return;
+  }
+  
+  console.log('Unknown command: ' + command);
+})();
 
-console.log('Unknown command: ' + command);

package/boilerplate/assets/certs/README.md

@@ -0,0 +1,6 @@
+For local development, mkcert generated certs will be stored here.
+We do this to allow https://localhost & wss://localhost support. 
+Without this, play.hytopia.com requires a bunch of funky browser 
+flag workarounds in order to connect to our local server.
+This is only used for local development and will be ignored
+when your game is deployed to HYTOPIA servers.

package/boilerplate/index.ts

@@ -41,6 +41,17 @@ import worldMap from './assets/map.json';
  */
 
 startServer(world => {
+  /**
+   * Enable debug rendering of the physics simulation.
+   * This will overlay lines in-game representing colliders,
+   * rigid bodies, and raycasts. This is useful for debugging
+   * physics-related issues in a development environment.
+   * For larger worlds, enabling this can cause performance
+   * issues, which will be noticed as dropped frame rates
+   * and higher RTT times.
+   */
+  world.simulation.enableDebugRendering(true);
+
   /**
    * Load our map.
    * You can build your own map using https://build.hytopia.com
@@ -73,7 +84,7 @@ startServer(world => {
     world.chatManager.sendPlayerMessage(player, 'Use WASD to move around.');
     world.chatManager.sendPlayerMessage(player, 'Press space to jump.');
     world.chatManager.sendPlayerMessage(player, 'Hold shift to sprint.');
-    world.chatManager.sendPlayerMessage(player, 'Type /rocket for a little surprise!');
+    world.chatManager.sendPlayerMessage(player, 'Press \\ to enter or exit debug view.');
   };
 
   /**

package/docs/server.hytopia.simulation.enabledebugrendering.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; [HYTOPIA](./server.hytopia.md) &gt; [Simulation](./server.hytopia.simulation.md) &gt; [enableDebugRendering](./server.hytopia.simulation.enabledebugrendering.md)
+
+## HYTOPIA.Simulation.enableDebugRendering() method
+
+Enables or disables debug rendering for the simulation. When enabled, all colliders, rigid body and raycast outlines will be rendered in the world. Do not enable this in production. In large worlds enabling this can cause noticable lag and RTT spikes.
+
+**Signature:**
+
+```typescript
+enableDebugRendering(enabled: boolean): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+enabled
+
+
+</td><td>
+
+boolean
+
+
+</td><td>
+
+Whether to enable debug rendering.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+

package/docs/server.hytopia.simulation.isdebugrenderingenabled.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; [HYTOPIA](./server.hytopia.md) &gt; [Simulation](./server.hytopia.simulation.md) &gt; [isDebugRenderingEnabled](./server.hytopia.simulation.isdebugrenderingenabled.md)
+
+## HYTOPIA.Simulation.isDebugRenderingEnabled property
+
+Whether the simulation has debug rendering enabled.
+
+**Signature:**
+
+```typescript
+get isDebugRenderingEnabled(): boolean;
+```

package/docs/server.hytopia.simulation.md

@@ -61,6 +61,27 @@ RAPIER.Vector3
 The gravity vector for the simulation.
 
 
+</td></tr>
+<tr><td>
+
+[isDebugRenderingEnabled](./server.hytopia.simulation.isdebugrenderingenabled.md)
+
+
+</td><td>
+
+`readonly`
+
+
+</td><td>
+
+boolean
+
+
+</td><td>
+
+Whether the simulation has debug rendering enabled.
+
+
 </td></tr>
 <tr><td>
 
@@ -137,5 +158,19 @@ Description
 Casts a ray through the simulation.
 
 
+</td></tr>
+<tr><td>
+
+[enableDebugRendering(enabled)](./server.hytopia.simulation.enabledebugrendering.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Enables or disables debug rendering for the simulation. When enabled, all colliders, rigid body and raycast outlines will be rendered in the world. Do not enable this in production. In large worlds enabling this can cause noticable lag and RTT spikes.
+
+
 </td></tr>
 </tbody></table>

package/docs/server.simulation.enabledebugrendering.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; [Simulation](./server.simulation.md) &gt; [enableDebugRendering](./server.simulation.enabledebugrendering.md)
+
+## Simulation.enableDebugRendering() method
+
+Enables or disables debug rendering for the simulation. When enabled, all colliders, rigid body and raycast outlines will be rendered in the world. Do not enable this in production. In large worlds enabling this can cause noticable lag and RTT spikes.
+
+**Signature:**
+
+```typescript
+enableDebugRendering(enabled: boolean): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+enabled
+
+
+</td><td>
+
+boolean
+
+
+</td><td>
+
+Whether to enable debug rendering.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+

package/docs/server.simulation.isdebugrenderingenabled.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; [Simulation](./server.simulation.md) &gt; [isDebugRenderingEnabled](./server.simulation.isdebugrenderingenabled.md)
+
+## Simulation.isDebugRenderingEnabled property
+
+Whether the simulation has debug rendering enabled.
+
+**Signature:**
+
+```typescript
+get isDebugRenderingEnabled(): boolean;
+```

package/docs/server.simulation.md

@@ -61,6 +61,27 @@ RAPIER.Vector3
 The gravity vector for the simulation.
 
 
+</td></tr>
+<tr><td>
+
+[isDebugRenderingEnabled](./server.simulation.isdebugrenderingenabled.md)
+
+
+</td><td>
+
+`readonly`
+
+
+</td><td>
+
+boolean
+
+
+</td><td>
+
+Whether the simulation has debug rendering enabled.
+
+
 </td></tr>
 <tr><td>
 
@@ -137,5 +158,19 @@ Description
 Casts a ray through the simulation.
 
 
+</td></tr>
+<tr><td>
+
+[enableDebugRendering(enabled)](./server.simulation.enabledebugrendering.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Enables or disables debug rendering for the simulation. When enabled, all colliders, rigid body and raycast outlines will be rendered in the world. Do not enable this in production. In large worlds enabling this can cause noticable lag and RTT spikes.
+
+
 </td></tr>
 </tbody></table>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hytopia",
-  "version": "0.1.4",
+  "version": "0.1.8",
   "description": "The HYTOPIA SDK makes it easy for developers to create multiplayer games on the HYTOPIA platform using JavaScript or TypeScript.",
   "main": "server.js",
   "bin": {
@@ -46,5 +46,8 @@
   "bugs": {
     "url": "https://github.com/hytopiagg/sdk/issues"
   },
-  "homepage": "https://github.com/hytopiagg/sdk#readme"
+  "homepage": "https://github.com/hytopiagg/sdk#readme",
+  "devDependencies": {
+    "mkcert": "^3.2.0"
+  }
 }

package/server.api.json

@@ -28114,6 +28114,54 @@
                   "isAbstract": false,
                   "name": "castRay"
                 },
+                {
+                  "kind": "Method",
+                  "canonicalReference": "server!HYTOPIA.Simulation#enableDebugRendering:member(1)",
+                  "docComment": "/**\n * Enables or disables debug rendering for the simulation. When enabled, all colliders, rigid body and raycast outlines will be rendered in the world. Do not enable this in production. In large worlds enabling this can cause noticable lag and RTT spikes.\n *\n * @param enabled - Whether to enable debug rendering.\n */\n",
+                  "excerptTokens": [
+                    {
+                      "kind": "Content",
+                      "text": "enableDebugRendering(enabled: "
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "boolean"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "): "
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "void"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ";"
+                    }
+                  ],
+                  "isStatic": false,
+                  "returnTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "releaseTag": "Public",
+                  "isProtected": false,
+                  "overloadIndex": 1,
+                  "parameters": [
+                    {
+                      "parameterName": "enabled",
+                      "parameterTypeTokenRange": {
+                        "startIndex": 1,
+                        "endIndex": 2
+                      },
+                      "isOptional": false
+                    }
+                  ],
+                  "isOptional": false,
+                  "isAbstract": false,
+                  "name": "enableDebugRendering"
+                },
                 {
                   "kind": "Property",
                   "canonicalReference": "server!HYTOPIA.Simulation#gravity:member",
@@ -28145,6 +28193,36 @@
                   "isProtected": false,
                   "isAbstract": false
                 },
+                {
+                  "kind": "Property",
+                  "canonicalReference": "server!HYTOPIA.Simulation#isDebugRenderingEnabled:member",
+                  "docComment": "/**\n * Whether the simulation has debug rendering enabled.\n */\n",
+                  "excerptTokens": [
+                    {
+                      "kind": "Content",
+                      "text": "get isDebugRenderingEnabled(): "
+                    },
+                    {
+                      "kind": "Content",
+                      "text": "boolean"
+                    },
+                    {
+                      "kind": "Content",
+                      "text": ";"
+                    }
+                  ],
+                  "isReadonly": true,
+                  "isOptional": false,
+                  "releaseTag": "Public",
+                  "name": "isDebugRenderingEnabled",
+                  "propertyTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isStatic": false,
+                  "isProtected": false,
+                  "isAbstract": false
+                },
                 {
                   "kind": "Property",
                   "canonicalReference": "server!HYTOPIA.Simulation#timestepS:member",
@@ -34773,6 +34851,54 @@
               "isAbstract": false,
               "name": "castRay"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "server!Simulation#enableDebugRendering:member(1)",
+              "docComment": "/**\n * Enables or disables debug rendering for the simulation. When enabled, all colliders, rigid body and raycast outlines will be rendered in the world. Do not enable this in production. In large worlds enabling this can cause noticable lag and RTT spikes.\n *\n * @param enabled - Whether to enable debug rendering.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "enableDebugRendering(enabled: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "enabled",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "enableDebugRendering"
+            },
             {
               "kind": "Property",
               "canonicalReference": "server!Simulation#gravity:member",
@@ -34804,6 +34930,36 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "server!Simulation#isDebugRenderingEnabled:member",
+              "docComment": "/**\n * Whether the simulation has debug rendering enabled.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get isDebugRenderingEnabled(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "isDebugRenderingEnabled",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "server!Simulation#timestepS:member",

package/server.d.ts

@@ -2297,6 +2297,9 @@ export declare class Simulation {
 
 
 
+
+    /** Whether the simulation has debug rendering enabled. */
+    get isDebugRenderingEnabled(): boolean;
     /** The gravity vector for the simulation. */
     get gravity(): RAPIER.Vector3;
     /** The fixed timestep for the simulation. */
@@ -2314,6 +2317,14 @@ export declare class Simulation {
     castRay(origin: RAPIER.Vector3, direction: RAPIER.Vector3, length: number, options?: RayCastOptions): Block | Entity | null;
 
 
+    /**
+     * Enables or disables debug rendering for the simulation.
+     * When enabled, all colliders, rigid body and raycast outlines
+     * will be rendered in the world. Do not enable this in production.
+     * In large worlds enabling this can cause noticable lag and RTT spikes.
+     * @param enabled - Whether to enable debug rendering.
+     */
+    enableDebugRendering(enabled: boolean): void;