gamedev 0.0.3-alpha.0 → 0.0.4-alpha.2

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

@@ -12,7 +12,7 @@ const CLAUDE_SKILL_TEMPLATE = path.join(
   TEMPLATES_DIR,
   'claude',
   'skills',
-  'lobby-app-scripting',
+  'hyperfy-app-scripting',
   'SKILL.md'
 )
 
@@ -51,7 +51,7 @@ const DEFAULT_TSCONFIG = {
     skipLibCheck: true,
     types: ['gamedev/app-runtime'],
   },
-  include: ['apps/**/*', 'lobby.app-runtime.d.ts'],
+  include: ['apps/**/*', 'hyperfy.app-runtime.d.ts'],
 }
 
 function normalizePackageName(name, fallback) {
@@ -100,7 +100,7 @@ function resolveSdkVersion() {
 }
 
 function buildEnvExample() {
-  return `# Lobby project environment (example)
+  return `# Hyperfy project environment (example)
 # Run "gamedev dev" to generate a local .env automatically.
 WORLD_URL=http://localhost:5000
 WORLD_ID=local-your-world-id
@@ -202,6 +202,58 @@ function resolveBuiltinScriptPath(filename) {
   return null
 }
 
+function resolveBuiltinAssetPath(filename) {
+  const buildPath = path.join(__dirname, '..', 'build', 'world', 'assets', filename)
+  if (fs.existsSync(buildPath)) return buildPath
+  const srcPath = path.join(__dirname, '..', 'src', 'world', 'assets', filename)
+  if (fs.existsSync(srcPath)) return srcPath
+  return null
+}
+
+function collectAssetFilenames(value, out) {
+  if (!out) out = new Set()
+  if (typeof value === 'string') {
+    if (value.startsWith('asset://')) {
+      out.add(value.slice('asset://'.length))
+    } else if (value.startsWith('assets/')) {
+      out.add(value.slice('assets/'.length))
+    }
+    return out
+  }
+  if (Array.isArray(value)) {
+    for (const item of value) {
+      collectAssetFilenames(item, out)
+    }
+    return out
+  }
+  if (value && typeof value === 'object') {
+    for (const item of Object.values(value)) {
+      collectAssetFilenames(item, out)
+    }
+  }
+  return out
+}
+
+function toLocalAssetUrls(value) {
+  if (typeof value === 'string') {
+    if (value.startsWith('asset://')) {
+      return `assets/${value.slice('asset://'.length)}`
+    }
+    return value
+  }
+  if (Array.isArray(value)) {
+    return value.map(item => toLocalAssetUrls(item))
+  }
+  if (value && typeof value === 'object') {
+    const next = {}
+    for (const [key, item] of Object.entries(value)) {
+      next[key] = toLocalAssetUrls(item)
+    }
+    return next
+  }
+  return value
+}
+
 function readBuiltinScript(template) {
   const scriptPath = resolveBuiltinScriptPath(template.scriptAsset)
   if (!scriptPath) {
@@ -256,7 +308,7 @@ export function scaffoldBaseProject({
     report,
   })
 
-  writeFileWithPolicy(path.join(rootDir, 'lobby.app-runtime.d.ts'), APP_RUNTIME_TYPES_REFERENCE, {
+  writeFileWithPolicy(path.join(rootDir, 'hyperfy.app-runtime.d.ts'), APP_RUNTIME_TYPES_REFERENCE, {
     force,
     writeFile,
     report,
@@ -266,7 +318,7 @@ export function scaffoldBaseProject({
     const skillContent = readText(CLAUDE_SKILL_TEMPLATE)
     if (skillContent != null) {
       writeFileWithPolicy(
-        path.join(rootDir, '.claude', 'skills', 'lobby-app-scripting', 'SKILL.md'),
+        path.join(rootDir, '.claude', 'skills', 'hyperfy-app-scripting', 'SKILL.md'),
         skillContent.endsWith('\n') ? skillContent : `${skillContent}\n`,
         { force, writeFile, report }
       )
@@ -296,16 +348,21 @@ export function createDefaultManifest() {
 export function scaffoldBuiltins({ rootDir, force = false, writeFile } = {}) {
   const report = { created: [], updated: [], skipped: [] }
   const appsDir = path.join(rootDir, 'apps')
+  const assetsDir = path.join(rootDir, 'assets')
   ensureDir(appsDir)
 
   const templates = [...BUILTIN_APP_TEMPLATES, SCENE_TEMPLATE]
+  const assetFiles = new Set()
+
   for (const template of templates) {
+    collectAssetFilenames(template.config, assetFiles)
     const appDir = path.join(appsDir, template.appName)
     ensureDir(appDir)
 
     const blueprintPath = path.join(appDir, `${template.fileBase}.json`)
     if (!fs.existsSync(blueprintPath) || force) {
-      writeFileWithPolicy(blueprintPath, JSON.stringify(template.config, null, 2) + '\n', {
+      const localConfig = toLocalAssetUrls(template.config)
+      writeFileWithPolicy(blueprintPath, JSON.stringify(localConfig, null, 2) + '\n', {
         force,
         writeFile,
         report,
@@ -320,6 +377,34 @@ export function scaffoldBuiltins({ rootDir, force = false, writeFile } = {}) {
     }
   }
 
+  if (assetFiles.size) {
+    ensureDir(assetsDir)
+    for (const filename of assetFiles) {
+      const srcPath = resolveBuiltinAssetPath(filename)
+      if (!srcPath) {
+        throw new Error(`missing_builtin_asset:${filename}`)
+      }
+      const destPath = path.join(assetsDir, filename)
+      const exists = fs.existsSync(destPath)
+      if (exists && !force) {
+        report.skipped.push(destPath)
+        continue
+      }
+      const buffer = fs.readFileSync(srcPath)
+      if (writeFile) {
+        writeFile(destPath, buffer)
+      } else {
+        ensureDir(path.dirname(destPath))
+        fs.writeFileSync(destPath, buffer)
+      }
+      if (exists) {
+        report.updated.push(destPath)
+      } else {
+        report.created.push(destPath)
+      }
+    }
+  }
+
   return { report, manifest: createDefaultManifest() }
 }
 

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/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)
@@ -563,12 +541,15 @@ async function initCommand(args = []) {
     console.log(`↪️  Skipped ${skipped.length} existing file(s)`)
   }
 
+  const envResult = ensureEnvForStart()
+  if (!envResult.ok) return 1
+
   return 0
 }
 
 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 +570,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 +591,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 +599,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 +614,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 +643,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 +658,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 +970,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 +995,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=1768870916598" />
+    <link rel="stylesheet" type="text/css" href="/index.css?v=1768878465145" />
     <script>
       window.PARTICLES_PATH = '/particles-4YQR4CFO.js'
     </script>
   </head>
   <body>
     <div id="root"></div>
-    <script src="/env.js?v=1768870916598"></script>
+    <script src="/env.js?v=1768878465145"></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=1768870916558" />
+    <link rel="stylesheet" type="text/css" href="/index.css?v=1768878465144" />
     <script>
       window.PARTICLES_PATH = '/particles-4YQR4CFO.js'
     </script>
   </head>
   <body>
     <div id="root"></div>
-    <script src="/env.js?v=1768870916558"></script>
+    <script src="/env.js?v=1768878465144"></script>
     <script src="/index-RJRKEY6V.js" type="module"></script>
   </body>
 </html>