hytopia 0.1.19 → 0.1.20

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,23 @@
+---
+name: Bug report
+about: Create a bug report. Use this for unexpected behaviors that we can reproduce so we can fix them in the SDK. If we find your issue is not an SDK bug, we'll provide clarity on a fix for your code.
+title: <Concise title for this bug> [BUG]
+labels: bug
+assignees: iamarkdev
+
+---
+
+**What were you trying to do, what did you expect to happen?**
+Let us know what you were trying to do, and what you expected your code to do that it did not.
+
+**What actually happened?**
+What did your code actually do? Explain the bug/issue clearly.
+
+**To Reproduce**
+For SDK specific bugs, please provide the HYTOPIA SDK version you're using and a complete snippet of your code so we can reproduce this issue locally.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Additional context**
+Add any other context about the problem here.

package/README.md

@@ -1,7 +1,7 @@
 # HYTOPIA SDK
 
 ## Quick Links
-[Quickstart](#quickstart) • [API Reference](./docs/server.md) • [Report Bugs or Request Features](https://github.com/hytopiagg/sdk/issues)
+[Quickstart](#quickstart) • [API Reference](./docs/server.md) • [Examples](./examples) • [Join Our Developer Discord](https://discord.gg/hytopia-developers) • [Report Bugs or Request Features](https://github.com/hytopiagg/sdk/issues)
 
 ## What is HYTOPIA?
 

package/bin/scripts.js

@@ -43,7 +43,8 @@ const path = require('path');
       console.log('🔧 Initializing project');
       execSync('bun init --yes');
       execSync('bun add hytopia');
-
+      
+      const srcDir = path.join(__dirname, '..', 'boilerplate');
       fs.cpSync(srcDir, destDir, { recursive: true });  
     }
 

package/examples/README.md

@@ -0,0 +1,22 @@
+# HYTOPIA SDK Examples
+
+HYTOPIA SDK examples are a collection of HYTOPIA SDK projects that demonstrate full games or specific features using the SDK.
+
+In each folder, you'll find an index.ts file - this is the main entry point and where you'll find the code for each example.
+
+Here's an overview of the examples available:
+- [`payload-game`](./payload-game): A simple game where players must stay near a payload for it to move towards its destination while enemies spawn and swarm the players.
+- [`character-controller`](./character-controller): A simple example of how to implement your own character controller class.
+- [`entity-spawn`](./entity-spawn): A simple example of how to spawn an entity and set some of its properties.
+
+## Use Examples As Templates For Your Projects
+
+If you want to init a new HYTOPIA project based on an example in this directory, you can use the `hytopia init` command with the `--template` flag. 
+
+For example, to create a new project based on the `payload-game` example, you can run:
+
+```bash
+bunx hytopia init --template payload-game
+```
+
+The value passed to the `--template` flag should be the name of the folder in the examples directory.

package/examples/payload-game/index.ts

@@ -1,5 +1,19 @@
 /**
+ * payload-game is a simple game that encompasses a number of core HYTOPIA SDK systems.
+ * This example utilizes entities, spawning, rigid body, colliders and sensors, 
+ * collision groups, audio, character controller hooks, and more.
  * 
+ * This example is a quick and dirty implementation of an overwatch style push the payload
+ * in a multiplayer PvE style. Players start the game around the payload and must stay near it
+ * for it to move towards the next waypoint. Enemies spawn near the next arget waypoint of 
+ * the payload and swarm towards the players. Players can left click to shoot spiders with
+ * bullets.
+ * 
+ * This example is not meant to be a polished game, but rather a demonstration of how to use
+ * the SDK to build your own games. 
+ * 
+ * In a polished implementation, we'd be using multiple files and not just index.ts to
+ * break out and properly organize game behavior and mechanics.
  */
 
 import {

package/package.json

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