@mpgd/cli 0.37.0 → 0.38.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/cli",
-  "version": "0.37.0",
+  "version": "0.38.0",
   "description": "Gunshi CLI for mpgd-kit starter generation and target workflow orchestration.",
   "license": "MIT",
   "repository": {
@@ -54,26 +54,26 @@
     "typia": "13.0.2",
     "undici": "^7.29.1",
     "vite": "8.1.3",
-    "@mpgd/catalog": "0.7.7",
-    "@mpgd/phaser-assets": "0.7.0",
-    "@mpgd/target-config": "0.17.1"
+    "@mpgd/catalog": "0.7.8",
+    "@mpgd/target-config": "0.18.0",
+    "@mpgd/phaser-assets": "0.7.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
     "@types/semver": "^7.8.0",
     "ttsc": "0.30.4",
     "typescript": "7.0.2",
-    "@mpgd/adapter-browser": "0.7.9",
-    "@mpgd/adapter-ait": "0.13.0",
-    "@mpgd/adapter-capacitor": "0.7.0",
-    "@mpgd/analytics": "0.4.1",
-    "@mpgd/adapter-verse8": "0.4.0",
-    "@mpgd/game-runtime": "0.3.0",
-    "@mpgd/i18n": "0.6.6",
-    "@mpgd/adapter-devvit": "0.9.15",
-    "@mpgd/platform": "0.15.0",
+    "@mpgd/adapter-ait": "0.13.1",
+    "@mpgd/adapter-browser": "0.8.0",
+    "@mpgd/adapter-capacitor": "0.7.1",
+    "@mpgd/adapter-devvit": "0.9.16",
+    "@mpgd/adapter-verse8": "0.4.1",
+    "@mpgd/analytics": "0.4.2",
+    "@mpgd/game-runtime": "0.4.0",
     "@mpgd/bridge": "0.11.0",
-    "@mpgd/game-services": "0.18.0"
+    "@mpgd/game-services": "0.18.1",
+    "@mpgd/i18n": "0.6.7",
+    "@mpgd/platform": "0.16.0"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/templates/phaser-game/agent/game-manifest.json

@@ -9,6 +9,7 @@
     "web-preview",
     "microsoft-store",
     "verse8",
+    "crazygames",
     "android",
     "ios",
     "ait",

package/templates/phaser-game/docs/MPGD_KIT_WORKFLOWS.md

@@ -104,6 +104,22 @@ state behind target services. Treat client commerce as pending; authoritative
 grants belong in a game-owned Agent8 server purchase event with consume-once
 catalog handling and verified completion logic for leaderboards.
 
+### CrazyGames
+
+Use the browser adapter's `/crazygames` entry point and the non-installable
+`crazygames` web target. `crazyGamesLaunch: "basic"` disables monetization;
+change it to `"full"` only after Full Launch approval. Configured midgame
+interstitials use the shared advertising presentation contract. SDK callbacks
+must never grant rewards or purchases: those capabilities remain disabled.
+
+Playable scenes own gameplay scopes through the game runtime. Keep loading,
+gameplay, and host `muteAudio` policy behind `PlatformGateway`; the host handles
+focus reporting. Build and smoke with `pnpm exec mpgd target build crazygames`
+and `pnpm exec mpgd target smoke crazygames`, providing `--kit-path` and the
+project's `--targets-file`. See the kit's
+[CrazyGames guide](https://github.com/imjlk/mpgd-kit/blob/main/docs/CRAZYGAMES.md)
+and [official SDK documentation](https://docs.crazygames.com/sdk/intro/).
+
 ### Apps in Toss
 
 Use official Apps in Toss documentation/MCP before SDK or review-flow changes.

package/templates/phaser-game/mpgd.targets.json

@@ -22,6 +22,17 @@
       "icon": { "profile": "web-preview" },
       "output": "artifacts/verse8"
     },
+    "crazygames": {
+      "kind": "web",
+      "gameApp": ".",
+      "adapter": "crazygames",
+      "icon": {
+        "profile": "web-preview"
+      },
+      "installable": false,
+      "crazyGamesLaunch": "basic",
+      "output": "artifacts/crazygames"
+    },
     "android": {
       "kind": "capacitor-android",
       "gameApp": ".",

package/templates/phaser-game/src/platform/buildGateways/crazygames.ts

@@ -0,0 +1,14 @@
+import { createCrazyGamesPlatformGateway } from '@mpgd/adapter-browser/crazygames';
+import { resolveAdPlacementPlatformId, type AdPlacements } from '@mpgd/catalog';
+import adPlacementsJson from '@mpgd/catalog/placements.json';
+import type { PlatformGateway } from '@mpgd/platform';
+import type { RuntimeConfig } from '../runtimeDetector';
+
+export async function createBuildGateway(runtime: RuntimeConfig): Promise<PlatformGateway> {
+  const placements = (adPlacementsJson as AdPlacements).placements;
+  return createCrazyGamesPlatformGateway({
+    launch: __MPGD_PLATFORM_TARGET__?.crazyGamesLaunch ?? 'basic',
+    placementIds: placements.filter((placement) => placement.type === 'interstitial'
+      && resolveAdPlacementPlatformId(placement, runtime.configTarget) !== undefined).map((placement) => placement.id),
+  });
+}

package/templates/phaser-game/src/platform/runtimeDetector.ts

@@ -7,6 +7,7 @@ const validTargets = new Set<string>([
   'microsoft-store',
   'reddit',
   'verse8',
+  'crazygames',
   'telegram',
   'tauri',
   'wechat',

package/templates/phaser-game/src/scenes/BootScene.ts

@@ -2,6 +2,8 @@ import Phaser from 'phaser';
 
 import { loadPhaserAssets } from '@mpgd/phaser-assets';
 
+import { starterContextKey, type StarterContext } from '../runtime/gameContext';
+
 import { starterAssets } from '../assets/manifest';
 
 export class BootScene extends Phaser.Scene {
@@ -14,6 +16,7 @@ export class BootScene extends Phaser.Scene {
   }
 
   create(): void {
-    this.scene.start('LobbyScene');
+    const context = this.registry.get(starterContextKey) as StarterContext;
+    this.scene.start(context.launchIntent.entry === 'free-play' ? 'PlayScene' : 'LobbyScene');
   }
 }

package/templates/phaser-game/src/scenes/PlayScene.ts

@@ -31,6 +31,7 @@ export class PlayScene extends Phaser.Scene {
     this.context = this.registry.get(starterContextKey) as StarterContext;
     bindPhaserGameScene({
       controller: this.context.gameRuntime.execution,
+      gameplayScope: this.context.gameRuntime.createGameplayScope(),
       scene: this,
       renderingPolicy: 'visibility',
       audioOwner: 'game',

package/templates/phaser-game/vite.runtime-target-config.ts

@@ -20,6 +20,7 @@ const runtimeKinds = valueSet({
   'apps-in-toss': true,
   'devvit-web': true,
   'verse8-web': true,
+  'crazygames-web': true,
   'wechat-minigame': true,
   'tiktok-minigame': true,
 } satisfies Record<TargetRuntimeKind, true>);
@@ -32,6 +33,7 @@ const releaseProfiles = valueSet({
   'apps-in-toss': true,
   devvit: true,
   verse8: true,
+  crazygames: true,
   'wechat-minigame': true,
   'tiktok-minigame': true,
 } satisfies Record<ReleaseProfile, true>);

package/templates/phaser-game/vite.shared.ts

@@ -14,6 +14,7 @@ import { resolveTextSelectionMode } from './src/platform/textSelection';
 interface RuntimePlatformTargetMetadata {
   readonly kind: string;
   readonly adapter: string;
+  readonly crazyGamesLaunch?: 'basic' | 'full';
   readonly authoritativeGameServices?: boolean;
   readonly integrations?: Record<string, unknown>;
 }
@@ -151,6 +152,8 @@ export function resolveBuildGatewayModule(input: {
       return input.debug && input.buildId === devvitSandboxBuildId
         ? 'src/platform/buildGateways/redditSandbox.ts'
         : 'src/platform/buildGateways/reddit.ts';
+    case 'crazygames':
+      return 'src/platform/buildGateways/crazygames.ts';
     case 'verse8':
       return 'src/platform/buildGateways/verse8.ts';
     case 'microsoft-store':
@@ -245,6 +248,9 @@ function readRuntimePlatformTarget(
     throw new Error(`Platform target ${configTarget} must define kind and adapter.`);
   }
 
+  if (target.crazyGamesLaunch !== undefined && (target.adapter !== 'crazygames' || !['basic', 'full'].includes(target.crazyGamesLaunch as string))) {
+    throw new Error(`Invalid CrazyGames launch setting for ${configTarget}.`);
+  }
   if (target.integrations !== undefined && !isRecord(target.integrations)) {
     throw new Error(`Platform target ${configTarget} integrations must be an object.`);
   }
@@ -262,6 +268,7 @@ function readRuntimePlatformTarget(
     ...(target.authoritativeGameServices === undefined
       ? {}
       : { authoritativeGameServices: target.authoritativeGameServices }),
+    ...(target.crazyGamesLaunch === undefined ? {} : { crazyGamesLaunch: target.crazyGamesLaunch as 'basic' | 'full' }),
     ...(target.integrations === undefined ? {} : { integrations: target.integrations }),
   };
 }