gamedev 0.0.2-alpha.0 → 0.0.4-alpha.1

package/app-server/WorldManifest.js

@@ -22,7 +22,7 @@ export class WorldManifest {
       if (parsed.formatVersion !== 2) {
         throw new Error(
           'Invalid world.json format version. Expected formatVersion 2.\n' +
-            'Run "hyperfy world export" to regenerate world.json (formatVersion 2).'
+            'Run "gamedev world export" to regenerate world.json (formatVersion 2).'
         )
       }
 

package/app-server/cli.js

@@ -17,7 +17,7 @@ async function main() {
     console.error(`❌ ${err?.message || err}`)
     process.exit(1)
   }
-  const exitCode = await runAppCommand({ command, args, helpPrefix: 'hyperfy' })
+  const exitCode = await runAppCommand({ command, args, helpPrefix: 'gamedev apps' })
   process.exit(exitCode)
 }
 

package/app-server/commands.js

@@ -246,7 +246,7 @@ export class HyperfyCLI {
     const blueprints = listLocalBlueprints(this.appsDir)
     if (blueprints.length === 0) {
       console.log(`📝 No local blueprints found in ${this.appsDir}`)
-      console.log(`💡 Run "hyperfy world export" to pull blueprints from the world.`)
+      console.log(`💡 Run "gamedev world export" to pull blueprints from the world.`)
       console.log(`   Use --include-built-scripts if you need script code locally.`)
       return
     }
@@ -399,7 +399,7 @@ app.on("update", (delta) => {
       console.log(`✅ Successfully created app in world: ${appName}`)
       console.log(`   • Blueprint: ${blueprintId}`)
       console.log(`   • Entity:    ${entityId}`)
-      console.log(`💡 Run "hyperfy world export" to sync into ${this.appsDir}.`)
+      console.log(`💡 Run "gamedev world export" to sync into ${this.appsDir}.`)
       console.log(`   Use --include-built-scripts if you need script code locally.`)
     } catch (error) {
       console.error(`❌ Error creating app:`, error?.message || error)
@@ -563,7 +563,7 @@ app.on("update", (delta) => {
         console.log(`✅ Script validation passed for ${appName}`)
         console.log(`🔗 Hash: ${localHash}`)
       } else {
-        console.log(`💡 Run 'hyperfy apps deploy ${appName}' (or save the file with app-server running)`) 
+        console.log(`💡 Run 'gamedev apps deploy ${appName}' (or save the file with app-server running)`) 
       }
     } catch (error) {
       console.error(`❌ Error validating app:`, error?.message || error)
@@ -677,9 +677,9 @@ app.on("update", (delta) => {
     }
   }
 
-  showHelp({ commandPrefix = 'hyperfy apps' } = {}) {
+  showHelp({ commandPrefix = 'gamedev apps' } = {}) {
     console.log(`
-🚀 Hyperfy CLI (direct /admin mode)
+🚀 Gamedev CLI (direct /admin mode)
 
 Usage:
   ${commandPrefix} <command> [options]
@@ -697,7 +697,7 @@ Commands:
   reset [--force]            Delete local apps/assets/world.json
   status                     Show /admin snapshot summary
   help                       Show this help
-  --target <name>            Use .hyperfy/targets.json entry for WORLD_URL/WORLD_ID/ADMIN_CODE/DEPLOY_CODE
+  --target <name>            Use .lobby/targets.json entry for WORLD_URL/WORLD_ID/ADMIN_CODE/DEPLOY_CODE
 
 Options:
   --dry-run, -n              Show deploy plan without applying changes
@@ -739,7 +739,7 @@ export async function runAppCommand({ command, args = [], rootDir = process.cwd(
     }
   }
   const cli = new HyperfyCLI({ rootDir })
-  const commandPrefix = helpPrefix || 'hyperfy apps'
+  const commandPrefix = helpPrefix || 'gamedev apps'
   let exitCode = 0
 
   switch (command) {

package/app-server/direct.js

@@ -558,7 +558,7 @@ export class DirectAppServer {
     } else if (!hasWorldFile && hasApps) {
       throw new Error(
         'world.json missing; cannot safely apply exact world layout. ' +
-          'Run "hyperfy world export" to generate it from the world, or create world.json to seed a new world.'
+          'Run "gamedev world export" to generate it from the world, or create world.json to seed a new world.'
       )
     } else {
       const manifest = this.manifest.read()
@@ -586,7 +586,7 @@ export class DirectAppServer {
       const err = new Error(
         'Local project is empty and this world already has content. ' +
           'Script code is not downloaded by default. ' +
-          'Run "hyperfy world export --include-built-scripts" to scaffold from the world.'
+          'Run "gamedev world export --include-built-scripts" to scaffold from the world.'
       )
       err.code = 'empty_project_requires_export'
       throw err
@@ -657,7 +657,7 @@ export class DirectAppServer {
   async importWorldFromDisk() {
     const manifest = this.manifest.read()
     if (!manifest) {
-      throw new Error('world.json missing. Run "hyperfy world export" to generate it first.')
+      throw new Error('world.json missing. Run "gamedev world export" to generate it first.')
     }
     const errors = this.manifest.validate(manifest)
     if (errors.length) {

package/app-server/scaffold.js

@@ -29,9 +29,9 @@ dist/
 !.env.example
 
 # Local world state
-.hyperfy/*
-!.hyperfy/
-!.hyperfy/targets.example.json
+.lobby/*
+!.lobby/
+!.lobby/targets.example.json
 
 # Claude local settings
 .claude/settings.local.json
@@ -56,7 +56,7 @@ const DEFAULT_TSCONFIG = {
 
 function normalizePackageName(name, fallback) {
   const raw = (name || '').trim() || (fallback || '').trim()
-  const base = raw || 'hyperfy-world'
+  const base = raw || 'lobby-world'
   const scopeMatch = base.startsWith('@') ? base.split('/') : null
   if (scopeMatch && scopeMatch.length === 2) {
     const scope = scopeMatch[0].toLowerCase().replace(/[^a-z0-9._-]+/g, '')
@@ -64,7 +64,7 @@ function normalizePackageName(name, fallback) {
     if (scope && pkg) return `${scope}/${pkg}`
   }
   const normalized = base.toLowerCase().replace(/[^a-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '')
-  return normalized || 'hyperfy-world'
+  return normalized || 'lobby-world'
 }
 
 function buildPackageJson({ packageName, sdkName, sdkVersion }) {
@@ -79,8 +79,8 @@ function buildPackageJson({ packageName, sdkName, sdkVersion }) {
     private: true,
     type: 'module',
     scripts: {
-      dev: 'hyperfy dev',
-      build: 'hyperfy apps build --all',
+      dev: 'gamedev dev',
+      build: 'gamedev apps build --all',
       typecheck: 'tsc --noEmit',
     },
     devDependencies,
@@ -101,7 +101,7 @@ function resolveSdkVersion() {
 
 function buildEnvExample() {
   return `# Hyperfy project environment (example)
-# Run "hyperfy dev" to generate a local .env automatically.
+# Run "gamedev dev" to generate a local .env automatically.
 WORLD_URL=http://localhost:5000
 WORLD_ID=local-your-world-id
 ADMIN_CODE=your-admin-code
@@ -250,7 +250,7 @@ export function scaffoldBaseProject({
     report,
   })
 
-  writeFileWithPolicy(path.join(rootDir, '.hyperfy', 'targets.example.json'), buildTargetsExample(), {
+  writeFileWithPolicy(path.join(rootDir, '.lobby', 'targets.example.json'), buildTargetsExample(), {
     force,
     writeFile,
     report,

package/app-server/targets.js

@@ -1,7 +1,7 @@
 import fs from 'fs'
 import path from 'path'
 
-const TARGETS_FILE = path.join('.hyperfy', 'targets.json')
+const TARGETS_FILE = path.join('.lobby', 'targets.json')
 
 export function parseTargetArgs(args = []) {
   let target = null

package/app-server/templates/claude/skills/hyperfy-app-scripting/SKILL.md

@@ -16,7 +16,7 @@ description: Hyperfy world-project app scripting workflow and constraints. Use w
 1. Identify the target app(s) and update the entry script at `apps/<AppName>/index.ts`.
 2. Update blueprint defaults in `apps/<AppName>/*.json` (model, props, flags).
 3. Keep per-instance overrides in `world.json`.
-4. Use `hyperfy dev` for continuous sync; use `hyperfy apps build --all` and `hyperfy apps deploy <app>` for explicit deploys.
+4. Use `gamedev dev` for continuous sync; use `gamedev apps build --all` and `gamedev apps deploy <app>` for explicit deploys.
 
 ## Runtime Constraints
 
@@ -38,4 +38,4 @@ description: Hyperfy world-project app scripting workflow and constraints. Use w
 ## Guardrails
 
 - Do not edit `dist/` (build output).
-- Do not edit `.hyperfy/*` except `targets.json` (local only).
+- Do not edit `.lobby/*` except `targets.json` (local only).

package/bin/{hyperfy.mjs → gamedev.mjs}

@@ -7,7 +7,7 @@ import { fileURLToPath } from 'url'
 import { spawn } from 'child_process'
 import { customAlphabet } from 'nanoid'
 
-import { HyperfyCLI, runAppCommand } from '../app-server/commands.js'
+import { runAppCommand } from '../app-server/commands.js'
 import { DirectAppServer } from '../app-server/direct.js'
 import { scaffoldBaseProject, scaffoldBuiltins, writeManifest } from '../app-server/scaffold.js'
 import { applyTargetEnv, parseTargetArgs, resolveTarget, readTargets } from '../app-server/targets.js'
@@ -59,7 +59,7 @@ function writeDotEnv(filePath, content) {
   fs.writeFileSync(filePath, content.endsWith('\n') ? content : `${content}\n`, 'utf8')
 }
 
-const TARGETS_FILE = path.join('.hyperfy', 'targets.json')
+const TARGETS_FILE = path.join('.lobby', 'targets.json')
 
 function writeTargetsFile(targets, rootDir = projectDir) {
   const filePath = path.join(rootDir, TARGETS_FILE)
@@ -68,13 +68,6 @@ function writeTargetsFile(targets, rootDir = projectDir) {
   return filePath
 }
 
-function isProjectEmpty(dirPath) {
-  const ignore = new Set(['.git', '.DS_Store'])
-  if (!fs.existsSync(dirPath)) return true
-  const entries = fs.readdirSync(dirPath, { withFileTypes: true })
-  return entries.every(entry => ignore.has(entry.name))
-}
-
 function generateAdminCode() {
   return crypto.randomBytes(16).toString('base64url')
 }
@@ -161,7 +154,7 @@ function isLocalWorld({ worldUrl }) {
 }
 
 function getWorldDir(worldId) {
-  return path.join(projectDir, '.hyperfy', worldId)
+  return path.join(projectDir, '.lobby', worldId)
 }
 
 function hasKey(env, key) {
@@ -282,15 +275,6 @@ function validateLocalEnv(env, derived) {
   return issues
 }
 
-async function confirmAction(prompt) {
-  if (!process.stdin.isTTY) return false
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
-  const answer = await new Promise(resolve => rl.question(prompt, resolve))
-  rl.close()
-  const normalized = (answer || '').trim().toLowerCase()
-  return normalized === 'y' || normalized === 'yes'
-}
-
 async function promptValue(prompt) {
   if (!process.stdin.isTTY) return null
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
@@ -302,12 +286,6 @@ async function promptValue(prompt) {
 
 function ensureEnvForStart() {
   if (!fs.existsSync(envPath)) {
-    if (!isProjectEmpty(projectDir)) {
-      console.error('Error: Missing .env in a non-empty project.')
-      console.error('Hint: Create a .env with WORLD_URL, WORLD_ID, ADMIN_CODE, and world server settings.')
-      return { ok: false }
-    }
-
     const worldId = `local-${uuid()}`
     const adminCode = generateAdminCode()
     const jwtSecret = generateJwtSecret()
@@ -469,10 +447,10 @@ async function startCommand(args = []) {
 
 function printInitHelp() {
   console.log(`
-Hyperfy Init
+Gamedev Init
 
 Usage:
-  hyperfy init [options]
+  gamedev init [options]
 
 Options:
   --name <package>          Package name (defaults to folder name)
@@ -568,7 +546,7 @@ async function initCommand(args = []) {
 
 async function appsCommand(args) {
   if (!args.length || ['help', '--help', '-h'].includes(args[0])) {
-    await runAppCommand({ command: 'help', args: [], rootDir: projectDir, helpPrefix: 'hyperfy apps' })
+    await runAppCommand({ command: 'help', args: [], rootDir: projectDir, helpPrefix: 'gamedev apps' })
     return 0
   }
 
@@ -589,7 +567,7 @@ async function appsCommand(args) {
   const env = readDotEnv(envPath)
   if (env) applyEnvToProcess(env)
 
-  return runAppCommand({ command, args: commandArgs, rootDir: projectDir, helpPrefix: 'hyperfy apps' })
+  return runAppCommand({ command, args: commandArgs, rootDir: projectDir, helpPrefix: 'gamedev apps' })
 }
 
 async function connectAdminServer({ worldUrl, adminCode, rootDir }) {
@@ -610,53 +588,6 @@ async function connectAdminServer({ worldUrl, adminCode, rootDir }) {
   }
 }
 
-async function projectCommand(args) {
-  if (!args.length || ['help', '--help', '-h'].includes(args[0])) {
-    printHelp()
-    return 0
-  }
-
-  if (args[0] !== 'reset') {
-    console.error(`Error: Unknown project command: ${args[0]}`)
-    printHelp()
-    return 1
-  }
-
-  const force = args.includes('--force') || args.includes('-f')
-  const cli = new HyperfyCLI({ rootDir: projectDir })
-  await cli.reset({ force })
-  return 0
-}
-
-async function worldsCommand(args) {
-  if (!args.length || ['help', '--help', '-h'].includes(args[0]) || args[0] === 'list') {
-    const root = path.join(projectDir, '.hyperfy')
-    if (!fs.existsSync(root)) {
-      console.log('Worlds: No local worlds found.')
-      return 0
-    }
-    const entries = fs
-      .readdirSync(root, { withFileTypes: true })
-      .filter(entry => entry.isDirectory())
-      .map(entry => entry.name)
-
-    if (!entries.length) {
-      console.log('Worlds: No local worlds found.')
-      return 0
-    }
-
-    console.log('Worlds: Local worlds:')
-    for (const entry of entries) {
-      console.log(`  - ${entry}`)
-    }
-    return 0
-  }
-
-  console.error(`Error: Unknown worlds command: ${args[0]}`)
-  printHelp()
-  return 1
-}
-
 async function worldCommand(args) {
   if (!args.length || ['help', '--help', '-h'].includes(args[0])) {
     printHelp()
@@ -665,7 +596,7 @@ async function worldCommand(args) {
 
   const action = args[0]
 
-  if (action === 'export' || action === 'import' || action === 'wipe') {
+  if (action === 'export' || action === 'import') {
     const env = readDotEnv(envPath)
     if (!env) {
       console.error('Error: Missing .env in this project.')
@@ -680,37 +611,6 @@ async function worldCommand(args) {
       return 1
     }
 
-    if (action === 'wipe') {
-      if (!isLocalWorld({ worldUrl })) {
-        console.error('Error: WORLD_URL does not indicate a local world. Refusing to wipe.')
-        return 1
-      }
-
-      const worldDir = getWorldDir(worldId)
-      if (!fs.existsSync(worldDir)) {
-        console.log(`Worlds: No local world found at ${worldDir}`)
-        return 0
-      }
-
-      const force = args.includes('--force') || args.includes('-f')
-      if (!force) {
-        const ok = await confirmAction(`Delete local world data at ${worldDir}? (y/N): `)
-        if (!ok) {
-          console.log('World wipe cancelled')
-          return 1
-        }
-      }
-
-      try {
-        fs.rmSync(worldDir, { recursive: true, force: true })
-        console.log(`Deleted ${worldDir}`)
-        return 0
-      } catch (error) {
-        console.error(`Error: Failed to delete ${worldDir}`, error?.message || error)
-        return 1
-      }
-    }
-
     let server
     try {
       server = await connectAdminServer({ worldUrl, adminCode: env.ADMIN_CODE, rootDir: projectDir })
@@ -740,10 +640,10 @@ async function worldCommand(args) {
 
 function printFlyHelp() {
   console.log(`
-Hyperfy Fly
+Gamedev Fly
 
 Usage:
-  hyperfy fly <command> [options]
+  gamedev fly <command> [options]
 
 Commands:
   init                      Generate fly.toml and optional GitHub workflow
@@ -755,11 +655,11 @@ Init options:
   --region <code>           Fly region (default: ams)
   --persist                 Enable volume mount + SAVE_INTERVAL
   --world-id <id>           WORLD_ID override (default: fly-<app>)
-  --target <name>           Update .hyperfy/targets.json with worldUrl/worldId
+  --target <name>           Update .lobby/targets.json with worldUrl/worldId
   --force, -f               Overwrite existing fly.toml / workflow
 
 Secrets options:
-  --target <name>           Update .hyperfy/targets.json with generated codes
+  --target <name>           Update .lobby/targets.json with generated codes
   --no-deploy-code          Skip DEPLOY_CODE generation
   --force, -f               Overwrite existing target codes
 `)
@@ -1067,26 +967,22 @@ async function flyCommand(args) {
 
 function printHelp() {
   console.log(`
-Hyperfy CLI
+Gamedev CLI
 
 Usage:
-  hyperfy <command> [options]
+  gamedev <command> [options]
 
 Commands:
   init                      Scaffold a new world project in the current folder
-  start                     Start the world (local or remote) + app-server sync
-  dev                       Alias for start
+  dev                       Start the world (local or remote) + app-server sync
   apps <command>            Manage apps (create, list, build, clean, deploy, update, validate, status)
   fly <command>             Fly.io deployment helpers
-  project reset [--force]   Delete local apps/assets/world.json in this project
   world export              Export world.json + apps/assets from the world (use --include-built-scripts for scripts)
   world import              Import local apps + world.json into the world
-  world wipe [--force]      Delete the local world runtime directory for this project
-  worlds list               List local world directories in ./.hyperfy
   help                      Show this help
 
 Options:
-  --target <name>           Use .hyperfy/targets.json entry (applies to start/dev/apps)
+  --target <name>           Use .lobby/targets.json entry (applies to dev/apps)
 `)
 }
 
@@ -1096,17 +992,12 @@ async function main() {
   switch (command) {
     case 'init':
       return initCommand(args)
-    case 'start':
     case 'dev':
       return startCommand(args)
     case 'apps':
       return appsCommand(args)
-    case 'project':
-      return projectCommand(args)
     case 'world':
       return worldCommand(args)
-    case 'worlds':
-      return worldsCommand(args)
     case 'fly':
       return flyCommand(args)
     case 'help':

package/build/public/admin.html

@@ -25,14 +25,14 @@
     <meta name="apple-mobile-web-app-capable" content="yes" />
     <meta name="mobile-web-app-capable" content="yes" />
     <link rel="preload" href="/rubik.woff2" as="font" type="font/woff2" crossorigin />
-    <link rel="stylesheet" type="text/css" href="/index.css?v=1768869532415" />
+    <link rel="stylesheet" type="text/css" href="/index.css?v=1768873891919" />
     <script>
       window.PARTICLES_PATH = '/particles-4YQR4CFO.js'
     </script>
   </head>
   <body>
     <div id="root"></div>
-    <script src="/env.js?v=1768869532415"></script>
+    <script src="/env.js?v=1768873891919"></script>
     <script src="/admin-EJMJPJ7M.js" type="module"></script>
   </body>
 </html>

package/build/public/index.html

@@ -26,14 +26,14 @@
     <meta name="mobile-web-app-capable" content="yes" />
     <!-- <link rel='icon' href='/favicon.ico' /> -->
     <link rel="preload" href="/rubik.woff2" as="font" type="font/woff2" crossorigin />
-    <link rel="stylesheet" type="text/css" href="/index.css?v=1768869532414" />
+    <link rel="stylesheet" type="text/css" href="/index.css?v=1768873891919" />
     <script>
       window.PARTICLES_PATH = '/particles-4YQR4CFO.js'
     </script>
   </head>
   <body>
     <div id="root"></div>
-    <script src="/env.js?v=1768869532414"></script>
+    <script src="/env.js?v=1768873891919"></script>
     <script src="/index-RJRKEY6V.js" type="module"></script>
   </body>
 </html>

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "gamedev",
-  "version": "0.0.2-alpha.0",
+  "version": "0.0.4-alpha.1",
   "type": "module",
   "main": "index.node.js",
   "types": "index.d.ts",
   "files": [
     "build/**",
     "app-server/**",
+    "src/core/packets.js",
     "index.node.js",
     "index.node-client.js",
     "index.d.ts",
@@ -65,7 +66,7 @@
     "test:integration": "node --test \"test/integration/**/*.test.js\""
   },
   "bin": {
-    "@drama.haus/hyperfy": "bin/hyperfy.mjs"
+    "gamedev": "bin/gamedev.mjs"
   },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.859.0",

package/src/core/packets.js

@@ -0,0 +1,78 @@
+import { Packr } from 'msgpackr'
+
+const packr = new Packr({ structuredClone: true })
+
+// prettier-ignore
+const names = [
+  'snapshot',
+  'command',
+  'chatAdded',
+  'chatCleared',
+  'blueprintAdded',
+  'blueprintModified',
+  'entityAdded',
+  'entityModified',
+  'entityEvent',
+  'entityRemoved',
+  'playerTeleport',
+  'playerPush',
+  'playerSessionAvatar',
+  'liveKitLevel',
+  'mute',
+  'settingsModified',
+  'spawnModified',
+  'modifyRank',
+  'kick',
+  'ping',
+  'pong',
+  'blueprintRemoved',
+  // admin protocol
+  'adminAuth',
+  'adminAuthOk',
+  'adminAuthError',
+  'adminCommand',
+  'adminResult',
+  // admin player streaming
+  'playerJoined',
+  'playerUpdated',
+  'playerLeft',
+]
+
+const byName = {}
+const byId = {}
+
+let ids = -1
+
+for (const name of names) {
+  const id = ++ids
+  const info = {
+    id,
+    name,
+    method: `on${capitalize(name)}`, // eg 'connect' -> 'onConnect'
+  }
+  byName[name] = info
+  byId[id] = info
+}
+
+function capitalize(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1)
+}
+
+export function writePacket(name, data) {
+  const info = byName[name]
+  if (!info) throw new Error(`writePacket failed: ${name} (name not found)`)
+  const packet = packr.pack([info.id, data])
+  return packet
+}
+
+export function readPacket(packet) {
+  try {
+    const [id, data] = packr.unpack(packet)
+    const info = byId[id]
+    if (!info) throw new Error(`readPacket failed: ${id} (id not found)`)
+    return [info.method, data]
+  } catch (err) {
+    console.error(err)
+    return []
+  }
+}