@myvillage/cli 2.6.1 → 2.8.0

package/src/commands/create-game.js

@@ -24,7 +24,7 @@ function normEngine(v) {
 function normType(v) {
   if (!v) return null;
   v = String(v).toLowerCase();
-  return ['quiz', 'exploration', 'narrative', 'custom'].includes(v) ? v : null;
+  return ['quiz', 'exploration', 'narrative', 'custom', 'arena'].includes(v) ? v : null;
 }
 function normAge(v) {
   if (!v) return null;
@@ -127,6 +127,7 @@ export async function createGameCommand(options = {}) {
         { name: 'Exploration Game - Navigate and discover', value: 'exploration' },
         { name: 'Narrative Game - Story-driven experience', value: 'narrative' },
         { name: 'Custom - Start with base Three.js template', value: 'custom' },
+        { name: 'Arena (multiplayer) - Real-time first-person tag / blaster matches', value: 'arena' },
       ],
     });
   if (needName)
@@ -213,6 +214,10 @@ export async function createGameCommand(options = {}) {
     console.log(`    ${brand.gold('myvillage deploy')} ${brand.teal('- Deploy to MyVillageOS')}`);
     console.log();
     console.log(brand.teal(`  Game type: ${game.type} | Orientation: ${orientation} | Age group: ${game.ageGroup}`));
+    if (game.type === 'arena') {
+      console.log(brand.teal('  Multiplayer: open the dev server in two browser tabs and press Quick match in both.'));
+      console.log(brand.teal('  Match rules + map: src/arena.json (sent with every deploy).'));
+    }
     console.log(brand.teal(`  Cover art: drop thumbnail.png / banner.png in ${slug}/assets/ before deploy.`));
     console.log();
   } catch (err) {

package/src/commands/deploy.js

@@ -22,6 +22,42 @@ function readPackageJson(dir) {
   }
 }
 
+const MAX_MULTIPLAYER_BYTES = 64 * 1024;
+
+/**
+ * The game's real-time multiplayer config for the deploy metadata, from
+ * `myvillage.multiplayer` in package.json: `{ arena: 'src/arena.json' }` (a
+ * path) or `{ arena: {...} }` (inline). Returns undefined when the game doesn't
+ * declare one (the platform keeps its current setting), null to turn it off.
+ * Throws a readable error for a missing or malformed config.
+ */
+export function readMultiplayerConfig(dir, mv) {
+  const setting = mv?.multiplayer;
+  if (setting === undefined) return undefined;
+  if (setting === null || setting === false) return null;
+  if (typeof setting !== 'object' || Array.isArray(setting)) {
+    throw new Error('myvillage.multiplayer must be an object like { "arena": "src/arena.json" }');
+  }
+  let arena = setting.arena ?? {};
+  if (typeof arena === 'string') {
+    const file = join(dir, arena);
+    if (!existsSync(file)) throw new Error(`myvillage.multiplayer.arena points to ${arena}, which doesn't exist`);
+    try {
+      arena = JSON.parse(readFileSync(file, 'utf-8'));
+    } catch (err) {
+      throw new Error(`${arena} is not valid JSON: ${err.message}`);
+    }
+  }
+  if (typeof arena !== 'object' || arena === null || Array.isArray(arena)) {
+    throw new Error('myvillage.multiplayer.arena must be a JSON object (or a path to one)');
+  }
+  const config = { arena };
+  if (JSON.stringify(config).length > MAX_MULTIPLAYER_BYTES) {
+    throw new Error('Multiplayer config is larger than 64 KB — simplify the map');
+  }
+  return config;
+}
+
 function readMyVillageJson(dir) {
   const configPath = join(dir, 'myvillage.json');
   if (!existsSync(configPath)) return null;
@@ -217,6 +253,17 @@ async function deployThreeJsGame(projectDir, pkg, options = {}) {
   // If this game is already live, confirm + unpublish before we rebuild/upload.
   if (!(await confirmRedeployIfPublished(pkg.myvillage.gameId, options))) return;
 
+  // Multiplayer rules + map ship with the deploy; a broken config should fail
+  // before anything is built or uploaded.
+  let multiplayer;
+  try {
+    multiplayer = readMultiplayerConfig(projectDir, pkg.myvillage);
+  } catch (err) {
+    if (json) console.log(JSON.stringify({ ok: false, error: err.message }));
+    else console.log(chalk.red(`\n  ✗ ${err.message}`));
+    return;
+  }
+
   // Village visibility is part of the submission — gather it up front (before
   // the build) so it travels in the deploy metadata.
   const villageIds = await gatherVillages(pkg.myvillage.villages || [], options);
@@ -263,6 +310,7 @@ async function deployThreeJsGame(projectDir, pkg, options = {}) {
       orientation: pkg.myvillage.orientation || 'landscape',
       entryFile: 'index.html',
       villageIds,
+      ...(multiplayer !== undefined && { multiplayer }),
     };
     formData.append('metadata', JSON.stringify(metadata));
 

package/src/index.js

@@ -215,7 +215,7 @@ export function run() {
     .option('--description <text>', 'Game description')
     .option('--engine <engine>', 'Engine: threejs | unity')
     .option('--orientation <orientation>', 'portrait | landscape')
-    .option('--type <type>', 'Three.js type: quiz | exploration | narrative | custom')
+    .option('--type <type>', 'Three.js type: quiz | exploration | narrative | custom | arena (multiplayer)')
     .option('--category <category>', 'Unity category: education | action | adventure | puzzle | other')
     .option('--target-age <age>', 'Target age: under-5 | 6-12 | 13-and-over')
     .option('--dir <path>', 'Parent directory to scaffold into (defaults to cwd)')