@idosgames/mcp 0.1.15 → 0.1.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idosgames/mcp",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "MCP server that serves the iDosGames Module & Skills Registry to AI coding agents (Claude Code, Codex, Cursor…): list/pull composable game modules and the host scaffold, and load skills for @idosgames/core, the module contract, and composition.",
   "type": "module",
   "license": "MIT",

package/registry/host.json

@@ -23,7 +23,7 @@
     },
     {
       "path": "package.json",
-      "content": "{\n  \"name\": \"@idosgames/host-starter\",\n  \"version\": \"0.0.0\",\n  \"private\": true,\n  \"type\": \"module\",\n  \"description\": \"The seed project for the AI Coder: a host shell that composes feature modules. Fresh projects start here with zero modules; the developer/agent plugs modules into src/modules.ts.\",\n  \"scripts\": {\n    \"dev\": \"vite\",\n    \"build\": \"vite build\",\n    \"preview\": \"vite preview\",\n    \"typecheck\": \"tsc --noEmit -p tsconfig.json\"\n  },\n  \"//\": \"Versions are pinned exactly: this is a seed for AI Coder projects, which build offline against a dependency allowlist baked at these versions (see scripts/pack-builder.mjs). Modules bring their own engine deps (three/phaser) when added.\",\n  \"dependencies\": {\n    \"@idosgames/app-shell\": \"0.3.3\",\n    \"@idosgames/core\": \"0.16.0\",\n    \"@idosgames/module-sdk\": \"0.3.3\",\n    \"@idosgames/react\": \"0.2.9\",\n    \"@idosgames/wallet\": \"0.3.1\",\n    \"@tanstack/react-query\": \"5.101.2\",\n    \"react\": \"19.2.7\",\n    \"react-dom\": \"19.2.7\",\n    \"wagmi\": \"3.7.2\"\n  },\n  \"devDependencies\": {\n    \"@types/react\": \"19.2.17\",\n    \"@types/react-dom\": \"19.2.3\",\n    \"@vitejs/plugin-react\": \"6.0.4\",\n    \"typescript\": \"5.9.3\",\n    \"vite\": \"8.1.5\"\n  }\n}\n"
+      "content": "{\n  \"name\": \"@idosgames/host-starter\",\n  \"version\": \"0.0.0\",\n  \"private\": true,\n  \"type\": \"module\",\n  \"description\": \"The seed project for the AI Coder: a host shell that composes feature modules. Fresh projects start here with zero modules; the developer/agent plugs modules into src/modules.ts.\",\n  \"scripts\": {\n    \"dev\": \"vite\",\n    \"build\": \"vite build\",\n    \"preview\": \"vite preview\",\n    \"typecheck\": \"tsc --noEmit -p tsconfig.json\"\n  },\n  \"//\": \"Versions are pinned exactly: this is a seed for AI Coder projects, which build offline against a dependency allowlist baked at these versions (see scripts/pack-builder.mjs). Modules bring their own engine deps (three/phaser) when added.\",\n  \"dependencies\": {\n    \"@idosgames/app-shell\": \"0.4.0\",\n    \"@idosgames/core\": \"0.17.0\",\n    \"@idosgames/module-sdk\": \"0.4.0\",\n    \"@idosgames/react\": \"0.2.10\",\n    \"@idosgames/wallet\": \"0.4.1\",\n    \"@tanstack/react-query\": \"5.101.2\",\n    \"react\": \"19.2.7\",\n    \"react-dom\": \"19.2.7\",\n    \"wagmi\": \"3.7.2\"\n  },\n  \"devDependencies\": {\n    \"@types/react\": \"19.2.17\",\n    \"@types/react-dom\": \"19.2.3\",\n    \"@vitejs/plugin-react\": \"6.0.4\",\n    \"typescript\": \"5.9.3\",\n    \"vite\": \"8.1.5\"\n  }\n}\n"
     },
     {
       "path": "public/sw.js",

package/registry/index.json

@@ -1,11 +1,11 @@
 {
-  "generatedFromCommit": "1a1860e21323fff062a90c8b3b90bd1d0389c94a",
+  "generatedFromCommit": "3ade0a9ffb940a254cb292020d5316ff15ae13e1",
   "runtimePackages": {
-    "@idosgames/core": "0.16.0",
-    "@idosgames/wallet": "0.3.1",
-    "@idosgames/module-sdk": "0.3.3",
-    "@idosgames/react": "0.2.9",
-    "@idosgames/app-shell": "0.3.3"
+    "@idosgames/core": "0.17.0",
+    "@idosgames/wallet": "0.4.1",
+    "@idosgames/module-sdk": "0.4.0",
+    "@idosgames/react": "0.2.10",
+    "@idosgames/app-shell": "0.4.0"
   },
   "host": {
     "id": "host-starter",
@@ -54,10 +54,10 @@
         ]
       },
       "dependencies": {
-        "@idosgames/core": "0.16.0",
-        "@idosgames/module-sdk": "0.3.3",
-        "@idosgames/react": "0.2.9",
-        "@idosgames/wallet": "0.3.1",
+        "@idosgames/core": "0.17.0",
+        "@idosgames/module-sdk": "0.4.0",
+        "@idosgames/react": "0.2.10",
+        "@idosgames/wallet": "0.4.1",
         "@tanstack/react-query": "5.101.2",
         "react": "19.2.7",
         "three": "0.185.1",
@@ -65,7 +65,7 @@
         "wagmi": "3.7.2"
       },
       "fileCount": 27,
-      "contentHash": "c33e4df315755b53354de2ca5973cba5c31c05df352606e1481e4354f93c5541"
+      "contentHash": "a7a360f0ecb5106bb5c5565d06b13845a8f1838bdb475d626f33ca89c73cec29"
     },
     {
       "id": "idle-rpg",
@@ -113,10 +113,10 @@
         ]
       },
       "dependencies": {
-        "@idosgames/core": "0.16.0",
-        "@idosgames/module-sdk": "0.3.3",
-        "@idosgames/react": "0.2.9",
-        "@idosgames/wallet": "0.3.1",
+        "@idosgames/core": "0.17.0",
+        "@idosgames/module-sdk": "0.4.0",
+        "@idosgames/react": "0.2.10",
+        "@idosgames/wallet": "0.4.1",
         "@tanstack/react-query": "5.101.2",
         "phaser": "4.2.1",
         "react": "19.2.7",
@@ -124,7 +124,7 @@
         "wagmi": "3.7.2"
       },
       "fileCount": 19,
-      "contentHash": "c395a20365d53fd5aee509d40dfd9dfad5976b822ec12e808e460f0d0cba432d"
+      "contentHash": "143c4595784974ca4d58d5032e77b26e93d1d96c2455974c796c7d5c1d710ba6"
     },
     {
       "id": "voxelcraft",
@@ -183,12 +183,12 @@
       },
       "version": "0.3.0",
       "dependencies": {
-        "@idosgames/core": "0.16.0",
-        "@idosgames/module-sdk": "0.3.3",
+        "@idosgames/core": "0.17.0",
+        "@idosgames/module-sdk": "0.4.0",
         "three": "0.185.1"
       },
       "fileCount": 524,
-      "contentHash": "9eb50576a72e034a28f19b05742129de403113afb09b704b6c2b309d51b279e7"
+      "contentHash": "0de6a76e323311ee027133892e4fa66c72540ced75d21cb9e441025c06feea6c"
     },
     {
       "id": "game-hud",
@@ -235,10 +235,10 @@
         ]
       },
       "dependencies": {
-        "@idosgames/core": "0.16.0",
-        "@idosgames/module-sdk": "0.3.3",
-        "@idosgames/react": "0.2.9",
-        "@idosgames/wallet": "0.3.1",
+        "@idosgames/core": "0.17.0",
+        "@idosgames/module-sdk": "0.4.0",
+        "@idosgames/react": "0.2.10",
+        "@idosgames/wallet": "0.4.1",
         "@tanstack/react-query": "5.101.2",
         "react": "19.2.7",
         "viem": "2.55.2",
@@ -283,9 +283,9 @@
       },
       "version": "0.1.0",
       "dependencies": {
-        "@idosgames/core": "0.16.0",
-        "@idosgames/module-sdk": "0.3.3",
-        "@idosgames/react": "0.2.9",
+        "@idosgames/core": "0.17.0",
+        "@idosgames/module-sdk": "0.4.0",
+        "@idosgames/react": "0.2.10",
         "react": "19.2.7"
       },
       "fileCount": 4,

package/registry/modules/board-game.json

@@ -45,17 +45,17 @@
     }
   },
   "dependencies": {
-    "@idosgames/core": "0.16.0",
-    "@idosgames/module-sdk": "0.3.3",
-    "@idosgames/react": "0.2.9",
-    "@idosgames/wallet": "0.3.1",
+    "@idosgames/core": "0.17.0",
+    "@idosgames/module-sdk": "0.4.0",
+    "@idosgames/react": "0.2.10",
+    "@idosgames/wallet": "0.4.1",
     "@tanstack/react-query": "5.101.2",
     "react": "19.2.7",
     "three": "0.185.1",
     "viem": "2.55.2",
     "wagmi": "3.7.2"
   },
-  "contentHash": "c33e4df315755b53354de2ca5973cba5c31c05df352606e1481e4354f93c5541",
+  "contentHash": "a7a360f0ecb5106bb5c5565d06b13845a8f1838bdb475d626f33ca89c73cec29",
   "files": [
     {
       "path": "chrome.ts",
@@ -127,7 +127,7 @@
     },
     {
       "path": "game/BoardController.ts",
-      "content": "import * as THREE from \"three\";\nimport type { TileInfo } from \"../data/boardConfig\";\n\nconst TILE_COLORS: Record<string, number> = {\n  Chance: 0xf0a020,\n  Reward: 0x4caf50,\n  Special: 0x9c5cff,\n  RandomAction: 0xe8534e,\n  Shield: 0x4a90e2,\n};\nconst DEFAULT_TILE_COLOR = 0x6b6b7a;\n\n// Glyphs drawn on top of non-reward tiles so the board reads at a glance.\nconst TILE_SYMBOLS: Record<string, string> = {\n  Chance: \"?\",\n  Special: \"★\",\n  RandomAction: \"✖\",\n  Shield: \"✚\",\n};\n\nconst BUILDING_COLORS = [\n  0x6c5ce7, 0x4caf50, 0xe8534e, 0xf0a020, 0x4a90e2, 0x42c9c2,\n];\n\nconst TOKEN_Y = 0.85;\nconst TILE_Y = 0.13;\nconst STEP_MS = 240;\nconst HIGHLIGHT_MS = 850;\nconst BODY_H = 1.0;\nconst DICE_MS = 950;\nconst DICE_BASE_Y = 3.2;\nconst DICE_DROP = 3.4;\n\n// Standard bounce-out easing (0 → 1 with decaying bounces) for the dice toss.\nfunction bounceOut(t: number): number {\n  const n1 = 7.5625;\n  const d1 = 2.75;\n  if (t < 1 / d1) return n1 * t * t;\n  if (t < 2 / d1) {\n    const u = t - 1.5 / d1;\n    return n1 * u * u + 0.75;\n  }\n  if (t < 2.5 / d1) {\n    const u = t - 2.25 / d1;\n    return n1 * u * u + 0.9375;\n  }\n  const u = t - 2.625 / d1;\n  return n1 * u * u + 0.984375;\n}\n\n// BoxGeometry face order is +X, -X, +Y, -Y, +Z, -Z. Assign pip values so opposite faces sum to 7.\nconst FACE_VALUES = [2, 5, 3, 4, 1, 6];\n// Resting rotation that brings each value's face to the top (+Y).\nconst REST_ROTATION: Record<number, [number, number, number]> = {\n  1: [-Math.PI / 2, 0, 0],\n  2: [0, 0, Math.PI / 2],\n  3: [0, 0, 0],\n  4: [Math.PI, 0, 0],\n  5: [0, 0, -Math.PI / 2],\n  6: [Math.PI / 2, 0, 0],\n};\n\nconst PIP_LAYOUTS: Record<number, string[]> = {\n  1: [\"C\"],\n  2: [\"TL\", \"BR\"],\n  3: [\"TL\", \"C\", \"BR\"],\n  4: [\"TL\", \"TR\", \"BL\", \"BR\"],\n  5: [\"TL\", \"TR\", \"C\", \"BL\", \"BR\"],\n  6: [\"TL\", \"TR\", \"ML\", \"MR\", \"BL\", \"BR\"],\n};\nconst PIP_COORDS: Record<string, [number, number]> = {\n  TL: [0.28, 0.28],\n  TR: [0.72, 0.28],\n  ML: [0.28, 0.5],\n  C: [0.5, 0.5],\n  MR: [0.72, 0.5],\n  BL: [0.28, 0.72],\n  BR: [0.72, 0.72],\n};\n\ninterface Tween {\n  from: THREE.Vector3;\n  to: THREE.Vector3;\n  start: number;\n  resolve: () => void;\n}\n\ninterface DiceTween {\n  entries: {\n    mesh: THREE.Mesh;\n    from: THREE.Euler;\n    to: THREE.Euler;\n    rest: THREE.Euler;\n  }[];\n  start: number;\n  resolve: () => void;\n}\n\ninterface Building {\n  body: THREE.Mesh;\n  roof: THREE.Mesh;\n}\n\n/**\n * Three.js renderer for the board: a square loop of tiles (colored + glyph-marked by type), the\n * player's city as towers that grow with their level, an animated token, and a pair of pip dice that\n * tumble to the rolled total. Engine-only — it knows nothing about the SDK.\n */\nexport class BoardController {\n  private readonly renderer: THREE.WebGLRenderer;\n  private readonly scene: THREE.Scene;\n  private readonly camera: THREE.PerspectiveCamera;\n  private readonly token: THREE.Mesh;\n  private readonly tileGroup = new THREE.Group();\n  private readonly cityGroup = new THREE.Group();\n  private readonly lookAt = new THREE.Vector3(0, 0, 0);\n  private readonly diceTextures: THREE.CanvasTexture[] = [];\n  private readonly diceMaterials: THREE.MeshStandardMaterial[] = [];\n  private readonly dice: THREE.Mesh[] = [];\n  private readonly tileDecalTextures = new Map<string, THREE.CanvasTexture>();\n\n  private tilePositions: THREE.Vector3[] = [];\n  private tileMeshes: THREE.Mesh[] = [];\n  private tileColors: THREE.Color[] = [];\n  private buildings: Building[] = [];\n  private tween: Tween | null = null;\n  private diceTween: DiceTween | null = null;\n  private highlight: { index: number; start: number } | null = null;\n  private frame = 0;\n  private disposed = false;\n  private running = true;\n  private resizeObserver?: ResizeObserver;\n\n  private readonly loop = (): void => {\n    if (this.disposed) return;\n    this.frame = requestAnimationFrame(this.loop);\n\n    if (this.tween) {\n      const t = Math.min(1, (performance.now() - this.tween.start) / STEP_MS);\n      const e = t * t * (3 - 2 * t); // smoothstep\n      const { from, to } = this.tween;\n      this.token.position.x = from.x + (to.x - from.x) * e;\n      this.token.position.z = from.z + (to.z - from.z) * e;\n      this.token.position.y = TOKEN_Y + Math.sin(t * Math.PI) * 0.6;\n      if (t >= 1) {\n        this.token.position.set(to.x, TOKEN_Y, to.z);\n        const done = this.tween.resolve;\n        this.tween = null;\n        done();\n      }\n    }\n\n    this.updateDice();\n    this.updateHighlight();\n    this.token.rotation.y += 0.02;\n\n    // Gentle camera lean: drift the look-at point a fraction toward the token.\n    this.lookAt.lerp(\n      new THREE.Vector3(\n        this.token.position.x * 0.35,\n        0,\n        this.token.position.z * 0.35,\n      ),\n      0.05,\n    );\n    this.camera.lookAt(this.lookAt);\n\n    this.renderer.render(this.scene, this.camera);\n  };\n\n  constructor(private readonly host: HTMLElement) {\n    this.renderer = new THREE.WebGLRenderer({ antialias: true });\n    this.renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));\n    this.renderer.domElement.style.display = \"block\";\n    host.appendChild(this.renderer.domElement);\n\n    this.scene = new THREE.Scene();\n    this.scene.background = new THREE.Color(0x063d99);\n\n    this.camera = new THREE.PerspectiveCamera(50, 1, 0.1, 200);\n    this.camera.position.set(0, 24, 19);\n    this.camera.lookAt(0, 0, 0);\n\n    const ambient = new THREE.AmbientLight(0xffffff, 0.75);\n    const dir = new THREE.DirectionalLight(0xffffff, 0.85);\n    dir.position.set(12, 22, 8);\n    this.scene.add(ambient, dir, this.tileGroup, this.cityGroup);\n\n    const tokenMat = new THREE.MeshStandardMaterial({\n      color: 0xffd479,\n      emissive: 0x6b5a1f,\n    });\n    this.token = new THREE.Mesh(\n      new THREE.SphereGeometry(0.5, 24, 16),\n      tokenMat,\n    );\n    this.token.position.set(0, TOKEN_Y, 0);\n    this.scene.add(this.token);\n\n    this.buildDice();\n\n    this.resize();\n    this.resizeObserver = new ResizeObserver(() => {\n      this.resize();\n    });\n    this.resizeObserver.observe(host);\n\n    this.loop();\n  }\n\n  // ---- dice ----\n\n  private buildDice(): void {\n    const textureByValue: Record<number, THREE.CanvasTexture> = {};\n    for (let v = 1; v <= 6; v++) {\n      const texture = new THREE.CanvasTexture(this.makePipCanvas(v));\n      this.diceTextures.push(texture);\n      textureByValue[v] = texture;\n    }\n    for (const value of FACE_VALUES) {\n      this.diceMaterials.push(\n        new THREE.MeshStandardMaterial({\n          map: textureByValue[value],\n          color: 0xffffff,\n        }),\n      );\n    }\n\n    const geo = new THREE.BoxGeometry(1.2, 1.2, 1.2);\n    for (let i = 0; i < 2; i++) {\n      const die = new THREE.Mesh(geo, this.diceMaterials);\n      die.position.set(i === 0 ? -1.0 : 1.0, 3.2, 0);\n      const rest = REST_ROTATION[3] ?? [0, 0, 0];\n      die.rotation.set(rest[0], 0, rest[2]);\n      this.scene.add(die);\n      this.dice.push(die);\n    }\n  }\n\n  private makePipCanvas(value: number): HTMLCanvasElement {\n    const canvas = document.createElement(\"canvas\");\n    canvas.width = 128;\n    canvas.height = 128;\n    const ctx = canvas.getContext(\"2d\");\n    if (!ctx) return canvas;\n    const s = canvas.width;\n    ctx.fillStyle = \"#f6f3ff\";\n    ctx.fillRect(0, 0, s, s);\n    ctx.strokeStyle = \"#d9d2f0\";\n    ctx.lineWidth = 4;\n    ctx.strokeRect(4, 4, s - 8, s - 8);\n    ctx.fillStyle = \"#052e7e\";\n    for (const slot of PIP_LAYOUTS[value] ?? []) {\n      const coord = PIP_COORDS[slot];\n      if (!coord) continue;\n      ctx.beginPath();\n      ctx.arc(coord[0] * s, coord[1] * s, s * 0.1, 0, Math.PI * 2);\n      ctx.fill();\n    }\n    return canvas;\n  }\n\n  private splitTotal(total: number): [number, number] {\n    const clamped = Math.max(2, Math.min(12, Math.round(total)));\n    const min1 = Math.max(1, clamped - 6);\n    const max1 = Math.min(6, clamped - 1);\n    const v1 = min1 + Math.floor(Math.random() * (max1 - min1 + 1));\n    return [v1, clamped - v1];\n  }\n\n  /** Tumble both dice and land them showing two faces that sum to the rolled total. */\n  rollDice(total: number): Promise<void> {\n    const values = this.splitTotal(total);\n    const entries = this.dice.map((mesh, i) => {\n      const r = REST_ROTATION[values[i] ?? 3] ?? [0, 0, 0];\n      const rest = new THREE.Euler(r[0], 0, r[2]);\n      const turns = (n: number): number => Math.PI * 2 * n;\n      const to = new THREE.Euler(\n        rest.x + turns(2 + i),\n        rest.y + turns(2),\n        rest.z + turns(2 + i),\n      );\n      return { mesh, from: mesh.rotation.clone(), to, rest };\n    });\n    return new Promise<void>((resolve) => {\n      this.diceTween = { entries, start: performance.now(), resolve };\n    });\n  }\n\n  private updateDice(): void {\n    if (!this.diceTween) return;\n    const t = Math.min(1, (performance.now() - this.diceTween.start) / DICE_MS);\n    const e = 1 - Math.pow(1 - t, 3); // easeOutCubic for the tumble\n    const y = DICE_BASE_Y + DICE_DROP * (1 - bounceOut(t)); // drop + bounce for the toss\n    for (const entry of this.diceTween.entries) {\n      entry.mesh.rotation.set(\n        entry.from.x + (entry.to.x - entry.from.x) * e,\n        entry.from.y + (entry.to.y - entry.from.y) * e,\n        entry.from.z + (entry.to.z - entry.from.z) * e,\n      );\n      entry.mesh.position.y = y;\n    }\n    if (t >= 1) {\n      for (const entry of this.diceTween.entries) {\n        entry.mesh.rotation.copy(entry.rest);\n        entry.mesh.position.y = DICE_BASE_Y;\n      }\n      const done = this.diceTween.resolve;\n      this.diceTween = null;\n      done();\n    }\n  }\n\n  // ---- board ----\n\n  loadBoard(tiles: TileInfo[], buildingCount: number): void {\n    this.disposeGroup(this.tileGroup);\n    this.disposeGroup(this.cityGroup);\n    this.tilePositions = [];\n    this.tileMeshes = [];\n    this.tileColors = [];\n    this.buildings = [];\n\n    const count = tiles.length;\n    const perSide = Math.max(1, Math.round(count / 4));\n    const spacing = 1.4;\n    const extent = perSide * spacing;\n    const half = extent / 2;\n\n    for (const tile of tiles) {\n      const pos = this.ringPosition(tile.index, perSide, extent, half);\n      const colorHex = TILE_COLORS[tile.type] ?? DEFAULT_TILE_COLOR;\n      const mesh = new THREE.Mesh(\n        new THREE.BoxGeometry(1.1, 0.25, 1.1),\n        new THREE.MeshStandardMaterial({ color: colorHex }),\n      );\n      mesh.position.set(pos.x, TILE_Y, pos.z);\n\n      const symbol = TILE_SYMBOLS[tile.type];\n      if (symbol) {\n        const decal = new THREE.Mesh(\n          new THREE.PlaneGeometry(0.7, 0.7),\n          new THREE.MeshBasicMaterial({\n            map: this.getDecalTexture(tile.type, symbol),\n            transparent: true,\n          }),\n        );\n        decal.rotation.x = -Math.PI / 2;\n        decal.position.set(0, 0.14, 0);\n        mesh.add(decal);\n      }\n\n      this.tileGroup.add(mesh);\n      this.tilePositions[tile.index] = new THREE.Vector3(pos.x, TOKEN_Y, pos.z);\n      this.tileMeshes[tile.index] = mesh;\n      this.tileColors[tile.index] = new THREE.Color(colorHex);\n    }\n\n    const startX = -((buildingCount - 1) * 1.7) / 2;\n    for (let i = 0; i < buildingCount; i++) {\n      const color = BUILDING_COLORS[i % BUILDING_COLORS.length] ?? 0x6c5ce7;\n      const body = new THREE.Mesh(\n        new THREE.BoxGeometry(0.9, BODY_H, 0.9),\n        new THREE.MeshStandardMaterial({ color }),\n      );\n      const roof = new THREE.Mesh(\n        new THREE.BoxGeometry(1.05, 0.22, 1.05),\n        new THREE.MeshStandardMaterial({\n          color: new THREE.Color(color).multiplyScalar(0.6),\n        }),\n      );\n      body.position.set(startX + i * 1.7, BODY_H / 2, 0);\n      roof.position.set(startX + i * 1.7, BODY_H + 0.11, 0);\n      this.cityGroup.add(body, roof);\n      this.buildings[i] = { body, roof };\n    }\n  }\n\n  private getDecalTexture(type: string, symbol: string): THREE.CanvasTexture {\n    const cached = this.tileDecalTextures.get(type);\n    if (cached) return cached;\n    const canvas = document.createElement(\"canvas\");\n    canvas.width = 96;\n    canvas.height = 96;\n    const ctx = canvas.getContext(\"2d\");\n    if (ctx) {\n      ctx.clearRect(0, 0, 96, 96);\n      ctx.fillStyle = \"rgba(20,16,40,0.85)\";\n      ctx.font = \"bold 64px system-ui, sans-serif\";\n      ctx.textAlign = \"center\";\n      ctx.textBaseline = \"middle\";\n      ctx.fillText(symbol, 48, 52);\n    }\n    const texture = new THREE.CanvasTexture(canvas);\n    this.tileDecalTextures.set(type, texture);\n    return texture;\n  }\n\n  private ringPosition(\n    index: number,\n    perSide: number,\n    extent: number,\n    half: number,\n  ): THREE.Vector3 {\n    const side = Math.floor(index / perSide) % 4;\n    const f = (index % perSide) / perSide;\n    let x = 0;\n    let z = 0;\n    switch (side) {\n      case 0:\n        x = -half + f * extent;\n        z = half;\n        break;\n      case 1:\n        x = half;\n        z = half - f * extent;\n        break;\n      case 2:\n        x = half - f * extent;\n        z = -half;\n        break;\n      default:\n        x = -half;\n        z = -half + f * extent;\n        break;\n    }\n    return new THREE.Vector3(x, 0, z);\n  }\n\n  /** Start/stop the render loop. The host calls this so a suspended mode stops ticking\n   *  (the Mode Router invariant: only the active mode runs its RAF). */\n  setRunning(running: boolean): void {\n    const shouldRun = running && !this.disposed;\n    if (shouldRun === this.running) return;\n    this.running = shouldRun;\n    if (shouldRun) this.frame = requestAnimationFrame(this.loop);\n    else cancelAnimationFrame(this.frame);\n  }\n\n  /** Snap the token to a tile with no animation. */\n  setPosition(index: number): void {\n    const p = this.tilePositions[index];\n    if (p) this.token.position.set(p.x, TOKEN_Y, p.z);\n  }\n\n  /**\n   * What the scene currently shows. Read by the module's agent surface (`agent.ts`): a rendered\n   * board is a single canvas, so this is the only way the AI Coder's agent can tell where the\n   * token stands and whether the board was loaded at all.\n   */\n  describeScene(): {\n    running: boolean;\n    tileCount: number;\n    buildingCount: number;\n    token: { x: number; z: number };\n  } {\n    return {\n      running: this.running,\n      tileCount: this.tilePositions.length,\n      buildingCount: this.buildings.length,\n      token: {\n        x: Math.round(this.token.position.x * 100) / 100,\n        z: Math.round(this.token.position.z * 100) / 100,\n      },\n    };\n  }\n\n  /** Animate the token through the given tile indices, one hop at a time. */\n  async moveToken(path: number[]): Promise<void> {\n    for (const idx of path) {\n      const to = this.tilePositions[idx];\n      if (!to) continue;\n      await this.tweenTo(to);\n    }\n  }\n\n  /** Pulse a tile (emissive + lift) to mark where the token landed. */\n  highlightTile(index: number): void {\n    if (this.tileMeshes[index])\n      this.highlight = { index, start: performance.now() };\n  }\n\n  /** Grow the city towers to reflect each building's level. */\n  setBuildingLevels(levels: number[]): void {\n    for (let i = 0; i < this.buildings.length; i++) {\n      const building = this.buildings[i];\n      if (!building) continue;\n      const level = levels[i] ?? 0;\n      const scaleY = 0.5 + level * 0.9;\n      const height = BODY_H * scaleY;\n      building.body.scale.y = scaleY;\n      building.body.position.y = height / 2;\n      building.roof.position.y = height + 0.11;\n    }\n  }\n\n  private updateHighlight(): void {\n    if (!this.highlight) return;\n    const mesh = this.tileMeshes[this.highlight.index];\n    const baseColor = this.tileColors[this.highlight.index];\n    if (!mesh || !baseColor) {\n      this.highlight = null;\n      return;\n    }\n    const mat = mesh.material as THREE.MeshStandardMaterial;\n    const t = (performance.now() - this.highlight.start) / HIGHLIGHT_MS;\n    if (t >= 1) {\n      mat.emissive.setHex(0x000000);\n      mat.emissiveIntensity = 1;\n      mesh.position.y = TILE_Y;\n      this.highlight = null;\n      return;\n    }\n    const pulse = Math.sin(Math.min(1, t) * Math.PI); // 0 → 1 → 0\n    mat.emissive.copy(baseColor);\n    mat.emissiveIntensity = pulse * 0.9;\n    mesh.position.y = TILE_Y + pulse * 0.35;\n  }\n\n  private tweenTo(to: THREE.Vector3): Promise<void> {\n    return new Promise<void>((resolve) => {\n      this.tween = {\n        from: this.token.position.clone(),\n        to: to.clone(),\n        start: performance.now(),\n        resolve,\n      };\n    });\n  }\n\n  private resize(): void {\n    const w = this.host.clientWidth || 640;\n    const h = this.host.clientHeight || 640;\n    this.renderer.setSize(w, h, false);\n    this.camera.aspect = w / h;\n    this.camera.updateProjectionMatrix();\n  }\n\n  private disposeGroup(group: THREE.Group): void {\n    group.traverse((obj) => {\n      if (obj instanceof THREE.Mesh) {\n        obj.geometry.dispose();\n        const material = obj.material;\n        if (Array.isArray(material)) material.forEach((m) => m.dispose());\n        else material.dispose();\n      }\n    });\n    group.clear();\n  }\n\n  destroy(): void {\n    this.disposed = true;\n    cancelAnimationFrame(this.frame);\n    this.resizeObserver?.disconnect();\n    this.disposeGroup(this.tileGroup);\n    this.disposeGroup(this.cityGroup);\n    this.token.geometry.dispose();\n    (this.token.material as THREE.Material).dispose();\n    if (this.dice[0]) this.dice[0].geometry.dispose();\n    this.diceMaterials.forEach((m) => m.dispose());\n    this.diceTextures.forEach((t) => t.dispose());\n    this.tileDecalTextures.forEach((t) => t.dispose());\n    this.renderer.dispose();\n    this.renderer.domElement.remove();\n  }\n}\n"
+      "content": "import * as THREE from \"three\";\nimport type { TileInfo } from \"../data/boardConfig\";\n\nconst TILE_COLORS: Record<string, number> = {\n  Chance: 0xf0a020,\n  Reward: 0x4caf50,\n  Special: 0x9c5cff,\n  RandomAction: 0xe8534e,\n  Shield: 0x4a90e2,\n};\nconst DEFAULT_TILE_COLOR = 0x6b6b7a;\n\n// Glyphs drawn on top of non-reward tiles so the board reads at a glance.\nconst TILE_SYMBOLS: Record<string, string> = {\n  Chance: \"?\",\n  Special: \"★\",\n  RandomAction: \"✖\",\n  Shield: \"✚\",\n};\n\nconst BUILDING_COLORS = [\n  0x6c5ce7, 0x4caf50, 0xe8534e, 0xf0a020, 0x4a90e2, 0x42c9c2,\n];\n\nconst TOKEN_Y = 0.85;\nconst TILE_Y = 0.13;\nconst STEP_MS = 240;\nconst HIGHLIGHT_MS = 850;\nconst BODY_H = 1.0;\nconst DICE_MS = 950;\nconst DICE_BASE_Y = 3.2;\nconst DICE_DROP = 3.4;\n\n// Standard bounce-out easing (0 → 1 with decaying bounces) for the dice toss.\nfunction bounceOut(t: number): number {\n  const n1 = 7.5625;\n  const d1 = 2.75;\n  if (t < 1 / d1) return n1 * t * t;\n  if (t < 2 / d1) {\n    const u = t - 1.5 / d1;\n    return n1 * u * u + 0.75;\n  }\n  if (t < 2.5 / d1) {\n    const u = t - 2.25 / d1;\n    return n1 * u * u + 0.9375;\n  }\n  const u = t - 2.625 / d1;\n  return n1 * u * u + 0.984375;\n}\n\n// BoxGeometry face order is +X, -X, +Y, -Y, +Z, -Z. Assign pip values so opposite faces sum to 7.\nconst FACE_VALUES = [2, 5, 3, 4, 1, 6];\n// Resting rotation that brings each value's face to the top (+Y).\nconst REST_ROTATION: Record<number, [number, number, number]> = {\n  1: [-Math.PI / 2, 0, 0],\n  2: [0, 0, Math.PI / 2],\n  3: [0, 0, 0],\n  4: [Math.PI, 0, 0],\n  5: [0, 0, -Math.PI / 2],\n  6: [Math.PI / 2, 0, 0],\n};\n\nconst PIP_LAYOUTS: Record<number, string[]> = {\n  1: [\"C\"],\n  2: [\"TL\", \"BR\"],\n  3: [\"TL\", \"C\", \"BR\"],\n  4: [\"TL\", \"TR\", \"BL\", \"BR\"],\n  5: [\"TL\", \"TR\", \"C\", \"BL\", \"BR\"],\n  6: [\"TL\", \"TR\", \"ML\", \"MR\", \"BL\", \"BR\"],\n};\nconst PIP_COORDS: Record<string, [number, number]> = {\n  TL: [0.28, 0.28],\n  TR: [0.72, 0.28],\n  ML: [0.28, 0.5],\n  C: [0.5, 0.5],\n  MR: [0.72, 0.5],\n  BL: [0.28, 0.72],\n  BR: [0.72, 0.72],\n};\n\ninterface Tween {\n  from: THREE.Vector3;\n  to: THREE.Vector3;\n  start: number;\n  resolve: () => void;\n}\n\ninterface DiceTween {\n  entries: {\n    mesh: THREE.Mesh;\n    from: THREE.Euler;\n    to: THREE.Euler;\n    rest: THREE.Euler;\n  }[];\n  start: number;\n  resolve: () => void;\n}\n\ninterface Building {\n  body: THREE.Mesh;\n  roof: THREE.Mesh;\n}\n\n/**\n * Three.js renderer for the board: a square loop of tiles (colored + glyph-marked by type), the\n * player's city as towers that grow with their level, an animated token, and a pair of pip dice that\n * tumble to the rolled total. Engine-only — it knows nothing about the SDK.\n */\nexport class BoardController {\n  private readonly renderer: THREE.WebGLRenderer;\n  private readonly scene: THREE.Scene;\n  private readonly camera: THREE.PerspectiveCamera;\n  private readonly token: THREE.Mesh;\n  private readonly tileGroup = new THREE.Group();\n  private readonly cityGroup = new THREE.Group();\n  private readonly lookAt = new THREE.Vector3(0, 0, 0);\n  private readonly diceTextures: THREE.CanvasTexture[] = [];\n  private readonly diceMaterials: THREE.MeshStandardMaterial[] = [];\n  private readonly dice: THREE.Mesh[] = [];\n  private readonly tileDecalTextures = new Map<string, THREE.CanvasTexture>();\n\n  private tilePositions: THREE.Vector3[] = [];\n  private tileMeshes: THREE.Mesh[] = [];\n  private tileColors: THREE.Color[] = [];\n  private buildings: Building[] = [];\n  private tween: Tween | null = null;\n  private diceTween: DiceTween | null = null;\n  private highlight: { index: number; start: number } | null = null;\n  private frame = 0;\n  private disposed = false;\n  private running = true;\n  private resizeObserver?: ResizeObserver;\n\n  private readonly loop = (): void => {\n    if (this.disposed) return;\n    this.frame = requestAnimationFrame(this.loop);\n\n    if (this.tween) {\n      const t = Math.min(1, (performance.now() - this.tween.start) / STEP_MS);\n      const e = t * t * (3 - 2 * t); // smoothstep\n      const { from, to } = this.tween;\n      this.token.position.x = from.x + (to.x - from.x) * e;\n      this.token.position.z = from.z + (to.z - from.z) * e;\n      this.token.position.y = TOKEN_Y + Math.sin(t * Math.PI) * 0.6;\n      if (t >= 1) {\n        this.token.position.set(to.x, TOKEN_Y, to.z);\n        const done = this.tween.resolve;\n        this.tween = null;\n        done();\n      }\n    }\n\n    this.updateDice();\n    this.updateHighlight();\n    this.token.rotation.y += 0.02;\n\n    // Gentle camera lean: drift the look-at point a fraction toward the token.\n    this.lookAt.lerp(\n      new THREE.Vector3(\n        this.token.position.x * 0.35,\n        0,\n        this.token.position.z * 0.35,\n      ),\n      0.05,\n    );\n    this.camera.lookAt(this.lookAt);\n\n    this.renderer.render(this.scene, this.camera);\n  };\n\n  constructor(private readonly host: HTMLElement) {\n    this.renderer = new THREE.WebGLRenderer({ antialias: true });\n    this.renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));\n    this.renderer.domElement.style.display = \"block\";\n    host.appendChild(this.renderer.domElement);\n\n    this.scene = new THREE.Scene();\n    this.scene.background = new THREE.Color(0x063d99);\n\n    this.camera = new THREE.PerspectiveCamera(50, 1, 0.1, 200);\n    this.camera.position.set(0, 24, 19);\n    this.camera.lookAt(0, 0, 0);\n\n    const ambient = new THREE.AmbientLight(0xffffff, 0.75);\n    const dir = new THREE.DirectionalLight(0xffffff, 0.85);\n    dir.position.set(12, 22, 8);\n    this.scene.add(ambient, dir, this.tileGroup, this.cityGroup);\n\n    const tokenMat = new THREE.MeshStandardMaterial({\n      color: 0xffd479,\n      emissive: 0x6b5a1f,\n    });\n    this.token = new THREE.Mesh(\n      new THREE.SphereGeometry(0.5, 24, 16),\n      tokenMat,\n    );\n    this.token.position.set(0, TOKEN_Y, 0);\n    this.scene.add(this.token);\n\n    this.buildDice();\n\n    this.resize();\n    this.resizeObserver = new ResizeObserver(() => {\n      this.resize();\n    });\n    this.resizeObserver.observe(host);\n\n    this.loop();\n  }\n\n  // ---- dice ----\n\n  private buildDice(): void {\n    const textureByValue: Record<number, THREE.CanvasTexture> = {};\n    for (let v = 1; v <= 6; v++) {\n      const texture = new THREE.CanvasTexture(this.makePipCanvas(v));\n      this.diceTextures.push(texture);\n      textureByValue[v] = texture;\n    }\n    for (const value of FACE_VALUES) {\n      this.diceMaterials.push(\n        new THREE.MeshStandardMaterial({\n          map: textureByValue[value],\n          color: 0xffffff,\n        }),\n      );\n    }\n\n    const geo = new THREE.BoxGeometry(1.2, 1.2, 1.2);\n    for (let i = 0; i < 2; i++) {\n      const die = new THREE.Mesh(geo, this.diceMaterials);\n      die.position.set(i === 0 ? -1.0 : 1.0, 3.2, 0);\n      const rest = REST_ROTATION[3] ?? [0, 0, 0];\n      die.rotation.set(rest[0], 0, rest[2]);\n      this.scene.add(die);\n      this.dice.push(die);\n    }\n  }\n\n  private makePipCanvas(value: number): HTMLCanvasElement {\n    const canvas = document.createElement(\"canvas\");\n    canvas.width = 128;\n    canvas.height = 128;\n    const ctx = canvas.getContext(\"2d\");\n    if (!ctx) return canvas;\n    const s = canvas.width;\n    ctx.fillStyle = \"#f6f3ff\";\n    ctx.fillRect(0, 0, s, s);\n    ctx.strokeStyle = \"#d9d2f0\";\n    ctx.lineWidth = 4;\n    ctx.strokeRect(4, 4, s - 8, s - 8);\n    ctx.fillStyle = \"#052e7e\";\n    for (const slot of PIP_LAYOUTS[value] ?? []) {\n      const coord = PIP_COORDS[slot];\n      if (!coord) continue;\n      ctx.beginPath();\n      ctx.arc(coord[0] * s, coord[1] * s, s * 0.1, 0, Math.PI * 2);\n      ctx.fill();\n    }\n    return canvas;\n  }\n\n  private splitTotal(total: number): [number, number] {\n    const clamped = Math.max(2, Math.min(12, Math.round(total)));\n    const min1 = Math.max(1, clamped - 6);\n    const max1 = Math.min(6, clamped - 1);\n    const v1 = min1 + Math.floor(Math.random() * (max1 - min1 + 1));\n    return [v1, clamped - v1];\n  }\n\n  /** Tumble both dice and land them showing two faces that sum to the rolled total. */\n  rollDice(total: number): Promise<void> {\n    const values = this.splitTotal(total);\n    const entries = this.dice.map((mesh, i) => {\n      const r = REST_ROTATION[values[i] ?? 3] ?? [0, 0, 0];\n      const rest = new THREE.Euler(r[0], 0, r[2]);\n      const turns = (n: number): number => Math.PI * 2 * n;\n      const to = new THREE.Euler(\n        rest.x + turns(2 + i),\n        rest.y + turns(2),\n        rest.z + turns(2 + i),\n      );\n      return { mesh, from: mesh.rotation.clone(), to, rest };\n    });\n    return new Promise<void>((resolve) => {\n      this.diceTween = { entries, start: performance.now(), resolve };\n    });\n  }\n\n  private updateDice(): void {\n    if (!this.diceTween) return;\n    const t = Math.min(1, (performance.now() - this.diceTween.start) / DICE_MS);\n    const e = 1 - Math.pow(1 - t, 3); // easeOutCubic for the tumble\n    const y = DICE_BASE_Y + DICE_DROP * (1 - bounceOut(t)); // drop + bounce for the toss\n    for (const entry of this.diceTween.entries) {\n      entry.mesh.rotation.set(\n        entry.from.x + (entry.to.x - entry.from.x) * e,\n        entry.from.y + (entry.to.y - entry.from.y) * e,\n        entry.from.z + (entry.to.z - entry.from.z) * e,\n      );\n      entry.mesh.position.y = y;\n    }\n    if (t >= 1) {\n      for (const entry of this.diceTween.entries) {\n        entry.mesh.rotation.copy(entry.rest);\n        entry.mesh.position.y = DICE_BASE_Y;\n      }\n      const done = this.diceTween.resolve;\n      this.diceTween = null;\n      done();\n    }\n  }\n\n  // ---- board ----\n\n  loadBoard(tiles: TileInfo[], buildingCount: number): void {\n    this.disposeGroup(this.tileGroup);\n    this.disposeGroup(this.cityGroup);\n    this.tilePositions = [];\n    this.tileMeshes = [];\n    this.tileColors = [];\n    this.buildings = [];\n\n    const count = tiles.length;\n    const perSide = Math.max(1, Math.round(count / 4));\n    const spacing = 1.4;\n    const extent = perSide * spacing;\n    const half = extent / 2;\n\n    for (const tile of tiles) {\n      const pos = this.ringPosition(tile.index, perSide, extent, half);\n      const colorHex = TILE_COLORS[tile.type] ?? DEFAULT_TILE_COLOR;\n      const mesh = new THREE.Mesh(\n        new THREE.BoxGeometry(1.1, 0.25, 1.1),\n        new THREE.MeshStandardMaterial({ color: colorHex }),\n      );\n      mesh.position.set(pos.x, TILE_Y, pos.z);\n\n      const symbol = TILE_SYMBOLS[tile.type];\n      if (symbol) {\n        const decal = new THREE.Mesh(\n          new THREE.PlaneGeometry(0.7, 0.7),\n          new THREE.MeshBasicMaterial({\n            map: this.getDecalTexture(tile.type, symbol),\n            transparent: true,\n          }),\n        );\n        decal.rotation.x = -Math.PI / 2;\n        decal.position.set(0, 0.14, 0);\n        mesh.add(decal);\n      }\n\n      this.tileGroup.add(mesh);\n      this.tilePositions[tile.index] = new THREE.Vector3(pos.x, TOKEN_Y, pos.z);\n      this.tileMeshes[tile.index] = mesh;\n      this.tileColors[tile.index] = new THREE.Color(colorHex);\n    }\n\n    const startX = -((buildingCount - 1) * 1.7) / 2;\n    for (let i = 0; i < buildingCount; i++) {\n      const color = BUILDING_COLORS[i % BUILDING_COLORS.length] ?? 0x6c5ce7;\n      const body = new THREE.Mesh(\n        new THREE.BoxGeometry(0.9, BODY_H, 0.9),\n        new THREE.MeshStandardMaterial({ color }),\n      );\n      const roof = new THREE.Mesh(\n        new THREE.BoxGeometry(1.05, 0.22, 1.05),\n        new THREE.MeshStandardMaterial({\n          color: new THREE.Color(color).multiplyScalar(0.6),\n        }),\n      );\n      body.position.set(startX + i * 1.7, BODY_H / 2, 0);\n      roof.position.set(startX + i * 1.7, BODY_H + 0.11, 0);\n      this.cityGroup.add(body, roof);\n      this.buildings[i] = { body, roof };\n    }\n  }\n\n  private getDecalTexture(type: string, symbol: string): THREE.CanvasTexture {\n    const cached = this.tileDecalTextures.get(type);\n    if (cached) return cached;\n    const canvas = document.createElement(\"canvas\");\n    canvas.width = 96;\n    canvas.height = 96;\n    const ctx = canvas.getContext(\"2d\");\n    if (ctx) {\n      ctx.clearRect(0, 0, 96, 96);\n      ctx.fillStyle = \"rgba(20,16,40,0.85)\";\n      ctx.font = \"bold 64px system-ui, sans-serif\";\n      ctx.textAlign = \"center\";\n      ctx.textBaseline = \"middle\";\n      ctx.fillText(symbol, 48, 52);\n    }\n    const texture = new THREE.CanvasTexture(canvas);\n    this.tileDecalTextures.set(type, texture);\n    return texture;\n  }\n\n  private ringPosition(\n    index: number,\n    perSide: number,\n    extent: number,\n    half: number,\n  ): THREE.Vector3 {\n    const side = Math.floor(index / perSide) % 4;\n    const f = (index % perSide) / perSide;\n    let x = 0;\n    let z = 0;\n    switch (side) {\n      case 0:\n        x = -half + f * extent;\n        z = half;\n        break;\n      case 1:\n        x = half;\n        z = half - f * extent;\n        break;\n      case 2:\n        x = half - f * extent;\n        z = -half;\n        break;\n      default:\n        x = -half;\n        z = -half + f * extent;\n        break;\n    }\n    return new THREE.Vector3(x, 0, z);\n  }\n\n  /** Start/stop the render loop. The host calls this so a suspended mode stops ticking\n   *  (the Mode Router invariant: only the active mode runs its RAF). */\n  setRunning(running: boolean): void {\n    const shouldRun = running && !this.disposed;\n    if (shouldRun === this.running) return;\n    this.running = shouldRun;\n    if (shouldRun) this.frame = requestAnimationFrame(this.loop);\n    else cancelAnimationFrame(this.frame);\n  }\n\n  /** Snap the token to a tile with no animation. */\n  setPosition(index: number): void {\n    const p = this.tilePositions[index];\n    if (p) this.token.position.set(p.x, TOKEN_Y, p.z);\n  }\n\n  /**\n   * What the scene currently shows. Read by the module's agent surface (`agent.ts`): a rendered\n   * board is a single canvas, so this is the only way the AI Coder's agent can tell where the\n   * token stands and whether the board was loaded at all.\n   */\n  describeScene(): {\n    running: boolean;\n    tileCount: number;\n    buildingCount: number;\n    token: { x: number; z: number };\n  } {\n    return {\n      running: this.running,\n      tileCount: this.tilePositions.length,\n      buildingCount: this.buildings.length,\n      token: {\n        x: Math.round(this.token.position.x * 100) / 100,\n        z: Math.round(this.token.position.z * 100) / 100,\n      },\n    };\n  }\n\n  /** Animate the token through the given tile indices, one hop at a time. */\n  async moveToken(path: number[]): Promise<void> {\n    for (const idx of path) {\n      const to = this.tilePositions[idx];\n      if (!to) continue;\n      await this.tweenTo(to);\n    }\n  }\n\n  /** Pulse a tile (emissive + lift) to mark where the token landed. */\n  highlightTile(index: number): void {\n    if (this.tileMeshes[index])\n      this.highlight = { index, start: performance.now() };\n  }\n\n  /** Grow the city towers to reflect each building's level. */\n  setBuildingLevels(levels: number[]): void {\n    for (let i = 0; i < this.buildings.length; i++) {\n      const building = this.buildings[i];\n      if (!building) continue;\n      const level = levels[i] ?? 0;\n      const scaleY = 0.5 + level * 0.9;\n      const height = BODY_H * scaleY;\n      building.body.scale.y = scaleY;\n      building.body.position.y = height / 2;\n      building.roof.position.y = height + 0.11;\n    }\n  }\n\n  private updateHighlight(): void {\n    if (!this.highlight) return;\n    const mesh = this.tileMeshes[this.highlight.index];\n    const baseColor = this.tileColors[this.highlight.index];\n    if (!mesh || !baseColor) {\n      this.highlight = null;\n      return;\n    }\n    const mat = mesh.material as THREE.MeshStandardMaterial;\n    const t = (performance.now() - this.highlight.start) / HIGHLIGHT_MS;\n    if (t >= 1) {\n      mat.emissive.setHex(0x000000);\n      mat.emissiveIntensity = 1;\n      mesh.position.y = TILE_Y;\n      this.highlight = null;\n      return;\n    }\n    const pulse = Math.sin(Math.min(1, t) * Math.PI); // 0 → 1 → 0\n    mat.emissive.copy(baseColor);\n    mat.emissiveIntensity = pulse * 0.9;\n    mesh.position.y = TILE_Y + pulse * 0.35;\n  }\n\n  private tweenTo(to: THREE.Vector3): Promise<void> {\n    return new Promise<void>((resolve) => {\n      this.tween = {\n        from: this.token.position.clone(),\n        to: to.clone(),\n        start: performance.now(),\n        resolve,\n      };\n    });\n  }\n\n  private resize(): void {\n    const w = this.host.clientWidth || 640;\n    const h = this.host.clientHeight || 640;\n    this.renderer.setSize(w, h, false);\n    this.camera.aspect = w / h;\n    this.camera.updateProjectionMatrix();\n  }\n\n  private disposeGroup(group: THREE.Group): void {\n    group.traverse((obj) => {\n      if (obj instanceof THREE.Mesh) {\n        obj.geometry.dispose();\n        const material = obj.material;\n        if (Array.isArray(material)) material.forEach((m) => m.dispose());\n        else material.dispose();\n      }\n    });\n    group.clear();\n  }\n\n  /**\n   * One still frame of the board, for the platform's share-a-shot button.\n   *\n   * ⚠ Renders and reads in the SAME turn. The renderer is created without\n   * `preserveDrawingBuffer`, so by the time anyone else touches this canvas its drawing buffer is\n   * already cleared and `toBlob` hands back a black rectangle without failing.\n   */\n  async capture(): Promise<Blob | null> {\n    if (this.disposed) return null;\n    this.renderer.render(this.scene, this.camera);\n    return await new Promise<Blob | null>((resolve) => {\n      this.renderer.domElement.toBlob(resolve, \"image/png\");\n    });\n  }\n\n  destroy(): void {\n    this.disposed = true;\n    cancelAnimationFrame(this.frame);\n    this.resizeObserver?.disconnect();\n    this.disposeGroup(this.tileGroup);\n    this.disposeGroup(this.cityGroup);\n    this.token.geometry.dispose();\n    (this.token.material as THREE.Material).dispose();\n    if (this.dice[0]) this.dice[0].geometry.dispose();\n    this.diceMaterials.forEach((m) => m.dispose());\n    this.diceTextures.forEach((t) => t.dispose());\n    this.tileDecalTextures.forEach((t) => t.dispose());\n    this.renderer.dispose();\n    this.renderer.domElement.remove();\n  }\n}\n"
     },
     {
       "path": "index.ts",
@@ -159,7 +159,7 @@
     },
     {
       "path": "scene.ts",
-      "content": "import type { EngineScene, SceneMountContext } from \"@idosgames/module-sdk\";\nimport { BoardController } from \"./game/BoardController\";\nimport type { ControllerBox } from \"./controller-box\";\n\n// Wraps the Three.js board renderer as a host-driven EngineScene. Created on mount (it appends its\n// own <canvas> to the host element and starts a RAF loop), published into the shared box for the\n// React overlay, and paused/resumed by the Mode Router via activate/suspend.\nexport function createBoardScene(\n  box: ControllerBox<BoardController>,\n): EngineScene {\n  let controller: BoardController | null = null;\n  return {\n    surface: \"fullbleed-canvas\",\n    mount(ctx: SceneMountContext): void {\n      controller = new BoardController(ctx.host);\n      box.set(controller);\n    },\n    activate(): void {\n      controller?.setRunning(true);\n    },\n    suspend(): void {\n      controller?.setRunning(false);\n    },\n    destroy(): void {\n      box.set(null);\n      controller?.destroy();\n      controller = null;\n    },\n  };\n}\n"
+      "content": "import type { EngineScene, SceneMountContext } from \"@idosgames/module-sdk\";\nimport { BoardController } from \"./game/BoardController\";\nimport type { ControllerBox } from \"./controller-box\";\n\n// Wraps the Three.js board renderer as a host-driven EngineScene. Created on mount (it appends its\n// own <canvas> to the host element and starts a RAF loop), published into the shared box for the\n// React overlay, and paused/resumed by the Mode Router via activate/suspend.\nexport function createBoardScene(\n  box: ControllerBox<BoardController>,\n): EngineScene {\n  let controller: BoardController | null = null;\n  return {\n    surface: \"fullbleed-canvas\",\n    mount(ctx: SceneMountContext): void {\n      controller = new BoardController(ctx.host);\n      box.set(controller);\n    },\n    activate(): void {\n      controller?.setRunning(true);\n    },\n    suspend(): void {\n      controller?.setRunning(false);\n    },\n    capture(): Promise<Blob | null> {\n      return controller?.capture() ?? Promise.resolve(null);\n    },\n    destroy(): void {\n      box.set(null);\n      controller?.destroy();\n      controller = null;\n    },\n  };\n}\n"
     },
     {
       "path": "module.meta.json",

package/registry/modules/game-hud.json

@@ -48,10 +48,10 @@
     }
   },
   "dependencies": {
-    "@idosgames/core": "0.16.0",
-    "@idosgames/module-sdk": "0.3.3",
-    "@idosgames/react": "0.2.9",
-    "@idosgames/wallet": "0.3.1",
+    "@idosgames/core": "0.17.0",
+    "@idosgames/module-sdk": "0.4.0",
+    "@idosgames/react": "0.2.10",
+    "@idosgames/wallet": "0.4.1",
     "@tanstack/react-query": "5.101.2",
     "react": "19.2.7",
     "viem": "2.55.2",

package/registry/modules/idle-rpg.json

@@ -49,17 +49,17 @@
     }
   },
   "dependencies": {
-    "@idosgames/core": "0.16.0",
-    "@idosgames/module-sdk": "0.3.3",
-    "@idosgames/react": "0.2.9",
-    "@idosgames/wallet": "0.3.1",
+    "@idosgames/core": "0.17.0",
+    "@idosgames/module-sdk": "0.4.0",
+    "@idosgames/react": "0.2.10",
+    "@idosgames/wallet": "0.4.1",
     "@tanstack/react-query": "5.101.2",
     "phaser": "4.2.1",
     "react": "19.2.7",
     "viem": "2.55.2",
     "wagmi": "3.7.2"
   },
-  "contentHash": "c395a20365d53fd5aee509d40dfd9dfad5976b822ec12e808e460f0d0cba432d",
+  "contentHash": "143c4595784974ca4d58d5032e77b26e93d1d96c2455974c796c7d5c1d710ba6",
   "files": [
     {
       "path": "chrome.ts",
@@ -107,7 +107,7 @@
     },
     {
       "path": "game/IdleRpgController.ts",
-      "content": "import Phaser from \"phaser\";\nimport { IdleRpgScene, type CharacterDisplay } from \"../phaser/IdleRpgScene\";\n\n/** Owns the Phaser game instance and bridges React → scene (selecting a character). */\nexport class IdleRpgController {\n  private readonly game: Phaser.Game;\n  private readonly scene: IdleRpgScene;\n\n  constructor(parent: HTMLElement) {\n    this.scene = new IdleRpgScene();\n    this.game = new Phaser.Game({\n      type: Phaser.AUTO,\n      parent,\n      width: 480,\n      height: 640,\n      backgroundColor: \"#063d99\",\n      scene: this.scene,\n      scale: {\n        // Hug the left of the full-bleed host so the host's UI panel can dock on the right without\n        // covering the character card.\n        mode: Phaser.Scale.FIT,\n        autoCenter: Phaser.Scale.CENTER_VERTICALLY,\n      },\n    });\n\n    // Makes the game observable in the AI Coder's live preview, which reads this exact global.\n    //\n    // Phaser sets it itself — but only in its debug build (`Game.boot` guards it behind\n    // WEBGL_DEBUG), and the release build shipped by npm has that branch stripped. So a Phaser game\n    // is invisible to any outside observer unless it hands itself over, which is this one line.\n    // Verified live: without it the preview reports no engine; with it, scenes, object counts,\n    // camera and loop fps all come through.\n    (globalThis as unknown as Record<string, unknown>).PHASER_GAME = this.game;\n  }\n\n  selectCharacter(display: CharacterDisplay): void {\n    this.scene.setSelected(display);\n    this.selected = display;\n  }\n\n  /** Последний выбранный персонаж — единственное, что сцена показывает и чего нет в DOM. */\n  private selected: CharacterDisplay | null = null;\n\n  /**\n   * Что сейчас на канвасе. Читается поверхностью для агента (`module.ts`): у отрисованной сцены\n   * нет DOM, и без этого агент не может сказать, дошёл ли выбор персонажа до Phaser.\n   */\n  describeScene(): { running: boolean; selected: CharacterDisplay | null } {\n    return { running: this.game.loop.running, selected: this.selected };\n  }\n\n  /** Pause/resume the Phaser RAF loop. The host calls this so a suspended mode stops ticking\n   *  (the Mode Router invariant: only the active mode runs). */\n  setRunning(running: boolean): void {\n    if (running) this.game.loop.wake();\n    else this.game.loop.sleep();\n  }\n\n  destroy(): void {\n    this.game.destroy(true);\n    // Drop the debug global with the game itself: the Mode Router destroys a suspended mode, and a\n    // stale reference here would show an observer a game that no longer exists.\n    const globals = globalThis as unknown as Record<string, unknown>;\n    if (globals[\"PHASER_GAME\"] === this.game) delete globals[\"PHASER_GAME\"];\n  }\n}\n"
+      "content": "import Phaser from \"phaser\";\nimport { IdleRpgScene, type CharacterDisplay } from \"../phaser/IdleRpgScene\";\n\n/** Owns the Phaser game instance and bridges React → scene (selecting a character). */\nexport class IdleRpgController {\n  private readonly game: Phaser.Game;\n  private readonly scene: IdleRpgScene;\n\n  constructor(parent: HTMLElement) {\n    this.scene = new IdleRpgScene();\n    this.game = new Phaser.Game({\n      type: Phaser.AUTO,\n      parent,\n      width: 480,\n      height: 640,\n      backgroundColor: \"#063d99\",\n      scene: this.scene,\n      scale: {\n        // Hug the left of the full-bleed host so the host's UI panel can dock on the right without\n        // covering the character card.\n        mode: Phaser.Scale.FIT,\n        autoCenter: Phaser.Scale.CENTER_VERTICALLY,\n      },\n    });\n\n    // Makes the game observable in the AI Coder's live preview, which reads this exact global.\n    //\n    // Phaser sets it itself — but only in its debug build (`Game.boot` guards it behind\n    // WEBGL_DEBUG), and the release build shipped by npm has that branch stripped. So a Phaser game\n    // is invisible to any outside observer unless it hands itself over, which is this one line.\n    // Verified live: without it the preview reports no engine; with it, scenes, object counts,\n    // camera and loop fps all come through.\n    (globalThis as unknown as Record<string, unknown>).PHASER_GAME = this.game;\n  }\n\n  selectCharacter(display: CharacterDisplay): void {\n    this.scene.setSelected(display);\n    this.selected = display;\n  }\n\n  /** Последний выбранный персонаж — единственное, что сцена показывает и чего нет в DOM. */\n  private selected: CharacterDisplay | null = null;\n\n  /**\n   * Что сейчас на канвасе. Читается поверхностью для агента (`module.ts`): у отрисованной сцены\n   * нет DOM, и без этого агент не может сказать, дошёл ли выбор персонажа до Phaser.\n   */\n  describeScene(): { running: boolean; selected: CharacterDisplay | null } {\n    return { running: this.game.loop.running, selected: this.selected };\n  }\n\n  /** Pause/resume the Phaser RAF loop. The host calls this so a suspended mode stops ticking\n   *  (the Mode Router invariant: only the active mode runs). */\n  setRunning(running: boolean): void {\n    if (running) this.game.loop.wake();\n    else this.game.loop.sleep();\n  }\n\n  /**\n   * Один кадр игры для платформенной кнопки «поделиться снимком».\n   *\n   * ⚠ Через `renderer.snapshot`, а НЕ `canvas.toBlob`. У WebGL-рендерера Phaser (как и у любого\n   * другого) буфер отрисовки очищен к моменту, когда до канвы доберётся посторонний код, и чтение\n   * снаружи отдаёт ЧЁРНЫЙ прямоугольник, ничем не пожаловавшись — проверено живьём на стенде,\n   * ровно так этот модуль и снимался, пока снимал его общий запасной путь хоста. `snapshot`\n   * встроен в Phaser именно для этого: он забирает пиксели сразу после следующей отрисовки.\n   *\n   * Поэтому же сначала `wake()`: у остановленного цикла (режим только что был скрыт) следующей\n   * отрисовки не случится вовсе, и обещание висело бы до таймаута.\n   */\n  capture(): Promise<Blob | null> {\n    return new Promise<Blob | null>((resolve) => {\n      let settled = false;\n      const finish = (value: Blob | null) => {\n        if (settled) return;\n        settled = true;\n        resolve(value);\n      };\n\n      // Кадр не пришёл (контекст потерян, игра уничтожена между вызовом и отрисовкой) — отвечаем\n      // «нет», а не висим: у вызывающего за нами стоит следующий способ снять игру.\n      setTimeout(() => finish(null), 1500);\n\n      try {\n        this.game.loop.wake();\n        this.game.renderer.snapshot((result) => {\n          if (!(result instanceof HTMLImageElement)) return finish(null);\n          const canvas = document.createElement(\"canvas\");\n          canvas.width = result.naturalWidth || result.width;\n          canvas.height = result.naturalHeight || result.height;\n          const ctx = canvas.getContext(\"2d\");\n          if (!ctx) return finish(null);\n          ctx.drawImage(result, 0, 0);\n          canvas.toBlob(finish, \"image/png\");\n        });\n      } catch {\n        finish(null);\n      }\n    });\n  }\n\n  destroy(): void {\n    this.game.destroy(true);\n    // Drop the debug global with the game itself: the Mode Router destroys a suspended mode, and a\n    // stale reference here would show an observer a game that no longer exists.\n    const globals = globalThis as unknown as Record<string, unknown>;\n    if (globals[\"PHASER_GAME\"] === this.game) delete globals[\"PHASER_GAME\"];\n  }\n}\n"
     },
     {
       "path": "index.ts",
@@ -131,7 +131,7 @@
     },
     {
       "path": "scene.ts",
-      "content": "import type { EngineScene, SceneMountContext } from \"@idosgames/module-sdk\";\nimport { IdleRpgController } from \"./game/IdleRpgController\";\nimport type { ControllerBox } from \"./controller-box\";\n\n// Wraps the Phaser controller as a host-driven EngineScene. Created lazily on mount (Phaser needs a\n// parent element), published into the shared box for the React panel, and paused/resumed by the\n// Mode Router via activate/suspend so a hidden mode stops ticking.\nexport function createIdleRpgScene(\n  box: ControllerBox<IdleRpgController>,\n): EngineScene {\n  let controller: IdleRpgController | null = null;\n  return {\n    surface: \"fullbleed-canvas\",\n    mount(ctx: SceneMountContext): void {\n      controller = new IdleRpgController(ctx.host);\n      box.set(controller);\n    },\n    activate(): void {\n      controller?.setRunning(true);\n    },\n    suspend(): void {\n      controller?.setRunning(false);\n    },\n    destroy(): void {\n      box.set(null);\n      controller?.destroy();\n      controller = null;\n    },\n  };\n}\n"
+      "content": "import type { EngineScene, SceneMountContext } from \"@idosgames/module-sdk\";\nimport { IdleRpgController } from \"./game/IdleRpgController\";\nimport type { ControllerBox } from \"./controller-box\";\n\n// Wraps the Phaser controller as a host-driven EngineScene. Created lazily on mount (Phaser needs a\n// parent element), published into the shared box for the React panel, and paused/resumed by the\n// Mode Router via activate/suspend so a hidden mode stops ticking.\nexport function createIdleRpgScene(\n  box: ControllerBox<IdleRpgController>,\n): EngineScene {\n  let controller: IdleRpgController | null = null;\n  return {\n    surface: \"fullbleed-canvas\",\n    mount(ctx: SceneMountContext): void {\n      controller = new IdleRpgController(ctx.host);\n      box.set(controller);\n    },\n    activate(): void {\n      controller?.setRunning(true);\n    },\n    suspend(): void {\n      controller?.setRunning(false);\n    },\n    capture(): Promise<Blob | null> {\n      return controller?.capture() ?? Promise.resolve(null);\n    },\n    destroy(): void {\n      box.set(null);\n      controller?.destroy();\n      controller = null;\n    },\n  };\n}\n"
     },
     {
       "path": "module.meta.json",

package/registry/modules/voxelcraft.json

@@ -60,11 +60,11 @@
     "version": "0.3.0"
   },
   "dependencies": {
-    "@idosgames/core": "0.16.0",
-    "@idosgames/module-sdk": "0.3.3",
+    "@idosgames/core": "0.17.0",
+    "@idosgames/module-sdk": "0.4.0",
     "three": "0.185.1"
   },
-  "contentHash": "9eb50576a72e034a28f19b05742129de403113afb09b704b6c2b309d51b279e7",
+  "contentHash": "0de6a76e323311ee027133892e4fa66c72540ced75d21cb9e441025c06feea6c",
   "files": [
     {
       "path": "agent.ts",
@@ -636,7 +636,7 @@
     },
     {
       "path": "main.ts",
-      "content": "// Точка сборки: единственное место, где конструируются все системы и\n// внедряются зависимости. Модули общаются через EventBus или переданные ссылки.\n// Тик (20 TPS) — симуляция; кадр — ввод, физика игрока, интерполяция, рендер.\nimport * as THREE from \"three\";\nimport { CONFIG } from \"./config\";\nimport { events } from \"./core/EventBus\";\nimport { GameLoop } from \"./core/GameLoop\";\nimport { IntentQueue } from \"./core/Intents\";\nimport { TextureAtlas } from \"./gfx/TextureAtlas\";\nimport { buildIcons } from \"./registry/Items\";\nimport { ChunkManager } from \"./world/ChunkManager\";\nimport { Player } from \"./player/Player\";\nimport { Input } from \"./player/Input\";\nimport { Interaction } from \"./player/Interaction\";\nimport { ArmView, ARM_LAYER } from \"./player/ArmView\";\nimport { EntityManager } from \"./entities/EntityManager\";\nimport { Inventory } from \"./systems/Inventory\";\nimport { BlockUpdates } from \"./systems/BlockUpdates\";\nimport { BlockEntities } from \"./world/BlockEntities\";\nimport {\n  DIMENSIONS,\n  isDimensionId,\n  type DimensionId,\n} from \"./world/Dimensions\";\nimport { FACING_DIRS } from \"./registry/meta\";\nimport { BLOCKS, B } from \"./registry/Blocks\";\nimport { MOBS } from \"./registry/Mobs\";\nimport { buildPortal, findPortalNear, portalsOf } from \"./world/Portal\";\nimport { LAVA_SEA } from \"./worldgen/inferno/InfernoGenerator\";\nimport {\n  BEYOND_ARRIVAL,\n  BeyondGenerator,\n  ISLAND_Y,\n  OUTER_LANDING,\n  beyondPillars,\n  exitPortalCells,\n  gatewaySpot,\n} from \"./worldgen/beyond/BeyondGenerator\";\nimport { OUTER_START } from \"./worldgen/beyond/outer\";\nimport \"./world/behaviours/index\"; // поведения блоков регистрируются при импорте\nimport \"./world/blockentities/index\"; // типы блочных сущностей (печь, сундук) — тоже\nimport { FluidSim } from \"./systems/FluidSim\";\nimport { DayNight } from \"./systems/DayNight\";\nimport { Weather } from \"./systems/Weather\";\nimport { MAP_SIZE, newMap, surveyMap, type MapData } from \"./systems/Maps\";\nimport { EXPLORER_MAPS } from \"./registry/items/mansion\";\nimport { Sculk } from \"./systems/Sculk\";\nimport { hitTarget } from \"./world/behaviours/extras\";\nimport { anchorCharges } from \"./world/behaviours/stand\";\nimport { ArmorStand } from \"./gfx/ArmorStand\";\nimport { Fireworks } from \"./gfx/Fireworks\";\nimport { EMERGE_TIME } from \"./entities/WardenBrain\";\nimport { dripstoneFallDamage } from \"./world/behaviours/dripstone\";\nimport { Freezing } from \"./systems/Freezing\";\nimport {\n  TRIAL_RANGE,\n  trialStep,\n  type TrialState,\n} from \"./systems/TrialSpawner\";\nimport { TRIAL_MOBS } from \"./registry/blocks/trial\";\nimport type { Mob } from \"./entities/Mob\";\nimport { Audio } from \"./systems/Audio\";\nimport { SaveSystem } from \"./systems/Save\";\nimport { HUD } from \"./ui/HUD\";\nimport { InventoryUI } from \"./ui/InventoryUI\";\nimport { CreateWorldUI } from \"./ui/CreateWorldUI\";\nimport { ChatConsole } from \"./ui/ChatConsole\";\nimport { SignEditor } from \"./ui/SignEditor\";\nimport { BookScreen } from \"./ui/BookScreen\";\nimport { NameEditor } from \"./ui/NameEditor\";\nimport { TouchControls, touchWanted } from \"./ui/TouchControls\";\nimport { Commands } from \"./systems/Commands\";\nimport { BeaconBeams } from \"./gfx/BeaconBeams\";\nimport { DisplayItems } from \"./gfx/DisplayItems\";\nimport { SignText } from \"./gfx/SignText\";\nimport { Banners } from \"./gfx/Banners\";\nimport { Achievements } from \"./systems/Achievements\";\nimport { RAID_WAVES, Raid } from \"./systems/Raid\";\nimport { siegeCount, siegeSpot, siegeTonight } from \"./systems/Siege\";\nimport { Music, type Mood } from \"./systems/Music\";\nimport { AchievementsView } from \"./ui/AchievementsView\";\nimport { beaconEffects, inBeaconRange, type BeaconPulse } from \"./world/Beacon\";\nimport { WorldStore, newWorldId } from \"./systems/WorldStore\";\nimport type { WorldAI } from \"./ai/types\";\nimport { startSource } from \"./worlds/startWorld\";\nimport { CURRENT_GEN } from \"./worldgen/WorldGenerator\";\nimport type { DimensionSave, EffectId, SaveData, WorldSource } from \"./types\";\n\n/** Автосейв текущего мира в «Мои миры», секунд игры. */\nconst AUTOSAVE_EVERY = 30;\n\nexport interface GameOptions {\n  /** ИИ-генерация миров (client.ai). null/нет — только путь без ИИ. */\n  ai?: WorldAI | null;\n}\n\nexport class Game {\n  renderer: THREE.WebGLRenderer;\n  scene: THREE.Scene;\n  camera: THREE.PerspectiveCamera;\n  private _resizeObserver: ResizeObserver;\n  /** Снимает разом все DOM-подписки игры (document/window/канвас) в destroy(). */\n  private readonly _abort = new AbortController();\n  atlas: TextureAtlas;\n  intents: IntentQueue;\n  world: ChunkManager;\n  player: Player;\n  inventory: Inventory;\n  entities: EntityManager;\n  /** Блоки без опоры (факел, растение, дверь) ломаются вслед за соседом. */\n  blockUpdates: BlockUpdates;\n  /** Состояние клеток текущего измерения: сундуки, печи… */\n  blockEntities: BlockEntities;\n  /** Лучи светящих маяков. */\n  beams: BeaconBeams;\n  /** Предметы, выставленные в рамках. */\n  displays: DisplayItems;\n  /** Надписи на табличках. */\n  signs: SignText;\n  banners: Banners;\n  armorStands: ArmorStand;\n  fireworks: Fireworks;\n  /** Достижения мира (systems/Achievements) и музыка (systems/Music). */\n  achievements: Achievements;\n  music: Music;\n  /** Измерение, в котором игрок, и снимки остальных (дифы, сущности) до возвращения в них. */\n  dimension: DimensionId = \"overworld\";\n  readonly dims = new Map<DimensionId, DimensionSave>();\n  interaction: Interaction;\n  /** Вода и лава. */\n  fluids: FluidSim;\n  dayNight: DayNight;\n  /** Дождь и гроза (только в измерениях с небом). */\n  weather: Weather;\n  /** Секунды в портале; lock — не переносить снова, пока игрок не вышел из портала прибытия. */\n  _portalT = 0;\n  _portalLock = false;\n  /** Известные порталы: обратный путь выводит к своему порталу (в верхнем мире — в 128 блоках). */\n  portals = portalsOf(null);\n  /** Предел: кристаллы и дракон поставлены, дракон убит, титры показаны (сейв v3, `beyond`). */\n  /** Предел: кристаллы и дракон поставлены, дракон убит, титры показаны, где Врата (после победы). */\n  beyondState: {\n    initialized: boolean;\n    dragonKilled: boolean;\n    creditsShown: boolean;\n    gateway: [number, number, number] | null;\n  } = {\n    initialized: false,\n    dragonKilled: false,\n    creditsShown: false,\n    gateway: null,\n  };\n  audio: Audio;\n  input: Input;\n  armView: ArmView;\n  save: SaveSystem;\n  hud: HUD;\n  invUI: InventoryUI;\n  worldUI: CreateWorldUI;\n  /** Команды консоли и чат (T, /). */\n  commands: Commands;\n  chat: ChatConsole;\n  /** Ввод текста таблички. */\n  signEditor: SignEditor;\n  bookScreen: BookScreen;\n  nameEditor: NameEditor;\n  /** Сенсорное управление — только на устройствах с пальцем (или ?touch=1). */\n  touch: TouchControls | null;\n  playing: boolean;\n  private _time: number;\n  loop: GameLoop;\n  /** Текущий мир в «Моих мирах». Классический стартовый мир — \"default\". */\n  worldId = \"default\";\n  worldName = \"VoxelCraft\";\n  /** Хранилище миров; null — браузер не даёт IndexedDB (игра работает без сохранения). */\n  store: WorldStore | null = null;\n  private _autosaveT = 0;\n  /** Был ли день на прошлом тике — рассвет пополняет товар жителей. */\n  private _wasDay = true;\n  /** Деревни, в которые уже поселены жители (id региона; сейв v3, `villages`). */\n  villagesSettled = new Set<string>();\n  private _villageT = 0;\n  /** Ночей без сна (сейв v3 `daysAwake`); _slept — спал этой ночью. */\n  daysAwake = 0;\n  private _slept = false;\n  /** Карты мира по номеру (systems/Maps; сейв v3 `maps`). */\n  maps = new Map<number, MapData>();\n  nextMapId = 1;\n  private _mapT = 0;\n  private _mapPhase = 0;\n  /** Для компаратора: блочная сущность клетки текущего измерения. */\n  private readonly _containerAt = (x: number, y: number, z: number) =>\n    this.blockEntities.get(x, y, z);\n  /** Игрок уже сменил мир до того, как открылось хранилище, — не подменять его последним сейвом. */\n  private _worldTouched = false;\n  private _destroyed = false;\n\n  constructor(opts: GameOptions = {}) {\n    // --- рендер ---\n    const canvas = document.getElementById(\"game\") as HTMLCanvasElement;\n    this.renderer = new THREE.WebGLRenderer({ canvas, antialias: false });\n    this.renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));\n    // Казуальная картинка: Neutral-тонмаппинг держит насыщенность ярких цветов (ACES их смывает).\n    this.renderer.toneMapping = THREE.NeutralToneMapping;\n    this.renderer.toneMappingExposure = CONFIG.graphics.exposure;\n    this.renderer.shadowMap.enabled = CONFIG.graphics.shadows;\n    this.renderer.shadowMap.type = THREE.PCFShadowMap; // мягкость — shadow.radius (PCFSoft в r185 устарел)\n    // Карту теней обновляем сами, раз за кадр (см. frame): теневой проход фильтрует объекты по\n    // слоям камеры, и второй проход (рука) перерисовал бы её заново — из одной руки.\n    this.renderer.shadowMap.autoUpdate = false;\n    this.scene = new THREE.Scene();\n    // Пропорции выставит первый же замер ResizeObserver'а — до него кадров не будет.\n    this.camera = new THREE.PerspectiveCamera(\n      75,\n      1,\n      0.1,\n      CONFIG.renderDistance * 16 + 60,\n    );\n    this.camera.rotation.order = \"YXZ\";\n    this.scene.add(this.camera); // рука прикреплена к камере\n\n    // Размер берём из раскладки самого канваса (CSS растягивает его на вьюпорт), а не из\n    // window.innerWidth, и через ResizeObserver, а не событие resize: игра может стартовать\n    // в ещё не разложенном контейнере — фоновая вкладка или iframe превью, — где на момент\n    // конструктора innerWidth равен нулю. Событие resize там уже не придёт, и канвас навсегда\n    // остался бы 0x0: симуляция живая, экран чёрный. ResizeObserver сам отдаёт первый замер,\n    // как только раскладка появляется.\n    this._resizeObserver = new ResizeObserver(() => this._resize());\n    this._resizeObserver.observe(canvas);\n    this._resize();\n\n    // --- контент: атлас и иконки из одних и тех же процедурных текстур ---\n    this.atlas = new TextureAtlas();\n    buildIcons(this.atlas);\n\n    // --- системы ---\n    this.intents = new IntentQueue();\n    this.world = new ChunkManager(this.scene, this.atlas, startSource());\n    this.player = new Player(this.world);\n    this.inventory = new Inventory();\n    this.entities = new EntityManager(\n      this.scene,\n      this.world,\n      this.atlas,\n      this.player,\n      this.inventory,\n    );\n    this.blockUpdates = new BlockUpdates(() => this.world, this.entities);\n    // броня из инвентаря гасит урон игрока и изнашивается от ударов\n    this.player.armorStats = () => this.inventory.armorStats();\n    this.player.onArmorHit = (dmg) => this.inventory.damageArmor(dmg);\n    this.player.canGlide = () => this.inventory.canGlide();\n    this.player.tryTotem = () => {\n      if (this.inventory.heldItem()?.item !== \"life_totem\") return false;\n      this.inventory.consumeHeld(1);\n      return true;\n    };\n    this.player.onGlideWear = () => this.inventory.wearWings();\n    this.blockEntities = new BlockEntities(() => this.world, this.entities);\n    this.beams = new BeaconBeams(this.scene);\n    this.displays = new DisplayItems(this.scene, this.atlas);\n    this.signs = new SignText(this.scene);\n    this.banners = new Banners(this.scene);\n    this.armorStands = new ArmorStand(this.scene, this.atlas);\n    this.fireworks = new Fireworks(this.scene);\n    this.achievements = new Achievements({\n      has: (pred) => this.inventory.slots.some((s) => !!s && pred(s.item)),\n      wearing: (pred) => this.inventory.armor.some((s) => !!s && pred(s.item)),\n      effect: (id) => this.player.effects.has(id as EffectId),\n    });\n    this.interaction = new Interaction(\n      this.world,\n      this.player,\n      this.inventory,\n      this.intents,\n      this.scene,\n      this.atlas,\n      this.entities,\n    );\n    this.fluids = new FluidSim(this.world);\n    this.dayNight = new DayNight(this.scene, this.renderer);\n    this.weather = new Weather(this.scene);\n    const start = this.world.source;\n    if (start.kind === \"spec\") {\n      this.dayNight.setTimeOfDay(start.spec.ambience.timeOfDay);\n      this.worldName = start.spec.name;\n    }\n    this.audio = new Audio();\n    this.music = new Music(this.audio);\n    // пластинка в проигрывателе играет свою мелодию (сид и лад — systems/Disc), вынули — тишина\n    events.on(\"discPlay\", ({ mood, seed }: { mood: Mood; seed: number }) =>\n      this.music.play(mood, seed),\n    );\n    events.on(\"discEject\", () => this.music.stop());\n    this.input = new Input(canvas, this.intents, this._abort.signal);\n    this.armView = new ArmView(this.camera, this.atlas);\n    // второй проход (рука) видит только свой слой — свет мира включаем и на нём\n    this.dayNight.sun.layers.enable(ARM_LAYER);\n    this.dayNight.hemi.layers.enable(ARM_LAYER);\n    this.save = new SaveSystem(this);\n    this.hud = new HUD(this);\n    new AchievementsView(this.hud.heartsEl.parentElement!, this.achievements);\n    this.invUI = new InventoryUI(this, this._abort.signal);\n    this.worldUI = new CreateWorldUI(this, this._abort.signal, opts.ai ?? null);\n    this.commands = new Commands(this);\n    this.chat = new ChatConsole(this, this._abort.signal);\n    this.signEditor = new SignEditor(this, this._abort.signal);\n    this.bookScreen = new BookScreen(this, this._abort.signal);\n    this.nameEditor = new NameEditor(this, this._abort.signal);\n    this.touch = touchWanted()\n      ? new TouchControls(this, this._abort.signal)\n      : null;\n    this.interaction.onCommand = (text) => this.commands.run(text);\n    this.interaction.onUseMap = () => this.createMap();\n    // опыт из печи (и других источников, что не кидают сферы)\n    events.on(\"xpGain\", ({ amount }: { amount: number }) =>\n      this.player.addXp(amount),\n    );\n    events.on(\"playerDied\", () => this._onDeath());\n    events.on(\"portalLit\", (d: { x: number; y: number; z: number }) =>\n      this._rememberPortal(this.dimension, d.x, d.y, d.z),\n    );\n    events.on(\"throwEye\", (d: { x: number; y: number; z: number }) =>\n      this._throwEye(d.x, d.y, d.z),\n    );\n    events.on(\"dragonDefeated\", () => this._dragonDefeated());\n    events.on(\"ui:useBed\", (d: { x: number; y: number; z: number }) =>\n      this._useBed(d.x, d.y, d.z),\n    );\n    events.on(\"lightning\", (d: { x: number; y: number; z: number }) =>\n      this._lightning(d.x, d.y, d.z),\n    );\n    // упавший сталактит бьёт того, кто под ним, и рассыпается острым капельником\n    events.on(\n      \"dripstoneFall\",\n      (p: { x: number; y: number; z: number; landY: number }) => {\n        const pl = this.player;\n        if (\n          !pl.dead &&\n          Math.floor(pl.pos.x) === p.x &&\n          Math.floor(pl.pos.z) === p.z &&\n          pl.pos.y <= p.y &&\n          pl.pos.y >= p.landY - 0.5\n        )\n          pl.damage(dripstoneFallDamage(p.y - pl.pos.y), \"falling_stalactite\");\n        this.entities.spawnDrop(\n          p.x + 0.5,\n          p.landY + 0.2,\n          p.z + 0.5,\n          \"pointed_dripstone\",\n          1,\n        );\n      },\n    );\n    // находка из-под кисти — над расчищенным блоком\n    events.on(\n      \"brushLoot\",\n      (p: { x: number; y: number; z: number; item: string; count: number }) =>\n        this.entities.spawnDrop(\n          p.x + 0.5,\n          p.y + 1.1,\n          p.z + 0.5,\n          p.item,\n          p.count,\n        ),\n    );\n    // дроп, который роняет сам моб (рог козы)\n    events.on(\n      \"mobDrop\",\n      (p: { x: number; y: number; z: number; item: string }) =>\n        this.entities.spawnDrop(p.x, p.y, p.z, p.item, 1),\n    );\n    // глубокая тьма: сломанные и поставленные игроком блоки и взрывы — вибрации; смерть рядом с\n    // катализатором — скалк; место смерти игрока — для компаса возвращения\n    const overworld = () => this.dimension === \"overworld\";\n    events.on(\n      \"blockBreak\",\n      (p: { x: number; y: number; z: number; byPlayer?: boolean }) => {\n        if (overworld())\n          this.sculk.vibrate(\n            p.x + 0.5,\n            p.y + 0.5,\n            p.z + 0.5,\n            !!p.byPlayer && this.player.mode !== \"creative\",\n          );\n      },\n    );\n    // Жемчуг Предела упал: игрока переносит туда, и он расшибается, как в Minecraft; изредка из\n    // точки вылезает клещ Предела (registry/mobs/beyond)\n    events.on(\"pearlLand\", (p: { x: number; y: number; z: number }) => {\n      const pl = this.player;\n      if (pl.dead) return;\n      this.warmup(p.x, p.z);\n      let y = Math.floor(p.y);\n      while (\n        y > 1 &&\n        !this.world.isSolid(Math.floor(p.x), y - 1, Math.floor(p.z)) &&\n        y > Math.floor(p.y) - 4\n      )\n        y--;\n      pl.pos.set(Math.floor(p.x) + 0.5, y, Math.floor(p.z) + 0.5);\n      pl.vel.set(0, 0, 0);\n      pl._fallDist = 0;\n      if (pl.mode !== \"creative\") pl.damage(5, \"teleport\");\n      events.emit(\"pearlTeleport\", { x: pl.pos.x, y: pl.pos.y, z: pl.pos.z });\n      if (Math.random() < 0.05)\n        this.entities.spawnMob(\"rim_mite\", pl.pos.x, pl.pos.y, pl.pos.z);\n    });\n    // фейерверк с земли: ракета взлетает и рассыпается искрами (gfx/Fireworks)\n    events.on(\"fireworkLaunch\", (p: { x: number; y: number; z: number }) =>\n      this.fireworks.launch(p.x, p.y, p.z),\n    );\n    // компас по путевому камню: стрелка держится за него, пока камень цел (ui/HUD)\n    events.on(\"lodestoneBind\", (p: { x: number; y: number; z: number }) => {\n      this.player.lodestone = { x: p.x, z: p.z, dim: this.dimension };\n      this.hud.message(\"Компас привязан к путевому камню\", 2000);\n    });\n    // якорь возрождения: в Пекле — точка возрождения, в верхнем мире взрывается, как в Minecraft\n    events.on(\n      \"anchorUse\",\n      (p: { x: number; y: number; z: number; charges: number }) => {\n        if (!DIMENSIONS[this.dimension].bedsExplode) {\n          this.world.setBlock(p.x, p.y, p.z, B.air!);\n          this.entities.explode(p.x + 0.5, p.y + 0.5, p.z + 0.5, 5);\n          return;\n        }\n        if (p.charges <= 0) {\n          this.hud.message(\"Якорь не заряжен — нужен светокамень\", 2200);\n          return;\n        }\n        this.player.anchorPos = [p.x, p.y, p.z];\n        this.player.anchorDim = this.dimension;\n        this.hud.message(\"Точка возрождения — у якоря\", 2200);\n      },\n    );\n    // стрела в мишень — красный сигнал по близости к центру (world/behaviours/extras)\n    events.on(\n      \"arrowHit\",\n      (p: {\n        x: number;\n        y: number;\n        z: number;\n        hx?: number;\n        hy?: number;\n        hz?: number;\n      }) => {\n        if (p.hx === undefined || p.hy === undefined || p.hz === undefined)\n          return;\n        hitTarget(this.world, p.x, p.y, p.z, p.hx, p.hy, p.hz);\n      },\n    );\n    events.on(\"blockPlace\", (p: { x: number; y: number; z: number }) => {\n      if (overworld())\n        this.sculk.vibrate(\n          p.x + 0.5,\n          p.y + 0.5,\n          p.z + 0.5,\n          this.player.mode !== \"creative\",\n        );\n    });\n    events.on(\"explosion\", (p: { x: number; y: number; z: number }) => {\n      if (overworld()) this.sculk.vibrate(p.x, p.y, p.z, false);\n    });\n    events.on(\"mobDied\", (p: { entity: Mob }) => {\n      const e = p.entity;\n      if (overworld() && e.hitByPlayerT > 0 && !e.def.warden)\n        this.sculk.onDeath(e.pos.x, e.pos.y, e.pos.z, e.def.xp?.[1] ?? 1);\n    });\n    // моб волны спавнера испытаний убит — засчитать спавнеру\n    events.on(\"mobDied\", (p: { entity: Mob }) => {\n      const f = p.entity.trialFrom;\n      const be = f ? this.blockEntities.get(f[0], f[1], f[2]) : undefined;\n      if (be?.type === \"trial_spawner\") (be.state as TrialState).killed++;\n    });\n    events.on(\"playerDied\", () => {\n      const pp = this.player.pos;\n      this.lastDeath = { x: pp.x, y: pp.y, z: pp.z, dim: this.dimension };\n    });\n    // проводник: игрок в воде в его радиусе получает силу моря (дыхание, ночное зрение, спешка)\n    events.on(\n      \"conduitPulse\",\n      (p: { x: number; y: number; z: number; range: number }) => {\n        const pl = this.player;\n        if (\n          pl.dead ||\n          !pl.inWater ||\n          pl.pos.distanceTo(\n            new THREE.Vector3(p.x + 0.5, p.y + 0.5, p.z + 0.5),\n          ) > p.range\n        )\n          return;\n        for (const id of [\"water_breathing\", \"night_vision\", \"haste\"] as const)\n          pl.addEffect(id, 13);\n        events.emit(\"conduitPower\");\n      },\n    );\n    // маяк: игрок в зоне получает выбранные силы\n    events.on(\"beaconPulse\", (p: BeaconPulse) => {\n      const pl = this.player;\n      if (pl.dead || !inBeaconRange(p, pl.pos.x, pl.pos.y, pl.pos.z)) return;\n      for (const e of beaconEffects(p)) pl.addEffect(e.id, e.seconds, e.level);\n    });\n\n    this.playing = false;\n    this._time = 0;\n\n    events.on(\"ui:pause\", () => {\n      this.playing = false;\n      if (this.invUI.open) this.invUI.close();\n      this.hud.showOverlay(true);\n      void this.persist();\n    });\n    events.on(\"ui:resume\", () => {\n      this.playing = true;\n      this.hud.hideOverlay();\n    });\n    const { signal } = this._abort;\n    document.addEventListener(\n      \"keydown\",\n      (e) => {\n        if (e.code === \"Escape\" && this.invUI.open) this.invUI.close();\n      },\n      { signal },\n    );\n    // редкий случай: лок слетел, оверлея нет — клик по канвасу возвращает захват\n    canvas.addEventListener(\n      \"click\",\n      () => {\n        if (this.playing && !this.input.active && !this.input.uiOpen)\n          this.input.requestLock();\n      },\n      { signal },\n    );\n\n    // --- старт мира ---\n    this.warmupAtSpawn();\n    this.player.spawn();\n\n    this.loop = new GameLoop(this.tick.bind(this), this.frame.bind(this));\n    this.hud.showOverlay(false);\n    this.loop.start();\n\n    // «Мои миры»: открыть хранилище и продолжить последний мир, если игрок ещё не начал другой\n    void WorldStore.open().then(async (store) => {\n      if (!store) return;\n      if (this._destroyed) return store.close();\n      this.store = store;\n      const last = await store.lastPlayed().catch(() => undefined);\n      if (!last || this._worldTouched || this.playing || this._destroyed)\n        return;\n      try {\n        this.save.apply(last.save);\n        this.worldId = last.id;\n        this.worldName = last.name;\n        this.hud.message(\"Продолжаем мир «\" + last.name + \"»\", 2200);\n      } catch {\n        // повреждённый сейв не должен ломать запуск — остаёмся в стартовом мире\n      }\n    });\n  }\n\n  /** Сохранить текущий мир в «Мои миры» (без хранилища — ничего). */\n  async persist(): Promise<void> {\n    if (!this.store) return;\n    try {\n      await this.store.put({\n        id: this.worldId,\n        name: this.worldName,\n        updatedAt: Date.now(),\n        save: this.save.collect(),\n      });\n    } catch {\n      // квота/запрет хранилища: игра продолжается без автосейва\n    }\n  }\n\n  /** Открыть мир из «Моих миров». */\n  async openStoredWorld(id: string): Promise<boolean> {\n    if (!this.store) return false;\n    const w = await this.store.get(id).catch(() => undefined);\n    if (!w) return false;\n    if (id !== this.worldId) await this.persist();\n    try {\n      this.save.apply(w.save);\n    } catch {\n      return false;\n    }\n    this._worldTouched = true;\n    this.worldId = w.id;\n    this.worldName = w.name;\n    return true;\n  }\n\n  /**\n   * Мир из Мастерской: становится НОВОЙ записью в «Моих мирах» — правки игрока не трогают ни\n   * публикацию, ни прежний открытый мир (он сохраняется таким, каким его оставили).\n   * false — сейв не читается (повреждён или от несовместимой версии), мир остаётся прежним.\n   */\n  openSharedWorld(save: SaveData, name: string): boolean {\n    // persist() снимает сейв синхронно при вызове — до apply ниже, поэтому уходит именно старый мир.\n    void this.persist();\n    try {\n      this.save.apply(save);\n    } catch {\n      return false;\n    }\n    this.adoptNewWorld(name);\n    this.hud.message(\"Мир «\" + name + \"» из Мастерской\", 2200);\n    return true;\n  }\n\n  /** Мир сменился на новый (импорт сейва, новый сид, рецепт): новая запись в «Моих мирах». */\n  adoptNewWorld(name: string) {\n    this._worldTouched = true;\n    this.worldId = newWorldId();\n    this.worldName = name;\n    void this.persist();\n  }\n\n  /** Подгонка рендера под текущую раскладку канваса. Вызывается ResizeObserver'ом. */\n  _resize() {\n    const canvas = this.renderer.domElement;\n    const w = canvas.clientWidth;\n    const h = canvas.clientHeight;\n    if (w === 0 || h === 0) return; // ещё не разложено — придёт следующим замером\n\n    this.camera.aspect = w / h;\n    this.camera.updateProjectionMatrix();\n    // updateStyle=false: размерами канваса управляет CSS (#game { position: fixed; inset: 0 }),\n    // инлайновый стиль от three конфликтовал бы с ним.\n    this.renderer.setSize(w, h, false);\n  }\n\n  /** Синхронная прогенерация зоны вокруг точки (старт/телепорт/импорт). */\n  warmup(x: number, z: number) {\n    for (let i = 0; i < 200; i++) {\n      this.world.update(x, z);\n      const busy =\n        this.world.genQueue.length > 0 ||\n        [...this.world.chunks.values()].some(\n          (c) => c.generated && (c.dirty || c.waterDirty),\n        );\n      if (!busy) break;\n    }\n  }\n\n  /** Прогрузка вокруг точки спавна текущего мира (подсказка генератора). */\n  warmupAtSpawn() {\n    const s = this.world.generator.spawnHint();\n    this.warmup(s.x, s.z);\n  }\n\n  /** Пересоздание мира под источник (сид или рецепт) и измерение: регенерация/импорт/портал. */\n  rebuildWorld(source: WorldSource, dimension: DimensionId = this.dimension) {\n    this.world.clear();\n    this.world = new ChunkManager(this.scene, this.atlas, source, dimension);\n    this.dimension = dimension;\n    this.blockEntities.clear();\n    this.player.world = this.world;\n    this.entities.world = this.world;\n    this.interaction.world = this.world;\n    this.fluids.world = this.world;\n    this.fluids.clear();\n    this.interaction.breaking = null;\n    this.interaction.damage.clear(); // трещины старого мира не должны лечь на блоки нового\n    this.interaction.eating = null;\n    this.intents.clear();\n  }\n\n  /** Полностью новый мир: чистые инвентарь, сущности, время. Число — классический мир по сиду. */\n  newWorld(source: WorldSource | number) {\n    const src: WorldSource =\n      typeof source === \"number\"\n        ? { kind: \"noise\", seed: source, gen: CURRENT_GEN }\n        : // новый мир — текущего поколения (у мира из рецепта: цитадель под островом)\n          { ...source, gen: source.gen ?? CURRENT_GEN };\n    void this.persist(); // старый мир остаётся в «Моих мирах» таким, каким его оставили\n    this.dims.clear();\n    this.portals = portalsOf(null);\n    this.beyondState = {\n      initialized: false,\n      dragonKilled: false,\n      creditsShown: false,\n      gateway: null,\n    };\n    this.villagesSettled = new Set();\n    this.achievements.load([]); // достижения — у каждого мира свои, как в Minecraft\n    this.maps = new Map();\n    this.nextMapId = 1;\n    this.daysAwake = 0;\n    this.rebuildWorld(src, \"overworld\");\n    this.entities.clear();\n    this.inventory.deserialize({\n      slots: new Array(36).fill(null),\n      hotbarIndex: 0,\n    });\n    if (src.kind === \"spec\")\n      this.dayNight.setTimeOfDay(src.spec.ambience.timeOfDay);\n    else this.dayNight.resetToMorning();\n    this.warmupAtSpawn();\n    this.player.spawn();\n    const name = src.kind === \"spec\" ? src.spec.name : \"Мир \" + src.seed;\n    this.adoptNewWorld(name);\n    this.hud.message(\n      src.kind === \"spec\"\n        ? \"Мир «\" + src.spec.name + \"»\"\n        : \"Новый мир, сид \" + src.seed,\n      1800,\n    );\n  }\n\n  /**\n   * Перейти в другое измерение (портал, смерть в Пределе): текущее уходит снимком в `dims`,\n   * целевое строится из своих дифов, игрок ставится в (x, y, z) целевого измерения.\n   */\n  changeDimension(target: DimensionId, x: number, y: number, z: number) {\n    if (target === this.dimension) return;\n    this.dims.set(this.dimension, {\n      chunks: this.world.serializeDiffs(),\n      entities: this.entities.serialize(),\n      blockEntities: this.blockEntities.serialize(),\n    });\n    const saved = this.dims.get(target);\n    this.dims.delete(target);\n    this.rebuildWorld(this.world.source, target);\n    this.entities.clear();\n    if (saved) {\n      this.world.loadDiffs(saved.chunks);\n      this.entities.deserialize(\n        (saved.entities ?? []) as Parameters<EntityManager[\"deserialize\"]>[0],\n      );\n      this.blockEntities.deserialize(saved.blockEntities);\n    }\n    this.warmup(x, z);\n    this.player.pos.set(x, y, z);\n    this.player.vel.set(0, 0, 0);\n    this.player._fallDist = 0;\n    events.emit(\"dimensionChanged\", { dimension: target });\n  }\n\n  /** Смерть: вещи, броня и опыт выпадают на месте (в выживании), показывается экран смерти. */\n  _onDeath() {\n    if (this.player.mode !== \"creative\") {\n      const p = this.player.pos;\n      const inv = this.inventory;\n      for (const s of [...inv.slots, ...inv.armor])\n        if (s)\n          this.entities.spawnDrop(\n            p.x + (Math.random() - 0.5),\n            p.y + 0.5,\n            p.z + (Math.random() - 0.5),\n            s.item,\n            s.count,\n            s.dmg,\n          );\n      inv.deserialize({\n        slots: new Array(36).fill(null),\n        hotbarIndex: inv.hotbarIndex,\n      });\n      const xp = Math.min(100, this.player.xpLevel * 7);\n      if (xp > 0) this.entities.spawnXp(p.x, p.y + 0.5, p.z, xp);\n      this.player.xpLevel = this.player.xpProgress = this.player.xpTotal = 0;\n    }\n    if (this.invUI.open) this.invUI.close();\n    this.input.uiOpen = true; // до releaseLock: без паузы — вместо неё экран смерти\n    this.input.releaseLock();\n    this.hud.showDeath(this.player.lastCause);\n  }\n\n  /** Возродиться: у кровати, если она цела, иначе у точки мира; из других измерений — домой. */\n  respawnPlayer() {\n    if (!this.player.dead) return;\n    this.player.respawn(this.goHome());\n    this.hud.hideDeath();\n    this.input.uiOpen = false;\n    this.input.requestLock();\n  }\n\n  /**\n   * Домой: в верхний мир (из Пекла и Предела — сменой измерения) к кровати, если она цела, иначе к\n   * точке мира; возвращает место на полу. Возрождение и выходной портал Предела.\n   */\n  goHome(): THREE.Vector3 {\n    // якорь возрождения сильнее кровати и возвращает в СВОЁ измерение (обычно в Пекло)\n    const anchor = this.anchorHome();\n    if (anchor) return anchor;\n    const s = this.player.spawnPoint;\n    let at = new THREE.Vector3(s.x, s.y, s.z);\n    const bed = this.player.bedPos;\n    if (this.dimension !== \"overworld\")\n      this.changeDimension(\"overworld\", at.x, at.y, at.z);\n    if (bed) {\n      this.warmup(bed[0], bed[2]);\n      if (BLOCKS[this.world.getBlock(bed[0], bed[1], bed[2])]?.shape === \"bed\")\n        at = new THREE.Vector3(bed[0] + 0.5, bed[1] + 0.6, bed[2] + 0.5);\n      else {\n        this.player.bedPos = null;\n        this.hud.message(\"Ваша кровать отсутствует или заблокирована\", 2500);\n      }\n    }\n    this.warmup(at.x, at.z);\n    // точку могли застроить — поднимаемся до свободного места на рост\n    const bx = Math.floor(at.x),\n      bz = Math.floor(at.z);\n    let y = Math.floor(at.y);\n    while (\n      y < 126 &&\n      (this.world.isSolid(bx, y, bz) || this.world.isSolid(bx, y + 1, bz))\n    )\n      y++;\n    // …и опускаемся до пола: точка возрождения в воздухе — это смерть от падения сразу после неё\n    while (y > 1 && this.world.getBlock(bx, y - 1, bz) === B.air) y--;\n    at.y = y;\n    return at;\n  }\n\n  /**\n   * Портал: 4 с внутри (в креативе — сразу) → другое измерение, координаты Пекла — /8, как в\n   * Minecraft. На той стороне — ближайший портал в 16 блоках или новый; обратно — только выйдя из\n   * портала прибытия и зайдя снова.\n   */\n  _tickPortal(dt: number) {\n    const p = this.player.pos;\n    const cell = (dy: number) =>\n      this.world.getBlock(\n        Math.floor(p.x),\n        Math.floor(p.y + dy),\n        Math.floor(p.z),\n      );\n    const inBeyond = cell(0) === B.beyond_portal;\n    const inside =\n      inBeyond || [0, 1].some((dy) => cell(dy) === B.inferno_portal);\n    if (!inside || this.player.dead) {\n      this._portalT = 0;\n      this._portalLock = false;\n      return;\n    }\n    if (this._portalLock) return;\n    // портал Предела переносит сразу, как в Minecraft\n    if (inBeyond) {\n      this._portalLock = true;\n      this._beyondTravel();\n      return;\n    }\n    this._portalT += dt;\n    if (this._portalT < (this.player.mode === \"creative\" ? 0.25 : 4)) return;\n    this._portalT = 0;\n    this._portalLock = true;\n    const target: DimensionId =\n      this.dimension === \"inferno\" ? \"overworld\" : \"inferno\";\n    const k =\n      target === \"inferno\"\n        ? 1 / DIMENSIONS.inferno.scale\n        : DIMENSIONS.inferno.scale;\n    const tx = Math.floor(p.x * k),\n      tz = Math.floor(p.z * k);\n    // портал, через который уходим, — тоже известный (порталы из сейвов до реестра)\n    this._rememberPortal(\n      this.dimension,\n      Math.floor(p.x),\n      Math.floor(p.y),\n      Math.floor(p.z),\n    );\n    // свой портал на той стороне: в верхнем мире ищем в 128 блоках, в Пекле — в 16, как в Minecraft\n    const known = this._nearestPortal(\n      target,\n      tx,\n      tz,\n      target === \"overworld\" ? 128 : 16,\n    );\n    this.changeDimension(\n      target,\n      (known?.[0] ?? tx) + 0.5,\n      70,\n      (known?.[2] ?? tz) + 0.5,\n    );\n    let at = known ? findPortalNear(this.world, known[0], known[2], 2) : null;\n    if (known && !at) this._forgetPortal(target, known); // сломали — забываем\n    if (!at) {\n      if (known) this.warmup(tx, tz);\n      at =\n        findPortalNear(this.world, tx, tz, 16) ??\n        (target === \"inferno\"\n          ? buildPortal(this.world, tx, tz, 64, LAVA_SEA + 2, 110)\n          : buildPortal(this.world, tx, tz, 70, 4, 120));\n      this._rememberPortal(target, at.x, at.y, at.z);\n    }\n    this.player.pos.set(at.x + 0.5, at.y, at.z + 0.5);\n    this.player.vel.set(0, 0, 0);\n    this.player._fallDist = 0;\n    events.emit(\"portalTravel\", { dimension: target });\n  }\n\n  /** Нажатые плиты: клетка → сколько ещё держать после того, как с неё сошли (сек). */\n  private readonly _plates = new Map<string, number>();\n\n  /** Нажимные плиты: пока на плите стоит игрок или моб — сигнал; сошли — через секунду отпускает. */\n  _tickPlates(dt: number) {\n    const plate = B.stone_pressure_plate;\n    if (plate === undefined) return;\n    const on = new Set<string>();\n    // плиту жмут все, нажимные рельсы — только вагонетки\n    const mark = (x: number, y: number, z: number, cart = false) => {\n      const bx = Math.floor(x),\n        by = Math.floor(y + 0.05),\n        bz = Math.floor(z);\n      const id = this.world.getBlock(bx, by, bz);\n      if (id === plate || (cart && id === B.detector_rail))\n        on.add(bx + \",\" + by + \",\" + bz);\n    };\n    if (!this.player.dead)\n      mark(this.player.pos.x, this.player.pos.y, this.player.pos.z);\n    for (const e of this.entities.entities.values())\n      if (e.kind === \"mob\" && !e.dead) mark(e.pos.x, e.pos.y, e.pos.z);\n      else if (e.kind === \"minecart\" && !e.dead)\n        mark(e.pos.x, e.pos.y, e.pos.z, true);\n    const at = (k: string) =>\n      k.split(\",\").map(Number) as [number, number, number];\n    for (const k of on) {\n      this._plates.set(k, 1);\n      const [x, y, z] = at(k);\n      const id = this.world.getBlock(x, y, z),\n        m = this.world.getMeta(x, y, z);\n      if (id === plate && m === 0) this.world.setBlock(x, y, z, plate, 1);\n      else if (id === B.detector_rail && !(m & 0x8))\n        this.world.setBlock(x, y, z, id, m | 0x8);\n    }\n    for (const [k, left] of this._plates) {\n      if (on.has(k)) continue;\n      if (left - dt > 0) {\n        this._plates.set(k, left - dt);\n        continue;\n      }\n      this._plates.delete(k);\n      const [x, y, z] = at(k);\n      const id = this.world.getBlock(x, y, z);\n      if (id === plate) this.world.setBlock(x, y, z, plate, 0);\n      else if (id === B.detector_rail)\n        this.world.setBlock(x, y, z, id, this.world.getMeta(x, y, z) & ~0x8);\n    }\n  }\n\n  /** Портал Предела: из верхнего мира — на обсидиановую площадку Предела; из Предела — домой. */\n  _beyondTravel() {\n    if (this.dimension === \"beyond\") {\n      const s = this.player.spawnPoint;\n      this.changeDimension(\"overworld\", s.x, s.y, s.z);\n      this.player.pos.copy(this.goHome());\n      // первый выход после победы — титры\n      if (this.beyondState.dragonKilled && !this.beyondState.creditsShown) {\n        this.beyondState.creditsShown = true;\n        this.hud.showCredits();\n      }\n    } else {\n      const { x, y, z } = BEYOND_ARRIVAL;\n      this.changeDimension(\"beyond\", x + 0.5, y, z + 0.5);\n      this._arrivalPlatform();\n      if (!this.beyondState.initialized) this._initBeyond();\n    }\n    this.player.vel.set(0, 0, 0);\n    this.player._fallDist = 0;\n    events.emit(\"portalTravel\", { dimension: this.dimension });\n  }\n\n  /** Первый визит в Предел: Кристаллы на вершины колонн и дракон над островом. */\n  _initBeyond() {\n    this.beyondState.initialized = true;\n    for (const p of beyondPillars(this.world.seed))\n      this.entities.spawnMob(\"beyond_crystal\", p.x + 0.5, p.top + 2, p.z + 0.5);\n    this.entities.spawnMob(\"void_dragon\", 0, 90, 0);\n  }\n\n  /** Площадка 5×5 из обсидиана у BEYOND_ARRIVAL и воздух над ней — заново при каждом прибытии, как в Minecraft. */\n  _arrivalPlatform() {\n    const { x, y, z } = BEYOND_ARRIVAL;\n    for (let dx = -2; dx <= 2; dx++)\n      for (let dz = -2; dz <= 2; dz++) {\n        this.world.setBlock(x + dx, y - 1, z + dz, B.obsidian!);\n        for (let dy = 0; dy < 3; dy++)\n          this.world.setBlock(x + dx, y + dy, z + dz, B.air!);\n      }\n    this.player.pos.set(x + 0.5, y, z + 0.5);\n  }\n\n  /** Врата Предела с нижней клеткой в (x, y, z): две клетки врат, бедрок сверху и снизу. */\n  _placeGateway(x: number, y: number, z: number) {\n    this.world.setBlock(x, y - 1, z, B.bedrock!);\n    this.world.setBlock(x, y, z, B.beyond_gateway!);\n    this.world.setBlock(x, y + 1, z, B.beyond_gateway!);\n    this.world.setBlock(x, y + 2, z, B.bedrock!);\n  }\n\n  /** Врата на кольце вокруг главного острова — после победы (сейв до врат получает их при визите). */\n  _openGateway() {\n    const [x, y, z] = gatewaySpot(this.world.seed);\n    this.warmup(x, z); // запись в незагруженный чанк пропала бы: победа бывает далеко от врат\n    this._placeGateway(x, y, z);\n    this.beyondState.gateway = [x, y, z];\n  }\n\n  /** Идущий набег на деревню (systems/Raid) или null. Не сохраняется: перезагрузка его прекращает. */\n  raid: Raid | null = null;\n\n  /**\n   * Набег: игрок с Дурным знамением у заселённой деревни — знамение сгорает, начинается набег. Волны\n   * приходят с одного края деревни (в 28–34 блоках от центра) и идут к центру; победа — «Герой\n   * деревни» уровня знамения, поражение — все жители в 64 блоках мертвы или вышло время.\n   */\n  _tickRaid(dt: number) {\n    if (this.dimension !== \"overworld\") return;\n    const pl = this.player;\n    if (!this.raid) {\n      const omen = pl.effects.get(\"bad_omen\");\n      if (!omen || pl.dead) return;\n      const v = (\n        this.world.generator.villagesNear?.(pl.pos.x, pl.pos.z, 48) ?? []\n      ).find(\n        (x) =>\n          this.villagesSettled.has(x.id) &&\n          x.residents.some((r) => r.type.startsWith(\"villager_\")),\n      );\n      if (!v) return;\n      pl.effects.delete(\"bad_omen\");\n      events.emit(\"effectsChanged\", { id: \"bad_omen\" });\n      this.raid = new Raid({ x: v.x + 0.5, y: v.y, z: v.z + 0.5 }, omen.level);\n      events.emit(\"raidStart\", { x: v.x, z: v.z });\n      this.hud.message(\"Набег! Защитите деревню\", 3500);\n      return;\n    }\n    const r = this.raid;\n    const center = new THREE.Vector3(r.center.x, r.center.y, r.center.z);\n    let villagers = 0;\n    for (const e of this.entities.entities.values())\n      if (\n        e.kind === \"mob\" &&\n        !e.dead &&\n        e.def.trades &&\n        e.pos.distanceTo(center) < 64\n      )\n        villagers++;\n    const res = r.tick(\n      dt,\n      (id) => {\n        const e = this.entities.entities.get(id);\n        return e?.kind === \"mob\" && !e.dead;\n      },\n      villagers,\n    );\n    if (res.spawn) {\n      const a = Math.random() * Math.PI * 2;\n      for (const type of res.spawn) {\n        if (!MOBS[type]) continue;\n        const d = 28 + Math.random() * 6,\n          aa = a + (Math.random() - 0.5) * 0.4;\n        const x = Math.floor(center.x + Math.cos(aa) * d),\n          z = Math.floor(center.z + Math.sin(aa) * d);\n        this.warmup(x, z);\n        const m = this.entities.spawnMob(\n          type,\n          x + 0.5,\n          this.world.surfaceY(x, z) + 1.01,\n          z + 0.5,\n        );\n        m.raider = true;\n        m.goal = center.clone();\n        r.add(m.id, m.def.hp);\n      }\n      this.hud.message(`Набег: волна ${r.wave} из ${RAID_WAVES}`, 2500);\n      events.emit(\"raidWave\", { wave: r.wave });\n    }\n    if (res.end === \"won\") {\n      pl.addEffect(\"hero\", 2400, r.level);\n      events.emit(\"raidWon\", { level: r.level });\n      this.hud.message(\n        \"Набег отбит! Вы — герой деревни: жители уступают в цене\",\n        4500,\n      );\n      this.raid = null;\n    } else if (res.end === \"lost\") {\n      for (const id of r.raiders) {\n        const e = this.entities.entities.get(id);\n        if (e?.kind === \"mob\") {\n          e.raider = false;\n          e.goal = null;\n        }\n      }\n      events.emit(\"raidLost\");\n      this.hud.message(\"Набег: деревня пала\", 3500);\n      this.raid = null;\n    }\n  }\n\n  /** Держим, пока игрок не отойдёт от врат прибытия (иначе они сразу вернули бы его). */\n  private _gateLock = false;\n\n  /**\n   * Врата Предела: коснулся — с главного острова на внешние острова в ту же сторону (OUTER_LANDING),\n   * рядом с местом прибытия встают обратные врата; с внешних островов — к площадке прибытия.\n   */\n  _tickGateway() {\n    if (this.dimension !== \"beyond\" || this.player.dead) return;\n    const g = this.beyondState.gateway;\n    if (this.beyondState.dragonKilled && !g) this._openGateway();\n    // врата не ломаются: записаны, чанк загружен, а их нет — значит, не встали (сейв до починки)\n    else if (g && this.world.getBlockOrUnloaded(g[0], g[1], g[2]) === B.air)\n      this._placeGateway(g[0], g[1], g[2]);\n    const p = this.player.pos;\n    let touching = false;\n    for (let x = Math.floor(p.x - 0.5); x <= Math.floor(p.x + 0.5); x++)\n      for (let y = Math.floor(p.y); y <= Math.floor(p.y + 1.9); y++)\n        for (let z = Math.floor(p.z - 0.5); z <= Math.floor(p.z + 0.5); z++)\n          if (this.world.getBlock(x, y, z) === B.beyond_gateway)\n            touching = true;\n    if (!touching) {\n      this._gateLock = false;\n      return;\n    }\n    if (this._gateLock) return;\n    this._gateLock = true;\n    const toOuter = Math.hypot(p.x, p.z) < OUTER_START / 2;\n    if (!toOuter) {\n      this.warmup(BEYOND_ARRIVAL.x, BEYOND_ARRIVAL.z);\n      this._arrivalPlatform();\n    } else {\n      const a = Math.atan2(p.z, p.x);\n      const tx = Math.round(Math.cos(a) * OUTER_LANDING),\n        tz = Math.round(Math.sin(a) * OUTER_LANDING);\n      this.warmup(tx, tz);\n      const gen = this.world.generator;\n      const land =\n        gen instanceof BeyondGenerator ? gen.landingNear(tx, tz, 96) : null;\n      const x = land?.x ?? tx,\n        z = land?.z ?? tz;\n      let y = land?.y ?? ISLAND_Y;\n      if (land) {\n        this.warmup(x, z);\n        while (\n          y < 120 &&\n          (this.world.isSolid(x, y, z) || this.world.isSolid(x, y + 1, z))\n        )\n          y++;\n      } else\n        // островов рядом нет — площадка из камня Предела, как в Minecraft\n        for (let dx = -2; dx <= 2; dx++)\n          for (let dz = -2; dz <= 2; dz++)\n            this.world.setBlock(x + dx, y - 1, z + dz, B.beyond_stone!);\n      this._placeGateway(x + 3, y, z); // обратные врата у места прибытия\n      this.player.pos.set(x + 0.5, y, z + 0.5);\n      this.hud.message(\"Внешние острова Предела\", 2500);\n    }\n    this.player.vel.set(0, 0, 0);\n    this.player._fallDist = 0;\n    events.emit(\"gatewayTravel\", { outer: toOuter });\n  }\n\n  /** Дракон повержен: выходной портал в фонтане и яйцо на его колонне. */\n  _dragonDefeated() {\n    this.beyondState.dragonKilled = true;\n    for (const [x, y, z] of exitPortalCells())\n      this.world.setBlock(x, y, z, B.beyond_portal!);\n    this.world.setBlock(0, ISLAND_Y + 4, 0, B.dragon_egg!);\n    this._openGateway();\n    this.hud.message(\n      \"Дракон Предела повержен! Портал домой — в фонтане, Врата на внешние острова — за краем\",\n      4500,\n    );\n  }\n\n  /** Бросок Ока Предела: к ближайшей цитадели; в мире без цитаделей Око возвращается в руку. */\n  _throwEye(x: number, y: number, z: number) {\n    const target = this.world.generator.locate?.(\"citadel\", x, z);\n    if (!target) {\n      this.hud.message(\"Око не чувствует цитадели в этом мире\", 2200);\n      if (this.player.mode !== \"creative\") this.inventory.add(\"rim_eye\", 1);\n      return;\n    }\n    this.entities.spawnRimEye(new THREE.Vector3(x, y, z), target);\n  }\n\n  /** Запомнить портал: одна запись на портал — рядом с уже известным не дублируем. */\n  _rememberPortal(dim: DimensionId, x: number, y: number, z: number) {\n    const list = this.portals[dim];\n    const near = list.some(\n      ([px, py, pz]) =>\n        Math.abs(px - x) <= 3 && Math.abs(py - y) <= 4 && Math.abs(pz - z) <= 3,\n    );\n    if (!near) list.push([x, y, z]);\n  }\n\n  _forgetPortal(dim: DimensionId, p: readonly number[]) {\n    this.portals[dim] = this.portals[dim].filter((q) => q !== p);\n  }\n\n  /** Ближайший известный портал измерения в квадрате radius вокруг (x, z). */\n  _nearestPortal(\n    dim: DimensionId,\n    x: number,\n    z: number,\n    radius: number,\n  ): [number, number, number] | null {\n    let best: [number, number, number] | null = null;\n    let bestD = Infinity;\n    for (const q of this.portals[dim]) {\n      const dx = Math.abs(q[0] - x),\n        dz = Math.abs(q[2] - z);\n      if (dx > radius || dz > radius) continue;\n      const d = dx * dx + dz * dz;\n      if (d < bestD) {\n        best = q;\n        bestD = d;\n      }\n    }\n    return best;\n  }\n\n  /**\n   * Возрождение у заряженного якоря: переносит в его измерение, тратит один заряд. null — якоря\n   * нет, он сломан или разряжен (тогда действует обычный путь домой).\n   */\n  private anchorHome(): THREE.Vector3 | null {\n    const a = this.player.anchorPos;\n    const dim = this.player.anchorDim;\n    if (!a || !dim || !isDimensionId(dim)) return null;\n    const [x, y, z] = a;\n    if (this.dimension !== dim)\n      this.changeDimension(dim, x + 0.5, y + 1, z + 0.5);\n    this.warmup(x, z);\n    const charges =\n      this.world.getBlock(x, y, z) === B.respawn_anchor\n        ? anchorCharges(this.world.getMeta(x, y, z))\n        : 0;\n    if (charges <= 0) {\n      this.player.anchorPos = null;\n      this.player.anchorDim = null;\n      this.hud.message(\"Якорь возрождения разряжен или сломан\", 2500);\n      return null;\n    }\n    this.world.setBlock(x, y, z, B.respawn_anchor!, charges - 1);\n    // рядом с якорем, а не в нём: ищем свободную клетку вокруг\n    for (const [dx, dz] of FACING_DIRS) {\n      const nx = x + dx,\n        nz = z + dz;\n      if (!this.world.isSolid(nx, y, nz) && !this.world.isSolid(nx, y + 1, nz))\n        return new THREE.Vector3(nx + 0.5, y, nz + 0.5);\n    }\n    return new THREE.Vector3(x + 0.5, y + 1, z + 0.5);\n  }\n\n  /** ПКМ по кровати: точка возрождения; ночью без монстров рядом — сон до утра. */\n  _useBed(x: number, y: number, z: number) {\n    if (DIMENSIONS[this.dimension].bedsExplode) {\n      // в Пекле и Пределе кровать взрывается, как в Minecraft\n      this.world.setBlock(x, y, z, B.air!);\n      this.entities.explode(x + 0.5, y + 0.5, z + 0.5, 5);\n      return;\n    }\n    this.player.bedPos = [x, y, z];\n    if (this.dayNight.isDay && this.weather.kind !== \"thunder\") {\n      this.hud.message(\n        \"Спать можно только ночью или в грозу. Точка возрождения — здесь\",\n        2400,\n      );\n      return;\n    }\n    const monsters = [...this.entities.entities.values()].some(\n      (e) =>\n        e.kind === \"mob\" &&\n        !e.dead &&\n        e.def.category === \"hostile\" &&\n        e.pos.distanceTo(this.player.pos) < 8,\n    );\n    if (monsters) {\n      this.hud.message(\"Нельзя спать — рядом монстры\", 2000);\n      return;\n    }\n    this.dayNight.resetToMorning();\n    this.weather.set(\"clear\"); // сон пережидает и непогоду, как в Minecraft\n    this._slept = true;\n    this.daysAwake = 0;\n    this.hud.message(\"Доброе утро!\", 1800);\n    events.emit(\"slept\");\n  }\n\n  /** ПКМ пустой картой: карта участка вокруг игрока в руку (как в Minecraft; сразу разведан круг). */\n  createMap(): void {\n    if (this.inventory.heldItem()?.item !== \"map\") return;\n    const p = this.player.pos;\n    const m = newMap(this.nextMapId++, p.x, p.z, this.dimension);\n    this.maps.set(m.id, m);\n    for (let ph = 0; ph < 4; ph++) surveyMap(this.world, m, p.x, p.z, 48, ph);\n    const filled = { item: \"filled_map\", count: 1, tag: { map: m.id } };\n    if (this.player.mode !== \"creative\") this.inventory.consumeHeld(1);\n    const i = this.inventory.hotbarIndex;\n    if (!this.inventory.slots[i]) this.inventory.setSlot(i, filled);\n    else if (this.inventory.addStack(filled) > 0)\n      this.entities.spawnDrop(p.x, p.y + 1, p.z, \"filled_map\", 1);\n    events.emit(\"mapCreated\", { id: m.id });\n  }\n\n  _trialScanT = 0;\n  /** Спавнеры испытаний: раз в секунду завести сущности спавнерам камер рядом и шагнуть их машины. */\n  _tickTrials(dt: number): void {\n    if (this.dimension !== \"overworld\") return;\n    const p = this.player;\n    if ((this._trialScanT -= dt) <= 0) {\n      this._trialScanT = 1;\n      for (const [x, y, z] of this.world.generator.trialSpawnersNear?.(\n        p.pos.x,\n        p.pos.z,\n        48,\n      ) ?? [])\n        if (this.world.getBlockOrUnloaded(x, y, z) === B.trial_spawner)\n          this.blockEntities.ensure(x, y, z);\n    }\n    const hunter = !p.dead && p.mode !== \"creative\";\n    for (const be of this.blockEntities.map.values()) {\n      if (be.type !== \"trial_spawner\") continue;\n      const mob =\n        TRIAL_MOBS[this.world.getMeta(be.x, be.y, be.z) % TRIAL_MOBS.length]!;\n      trialStep(be.state as TrialState, {\n        dt,\n        near:\n          hunter &&\n          Math.hypot(\n            p.pos.x - be.x - 0.5,\n            p.pos.y - be.y,\n            p.pos.z - be.z - 0.5,\n          ) <= TRIAL_RANGE,\n        rng: Math.random,\n        spawn: () => this._trialSpawn(be.x, be.y, be.z, mob),\n        reward: (items) => {\n          for (const s of items)\n            this.entities.spawnDrop(\n              be.x + 0.5,\n              be.y + 1.2,\n              be.z + 0.5,\n              s.item,\n              s.count,\n            );\n          events.emit(\"trialReward\", { x: be.x, y: be.y, z: be.z });\n        },\n      });\n    }\n  }\n\n  /** Моб волны спавнера испытаний: клетка с полом и воздухом на рост в 4 блоках от спавнера. */\n  _trialSpawn(x: number, y: number, z: number, mob: string): boolean {\n    for (let i = 0; i < 10; i++) {\n      const sx = x + Math.floor(Math.random() * 9) - 4,\n        sz = z + Math.floor(Math.random() * 9) - 4;\n      for (let sy = y - 1; sy <= y + 2; sy++) {\n        if (!BLOCKS[this.world.getBlock(sx, sy - 1, sz)]?.solid) continue;\n        if (\n          this.world.getBlock(sx, sy, sz) !== 0 ||\n          this.world.getBlock(sx, sy + 1, sz) !== 0\n        )\n          continue;\n        const m = this.entities.spawnMob(mob, sx + 0.5, sy, sz + 0.5);\n        m.trialFrom = [x, y, z];\n        events.emit(\"trialSpawn\", { x, y, z, mob });\n        return true;\n      }\n    }\n    return false;\n  }\n\n  freezing = new Freezing();\n  /** Снег-порох: холод, урон, иней на экране; кожаные ботинки — снег держит (Player.leatherBoots). */\n  _tickFreeze(dt: number): void {\n    const p = this.player;\n    const armor = this.inventory.armor;\n    p.leatherBoots = () => armor.some((s) => s?.item === \"leather_boots\");\n    p.goldArmor = () => armor.some((s) => !!s?.item.startsWith(\"golden_\"));\n    // щит принял удар — теряет прочность по урону (как в Minecraft), не меньше 1\n    p.onShieldBlock = (n) => {\n      if (this.inventory.heldItem()?.item === \"shield\")\n        this.inventory.damageHeld(Math.max(1, Math.floor(n)));\n    };\n    const leather = armor.some((s) => !!s?.item.startsWith(\"leather_\"));\n    const dmg = this.freezing.tick(\n      dt,\n      p.inPowderSnow && !p.dead,\n      leather || p.mode === \"creative\",\n      p.fireT > 0,\n    );\n    if (dmg) p.damage(dmg, \"freeze\");\n    this.hud.frost(this.freezing.level);\n  }\n\n  _hornCd = 0;\n  _hornHeld = false;\n  /** Козий рог: ПКМ — протрубить (слышно далеко, будит сенсоры скалка), не чаще раза в 7 с. */\n  _goatHorn(dt: number): void {\n    this._hornCd = Math.max(0, this._hornCd - dt);\n    const press =\n      this.input.rightDown &&\n      !this.player.dead &&\n      this.inventory.heldItem()?.item === \"goat_horn\";\n    if (press && !this._hornHeld && this._hornCd <= 0) {\n      this._hornCd = 7;\n      events.emit(\"goatHorn\");\n      const p = this.player.pos;\n      if (this.dimension === \"overworld\")\n        this.sculk.vibrate(p.x, p.y, p.z, this.player.mode !== \"creative\");\n    }\n    this._hornHeld = press;\n  }\n\n  /** Скалк, вибрации и Страж (systems/Sculk.ts) — в верхнем мире. */\n  sculk = new Sculk({\n    world: () => this.world,\n    player: () => this.player,\n    wardens: () =>\n      [...this.entities.entities.values()].filter(\n        (e): e is Mob => e.kind === \"mob\" && !e.dead && !!e.def.warden,\n      ),\n    summon: (x, y, z) => {\n      const m = this.entities.spawnMob(\"warden\", x, y, z);\n      m.emergeT = EMERGE_TIME;\n      m.invulnerable = true;\n      return m;\n    },\n  });\n  /** Пройдено шагов с последней вибрации (вибрация — каждые 2 блока ходьбы без приседа). */\n  _stepDist = 0;\n  /** Где игрок умер последний раз — туда указывает компас возвращения (в сейв не пишется). */\n  lastDeath: { x: number; y: number; z: number; dim: string } | null = null;\n\n  /** Шаги игрока в верхнем мире — вибрации; наступил на крикуна — он кричит. */\n  _tickSculk(dt: number): void {\n    if (this.dimension !== \"overworld\") return;\n    this.sculk.tick(dt);\n    const p = this.player;\n    if (p.dead || p.flying || !p.onGround || p._sneaking) return;\n    this._stepDist += Math.hypot(p.vel.x, p.vel.z) * dt;\n    if (this._stepDist < 2) return;\n    this._stepDist = 0;\n    const x = Math.floor(p.pos.x),\n      y = Math.floor(p.pos.y),\n      z = Math.floor(p.pos.z);\n    if (this.world.getBlock(x, y - 1, z) === B.sculk_shrieker)\n      this.sculk.shriek(x, y - 1, z);\n    this.sculk.vibrate(p.pos.x, p.pos.y, p.pos.z, p.mode !== \"creative\");\n  }\n\n  /** Подзорная труба: ПКМ держать — поле зрения плавно сужается до 10° (как в Minecraft). */\n  _spyglass(dt: number): void {\n    const on =\n      !this.player.dead &&\n      this.input.rightDown &&\n      this.inventory.heldItem()?.item === \"spyglass\";\n    const want = on ? 10 : 75;\n    if (this.camera.fov === want) return;\n    this.camera.fov += (want - this.camera.fov) * Math.min(1, dt * 12);\n    if (Math.abs(this.camera.fov - want) < 0.1) this.camera.fov = want;\n    this.camera.updateProjectionMatrix();\n  }\n\n  /** Карта в руке дорисовывает местность вокруг игрока (четверть строк за раз). */\n  _surveyHeldMap(): void {\n    const h = this.inventory.heldItem();\n    // карта сокровищ или исследователя в руке становится картой участка с крестиком над целью:\n    // из тега {x, z}, а без него (карта картографа) — ближайшая к игроку цель такого вида\n    const kind = h ? EXPLORER_MAPS[h.item] : undefined;\n    if (h && kind) {\n      let tx = Number(h.tag?.x),\n        tz = Number(h.tag?.z);\n      if (!Number.isFinite(tx) || !Number.isFinite(tz)) {\n        if (this.dimension !== \"overworld\") return;\n        const f = this.world.generator.locate?.(\n          kind,\n          this.player.pos.x,\n          this.player.pos.z,\n        );\n        if (!f) return;\n        tx = f.x;\n        tz = f.z;\n      }\n      const m = newMap(this.nextMapId++, tx, tz, \"overworld\");\n      // карта с целью — по центру цели, а не по сетке карт: иначе ✖ бывает у самого края\n      m.x0 = Math.floor(tx) - MAP_SIZE / 2;\n      m.z0 = Math.floor(tz) - MAP_SIZE / 2;\n      m.target = [tx, tz];\n      this.maps.set(m.id, m);\n      this.inventory.setSlot(this.inventory.hotbarIndex, {\n        item: \"filled_map\",\n        count: 1,\n        tag: { map: m.id },\n      });\n      events.emit(\"mapCreated\", { id: m.id, treasure: true });\n      return;\n    }\n    if (h?.item !== \"filled_map\") return;\n    const m = this.maps.get(Number(h.tag?.map));\n    if (!m || m.dim !== this.dimension) return;\n    const p = this.player.pos;\n    surveyMap(this.world, m, p.x, p.z, 48, this._mapPhase++ & 3);\n  }\n\n  /**\n   * Ночная осада (systems/Siege): с наступлением ночи к заселённой деревне рядом с игроком выходит\n   * отряд зомби с одной стороны. Они охотятся на жителей (MobDef.huntsLand), а убитый житель встаёт\n   * зомби-жителем — так зомби-жители появляются в игре сами, без команд. Во время набега осады нет.\n   */\n  _siege() {\n    if (this.dimension !== \"overworld\" || this.raid) return;\n    const p = this.player.pos;\n    const v = (this.world.generator.villagesNear?.(p.x, p.z, 72) ?? []).find(\n      (x) =>\n        this.villagesSettled.has(x.id) &&\n        x.residents.some((r) => r.type.startsWith(\"villager_\")),\n    );\n    if (!v || !siegeTonight()) return;\n    const angle = Math.random() * Math.PI * 2;\n    let n = 0;\n    for (let i = siegeCount(); i > 0; i--) {\n      const { x, z } = siegeSpot(v.x + 0.5, v.z + 0.5, angle);\n      this.warmup(x, z);\n      const y = this.world.surfaceY(x, z);\n      if (y <= 0) continue;\n      const m = this.entities.spawnMob(\"zombie\", x + 0.5, y + 1.01, z + 0.5);\n      // цель — центр деревни: без неё отряд разбредается, не дойдя до жителей (MobBrain, huntsLand)\n      m.goal = new THREE.Vector3(v.x + 0.5, v.y, v.z + 0.5);\n      n++;\n    }\n    if (n === 0) return;\n    events.emit(\"siegeStart\", { x: v.x, z: v.z, count: n });\n    this.hud.message(\"Ночная осада! Зомби идут к деревне\", 3500);\n  }\n\n  /**\n   * Деревня рядом, в которой ещё никто не живёт: поселить жителей и голема (один раз — список в\n   * сейве). Ждёт, пока прогрузятся чанки всех домов, иначе жители упали бы сквозь незагруженное.\n   */\n  _settleVillages() {\n    // деревни верхнего мира и города Предела (панцирники) — один путь: villagesNear генератора\n    const p = this.player.pos;\n    for (const v of this.world.generator.villagesNear?.(p.x, p.z, 72) ?? []) {\n      if (this.villagesSettled.has(v.id)) continue;\n      const loaded = v.residents.every(\n        (r) =>\n          this.world.getBlockOrUnloaded(\n            Math.floor(r.x),\n            Math.floor(r.y),\n            Math.floor(r.z),\n          ) !== -1,\n      );\n      if (!loaded) continue;\n      for (const r of v.residents)\n        if (MOBS[r.type]) {\n          const m = this.entities.spawnMob(r.type, r.x, r.y + 0.01, r.z);\n          if (r.captain) m.captain = true;\n        }\n      this.villagesSettled.add(v.id);\n    }\n  }\n\n  /** Удар молнии: 5 урона всем в 3 блоках (огонь ставит сама погода). */\n  _lightning(x: number, y: number, z: number) {\n    const near = (p: THREE.Vector3) =>\n      Math.hypot(p.x - x, p.z - z) < 3 && Math.abs(p.y - y) < 4;\n    for (const e of this.entities.entities.values())\n      if (e.kind === \"mob\" && !e.dead && near(e.pos)) e.damage(5);\n    if (near(this.player.pos)) this.player.damage(5, \"lightning\");\n  }\n\n  startPlay() {\n    this.playing = true;\n    this.hud.hideOverlay();\n    this.audio.unlock();\n    this.input.requestLock();\n  }\n\n  // ---- симуляция (20 TPS) ----\n  tick(dt: number, n: number) {\n    if (!this.playing) return;\n    this.interaction.tick(dt);\n    this.player.tickHunger(dt);\n    // спавн мобов зависит от времени суток и погоды: ночью небо «гаснет» до 4, в грозу — и днём\n    const sky = DIMENSIONS[this.dimension].hasSky;\n    this.weather.tick(\n      dt,\n      sky ? this.world : null,\n      this.player.pos.x,\n      this.player.pos.z,\n    );\n    this.world.raining = sky && this.weather.raining;\n    this.world.containerAt = this._containerAt;\n    this.entities.raining = this.world.raining;\n    this.entities.skyDarken = Math.max(\n      this.dayNight.skyDarken,\n      sky ? this.weather.darken : 0,\n    );\n    this.entities.isDay = this.dayNight.isDay;\n    this.entities.tick(dt);\n    this.fluids.tick();\n    this.player.tickHazards(dt);\n    // черепаший панцирь: над водой копит 10 с Подводного дыхания — под водой их хватает на нырок\n    const wb = this.player.effects.get(\"water_breathing\");\n    if (\n      this.inventory.armor[0]?.item === \"turtle_helmet\" &&\n      !this.player.headInWater &&\n      (!wb || wb.time < 9.5)\n    )\n      this.player.addEffect(\"water_breathing\", 10);\n    this._tickPortal(dt);\n    this._tickGateway();\n    this._tickRaid(dt);\n    this._spyglass(dt);\n    this._tickSculk(dt);\n    this._goatHorn(dt);\n    this._tickFreeze(dt);\n    this._tickTrials(dt);\n    this._tickPlates(dt);\n    this.world.tick(); // onTick-блоки, запланированные и случайные тики\n    this.blockEntities.tick(dt);\n    this.dayNight.tick(dt);\n    // утром жители пополняют товар\n    const day = this.dayNight.isDay;\n    if (day && !this._wasDay) {\n      for (const e of this.entities.entities.values())\n        if (e.kind === \"mob\" && e.def.trades) e.uses = [];\n      // ещё одна ночь без сна (сон её обнуляет) — с трёх прилетают фантомы\n      this.daysAwake = this._slept ? 0 : this.daysAwake + 1;\n      this._slept = false;\n    } else if (!day && this._wasDay) this._siege(); // стемнело — может начаться осада деревни\n    this.entities.insomnia = this.daysAwake >= 3;\n    this._wasDay = day;\n    this._villageT += dt;\n    if (this._villageT >= 1) {\n      this._villageT = 0;\n      this._settleVillages();\n    }\n    this._mapT += dt;\n    if (this._mapT >= 0.25) {\n      this._mapT = 0;\n      this._surveyHeldMap();\n    }\n    events.emit(\"tick\", { n });\n    this._autosaveT += dt;\n    if (this._autosaveT >= AUTOSAVE_EVERY) {\n      this._autosaveT = 0;\n      void this.persist();\n    }\n  }\n\n  // ---- кадр ----\n  frame(dt: number, alpha: number) {\n    this._time += dt;\n\n    if (this.playing) {\n      this.music.tick(dt, this.dimension);\n      this.player.update(dt, this.input);\n      this.interaction.frame(this.input);\n      this.interaction.frameTimers(dt);\n    }\n\n    // камера из игрока\n    const eye = this.player.eyePos;\n    this.camera.position.copy(eye);\n    this.camera.rotation.set(this.player.pitch, this.player.yaw, 0);\n\n    this.world.update(this.player.pos.x, this.player.pos.z);\n    this.entities.updateVisuals(alpha, this._time);\n    this.beams.update(this.blockEntities, this._time);\n    this.displays.update(this.blockEntities, this.world);\n    this.signs.update(this.blockEntities, this.world);\n    this.banners.update(this.blockEntities, this.world);\n    this.armorStands.update(this.blockEntities);\n    this.fireworks.update(dt);\n    this.dayNight.frame(\n      this.player.pos,\n      this.player.headInLava\n        ? \"lava\"\n        : this.player.headInWater\n          ? \"water\"\n          : \"air\",\n      this.dimension,\n      this.player.effects.has(\"night_vision\"),\n      DIMENSIONS[this.dimension].hasSky ? this.weather : undefined,\n    );\n    // Тьма пульсирует: то наползает, то чуть отступает\n    if (this.player.effects.has(\"darkness\"))\n      this.dayNight.darkness(\n        0.75 + 0.25 * Math.abs(Math.sin(this._time * 1.3)),\n      );\n    this.weather.frame(\n      dt,\n      eye,\n      DIMENSIONS[this.dimension].hasSky ? this.world : null,\n    );\n\n    const walking =\n      this.playing &&\n      this.player.onGround &&\n      (this.input.forward ||\n        this.input.back ||\n        this.input.left ||\n        this.input.right);\n    this.armView.frame(dt, this.inventory, walking, this._time);\n\n    // анимация поверхности воды: медленный сдвиг repeat-текстуры\n    this.atlas.waterTexture.offset.x = this._time * 0.02;\n    this.atlas.waterTexture.offset.y = this._time * 0.013;\n\n    this.hud.frame();\n    this.invUI.frame();\n    // Два прохода: мир, затем рука поверх него с чистым depth — иначе вплотную к блоку она уходит\n    // внутрь него. Второй проход видит только слой руки (и свет, включённый на этот слой).\n    this.renderer.shadowMap.needsUpdate = true; // тени — только в мировом проходе\n    this.renderer.render(this.scene, this.camera);\n    this.renderer.autoClear = false;\n    this.renderer.clearDepth();\n    this.camera.layers.set(ARM_LAYER);\n    this.renderer.render(this.scene, this.camera);\n    this.camera.layers.set(0);\n    this.renderer.autoClear = true;\n  }\n\n  /** Teardown for the host: stop the loop, release the pointer, dispose GPU + observers. Called by\n   *  the module's EngineScene when the host destroys the stage. (This engine is authored as a\n   *  standalone app; the host adds this so it can live as a composable module.) */\n  destroy() {\n    // последний снимок уходит до разбора мира; дописывается транзакция уже без нас\n    void this.persist().finally(() => this.store?.close());\n    this._destroyed = true;\n    this.worldUI.hide();\n    this.loop.stop();\n    this.input.releaseLock();\n    // Шина `events` и DOM-подписки живут дольше игры: хост пересоздаёт Game после перелогина, и\n    // без этого старый экземпляр продолжал бы слушать — `E` эмитился дважды (новый инвентарь\n    // открывался и тут же закрывался), звуки двоились, весь старый мир держался в памяти.\n    this._abort.abort();\n    events.clear();\n    this.hud.dispose();\n    this.chat.dispose();\n    this.signEditor.dispose();\n    this.bookScreen.dispose();\n    this.nameEditor.dispose();\n    this.touch?.dispose();\n    this.player.dispose();\n    this.audio.dispose();\n    this._resizeObserver.disconnect();\n    this.world.clear();\n    this.renderer.dispose();\n    this.renderer.forceContextLoss();\n  }\n\n  /** Pause/resume from the host's Mode Router (only the active mode runs its loop). */\n  setRunning(running: boolean) {\n    if (running) {\n      this.input.enabled = true;\n      if (!this.loop.running) this.loop.start();\n    } else {\n      this.loop.stop();\n      this.input.releaseLock();\n      this.input.enabled = false; // клавиатура на document — не слушать, пока игрок в другом режиме\n      this.playing = false;\n    }\n  }\n}\n"
+      "content": "// Точка сборки: единственное место, где конструируются все системы и\n// внедряются зависимости. Модули общаются через EventBus или переданные ссылки.\n// Тик (20 TPS) — симуляция; кадр — ввод, физика игрока, интерполяция, рендер.\nimport * as THREE from \"three\";\nimport { CONFIG } from \"./config\";\nimport { events } from \"./core/EventBus\";\nimport { GameLoop } from \"./core/GameLoop\";\nimport { IntentQueue } from \"./core/Intents\";\nimport { TextureAtlas } from \"./gfx/TextureAtlas\";\nimport { buildIcons } from \"./registry/Items\";\nimport { ChunkManager } from \"./world/ChunkManager\";\nimport { Player } from \"./player/Player\";\nimport { Input } from \"./player/Input\";\nimport { Interaction } from \"./player/Interaction\";\nimport { ArmView, ARM_LAYER } from \"./player/ArmView\";\nimport { EntityManager } from \"./entities/EntityManager\";\nimport { Inventory } from \"./systems/Inventory\";\nimport { BlockUpdates } from \"./systems/BlockUpdates\";\nimport { BlockEntities } from \"./world/BlockEntities\";\nimport {\n  DIMENSIONS,\n  isDimensionId,\n  type DimensionId,\n} from \"./world/Dimensions\";\nimport { FACING_DIRS } from \"./registry/meta\";\nimport { BLOCKS, B } from \"./registry/Blocks\";\nimport { MOBS } from \"./registry/Mobs\";\nimport { buildPortal, findPortalNear, portalsOf } from \"./world/Portal\";\nimport { LAVA_SEA } from \"./worldgen/inferno/InfernoGenerator\";\nimport {\n  BEYOND_ARRIVAL,\n  BeyondGenerator,\n  ISLAND_Y,\n  OUTER_LANDING,\n  beyondPillars,\n  exitPortalCells,\n  gatewaySpot,\n} from \"./worldgen/beyond/BeyondGenerator\";\nimport { OUTER_START } from \"./worldgen/beyond/outer\";\nimport \"./world/behaviours/index\"; // поведения блоков регистрируются при импорте\nimport \"./world/blockentities/index\"; // типы блочных сущностей (печь, сундук) — тоже\nimport { FluidSim } from \"./systems/FluidSim\";\nimport { DayNight } from \"./systems/DayNight\";\nimport { Weather } from \"./systems/Weather\";\nimport { MAP_SIZE, newMap, surveyMap, type MapData } from \"./systems/Maps\";\nimport { EXPLORER_MAPS } from \"./registry/items/mansion\";\nimport { Sculk } from \"./systems/Sculk\";\nimport { hitTarget } from \"./world/behaviours/extras\";\nimport { anchorCharges } from \"./world/behaviours/stand\";\nimport { ArmorStand } from \"./gfx/ArmorStand\";\nimport { Fireworks } from \"./gfx/Fireworks\";\nimport { EMERGE_TIME } from \"./entities/WardenBrain\";\nimport { dripstoneFallDamage } from \"./world/behaviours/dripstone\";\nimport { Freezing } from \"./systems/Freezing\";\nimport {\n  TRIAL_RANGE,\n  trialStep,\n  type TrialState,\n} from \"./systems/TrialSpawner\";\nimport { TRIAL_MOBS } from \"./registry/blocks/trial\";\nimport type { Mob } from \"./entities/Mob\";\nimport { Audio } from \"./systems/Audio\";\nimport { SaveSystem } from \"./systems/Save\";\nimport { HUD } from \"./ui/HUD\";\nimport { InventoryUI } from \"./ui/InventoryUI\";\nimport { CreateWorldUI } from \"./ui/CreateWorldUI\";\nimport { ChatConsole } from \"./ui/ChatConsole\";\nimport { SignEditor } from \"./ui/SignEditor\";\nimport { BookScreen } from \"./ui/BookScreen\";\nimport { NameEditor } from \"./ui/NameEditor\";\nimport { TouchControls, touchWanted } from \"./ui/TouchControls\";\nimport { Commands } from \"./systems/Commands\";\nimport { BeaconBeams } from \"./gfx/BeaconBeams\";\nimport { DisplayItems } from \"./gfx/DisplayItems\";\nimport { SignText } from \"./gfx/SignText\";\nimport { Banners } from \"./gfx/Banners\";\nimport { Achievements } from \"./systems/Achievements\";\nimport { RAID_WAVES, Raid } from \"./systems/Raid\";\nimport { siegeCount, siegeSpot, siegeTonight } from \"./systems/Siege\";\nimport { Music, type Mood } from \"./systems/Music\";\nimport { AchievementsView } from \"./ui/AchievementsView\";\nimport { beaconEffects, inBeaconRange, type BeaconPulse } from \"./world/Beacon\";\nimport { WorldStore, newWorldId } from \"./systems/WorldStore\";\nimport type { WorldAI } from \"./ai/types\";\nimport { startSource } from \"./worlds/startWorld\";\nimport { CURRENT_GEN } from \"./worldgen/WorldGenerator\";\nimport type { DimensionSave, EffectId, SaveData, WorldSource } from \"./types\";\n\n/** Автосейв текущего мира в «Мои миры», секунд игры. */\nconst AUTOSAVE_EVERY = 30;\n\nexport interface GameOptions {\n  /** ИИ-генерация миров (client.ai). null/нет — только путь без ИИ. */\n  ai?: WorldAI | null;\n}\n\nexport class Game {\n  renderer: THREE.WebGLRenderer;\n  scene: THREE.Scene;\n  camera: THREE.PerspectiveCamera;\n  private _resizeObserver: ResizeObserver;\n  /** Снимает разом все DOM-подписки игры (document/window/канвас) в destroy(). */\n  private readonly _abort = new AbortController();\n  atlas: TextureAtlas;\n  intents: IntentQueue;\n  world: ChunkManager;\n  player: Player;\n  inventory: Inventory;\n  entities: EntityManager;\n  /** Блоки без опоры (факел, растение, дверь) ломаются вслед за соседом. */\n  blockUpdates: BlockUpdates;\n  /** Состояние клеток текущего измерения: сундуки, печи… */\n  blockEntities: BlockEntities;\n  /** Лучи светящих маяков. */\n  beams: BeaconBeams;\n  /** Предметы, выставленные в рамках. */\n  displays: DisplayItems;\n  /** Надписи на табличках. */\n  signs: SignText;\n  banners: Banners;\n  armorStands: ArmorStand;\n  fireworks: Fireworks;\n  /** Достижения мира (systems/Achievements) и музыка (systems/Music). */\n  achievements: Achievements;\n  music: Music;\n  /** Измерение, в котором игрок, и снимки остальных (дифы, сущности) до возвращения в них. */\n  dimension: DimensionId = \"overworld\";\n  readonly dims = new Map<DimensionId, DimensionSave>();\n  interaction: Interaction;\n  /** Вода и лава. */\n  fluids: FluidSim;\n  dayNight: DayNight;\n  /** Дождь и гроза (только в измерениях с небом). */\n  weather: Weather;\n  /** Секунды в портале; lock — не переносить снова, пока игрок не вышел из портала прибытия. */\n  _portalT = 0;\n  _portalLock = false;\n  /** Известные порталы: обратный путь выводит к своему порталу (в верхнем мире — в 128 блоках). */\n  portals = portalsOf(null);\n  /** Предел: кристаллы и дракон поставлены, дракон убит, титры показаны (сейв v3, `beyond`). */\n  /** Предел: кристаллы и дракон поставлены, дракон убит, титры показаны, где Врата (после победы). */\n  beyondState: {\n    initialized: boolean;\n    dragonKilled: boolean;\n    creditsShown: boolean;\n    gateway: [number, number, number] | null;\n  } = {\n    initialized: false,\n    dragonKilled: false,\n    creditsShown: false,\n    gateway: null,\n  };\n  audio: Audio;\n  input: Input;\n  armView: ArmView;\n  save: SaveSystem;\n  hud: HUD;\n  invUI: InventoryUI;\n  worldUI: CreateWorldUI;\n  /** Команды консоли и чат (T, /). */\n  commands: Commands;\n  chat: ChatConsole;\n  /** Ввод текста таблички. */\n  signEditor: SignEditor;\n  bookScreen: BookScreen;\n  nameEditor: NameEditor;\n  /** Сенсорное управление — только на устройствах с пальцем (или ?touch=1). */\n  touch: TouchControls | null;\n  playing: boolean;\n  private _time: number;\n  loop: GameLoop;\n  /** Текущий мир в «Моих мирах». Классический стартовый мир — \"default\". */\n  worldId = \"default\";\n  worldName = \"VoxelCraft\";\n  /** Хранилище миров; null — браузер не даёт IndexedDB (игра работает без сохранения). */\n  store: WorldStore | null = null;\n  private _autosaveT = 0;\n  /** Был ли день на прошлом тике — рассвет пополняет товар жителей. */\n  private _wasDay = true;\n  /** Деревни, в которые уже поселены жители (id региона; сейв v3, `villages`). */\n  villagesSettled = new Set<string>();\n  private _villageT = 0;\n  /** Ночей без сна (сейв v3 `daysAwake`); _slept — спал этой ночью. */\n  daysAwake = 0;\n  private _slept = false;\n  /** Карты мира по номеру (systems/Maps; сейв v3 `maps`). */\n  maps = new Map<number, MapData>();\n  nextMapId = 1;\n  private _mapT = 0;\n  private _mapPhase = 0;\n  /** Для компаратора: блочная сущность клетки текущего измерения. */\n  private readonly _containerAt = (x: number, y: number, z: number) =>\n    this.blockEntities.get(x, y, z);\n  /** Игрок уже сменил мир до того, как открылось хранилище, — не подменять его последним сейвом. */\n  private _worldTouched = false;\n  private _destroyed = false;\n\n  constructor(opts: GameOptions = {}) {\n    // --- рендер ---\n    const canvas = document.getElementById(\"game\") as HTMLCanvasElement;\n    this.renderer = new THREE.WebGLRenderer({ canvas, antialias: false });\n    this.renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));\n    // Казуальная картинка: Neutral-тонмаппинг держит насыщенность ярких цветов (ACES их смывает).\n    this.renderer.toneMapping = THREE.NeutralToneMapping;\n    this.renderer.toneMappingExposure = CONFIG.graphics.exposure;\n    this.renderer.shadowMap.enabled = CONFIG.graphics.shadows;\n    this.renderer.shadowMap.type = THREE.PCFShadowMap; // мягкость — shadow.radius (PCFSoft в r185 устарел)\n    // Карту теней обновляем сами, раз за кадр (см. frame): теневой проход фильтрует объекты по\n    // слоям камеры, и второй проход (рука) перерисовал бы её заново — из одной руки.\n    this.renderer.shadowMap.autoUpdate = false;\n    this.scene = new THREE.Scene();\n    // Пропорции выставит первый же замер ResizeObserver'а — до него кадров не будет.\n    this.camera = new THREE.PerspectiveCamera(\n      75,\n      1,\n      0.1,\n      CONFIG.renderDistance * 16 + 60,\n    );\n    this.camera.rotation.order = \"YXZ\";\n    this.scene.add(this.camera); // рука прикреплена к камере\n\n    // Размер берём из раскладки самого канваса (CSS растягивает его на вьюпорт), а не из\n    // window.innerWidth, и через ResizeObserver, а не событие resize: игра может стартовать\n    // в ещё не разложенном контейнере — фоновая вкладка или iframe превью, — где на момент\n    // конструктора innerWidth равен нулю. Событие resize там уже не придёт, и канвас навсегда\n    // остался бы 0x0: симуляция живая, экран чёрный. ResizeObserver сам отдаёт первый замер,\n    // как только раскладка появляется.\n    this._resizeObserver = new ResizeObserver(() => this._resize());\n    this._resizeObserver.observe(canvas);\n    this._resize();\n\n    // --- контент: атлас и иконки из одних и тех же процедурных текстур ---\n    this.atlas = new TextureAtlas();\n    buildIcons(this.atlas);\n\n    // --- системы ---\n    this.intents = new IntentQueue();\n    this.world = new ChunkManager(this.scene, this.atlas, startSource());\n    this.player = new Player(this.world);\n    this.inventory = new Inventory();\n    this.entities = new EntityManager(\n      this.scene,\n      this.world,\n      this.atlas,\n      this.player,\n      this.inventory,\n    );\n    this.blockUpdates = new BlockUpdates(() => this.world, this.entities);\n    // броня из инвентаря гасит урон игрока и изнашивается от ударов\n    this.player.armorStats = () => this.inventory.armorStats();\n    this.player.onArmorHit = (dmg) => this.inventory.damageArmor(dmg);\n    this.player.canGlide = () => this.inventory.canGlide();\n    this.player.tryTotem = () => {\n      if (this.inventory.heldItem()?.item !== \"life_totem\") return false;\n      this.inventory.consumeHeld(1);\n      return true;\n    };\n    this.player.onGlideWear = () => this.inventory.wearWings();\n    this.blockEntities = new BlockEntities(() => this.world, this.entities);\n    this.beams = new BeaconBeams(this.scene);\n    this.displays = new DisplayItems(this.scene, this.atlas);\n    this.signs = new SignText(this.scene);\n    this.banners = new Banners(this.scene);\n    this.armorStands = new ArmorStand(this.scene, this.atlas);\n    this.fireworks = new Fireworks(this.scene);\n    this.achievements = new Achievements({\n      has: (pred) => this.inventory.slots.some((s) => !!s && pred(s.item)),\n      wearing: (pred) => this.inventory.armor.some((s) => !!s && pred(s.item)),\n      effect: (id) => this.player.effects.has(id as EffectId),\n    });\n    this.interaction = new Interaction(\n      this.world,\n      this.player,\n      this.inventory,\n      this.intents,\n      this.scene,\n      this.atlas,\n      this.entities,\n    );\n    this.fluids = new FluidSim(this.world);\n    this.dayNight = new DayNight(this.scene, this.renderer);\n    this.weather = new Weather(this.scene);\n    const start = this.world.source;\n    if (start.kind === \"spec\") {\n      this.dayNight.setTimeOfDay(start.spec.ambience.timeOfDay);\n      this.worldName = start.spec.name;\n    }\n    this.audio = new Audio();\n    this.music = new Music(this.audio);\n    // пластинка в проигрывателе играет свою мелодию (сид и лад — systems/Disc), вынули — тишина\n    events.on(\"discPlay\", ({ mood, seed }: { mood: Mood; seed: number }) =>\n      this.music.play(mood, seed),\n    );\n    events.on(\"discEject\", () => this.music.stop());\n    this.input = new Input(canvas, this.intents, this._abort.signal);\n    this.armView = new ArmView(this.camera, this.atlas);\n    // второй проход (рука) видит только свой слой — свет мира включаем и на нём\n    this.dayNight.sun.layers.enable(ARM_LAYER);\n    this.dayNight.hemi.layers.enable(ARM_LAYER);\n    this.save = new SaveSystem(this);\n    this.hud = new HUD(this);\n    new AchievementsView(this.hud.heartsEl.parentElement!, this.achievements);\n    this.invUI = new InventoryUI(this, this._abort.signal);\n    this.worldUI = new CreateWorldUI(this, this._abort.signal, opts.ai ?? null);\n    this.commands = new Commands(this);\n    this.chat = new ChatConsole(this, this._abort.signal);\n    this.signEditor = new SignEditor(this, this._abort.signal);\n    this.bookScreen = new BookScreen(this, this._abort.signal);\n    this.nameEditor = new NameEditor(this, this._abort.signal);\n    this.touch = touchWanted()\n      ? new TouchControls(this, this._abort.signal)\n      : null;\n    this.interaction.onCommand = (text) => this.commands.run(text);\n    this.interaction.onUseMap = () => this.createMap();\n    // опыт из печи (и других источников, что не кидают сферы)\n    events.on(\"xpGain\", ({ amount }: { amount: number }) =>\n      this.player.addXp(amount),\n    );\n    events.on(\"playerDied\", () => this._onDeath());\n    events.on(\"portalLit\", (d: { x: number; y: number; z: number }) =>\n      this._rememberPortal(this.dimension, d.x, d.y, d.z),\n    );\n    events.on(\"throwEye\", (d: { x: number; y: number; z: number }) =>\n      this._throwEye(d.x, d.y, d.z),\n    );\n    events.on(\"dragonDefeated\", () => this._dragonDefeated());\n    events.on(\"ui:useBed\", (d: { x: number; y: number; z: number }) =>\n      this._useBed(d.x, d.y, d.z),\n    );\n    events.on(\"lightning\", (d: { x: number; y: number; z: number }) =>\n      this._lightning(d.x, d.y, d.z),\n    );\n    // упавший сталактит бьёт того, кто под ним, и рассыпается острым капельником\n    events.on(\n      \"dripstoneFall\",\n      (p: { x: number; y: number; z: number; landY: number }) => {\n        const pl = this.player;\n        if (\n          !pl.dead &&\n          Math.floor(pl.pos.x) === p.x &&\n          Math.floor(pl.pos.z) === p.z &&\n          pl.pos.y <= p.y &&\n          pl.pos.y >= p.landY - 0.5\n        )\n          pl.damage(dripstoneFallDamage(p.y - pl.pos.y), \"falling_stalactite\");\n        this.entities.spawnDrop(\n          p.x + 0.5,\n          p.landY + 0.2,\n          p.z + 0.5,\n          \"pointed_dripstone\",\n          1,\n        );\n      },\n    );\n    // находка из-под кисти — над расчищенным блоком\n    events.on(\n      \"brushLoot\",\n      (p: { x: number; y: number; z: number; item: string; count: number }) =>\n        this.entities.spawnDrop(\n          p.x + 0.5,\n          p.y + 1.1,\n          p.z + 0.5,\n          p.item,\n          p.count,\n        ),\n    );\n    // дроп, который роняет сам моб (рог козы)\n    events.on(\n      \"mobDrop\",\n      (p: { x: number; y: number; z: number; item: string }) =>\n        this.entities.spawnDrop(p.x, p.y, p.z, p.item, 1),\n    );\n    // глубокая тьма: сломанные и поставленные игроком блоки и взрывы — вибрации; смерть рядом с\n    // катализатором — скалк; место смерти игрока — для компаса возвращения\n    const overworld = () => this.dimension === \"overworld\";\n    events.on(\n      \"blockBreak\",\n      (p: { x: number; y: number; z: number; byPlayer?: boolean }) => {\n        if (overworld())\n          this.sculk.vibrate(\n            p.x + 0.5,\n            p.y + 0.5,\n            p.z + 0.5,\n            !!p.byPlayer && this.player.mode !== \"creative\",\n          );\n      },\n    );\n    // Жемчуг Предела упал: игрока переносит туда, и он расшибается, как в Minecraft; изредка из\n    // точки вылезает клещ Предела (registry/mobs/beyond)\n    events.on(\"pearlLand\", (p: { x: number; y: number; z: number }) => {\n      const pl = this.player;\n      if (pl.dead) return;\n      this.warmup(p.x, p.z);\n      let y = Math.floor(p.y);\n      while (\n        y > 1 &&\n        !this.world.isSolid(Math.floor(p.x), y - 1, Math.floor(p.z)) &&\n        y > Math.floor(p.y) - 4\n      )\n        y--;\n      pl.pos.set(Math.floor(p.x) + 0.5, y, Math.floor(p.z) + 0.5);\n      pl.vel.set(0, 0, 0);\n      pl._fallDist = 0;\n      if (pl.mode !== \"creative\") pl.damage(5, \"teleport\");\n      events.emit(\"pearlTeleport\", { x: pl.pos.x, y: pl.pos.y, z: pl.pos.z });\n      if (Math.random() < 0.05)\n        this.entities.spawnMob(\"rim_mite\", pl.pos.x, pl.pos.y, pl.pos.z);\n    });\n    // фейерверк с земли: ракета взлетает и рассыпается искрами (gfx/Fireworks)\n    events.on(\"fireworkLaunch\", (p: { x: number; y: number; z: number }) =>\n      this.fireworks.launch(p.x, p.y, p.z),\n    );\n    // компас по путевому камню: стрелка держится за него, пока камень цел (ui/HUD)\n    events.on(\"lodestoneBind\", (p: { x: number; y: number; z: number }) => {\n      this.player.lodestone = { x: p.x, z: p.z, dim: this.dimension };\n      this.hud.message(\"Компас привязан к путевому камню\", 2000);\n    });\n    // якорь возрождения: в Пекле — точка возрождения, в верхнем мире взрывается, как в Minecraft\n    events.on(\n      \"anchorUse\",\n      (p: { x: number; y: number; z: number; charges: number }) => {\n        if (!DIMENSIONS[this.dimension].bedsExplode) {\n          this.world.setBlock(p.x, p.y, p.z, B.air!);\n          this.entities.explode(p.x + 0.5, p.y + 0.5, p.z + 0.5, 5);\n          return;\n        }\n        if (p.charges <= 0) {\n          this.hud.message(\"Якорь не заряжен — нужен светокамень\", 2200);\n          return;\n        }\n        this.player.anchorPos = [p.x, p.y, p.z];\n        this.player.anchorDim = this.dimension;\n        this.hud.message(\"Точка возрождения — у якоря\", 2200);\n      },\n    );\n    // стрела в мишень — красный сигнал по близости к центру (world/behaviours/extras)\n    events.on(\n      \"arrowHit\",\n      (p: {\n        x: number;\n        y: number;\n        z: number;\n        hx?: number;\n        hy?: number;\n        hz?: number;\n      }) => {\n        if (p.hx === undefined || p.hy === undefined || p.hz === undefined)\n          return;\n        hitTarget(this.world, p.x, p.y, p.z, p.hx, p.hy, p.hz);\n      },\n    );\n    events.on(\"blockPlace\", (p: { x: number; y: number; z: number }) => {\n      if (overworld())\n        this.sculk.vibrate(\n          p.x + 0.5,\n          p.y + 0.5,\n          p.z + 0.5,\n          this.player.mode !== \"creative\",\n        );\n    });\n    events.on(\"explosion\", (p: { x: number; y: number; z: number }) => {\n      if (overworld()) this.sculk.vibrate(p.x, p.y, p.z, false);\n    });\n    events.on(\"mobDied\", (p: { entity: Mob }) => {\n      const e = p.entity;\n      if (overworld() && e.hitByPlayerT > 0 && !e.def.warden)\n        this.sculk.onDeath(e.pos.x, e.pos.y, e.pos.z, e.def.xp?.[1] ?? 1);\n    });\n    // моб волны спавнера испытаний убит — засчитать спавнеру\n    events.on(\"mobDied\", (p: { entity: Mob }) => {\n      const f = p.entity.trialFrom;\n      const be = f ? this.blockEntities.get(f[0], f[1], f[2]) : undefined;\n      if (be?.type === \"trial_spawner\") (be.state as TrialState).killed++;\n    });\n    events.on(\"playerDied\", () => {\n      const pp = this.player.pos;\n      this.lastDeath = { x: pp.x, y: pp.y, z: pp.z, dim: this.dimension };\n    });\n    // проводник: игрок в воде в его радиусе получает силу моря (дыхание, ночное зрение, спешка)\n    events.on(\n      \"conduitPulse\",\n      (p: { x: number; y: number; z: number; range: number }) => {\n        const pl = this.player;\n        if (\n          pl.dead ||\n          !pl.inWater ||\n          pl.pos.distanceTo(\n            new THREE.Vector3(p.x + 0.5, p.y + 0.5, p.z + 0.5),\n          ) > p.range\n        )\n          return;\n        for (const id of [\"water_breathing\", \"night_vision\", \"haste\"] as const)\n          pl.addEffect(id, 13);\n        events.emit(\"conduitPower\");\n      },\n    );\n    // маяк: игрок в зоне получает выбранные силы\n    events.on(\"beaconPulse\", (p: BeaconPulse) => {\n      const pl = this.player;\n      if (pl.dead || !inBeaconRange(p, pl.pos.x, pl.pos.y, pl.pos.z)) return;\n      for (const e of beaconEffects(p)) pl.addEffect(e.id, e.seconds, e.level);\n    });\n\n    this.playing = false;\n    this._time = 0;\n\n    events.on(\"ui:pause\", () => {\n      this.playing = false;\n      if (this.invUI.open) this.invUI.close();\n      this.hud.showOverlay(true);\n      void this.persist();\n    });\n    events.on(\"ui:resume\", () => {\n      this.playing = true;\n      this.hud.hideOverlay();\n    });\n    const { signal } = this._abort;\n    document.addEventListener(\n      \"keydown\",\n      (e) => {\n        if (e.code === \"Escape\" && this.invUI.open) this.invUI.close();\n      },\n      { signal },\n    );\n    // редкий случай: лок слетел, оверлея нет — клик по канвасу возвращает захват\n    canvas.addEventListener(\n      \"click\",\n      () => {\n        if (this.playing && !this.input.active && !this.input.uiOpen)\n          this.input.requestLock();\n      },\n      { signal },\n    );\n\n    // --- старт мира ---\n    this.warmupAtSpawn();\n    this.player.spawn();\n\n    this.loop = new GameLoop(this.tick.bind(this), this.frame.bind(this));\n    this.hud.showOverlay(false);\n    this.loop.start();\n\n    // «Мои миры»: открыть хранилище и продолжить последний мир, если игрок ещё не начал другой\n    void WorldStore.open().then(async (store) => {\n      if (!store) return;\n      if (this._destroyed) return store.close();\n      this.store = store;\n      const last = await store.lastPlayed().catch(() => undefined);\n      if (!last || this._worldTouched || this.playing || this._destroyed)\n        return;\n      try {\n        this.save.apply(last.save);\n        this.worldId = last.id;\n        this.worldName = last.name;\n        this.hud.message(\"Продолжаем мир «\" + last.name + \"»\", 2200);\n      } catch {\n        // повреждённый сейв не должен ломать запуск — остаёмся в стартовом мире\n      }\n    });\n  }\n\n  /** Сохранить текущий мир в «Мои миры» (без хранилища — ничего). */\n  async persist(): Promise<void> {\n    if (!this.store) return;\n    try {\n      await this.store.put({\n        id: this.worldId,\n        name: this.worldName,\n        updatedAt: Date.now(),\n        save: this.save.collect(),\n      });\n    } catch {\n      // квота/запрет хранилища: игра продолжается без автосейва\n    }\n  }\n\n  /** Открыть мир из «Моих миров». */\n  async openStoredWorld(id: string): Promise<boolean> {\n    if (!this.store) return false;\n    const w = await this.store.get(id).catch(() => undefined);\n    if (!w) return false;\n    if (id !== this.worldId) await this.persist();\n    try {\n      this.save.apply(w.save);\n    } catch {\n      return false;\n    }\n    this._worldTouched = true;\n    this.worldId = w.id;\n    this.worldName = w.name;\n    return true;\n  }\n\n  /**\n   * Мир из Мастерской: становится НОВОЙ записью в «Моих мирах» — правки игрока не трогают ни\n   * публикацию, ни прежний открытый мир (он сохраняется таким, каким его оставили).\n   * false — сейв не читается (повреждён или от несовместимой версии), мир остаётся прежним.\n   */\n  openSharedWorld(save: SaveData, name: string): boolean {\n    // persist() снимает сейв синхронно при вызове — до apply ниже, поэтому уходит именно старый мир.\n    void this.persist();\n    try {\n      this.save.apply(save);\n    } catch {\n      return false;\n    }\n    this.adoptNewWorld(name);\n    this.hud.message(\"Мир «\" + name + \"» из Мастерской\", 2200);\n    return true;\n  }\n\n  /** Мир сменился на новый (импорт сейва, новый сид, рецепт): новая запись в «Моих мирах». */\n  adoptNewWorld(name: string) {\n    this._worldTouched = true;\n    this.worldId = newWorldId();\n    this.worldName = name;\n    void this.persist();\n  }\n\n  /** Подгонка рендера под текущую раскладку канваса. Вызывается ResizeObserver'ом. */\n  _resize() {\n    const canvas = this.renderer.domElement;\n    const w = canvas.clientWidth;\n    const h = canvas.clientHeight;\n    if (w === 0 || h === 0) return; // ещё не разложено — придёт следующим замером\n\n    this.camera.aspect = w / h;\n    this.camera.updateProjectionMatrix();\n    // updateStyle=false: размерами канваса управляет CSS (#game { position: fixed; inset: 0 }),\n    // инлайновый стиль от three конфликтовал бы с ним.\n    this.renderer.setSize(w, h, false);\n  }\n\n  /** Синхронная прогенерация зоны вокруг точки (старт/телепорт/импорт). */\n  warmup(x: number, z: number) {\n    for (let i = 0; i < 200; i++) {\n      this.world.update(x, z);\n      const busy =\n        this.world.genQueue.length > 0 ||\n        [...this.world.chunks.values()].some(\n          (c) => c.generated && (c.dirty || c.waterDirty),\n        );\n      if (!busy) break;\n    }\n  }\n\n  /** Прогрузка вокруг точки спавна текущего мира (подсказка генератора). */\n  warmupAtSpawn() {\n    const s = this.world.generator.spawnHint();\n    this.warmup(s.x, s.z);\n  }\n\n  /** Пересоздание мира под источник (сид или рецепт) и измерение: регенерация/импорт/портал. */\n  rebuildWorld(source: WorldSource, dimension: DimensionId = this.dimension) {\n    this.world.clear();\n    this.world = new ChunkManager(this.scene, this.atlas, source, dimension);\n    this.dimension = dimension;\n    this.blockEntities.clear();\n    this.player.world = this.world;\n    this.entities.world = this.world;\n    this.interaction.world = this.world;\n    this.fluids.world = this.world;\n    this.fluids.clear();\n    this.interaction.breaking = null;\n    this.interaction.damage.clear(); // трещины старого мира не должны лечь на блоки нового\n    this.interaction.eating = null;\n    this.intents.clear();\n  }\n\n  /** Полностью новый мир: чистые инвентарь, сущности, время. Число — классический мир по сиду. */\n  newWorld(source: WorldSource | number) {\n    const src: WorldSource =\n      typeof source === \"number\"\n        ? { kind: \"noise\", seed: source, gen: CURRENT_GEN }\n        : // новый мир — текущего поколения (у мира из рецепта: цитадель под островом)\n          { ...source, gen: source.gen ?? CURRENT_GEN };\n    void this.persist(); // старый мир остаётся в «Моих мирах» таким, каким его оставили\n    this.dims.clear();\n    this.portals = portalsOf(null);\n    this.beyondState = {\n      initialized: false,\n      dragonKilled: false,\n      creditsShown: false,\n      gateway: null,\n    };\n    this.villagesSettled = new Set();\n    this.achievements.load([]); // достижения — у каждого мира свои, как в Minecraft\n    this.maps = new Map();\n    this.nextMapId = 1;\n    this.daysAwake = 0;\n    this.rebuildWorld(src, \"overworld\");\n    this.entities.clear();\n    this.inventory.deserialize({\n      slots: new Array(36).fill(null),\n      hotbarIndex: 0,\n    });\n    if (src.kind === \"spec\")\n      this.dayNight.setTimeOfDay(src.spec.ambience.timeOfDay);\n    else this.dayNight.resetToMorning();\n    this.warmupAtSpawn();\n    this.player.spawn();\n    const name = src.kind === \"spec\" ? src.spec.name : \"Мир \" + src.seed;\n    this.adoptNewWorld(name);\n    this.hud.message(\n      src.kind === \"spec\"\n        ? \"Мир «\" + src.spec.name + \"»\"\n        : \"Новый мир, сид \" + src.seed,\n      1800,\n    );\n  }\n\n  /**\n   * Перейти в другое измерение (портал, смерть в Пределе): текущее уходит снимком в `dims`,\n   * целевое строится из своих дифов, игрок ставится в (x, y, z) целевого измерения.\n   */\n  changeDimension(target: DimensionId, x: number, y: number, z: number) {\n    if (target === this.dimension) return;\n    this.dims.set(this.dimension, {\n      chunks: this.world.serializeDiffs(),\n      entities: this.entities.serialize(),\n      blockEntities: this.blockEntities.serialize(),\n    });\n    const saved = this.dims.get(target);\n    this.dims.delete(target);\n    this.rebuildWorld(this.world.source, target);\n    this.entities.clear();\n    if (saved) {\n      this.world.loadDiffs(saved.chunks);\n      this.entities.deserialize(\n        (saved.entities ?? []) as Parameters<EntityManager[\"deserialize\"]>[0],\n      );\n      this.blockEntities.deserialize(saved.blockEntities);\n    }\n    this.warmup(x, z);\n    this.player.pos.set(x, y, z);\n    this.player.vel.set(0, 0, 0);\n    this.player._fallDist = 0;\n    events.emit(\"dimensionChanged\", { dimension: target });\n  }\n\n  /** Смерть: вещи, броня и опыт выпадают на месте (в выживании), показывается экран смерти. */\n  _onDeath() {\n    if (this.player.mode !== \"creative\") {\n      const p = this.player.pos;\n      const inv = this.inventory;\n      for (const s of [...inv.slots, ...inv.armor])\n        if (s)\n          this.entities.spawnDrop(\n            p.x + (Math.random() - 0.5),\n            p.y + 0.5,\n            p.z + (Math.random() - 0.5),\n            s.item,\n            s.count,\n            s.dmg,\n          );\n      inv.deserialize({\n        slots: new Array(36).fill(null),\n        hotbarIndex: inv.hotbarIndex,\n      });\n      const xp = Math.min(100, this.player.xpLevel * 7);\n      if (xp > 0) this.entities.spawnXp(p.x, p.y + 0.5, p.z, xp);\n      this.player.xpLevel = this.player.xpProgress = this.player.xpTotal = 0;\n    }\n    if (this.invUI.open) this.invUI.close();\n    this.input.uiOpen = true; // до releaseLock: без паузы — вместо неё экран смерти\n    this.input.releaseLock();\n    this.hud.showDeath(this.player.lastCause);\n  }\n\n  /** Возродиться: у кровати, если она цела, иначе у точки мира; из других измерений — домой. */\n  respawnPlayer() {\n    if (!this.player.dead) return;\n    this.player.respawn(this.goHome());\n    this.hud.hideDeath();\n    this.input.uiOpen = false;\n    this.input.requestLock();\n  }\n\n  /**\n   * Домой: в верхний мир (из Пекла и Предела — сменой измерения) к кровати, если она цела, иначе к\n   * точке мира; возвращает место на полу. Возрождение и выходной портал Предела.\n   */\n  goHome(): THREE.Vector3 {\n    // якорь возрождения сильнее кровати и возвращает в СВОЁ измерение (обычно в Пекло)\n    const anchor = this.anchorHome();\n    if (anchor) return anchor;\n    const s = this.player.spawnPoint;\n    let at = new THREE.Vector3(s.x, s.y, s.z);\n    const bed = this.player.bedPos;\n    if (this.dimension !== \"overworld\")\n      this.changeDimension(\"overworld\", at.x, at.y, at.z);\n    if (bed) {\n      this.warmup(bed[0], bed[2]);\n      if (BLOCKS[this.world.getBlock(bed[0], bed[1], bed[2])]?.shape === \"bed\")\n        at = new THREE.Vector3(bed[0] + 0.5, bed[1] + 0.6, bed[2] + 0.5);\n      else {\n        this.player.bedPos = null;\n        this.hud.message(\"Ваша кровать отсутствует или заблокирована\", 2500);\n      }\n    }\n    this.warmup(at.x, at.z);\n    // точку могли застроить — поднимаемся до свободного места на рост\n    const bx = Math.floor(at.x),\n      bz = Math.floor(at.z);\n    let y = Math.floor(at.y);\n    while (\n      y < 126 &&\n      (this.world.isSolid(bx, y, bz) || this.world.isSolid(bx, y + 1, bz))\n    )\n      y++;\n    // …и опускаемся до пола: точка возрождения в воздухе — это смерть от падения сразу после неё\n    while (y > 1 && this.world.getBlock(bx, y - 1, bz) === B.air) y--;\n    at.y = y;\n    return at;\n  }\n\n  /**\n   * Портал: 4 с внутри (в креативе — сразу) → другое измерение, координаты Пекла — /8, как в\n   * Minecraft. На той стороне — ближайший портал в 16 блоках или новый; обратно — только выйдя из\n   * портала прибытия и зайдя снова.\n   */\n  _tickPortal(dt: number) {\n    const p = this.player.pos;\n    const cell = (dy: number) =>\n      this.world.getBlock(\n        Math.floor(p.x),\n        Math.floor(p.y + dy),\n        Math.floor(p.z),\n      );\n    const inBeyond = cell(0) === B.beyond_portal;\n    const inside =\n      inBeyond || [0, 1].some((dy) => cell(dy) === B.inferno_portal);\n    if (!inside || this.player.dead) {\n      this._portalT = 0;\n      this._portalLock = false;\n      return;\n    }\n    if (this._portalLock) return;\n    // портал Предела переносит сразу, как в Minecraft\n    if (inBeyond) {\n      this._portalLock = true;\n      this._beyondTravel();\n      return;\n    }\n    this._portalT += dt;\n    if (this._portalT < (this.player.mode === \"creative\" ? 0.25 : 4)) return;\n    this._portalT = 0;\n    this._portalLock = true;\n    const target: DimensionId =\n      this.dimension === \"inferno\" ? \"overworld\" : \"inferno\";\n    const k =\n      target === \"inferno\"\n        ? 1 / DIMENSIONS.inferno.scale\n        : DIMENSIONS.inferno.scale;\n    const tx = Math.floor(p.x * k),\n      tz = Math.floor(p.z * k);\n    // портал, через который уходим, — тоже известный (порталы из сейвов до реестра)\n    this._rememberPortal(\n      this.dimension,\n      Math.floor(p.x),\n      Math.floor(p.y),\n      Math.floor(p.z),\n    );\n    // свой портал на той стороне: в верхнем мире ищем в 128 блоках, в Пекле — в 16, как в Minecraft\n    const known = this._nearestPortal(\n      target,\n      tx,\n      tz,\n      target === \"overworld\" ? 128 : 16,\n    );\n    this.changeDimension(\n      target,\n      (known?.[0] ?? tx) + 0.5,\n      70,\n      (known?.[2] ?? tz) + 0.5,\n    );\n    let at = known ? findPortalNear(this.world, known[0], known[2], 2) : null;\n    if (known && !at) this._forgetPortal(target, known); // сломали — забываем\n    if (!at) {\n      if (known) this.warmup(tx, tz);\n      at =\n        findPortalNear(this.world, tx, tz, 16) ??\n        (target === \"inferno\"\n          ? buildPortal(this.world, tx, tz, 64, LAVA_SEA + 2, 110)\n          : buildPortal(this.world, tx, tz, 70, 4, 120));\n      this._rememberPortal(target, at.x, at.y, at.z);\n    }\n    this.player.pos.set(at.x + 0.5, at.y, at.z + 0.5);\n    this.player.vel.set(0, 0, 0);\n    this.player._fallDist = 0;\n    events.emit(\"portalTravel\", { dimension: target });\n  }\n\n  /** Нажатые плиты: клетка → сколько ещё держать после того, как с неё сошли (сек). */\n  private readonly _plates = new Map<string, number>();\n\n  /** Нажимные плиты: пока на плите стоит игрок или моб — сигнал; сошли — через секунду отпускает. */\n  _tickPlates(dt: number) {\n    const plate = B.stone_pressure_plate;\n    if (plate === undefined) return;\n    const on = new Set<string>();\n    // плиту жмут все, нажимные рельсы — только вагонетки\n    const mark = (x: number, y: number, z: number, cart = false) => {\n      const bx = Math.floor(x),\n        by = Math.floor(y + 0.05),\n        bz = Math.floor(z);\n      const id = this.world.getBlock(bx, by, bz);\n      if (id === plate || (cart && id === B.detector_rail))\n        on.add(bx + \",\" + by + \",\" + bz);\n    };\n    if (!this.player.dead)\n      mark(this.player.pos.x, this.player.pos.y, this.player.pos.z);\n    for (const e of this.entities.entities.values())\n      if (e.kind === \"mob\" && !e.dead) mark(e.pos.x, e.pos.y, e.pos.z);\n      else if (e.kind === \"minecart\" && !e.dead)\n        mark(e.pos.x, e.pos.y, e.pos.z, true);\n    const at = (k: string) =>\n      k.split(\",\").map(Number) as [number, number, number];\n    for (const k of on) {\n      this._plates.set(k, 1);\n      const [x, y, z] = at(k);\n      const id = this.world.getBlock(x, y, z),\n        m = this.world.getMeta(x, y, z);\n      if (id === plate && m === 0) this.world.setBlock(x, y, z, plate, 1);\n      else if (id === B.detector_rail && !(m & 0x8))\n        this.world.setBlock(x, y, z, id, m | 0x8);\n    }\n    for (const [k, left] of this._plates) {\n      if (on.has(k)) continue;\n      if (left - dt > 0) {\n        this._plates.set(k, left - dt);\n        continue;\n      }\n      this._plates.delete(k);\n      const [x, y, z] = at(k);\n      const id = this.world.getBlock(x, y, z);\n      if (id === plate) this.world.setBlock(x, y, z, plate, 0);\n      else if (id === B.detector_rail)\n        this.world.setBlock(x, y, z, id, this.world.getMeta(x, y, z) & ~0x8);\n    }\n  }\n\n  /** Портал Предела: из верхнего мира — на обсидиановую площадку Предела; из Предела — домой. */\n  _beyondTravel() {\n    if (this.dimension === \"beyond\") {\n      const s = this.player.spawnPoint;\n      this.changeDimension(\"overworld\", s.x, s.y, s.z);\n      this.player.pos.copy(this.goHome());\n      // первый выход после победы — титры\n      if (this.beyondState.dragonKilled && !this.beyondState.creditsShown) {\n        this.beyondState.creditsShown = true;\n        this.hud.showCredits();\n      }\n    } else {\n      const { x, y, z } = BEYOND_ARRIVAL;\n      this.changeDimension(\"beyond\", x + 0.5, y, z + 0.5);\n      this._arrivalPlatform();\n      if (!this.beyondState.initialized) this._initBeyond();\n    }\n    this.player.vel.set(0, 0, 0);\n    this.player._fallDist = 0;\n    events.emit(\"portalTravel\", { dimension: this.dimension });\n  }\n\n  /** Первый визит в Предел: Кристаллы на вершины колонн и дракон над островом. */\n  _initBeyond() {\n    this.beyondState.initialized = true;\n    for (const p of beyondPillars(this.world.seed))\n      this.entities.spawnMob(\"beyond_crystal\", p.x + 0.5, p.top + 2, p.z + 0.5);\n    this.entities.spawnMob(\"void_dragon\", 0, 90, 0);\n  }\n\n  /** Площадка 5×5 из обсидиана у BEYOND_ARRIVAL и воздух над ней — заново при каждом прибытии, как в Minecraft. */\n  _arrivalPlatform() {\n    const { x, y, z } = BEYOND_ARRIVAL;\n    for (let dx = -2; dx <= 2; dx++)\n      for (let dz = -2; dz <= 2; dz++) {\n        this.world.setBlock(x + dx, y - 1, z + dz, B.obsidian!);\n        for (let dy = 0; dy < 3; dy++)\n          this.world.setBlock(x + dx, y + dy, z + dz, B.air!);\n      }\n    this.player.pos.set(x + 0.5, y, z + 0.5);\n  }\n\n  /** Врата Предела с нижней клеткой в (x, y, z): две клетки врат, бедрок сверху и снизу. */\n  _placeGateway(x: number, y: number, z: number) {\n    this.world.setBlock(x, y - 1, z, B.bedrock!);\n    this.world.setBlock(x, y, z, B.beyond_gateway!);\n    this.world.setBlock(x, y + 1, z, B.beyond_gateway!);\n    this.world.setBlock(x, y + 2, z, B.bedrock!);\n  }\n\n  /** Врата на кольце вокруг главного острова — после победы (сейв до врат получает их при визите). */\n  _openGateway() {\n    const [x, y, z] = gatewaySpot(this.world.seed);\n    this.warmup(x, z); // запись в незагруженный чанк пропала бы: победа бывает далеко от врат\n    this._placeGateway(x, y, z);\n    this.beyondState.gateway = [x, y, z];\n  }\n\n  /** Идущий набег на деревню (systems/Raid) или null. Не сохраняется: перезагрузка его прекращает. */\n  raid: Raid | null = null;\n\n  /**\n   * Набег: игрок с Дурным знамением у заселённой деревни — знамение сгорает, начинается набег. Волны\n   * приходят с одного края деревни (в 28–34 блоках от центра) и идут к центру; победа — «Герой\n   * деревни» уровня знамения, поражение — все жители в 64 блоках мертвы или вышло время.\n   */\n  _tickRaid(dt: number) {\n    if (this.dimension !== \"overworld\") return;\n    const pl = this.player;\n    if (!this.raid) {\n      const omen = pl.effects.get(\"bad_omen\");\n      if (!omen || pl.dead) return;\n      const v = (\n        this.world.generator.villagesNear?.(pl.pos.x, pl.pos.z, 48) ?? []\n      ).find(\n        (x) =>\n          this.villagesSettled.has(x.id) &&\n          x.residents.some((r) => r.type.startsWith(\"villager_\")),\n      );\n      if (!v) return;\n      pl.effects.delete(\"bad_omen\");\n      events.emit(\"effectsChanged\", { id: \"bad_omen\" });\n      this.raid = new Raid({ x: v.x + 0.5, y: v.y, z: v.z + 0.5 }, omen.level);\n      events.emit(\"raidStart\", { x: v.x, z: v.z });\n      this.hud.message(\"Набег! Защитите деревню\", 3500);\n      return;\n    }\n    const r = this.raid;\n    const center = new THREE.Vector3(r.center.x, r.center.y, r.center.z);\n    let villagers = 0;\n    for (const e of this.entities.entities.values())\n      if (\n        e.kind === \"mob\" &&\n        !e.dead &&\n        e.def.trades &&\n        e.pos.distanceTo(center) < 64\n      )\n        villagers++;\n    const res = r.tick(\n      dt,\n      (id) => {\n        const e = this.entities.entities.get(id);\n        return e?.kind === \"mob\" && !e.dead;\n      },\n      villagers,\n    );\n    if (res.spawn) {\n      const a = Math.random() * Math.PI * 2;\n      for (const type of res.spawn) {\n        if (!MOBS[type]) continue;\n        const d = 28 + Math.random() * 6,\n          aa = a + (Math.random() - 0.5) * 0.4;\n        const x = Math.floor(center.x + Math.cos(aa) * d),\n          z = Math.floor(center.z + Math.sin(aa) * d);\n        this.warmup(x, z);\n        const m = this.entities.spawnMob(\n          type,\n          x + 0.5,\n          this.world.surfaceY(x, z) + 1.01,\n          z + 0.5,\n        );\n        m.raider = true;\n        m.goal = center.clone();\n        r.add(m.id, m.def.hp);\n      }\n      this.hud.message(`Набег: волна ${r.wave} из ${RAID_WAVES}`, 2500);\n      events.emit(\"raidWave\", { wave: r.wave });\n    }\n    if (res.end === \"won\") {\n      pl.addEffect(\"hero\", 2400, r.level);\n      events.emit(\"raidWon\", { level: r.level });\n      this.hud.message(\n        \"Набег отбит! Вы — герой деревни: жители уступают в цене\",\n        4500,\n      );\n      this.raid = null;\n    } else if (res.end === \"lost\") {\n      for (const id of r.raiders) {\n        const e = this.entities.entities.get(id);\n        if (e?.kind === \"mob\") {\n          e.raider = false;\n          e.goal = null;\n        }\n      }\n      events.emit(\"raidLost\");\n      this.hud.message(\"Набег: деревня пала\", 3500);\n      this.raid = null;\n    }\n  }\n\n  /** Держим, пока игрок не отойдёт от врат прибытия (иначе они сразу вернули бы его). */\n  private _gateLock = false;\n\n  /**\n   * Врата Предела: коснулся — с главного острова на внешние острова в ту же сторону (OUTER_LANDING),\n   * рядом с местом прибытия встают обратные врата; с внешних островов — к площадке прибытия.\n   */\n  _tickGateway() {\n    if (this.dimension !== \"beyond\" || this.player.dead) return;\n    const g = this.beyondState.gateway;\n    if (this.beyondState.dragonKilled && !g) this._openGateway();\n    // врата не ломаются: записаны, чанк загружен, а их нет — значит, не встали (сейв до починки)\n    else if (g && this.world.getBlockOrUnloaded(g[0], g[1], g[2]) === B.air)\n      this._placeGateway(g[0], g[1], g[2]);\n    const p = this.player.pos;\n    let touching = false;\n    for (let x = Math.floor(p.x - 0.5); x <= Math.floor(p.x + 0.5); x++)\n      for (let y = Math.floor(p.y); y <= Math.floor(p.y + 1.9); y++)\n        for (let z = Math.floor(p.z - 0.5); z <= Math.floor(p.z + 0.5); z++)\n          if (this.world.getBlock(x, y, z) === B.beyond_gateway)\n            touching = true;\n    if (!touching) {\n      this._gateLock = false;\n      return;\n    }\n    if (this._gateLock) return;\n    this._gateLock = true;\n    const toOuter = Math.hypot(p.x, p.z) < OUTER_START / 2;\n    if (!toOuter) {\n      this.warmup(BEYOND_ARRIVAL.x, BEYOND_ARRIVAL.z);\n      this._arrivalPlatform();\n    } else {\n      const a = Math.atan2(p.z, p.x);\n      const tx = Math.round(Math.cos(a) * OUTER_LANDING),\n        tz = Math.round(Math.sin(a) * OUTER_LANDING);\n      this.warmup(tx, tz);\n      const gen = this.world.generator;\n      const land =\n        gen instanceof BeyondGenerator ? gen.landingNear(tx, tz, 96) : null;\n      const x = land?.x ?? tx,\n        z = land?.z ?? tz;\n      let y = land?.y ?? ISLAND_Y;\n      if (land) {\n        this.warmup(x, z);\n        while (\n          y < 120 &&\n          (this.world.isSolid(x, y, z) || this.world.isSolid(x, y + 1, z))\n        )\n          y++;\n      } else\n        // островов рядом нет — площадка из камня Предела, как в Minecraft\n        for (let dx = -2; dx <= 2; dx++)\n          for (let dz = -2; dz <= 2; dz++)\n            this.world.setBlock(x + dx, y - 1, z + dz, B.beyond_stone!);\n      this._placeGateway(x + 3, y, z); // обратные врата у места прибытия\n      this.player.pos.set(x + 0.5, y, z + 0.5);\n      this.hud.message(\"Внешние острова Предела\", 2500);\n    }\n    this.player.vel.set(0, 0, 0);\n    this.player._fallDist = 0;\n    events.emit(\"gatewayTravel\", { outer: toOuter });\n  }\n\n  /** Дракон повержен: выходной портал в фонтане и яйцо на его колонне. */\n  _dragonDefeated() {\n    this.beyondState.dragonKilled = true;\n    for (const [x, y, z] of exitPortalCells())\n      this.world.setBlock(x, y, z, B.beyond_portal!);\n    this.world.setBlock(0, ISLAND_Y + 4, 0, B.dragon_egg!);\n    this._openGateway();\n    this.hud.message(\n      \"Дракон Предела повержен! Портал домой — в фонтане, Врата на внешние острова — за краем\",\n      4500,\n    );\n  }\n\n  /** Бросок Ока Предела: к ближайшей цитадели; в мире без цитаделей Око возвращается в руку. */\n  _throwEye(x: number, y: number, z: number) {\n    const target = this.world.generator.locate?.(\"citadel\", x, z);\n    if (!target) {\n      this.hud.message(\"Око не чувствует цитадели в этом мире\", 2200);\n      if (this.player.mode !== \"creative\") this.inventory.add(\"rim_eye\", 1);\n      return;\n    }\n    this.entities.spawnRimEye(new THREE.Vector3(x, y, z), target);\n  }\n\n  /** Запомнить портал: одна запись на портал — рядом с уже известным не дублируем. */\n  _rememberPortal(dim: DimensionId, x: number, y: number, z: number) {\n    const list = this.portals[dim];\n    const near = list.some(\n      ([px, py, pz]) =>\n        Math.abs(px - x) <= 3 && Math.abs(py - y) <= 4 && Math.abs(pz - z) <= 3,\n    );\n    if (!near) list.push([x, y, z]);\n  }\n\n  _forgetPortal(dim: DimensionId, p: readonly number[]) {\n    this.portals[dim] = this.portals[dim].filter((q) => q !== p);\n  }\n\n  /** Ближайший известный портал измерения в квадрате radius вокруг (x, z). */\n  _nearestPortal(\n    dim: DimensionId,\n    x: number,\n    z: number,\n    radius: number,\n  ): [number, number, number] | null {\n    let best: [number, number, number] | null = null;\n    let bestD = Infinity;\n    for (const q of this.portals[dim]) {\n      const dx = Math.abs(q[0] - x),\n        dz = Math.abs(q[2] - z);\n      if (dx > radius || dz > radius) continue;\n      const d = dx * dx + dz * dz;\n      if (d < bestD) {\n        best = q;\n        bestD = d;\n      }\n    }\n    return best;\n  }\n\n  /**\n   * Возрождение у заряженного якоря: переносит в его измерение, тратит один заряд. null — якоря\n   * нет, он сломан или разряжен (тогда действует обычный путь домой).\n   */\n  private anchorHome(): THREE.Vector3 | null {\n    const a = this.player.anchorPos;\n    const dim = this.player.anchorDim;\n    if (!a || !dim || !isDimensionId(dim)) return null;\n    const [x, y, z] = a;\n    if (this.dimension !== dim)\n      this.changeDimension(dim, x + 0.5, y + 1, z + 0.5);\n    this.warmup(x, z);\n    const charges =\n      this.world.getBlock(x, y, z) === B.respawn_anchor\n        ? anchorCharges(this.world.getMeta(x, y, z))\n        : 0;\n    if (charges <= 0) {\n      this.player.anchorPos = null;\n      this.player.anchorDim = null;\n      this.hud.message(\"Якорь возрождения разряжен или сломан\", 2500);\n      return null;\n    }\n    this.world.setBlock(x, y, z, B.respawn_anchor!, charges - 1);\n    // рядом с якорем, а не в нём: ищем свободную клетку вокруг\n    for (const [dx, dz] of FACING_DIRS) {\n      const nx = x + dx,\n        nz = z + dz;\n      if (!this.world.isSolid(nx, y, nz) && !this.world.isSolid(nx, y + 1, nz))\n        return new THREE.Vector3(nx + 0.5, y, nz + 0.5);\n    }\n    return new THREE.Vector3(x + 0.5, y + 1, z + 0.5);\n  }\n\n  /** ПКМ по кровати: точка возрождения; ночью без монстров рядом — сон до утра. */\n  _useBed(x: number, y: number, z: number) {\n    if (DIMENSIONS[this.dimension].bedsExplode) {\n      // в Пекле и Пределе кровать взрывается, как в Minecraft\n      this.world.setBlock(x, y, z, B.air!);\n      this.entities.explode(x + 0.5, y + 0.5, z + 0.5, 5);\n      return;\n    }\n    this.player.bedPos = [x, y, z];\n    if (this.dayNight.isDay && this.weather.kind !== \"thunder\") {\n      this.hud.message(\n        \"Спать можно только ночью или в грозу. Точка возрождения — здесь\",\n        2400,\n      );\n      return;\n    }\n    const monsters = [...this.entities.entities.values()].some(\n      (e) =>\n        e.kind === \"mob\" &&\n        !e.dead &&\n        e.def.category === \"hostile\" &&\n        e.pos.distanceTo(this.player.pos) < 8,\n    );\n    if (monsters) {\n      this.hud.message(\"Нельзя спать — рядом монстры\", 2000);\n      return;\n    }\n    this.dayNight.resetToMorning();\n    this.weather.set(\"clear\"); // сон пережидает и непогоду, как в Minecraft\n    this._slept = true;\n    this.daysAwake = 0;\n    this.hud.message(\"Доброе утро!\", 1800);\n    events.emit(\"slept\");\n  }\n\n  /** ПКМ пустой картой: карта участка вокруг игрока в руку (как в Minecraft; сразу разведан круг). */\n  createMap(): void {\n    if (this.inventory.heldItem()?.item !== \"map\") return;\n    const p = this.player.pos;\n    const m = newMap(this.nextMapId++, p.x, p.z, this.dimension);\n    this.maps.set(m.id, m);\n    for (let ph = 0; ph < 4; ph++) surveyMap(this.world, m, p.x, p.z, 48, ph);\n    const filled = { item: \"filled_map\", count: 1, tag: { map: m.id } };\n    if (this.player.mode !== \"creative\") this.inventory.consumeHeld(1);\n    const i = this.inventory.hotbarIndex;\n    if (!this.inventory.slots[i]) this.inventory.setSlot(i, filled);\n    else if (this.inventory.addStack(filled) > 0)\n      this.entities.spawnDrop(p.x, p.y + 1, p.z, \"filled_map\", 1);\n    events.emit(\"mapCreated\", { id: m.id });\n  }\n\n  _trialScanT = 0;\n  /** Спавнеры испытаний: раз в секунду завести сущности спавнерам камер рядом и шагнуть их машины. */\n  _tickTrials(dt: number): void {\n    if (this.dimension !== \"overworld\") return;\n    const p = this.player;\n    if ((this._trialScanT -= dt) <= 0) {\n      this._trialScanT = 1;\n      for (const [x, y, z] of this.world.generator.trialSpawnersNear?.(\n        p.pos.x,\n        p.pos.z,\n        48,\n      ) ?? [])\n        if (this.world.getBlockOrUnloaded(x, y, z) === B.trial_spawner)\n          this.blockEntities.ensure(x, y, z);\n    }\n    const hunter = !p.dead && p.mode !== \"creative\";\n    for (const be of this.blockEntities.map.values()) {\n      if (be.type !== \"trial_spawner\") continue;\n      const mob =\n        TRIAL_MOBS[this.world.getMeta(be.x, be.y, be.z) % TRIAL_MOBS.length]!;\n      trialStep(be.state as TrialState, {\n        dt,\n        near:\n          hunter &&\n          Math.hypot(\n            p.pos.x - be.x - 0.5,\n            p.pos.y - be.y,\n            p.pos.z - be.z - 0.5,\n          ) <= TRIAL_RANGE,\n        rng: Math.random,\n        spawn: () => this._trialSpawn(be.x, be.y, be.z, mob),\n        reward: (items) => {\n          for (const s of items)\n            this.entities.spawnDrop(\n              be.x + 0.5,\n              be.y + 1.2,\n              be.z + 0.5,\n              s.item,\n              s.count,\n            );\n          events.emit(\"trialReward\", { x: be.x, y: be.y, z: be.z });\n        },\n      });\n    }\n  }\n\n  /** Моб волны спавнера испытаний: клетка с полом и воздухом на рост в 4 блоках от спавнера. */\n  _trialSpawn(x: number, y: number, z: number, mob: string): boolean {\n    for (let i = 0; i < 10; i++) {\n      const sx = x + Math.floor(Math.random() * 9) - 4,\n        sz = z + Math.floor(Math.random() * 9) - 4;\n      for (let sy = y - 1; sy <= y + 2; sy++) {\n        if (!BLOCKS[this.world.getBlock(sx, sy - 1, sz)]?.solid) continue;\n        if (\n          this.world.getBlock(sx, sy, sz) !== 0 ||\n          this.world.getBlock(sx, sy + 1, sz) !== 0\n        )\n          continue;\n        const m = this.entities.spawnMob(mob, sx + 0.5, sy, sz + 0.5);\n        m.trialFrom = [x, y, z];\n        events.emit(\"trialSpawn\", { x, y, z, mob });\n        return true;\n      }\n    }\n    return false;\n  }\n\n  freezing = new Freezing();\n  /** Снег-порох: холод, урон, иней на экране; кожаные ботинки — снег держит (Player.leatherBoots). */\n  _tickFreeze(dt: number): void {\n    const p = this.player;\n    const armor = this.inventory.armor;\n    p.leatherBoots = () => armor.some((s) => s?.item === \"leather_boots\");\n    p.goldArmor = () => armor.some((s) => !!s?.item.startsWith(\"golden_\"));\n    // щит принял удар — теряет прочность по урону (как в Minecraft), не меньше 1\n    p.onShieldBlock = (n) => {\n      if (this.inventory.heldItem()?.item === \"shield\")\n        this.inventory.damageHeld(Math.max(1, Math.floor(n)));\n    };\n    const leather = armor.some((s) => !!s?.item.startsWith(\"leather_\"));\n    const dmg = this.freezing.tick(\n      dt,\n      p.inPowderSnow && !p.dead,\n      leather || p.mode === \"creative\",\n      p.fireT > 0,\n    );\n    if (dmg) p.damage(dmg, \"freeze\");\n    this.hud.frost(this.freezing.level);\n  }\n\n  _hornCd = 0;\n  _hornHeld = false;\n  /** Козий рог: ПКМ — протрубить (слышно далеко, будит сенсоры скалка), не чаще раза в 7 с. */\n  _goatHorn(dt: number): void {\n    this._hornCd = Math.max(0, this._hornCd - dt);\n    const press =\n      this.input.rightDown &&\n      !this.player.dead &&\n      this.inventory.heldItem()?.item === \"goat_horn\";\n    if (press && !this._hornHeld && this._hornCd <= 0) {\n      this._hornCd = 7;\n      events.emit(\"goatHorn\");\n      const p = this.player.pos;\n      if (this.dimension === \"overworld\")\n        this.sculk.vibrate(p.x, p.y, p.z, this.player.mode !== \"creative\");\n    }\n    this._hornHeld = press;\n  }\n\n  /** Скалк, вибрации и Страж (systems/Sculk.ts) — в верхнем мире. */\n  sculk = new Sculk({\n    world: () => this.world,\n    player: () => this.player,\n    wardens: () =>\n      [...this.entities.entities.values()].filter(\n        (e): e is Mob => e.kind === \"mob\" && !e.dead && !!e.def.warden,\n      ),\n    summon: (x, y, z) => {\n      const m = this.entities.spawnMob(\"warden\", x, y, z);\n      m.emergeT = EMERGE_TIME;\n      m.invulnerable = true;\n      return m;\n    },\n  });\n  /** Пройдено шагов с последней вибрации (вибрация — каждые 2 блока ходьбы без приседа). */\n  _stepDist = 0;\n  /** Где игрок умер последний раз — туда указывает компас возвращения (в сейв не пишется). */\n  lastDeath: { x: number; y: number; z: number; dim: string } | null = null;\n\n  /** Шаги игрока в верхнем мире — вибрации; наступил на крикуна — он кричит. */\n  _tickSculk(dt: number): void {\n    if (this.dimension !== \"overworld\") return;\n    this.sculk.tick(dt);\n    const p = this.player;\n    if (p.dead || p.flying || !p.onGround || p._sneaking) return;\n    this._stepDist += Math.hypot(p.vel.x, p.vel.z) * dt;\n    if (this._stepDist < 2) return;\n    this._stepDist = 0;\n    const x = Math.floor(p.pos.x),\n      y = Math.floor(p.pos.y),\n      z = Math.floor(p.pos.z);\n    if (this.world.getBlock(x, y - 1, z) === B.sculk_shrieker)\n      this.sculk.shriek(x, y - 1, z);\n    this.sculk.vibrate(p.pos.x, p.pos.y, p.pos.z, p.mode !== \"creative\");\n  }\n\n  /** Подзорная труба: ПКМ держать — поле зрения плавно сужается до 10° (как в Minecraft). */\n  _spyglass(dt: number): void {\n    const on =\n      !this.player.dead &&\n      this.input.rightDown &&\n      this.inventory.heldItem()?.item === \"spyglass\";\n    const want = on ? 10 : 75;\n    if (this.camera.fov === want) return;\n    this.camera.fov += (want - this.camera.fov) * Math.min(1, dt * 12);\n    if (Math.abs(this.camera.fov - want) < 0.1) this.camera.fov = want;\n    this.camera.updateProjectionMatrix();\n  }\n\n  /** Карта в руке дорисовывает местность вокруг игрока (четверть строк за раз). */\n  _surveyHeldMap(): void {\n    const h = this.inventory.heldItem();\n    // карта сокровищ или исследователя в руке становится картой участка с крестиком над целью:\n    // из тега {x, z}, а без него (карта картографа) — ближайшая к игроку цель такого вида\n    const kind = h ? EXPLORER_MAPS[h.item] : undefined;\n    if (h && kind) {\n      let tx = Number(h.tag?.x),\n        tz = Number(h.tag?.z);\n      if (!Number.isFinite(tx) || !Number.isFinite(tz)) {\n        if (this.dimension !== \"overworld\") return;\n        const f = this.world.generator.locate?.(\n          kind,\n          this.player.pos.x,\n          this.player.pos.z,\n        );\n        if (!f) return;\n        tx = f.x;\n        tz = f.z;\n      }\n      const m = newMap(this.nextMapId++, tx, tz, \"overworld\");\n      // карта с целью — по центру цели, а не по сетке карт: иначе ✖ бывает у самого края\n      m.x0 = Math.floor(tx) - MAP_SIZE / 2;\n      m.z0 = Math.floor(tz) - MAP_SIZE / 2;\n      m.target = [tx, tz];\n      this.maps.set(m.id, m);\n      this.inventory.setSlot(this.inventory.hotbarIndex, {\n        item: \"filled_map\",\n        count: 1,\n        tag: { map: m.id },\n      });\n      events.emit(\"mapCreated\", { id: m.id, treasure: true });\n      return;\n    }\n    if (h?.item !== \"filled_map\") return;\n    const m = this.maps.get(Number(h.tag?.map));\n    if (!m || m.dim !== this.dimension) return;\n    const p = this.player.pos;\n    surveyMap(this.world, m, p.x, p.z, 48, this._mapPhase++ & 3);\n  }\n\n  /**\n   * Ночная осада (systems/Siege): с наступлением ночи к заселённой деревне рядом с игроком выходит\n   * отряд зомби с одной стороны. Они охотятся на жителей (MobDef.huntsLand), а убитый житель встаёт\n   * зомби-жителем — так зомби-жители появляются в игре сами, без команд. Во время набега осады нет.\n   */\n  _siege() {\n    if (this.dimension !== \"overworld\" || this.raid) return;\n    const p = this.player.pos;\n    const v = (this.world.generator.villagesNear?.(p.x, p.z, 72) ?? []).find(\n      (x) =>\n        this.villagesSettled.has(x.id) &&\n        x.residents.some((r) => r.type.startsWith(\"villager_\")),\n    );\n    if (!v || !siegeTonight()) return;\n    const angle = Math.random() * Math.PI * 2;\n    let n = 0;\n    for (let i = siegeCount(); i > 0; i--) {\n      const { x, z } = siegeSpot(v.x + 0.5, v.z + 0.5, angle);\n      this.warmup(x, z);\n      const y = this.world.surfaceY(x, z);\n      if (y <= 0) continue;\n      const m = this.entities.spawnMob(\"zombie\", x + 0.5, y + 1.01, z + 0.5);\n      // цель — центр деревни: без неё отряд разбредается, не дойдя до жителей (MobBrain, huntsLand)\n      m.goal = new THREE.Vector3(v.x + 0.5, v.y, v.z + 0.5);\n      n++;\n    }\n    if (n === 0) return;\n    events.emit(\"siegeStart\", { x: v.x, z: v.z, count: n });\n    this.hud.message(\"Ночная осада! Зомби идут к деревне\", 3500);\n  }\n\n  /**\n   * Деревня рядом, в которой ещё никто не живёт: поселить жителей и голема (один раз — список в\n   * сейве). Ждёт, пока прогрузятся чанки всех домов, иначе жители упали бы сквозь незагруженное.\n   */\n  _settleVillages() {\n    // деревни верхнего мира и города Предела (панцирники) — один путь: villagesNear генератора\n    const p = this.player.pos;\n    for (const v of this.world.generator.villagesNear?.(p.x, p.z, 72) ?? []) {\n      if (this.villagesSettled.has(v.id)) continue;\n      const loaded = v.residents.every(\n        (r) =>\n          this.world.getBlockOrUnloaded(\n            Math.floor(r.x),\n            Math.floor(r.y),\n            Math.floor(r.z),\n          ) !== -1,\n      );\n      if (!loaded) continue;\n      for (const r of v.residents)\n        if (MOBS[r.type]) {\n          const m = this.entities.spawnMob(r.type, r.x, r.y + 0.01, r.z);\n          if (r.captain) m.captain = true;\n        }\n      this.villagesSettled.add(v.id);\n    }\n  }\n\n  /** Удар молнии: 5 урона всем в 3 блоках (огонь ставит сама погода). */\n  _lightning(x: number, y: number, z: number) {\n    const near = (p: THREE.Vector3) =>\n      Math.hypot(p.x - x, p.z - z) < 3 && Math.abs(p.y - y) < 4;\n    for (const e of this.entities.entities.values())\n      if (e.kind === \"mob\" && !e.dead && near(e.pos)) e.damage(5);\n    if (near(this.player.pos)) this.player.damage(5, \"lightning\");\n  }\n\n  startPlay() {\n    this.playing = true;\n    this.hud.hideOverlay();\n    this.audio.unlock();\n    this.input.requestLock();\n  }\n\n  // ---- симуляция (20 TPS) ----\n  tick(dt: number, n: number) {\n    if (!this.playing) return;\n    this.interaction.tick(dt);\n    this.player.tickHunger(dt);\n    // спавн мобов зависит от времени суток и погоды: ночью небо «гаснет» до 4, в грозу — и днём\n    const sky = DIMENSIONS[this.dimension].hasSky;\n    this.weather.tick(\n      dt,\n      sky ? this.world : null,\n      this.player.pos.x,\n      this.player.pos.z,\n    );\n    this.world.raining = sky && this.weather.raining;\n    this.world.containerAt = this._containerAt;\n    this.entities.raining = this.world.raining;\n    this.entities.skyDarken = Math.max(\n      this.dayNight.skyDarken,\n      sky ? this.weather.darken : 0,\n    );\n    this.entities.isDay = this.dayNight.isDay;\n    this.entities.tick(dt);\n    this.fluids.tick();\n    this.player.tickHazards(dt);\n    // черепаший панцирь: над водой копит 10 с Подводного дыхания — под водой их хватает на нырок\n    const wb = this.player.effects.get(\"water_breathing\");\n    if (\n      this.inventory.armor[0]?.item === \"turtle_helmet\" &&\n      !this.player.headInWater &&\n      (!wb || wb.time < 9.5)\n    )\n      this.player.addEffect(\"water_breathing\", 10);\n    this._tickPortal(dt);\n    this._tickGateway();\n    this._tickRaid(dt);\n    this._spyglass(dt);\n    this._tickSculk(dt);\n    this._goatHorn(dt);\n    this._tickFreeze(dt);\n    this._tickTrials(dt);\n    this._tickPlates(dt);\n    this.world.tick(); // onTick-блоки, запланированные и случайные тики\n    this.blockEntities.tick(dt);\n    this.dayNight.tick(dt);\n    // утром жители пополняют товар\n    const day = this.dayNight.isDay;\n    if (day && !this._wasDay) {\n      for (const e of this.entities.entities.values())\n        if (e.kind === \"mob\" && e.def.trades) e.uses = [];\n      // ещё одна ночь без сна (сон её обнуляет) — с трёх прилетают фантомы\n      this.daysAwake = this._slept ? 0 : this.daysAwake + 1;\n      this._slept = false;\n    } else if (!day && this._wasDay) this._siege(); // стемнело — может начаться осада деревни\n    this.entities.insomnia = this.daysAwake >= 3;\n    this._wasDay = day;\n    this._villageT += dt;\n    if (this._villageT >= 1) {\n      this._villageT = 0;\n      this._settleVillages();\n    }\n    this._mapT += dt;\n    if (this._mapT >= 0.25) {\n      this._mapT = 0;\n      this._surveyHeldMap();\n    }\n    events.emit(\"tick\", { n });\n    this._autosaveT += dt;\n    if (this._autosaveT >= AUTOSAVE_EVERY) {\n      this._autosaveT = 0;\n      void this.persist();\n    }\n  }\n\n  // ---- кадр ----\n  frame(dt: number, alpha: number) {\n    this._time += dt;\n\n    if (this.playing) {\n      this.music.tick(dt, this.dimension);\n      this.player.update(dt, this.input);\n      this.interaction.frame(this.input);\n      this.interaction.frameTimers(dt);\n    }\n\n    // камера из игрока\n    const eye = this.player.eyePos;\n    this.camera.position.copy(eye);\n    this.camera.rotation.set(this.player.pitch, this.player.yaw, 0);\n\n    this.world.update(this.player.pos.x, this.player.pos.z);\n    this.entities.updateVisuals(alpha, this._time);\n    this.beams.update(this.blockEntities, this._time);\n    this.displays.update(this.blockEntities, this.world);\n    this.signs.update(this.blockEntities, this.world);\n    this.banners.update(this.blockEntities, this.world);\n    this.armorStands.update(this.blockEntities);\n    this.fireworks.update(dt);\n    this.dayNight.frame(\n      this.player.pos,\n      this.player.headInLava\n        ? \"lava\"\n        : this.player.headInWater\n          ? \"water\"\n          : \"air\",\n      this.dimension,\n      this.player.effects.has(\"night_vision\"),\n      DIMENSIONS[this.dimension].hasSky ? this.weather : undefined,\n    );\n    // Тьма пульсирует: то наползает, то чуть отступает\n    if (this.player.effects.has(\"darkness\"))\n      this.dayNight.darkness(\n        0.75 + 0.25 * Math.abs(Math.sin(this._time * 1.3)),\n      );\n    this.weather.frame(\n      dt,\n      eye,\n      DIMENSIONS[this.dimension].hasSky ? this.world : null,\n    );\n\n    const walking =\n      this.playing &&\n      this.player.onGround &&\n      (this.input.forward ||\n        this.input.back ||\n        this.input.left ||\n        this.input.right);\n    this.armView.frame(dt, this.inventory, walking, this._time);\n\n    // анимация поверхности воды: медленный сдвиг repeat-текстуры\n    this.atlas.waterTexture.offset.x = this._time * 0.02;\n    this.atlas.waterTexture.offset.y = this._time * 0.013;\n\n    this.hud.frame();\n    this.invUI.frame();\n    this.renderPasses();\n  }\n\n  /** Отрисовка кадра как таковая, без шага симуляции. Вынесена из `frame`, потому что её зовёт ещё\n   *  и `capture()`: снимок обязан рисовать РОВНО то же, что игрок видит, а не свою копию проходов. */\n  private renderPasses() {\n    // Два прохода: мир, затем рука поверх него с чистым depth — иначе вплотную к блоку она уходит\n    // внутрь него. Второй проход видит только слой руки (и свет, включённый на этот слой).\n    this.renderer.shadowMap.needsUpdate = true; // тени — только в мировом проходе\n    this.renderer.render(this.scene, this.camera);\n    this.renderer.autoClear = false;\n    this.renderer.clearDepth();\n    this.camera.layers.set(ARM_LAYER);\n    this.renderer.render(this.scene, this.camera);\n    this.camera.layers.set(0);\n    this.renderer.autoClear = true;\n  }\n\n  /**\n   * Снимок экрана для кнопки «поделиться» на странице игры.\n   *\n   * ⚠ Рисует и читает В ОДИН приём. Рендерер создан без `preserveDrawingBuffer` (и так и надо —\n   * флаг стоит памяти и копии каждый кадр), поэтому к моменту, когда до канвы доберётся кто-то\n   * ещё, буфер уже очищен: `toBlob` вернёт ЧЁРНЫЙ прямоугольник, ничем не пожаловавшись.\n   */\n  async capture(): Promise<Blob | null> {\n    if (this._destroyed) return null;\n    this.renderPasses();\n    return await new Promise<Blob | null>((resolve) => {\n      this.renderer.domElement.toBlob(resolve, \"image/png\");\n    });\n  }\n\n  /** Teardown for the host: stop the loop, release the pointer, dispose GPU + observers. Called by\n   *  the module's EngineScene when the host destroys the stage. (This engine is authored as a\n   *  standalone app; the host adds this so it can live as a composable module.) */\n  destroy() {\n    // последний снимок уходит до разбора мира; дописывается транзакция уже без нас\n    void this.persist().finally(() => this.store?.close());\n    this._destroyed = true;\n    this.worldUI.hide();\n    this.loop.stop();\n    this.input.releaseLock();\n    // Шина `events` и DOM-подписки живут дольше игры: хост пересоздаёт Game после перелогина, и\n    // без этого старый экземпляр продолжал бы слушать — `E` эмитился дважды (новый инвентарь\n    // открывался и тут же закрывался), звуки двоились, весь старый мир держался в памяти.\n    this._abort.abort();\n    events.clear();\n    this.hud.dispose();\n    this.chat.dispose();\n    this.signEditor.dispose();\n    this.bookScreen.dispose();\n    this.nameEditor.dispose();\n    this.touch?.dispose();\n    this.player.dispose();\n    this.audio.dispose();\n    this._resizeObserver.disconnect();\n    this.world.clear();\n    this.renderer.dispose();\n    this.renderer.forceContextLoss();\n  }\n\n  /** Pause/resume from the host's Mode Router (only the active mode runs its loop). */\n  setRunning(running: boolean) {\n    if (running) {\n      this.input.enabled = true;\n      if (!this.loop.running) this.loop.start();\n    } else {\n      this.loop.stop();\n      this.input.releaseLock();\n      this.input.enabled = false; // клавиатура на document — не слушать, пока игрок в другом режиме\n      this.playing = false;\n    }\n  }\n}\n"
     },
     {
       "path": "module.ts",
@@ -1268,7 +1268,7 @@
     },
     {
       "path": "scene.ts",
-      "content": "import type {\n  ContentTypeHandler,\n  EngineScene,\n  ModuleAgentApi,\n  SceneMountContext,\n} from \"@idosgames/module-sdk\";\nimport { createVoxelcraftAgentApi } from \"./agent\";\nimport { createVoxelWorldContentType } from \"./workshop\";\nimport { Game, type GameOptions } from \"./main\";\nimport \"./style.css\";\n\n// VoxelCraft is a standalone vanilla-Three game with its own DOM HUD (queried by id) and its own\n// RAF loop — no React, no SDK. It becomes a composable module by (1) injecting the DOM it expects\n// into the host surface instead of relying on index.html, and (2) exposing mount/suspend/destroy.\n// Because the host surface is in the document, the game's document.getElementById(...) lookups keep\n// working unchanged — no rewrite of its HUD/input code needed.\n//\n// This is the \"engine scene with NO React panels\" branch of the contract: the module registers a\n// scene and a nav entry, and nothing else.\n\nconst VOXEL_DOM = `\n  <canvas id=\"game\"></canvas>\n  <div id=\"crosshair\"></div>\n  <div id=\"fps\"></div>\n  <div id=\"debug\"></div>\n  <div id=\"timeIndicator\"></div>\n  <div id=\"hearts\"></div>\n  <div id=\"hunger\"></div>\n  <div id=\"hotbar\"></div>\n  <div id=\"hurtFlash\"></div>\n  <div id=\"message\"></div>\n  <div id=\"invScreen\" class=\"hidden\">\n    <div class=\"invPanel\">\n      <h3 id=\"invTitle\">Inventory</h3>\n      <div class=\"craftRow\">\n        <div id=\"craftGrid\"></div>\n        <div class=\"arrow\">&rarr;</div>\n        <div id=\"craftResult\" class=\"slot result\"></div>\n      </div>\n      <div id=\"invGrid\"></div>\n      <div id=\"invHotbar\"></div>\n    </div>\n  </div>\n  <div id=\"cursorStack\" class=\"hidden\"><img draggable=\"false\" /><span class=\"count\"></span></div>\n  <div id=\"overlay\">\n    <div class=\"panel\">\n      <h1 id=\"overlayTitle\">VoxelCraft</h1>\n      <p id=\"overlayHint\">Click to play</p>\n      <div class=\"controls\">\n        <div><b>WASD</b> move, <b>Space</b> jump / swim up, <b>W W</b> sprint, <b>Shift</b> sneak</div>\n        <div><b>LMB</b> (hold) break / attack, <b>RMB</b> place block / open door</div>\n        <div><b>Wheel / 1-9</b> hotbar slot, <b>E</b> inventory &amp; 2&times;2 craft</div>\n        <div><b>RMB (hold) with food</b> eat (watch the hunger bar)</div>\n        <div><b>RMB on a workbench</b> 3&times;3 craft, <b>C</b> creative (double <b>Space</b> to fly)</div>\n        <div><b>Esc</b> pause</div>\n      </div>\n      <div class=\"buttons\">\n        <button id=\"btnWorlds\" class=\"accent\">Create world</button>\n        <button id=\"btnExport\">Export world</button>\n        <button id=\"btnImport\">Import world</button>\n        <button id=\"btnNewSeed\">New seed</button>\n      </div>\n    </div>\n  </div>\n  <div id=\"worldScreen\" class=\"hidden\">\n    <div class=\"wsPanel\">\n      <div class=\"wsHead\">\n        <button class=\"wsTab active\" data-tab=\"new\">Новый мир</button>\n        <button class=\"wsTab\" data-tab=\"mine\">Мои миры</button>\n        <button id=\"wsClose\" class=\"wsClose\" title=\"Закрыть (Esc)\">&times;</button>\n      </div>\n      <div id=\"wsNew\" class=\"wsBody\">\n        <div class=\"wsForm\">\n          <div class=\"wsLabel\">Картинки-референсы <span class=\"wsNote\">до 4, можно один объект с разных сторон</span></div>\n          <div id=\"wsDrop\" class=\"wsDrop\" title=\"Клик, перетаскивание или Ctrl+V\">\n            <div id=\"wsThumbs\" class=\"wsThumbs hidden\"></div>\n            <span id=\"wsDropHint\">Перетащите картинки, вставьте Ctrl+V или нажмите, чтобы выбрать</span>\n          </div>\n          <div class=\"wsRow\">\n            <label title=\"ИИ сам поймёт по описанию, что на картинках: объект, который надо построить из блоков, стиль или место\">\n              <input type=\"radio\" name=\"wsRead\" value=\"reference\" checked /> Образец для ИИ</label>\n            <label><input type=\"radio\" name=\"wsRead\" value=\"topdown\" /> Карта сверху</label>\n            <label><input type=\"radio\" name=\"wsRead\" value=\"mood\" /> Настроение</label>\n            <button id=\"wsClearImg\" class=\"wsLink hidden\">убрать картинки</button>\n          </div>\n          <label class=\"wsLabel\" for=\"wsText\">Описание</label>\n          <textarea id=\"wsText\" rows=\"3\" maxlength=\"600\"\n            placeholder=\"Например: тропический остров, на взлётной полосе стоит самолёт с картинок\"></textarea>\n          <div class=\"wsLabel\">Размер</div>\n          <div class=\"wsRow\">\n            <label><input type=\"radio\" name=\"wsSize\" value=\"island\" checked /> Остров 256</label>\n            <label><input type=\"radio\" name=\"wsSize\" value=\"large\" /> Большой 512</label>\n            <label><input type=\"radio\" name=\"wsSize\" value=\"infinite\" /> Бесконечный</label>\n            <label><input type=\"radio\" name=\"wsSize\" value=\"custom\" /> Свой</label>\n            <span id=\"wsCustom\" class=\"hidden\">\n              <input id=\"wsW\" type=\"number\" min=\"4\" max=\"48\" value=\"24\" /> &times;\n              <input id=\"wsD\" type=\"number\" min=\"4\" max=\"48\" value=\"24\" /> чанков\n            </span>\n          </div>\n          <div class=\"wsLabel\">Как строить</div>\n          <div class=\"wsRow\">\n            <label><input type=\"radio\" name=\"wsMode\" value=\"local\" checked /> Без ИИ</label>\n            <label id=\"wsAiLabel\"><input type=\"radio\" name=\"wsMode\" value=\"ai\" disabled /> С ИИ</label>\n            <span id=\"wsAiNote\" class=\"wsNote\"></span>\n          </div>\n          <div class=\"wsButtons\">\n            <button id=\"wsGenerate\" class=\"wsPrimary\">Сгенерировать</button>\n            <button id=\"wsLoadSpec\">Загрузить рецепт</button>\n          </div>\n          <div id=\"wsStatus\" class=\"wsStatus\"></div>\n        </div>\n        <div class=\"wsPreview\">\n          <canvas id=\"wsMap\" width=\"256\" height=\"256\"></canvas>\n          <div id=\"wsInfo\" class=\"wsInfo\">Здесь появится карта мира</div>\n          <div class=\"wsButtons\">\n            <button id=\"wsPlay\" class=\"wsPrimary\" disabled>Играть в этом мире</button>\n            <button id=\"wsSaveSpec\" disabled>Скачать рецепт</button>\n          </div>\n        </div>\n      </div>\n      <div id=\"wsMine\" class=\"wsBody hidden\"><div id=\"wsList\" class=\"wsList\"></div></div>\n    </div>\n  </div>\n`;\n\n/**\n * Сцена + debug-поверхность для агента + тип контента для Мастерской: все смотрят на ОДИН экземпляр\n * игры, который создаётся в `mount()` и обнуляется в `destroy()`. Поэтому они получают не объект, а\n * доступ к текущему `game` — иначе после пересоздания сцены держали бы ссылку на мёртвую игру.\n */\nexport function createVoxelcraft(opts: GameOptions = {}): {\n  scene: EngineScene;\n  agent: ModuleAgentApi;\n  content: ContentTypeHandler;\n} {\n  let game: Game | null = null;\n  const scene = buildScene(\n    () => game,\n    (next) => {\n      game = next;\n    },\n    opts,\n  );\n  return {\n    scene,\n    agent: createVoxelcraftAgentApi(() => game),\n    content: createVoxelWorldContentType(() => game),\n  };\n}\n\nfunction buildScene(\n  getGame: () => Game | null,\n  setGame: (game: Game | null) => void,\n  opts: GameOptions,\n): EngineScene {\n  return {\n    surface: \"fullbleed-canvas\",\n    mount(ctx: SceneMountContext): void {\n      // The game reads its elements by id from the document; provide them inside the host surface.\n      ctx.host.innerHTML = VOXEL_DOM;\n      setGame(new Game(opts));\n    },\n    activate(): void {\n      getGame()?.setRunning(true);\n    },\n    suspend(): void {\n      getGame()?.setRunning(false);\n    },\n    destroy(): void {\n      getGame()?.destroy();\n      setGame(null);\n    },\n  };\n}\n\n/** @deprecated Используйте `createVoxelcraft()` — он отдаёт ещё и поверхность для агента. */\nexport function createVoxelScene(): EngineScene {\n  return createVoxelcraft().scene;\n}\n"
+      "content": "import type {\n  ContentTypeHandler,\n  EngineScene,\n  ModuleAgentApi,\n  SceneMountContext,\n} from \"@idosgames/module-sdk\";\nimport { createVoxelcraftAgentApi } from \"./agent\";\nimport { createVoxelWorldContentType } from \"./workshop\";\nimport { Game, type GameOptions } from \"./main\";\nimport \"./style.css\";\n\n// VoxelCraft is a standalone vanilla-Three game with its own DOM HUD (queried by id) and its own\n// RAF loop — no React, no SDK. It becomes a composable module by (1) injecting the DOM it expects\n// into the host surface instead of relying on index.html, and (2) exposing mount/suspend/destroy.\n// Because the host surface is in the document, the game's document.getElementById(...) lookups keep\n// working unchanged — no rewrite of its HUD/input code needed.\n//\n// This is the \"engine scene with NO React panels\" branch of the contract: the module registers a\n// scene and a nav entry, and nothing else.\n\nconst VOXEL_DOM = `\n  <canvas id=\"game\"></canvas>\n  <div id=\"crosshair\"></div>\n  <div id=\"fps\"></div>\n  <div id=\"debug\"></div>\n  <div id=\"timeIndicator\"></div>\n  <div id=\"hearts\"></div>\n  <div id=\"hunger\"></div>\n  <div id=\"hotbar\"></div>\n  <div id=\"hurtFlash\"></div>\n  <div id=\"message\"></div>\n  <div id=\"invScreen\" class=\"hidden\">\n    <div class=\"invPanel\">\n      <h3 id=\"invTitle\">Inventory</h3>\n      <div class=\"craftRow\">\n        <div id=\"craftGrid\"></div>\n        <div class=\"arrow\">&rarr;</div>\n        <div id=\"craftResult\" class=\"slot result\"></div>\n      </div>\n      <div id=\"invGrid\"></div>\n      <div id=\"invHotbar\"></div>\n    </div>\n  </div>\n  <div id=\"cursorStack\" class=\"hidden\"><img draggable=\"false\" /><span class=\"count\"></span></div>\n  <div id=\"overlay\">\n    <div class=\"panel\">\n      <h1 id=\"overlayTitle\">VoxelCraft</h1>\n      <p id=\"overlayHint\">Click to play</p>\n      <div class=\"controls\">\n        <div><b>WASD</b> move, <b>Space</b> jump / swim up, <b>W W</b> sprint, <b>Shift</b> sneak</div>\n        <div><b>LMB</b> (hold) break / attack, <b>RMB</b> place block / open door</div>\n        <div><b>Wheel / 1-9</b> hotbar slot, <b>E</b> inventory &amp; 2&times;2 craft</div>\n        <div><b>RMB (hold) with food</b> eat (watch the hunger bar)</div>\n        <div><b>RMB on a workbench</b> 3&times;3 craft, <b>C</b> creative (double <b>Space</b> to fly)</div>\n        <div><b>Esc</b> pause</div>\n      </div>\n      <div class=\"buttons\">\n        <button id=\"btnWorlds\" class=\"accent\">Create world</button>\n        <button id=\"btnExport\">Export world</button>\n        <button id=\"btnImport\">Import world</button>\n        <button id=\"btnNewSeed\">New seed</button>\n      </div>\n    </div>\n  </div>\n  <div id=\"worldScreen\" class=\"hidden\">\n    <div class=\"wsPanel\">\n      <div class=\"wsHead\">\n        <button class=\"wsTab active\" data-tab=\"new\">Новый мир</button>\n        <button class=\"wsTab\" data-tab=\"mine\">Мои миры</button>\n        <button id=\"wsClose\" class=\"wsClose\" title=\"Закрыть (Esc)\">&times;</button>\n      </div>\n      <div id=\"wsNew\" class=\"wsBody\">\n        <div class=\"wsForm\">\n          <div class=\"wsLabel\">Картинки-референсы <span class=\"wsNote\">до 4, можно один объект с разных сторон</span></div>\n          <div id=\"wsDrop\" class=\"wsDrop\" title=\"Клик, перетаскивание или Ctrl+V\">\n            <div id=\"wsThumbs\" class=\"wsThumbs hidden\"></div>\n            <span id=\"wsDropHint\">Перетащите картинки, вставьте Ctrl+V или нажмите, чтобы выбрать</span>\n          </div>\n          <div class=\"wsRow\">\n            <label title=\"ИИ сам поймёт по описанию, что на картинках: объект, который надо построить из блоков, стиль или место\">\n              <input type=\"radio\" name=\"wsRead\" value=\"reference\" checked /> Образец для ИИ</label>\n            <label><input type=\"radio\" name=\"wsRead\" value=\"topdown\" /> Карта сверху</label>\n            <label><input type=\"radio\" name=\"wsRead\" value=\"mood\" /> Настроение</label>\n            <button id=\"wsClearImg\" class=\"wsLink hidden\">убрать картинки</button>\n          </div>\n          <label class=\"wsLabel\" for=\"wsText\">Описание</label>\n          <textarea id=\"wsText\" rows=\"3\" maxlength=\"600\"\n            placeholder=\"Например: тропический остров, на взлётной полосе стоит самолёт с картинок\"></textarea>\n          <div class=\"wsLabel\">Размер</div>\n          <div class=\"wsRow\">\n            <label><input type=\"radio\" name=\"wsSize\" value=\"island\" checked /> Остров 256</label>\n            <label><input type=\"radio\" name=\"wsSize\" value=\"large\" /> Большой 512</label>\n            <label><input type=\"radio\" name=\"wsSize\" value=\"infinite\" /> Бесконечный</label>\n            <label><input type=\"radio\" name=\"wsSize\" value=\"custom\" /> Свой</label>\n            <span id=\"wsCustom\" class=\"hidden\">\n              <input id=\"wsW\" type=\"number\" min=\"4\" max=\"48\" value=\"24\" /> &times;\n              <input id=\"wsD\" type=\"number\" min=\"4\" max=\"48\" value=\"24\" /> чанков\n            </span>\n          </div>\n          <div class=\"wsLabel\">Как строить</div>\n          <div class=\"wsRow\">\n            <label><input type=\"radio\" name=\"wsMode\" value=\"local\" checked /> Без ИИ</label>\n            <label id=\"wsAiLabel\"><input type=\"radio\" name=\"wsMode\" value=\"ai\" disabled /> С ИИ</label>\n            <span id=\"wsAiNote\" class=\"wsNote\"></span>\n          </div>\n          <div class=\"wsButtons\">\n            <button id=\"wsGenerate\" class=\"wsPrimary\">Сгенерировать</button>\n            <button id=\"wsLoadSpec\">Загрузить рецепт</button>\n          </div>\n          <div id=\"wsStatus\" class=\"wsStatus\"></div>\n        </div>\n        <div class=\"wsPreview\">\n          <canvas id=\"wsMap\" width=\"256\" height=\"256\"></canvas>\n          <div id=\"wsInfo\" class=\"wsInfo\">Здесь появится карта мира</div>\n          <div class=\"wsButtons\">\n            <button id=\"wsPlay\" class=\"wsPrimary\" disabled>Играть в этом мире</button>\n            <button id=\"wsSaveSpec\" disabled>Скачать рецепт</button>\n          </div>\n        </div>\n      </div>\n      <div id=\"wsMine\" class=\"wsBody hidden\"><div id=\"wsList\" class=\"wsList\"></div></div>\n    </div>\n  </div>\n`;\n\n/**\n * Сцена + debug-поверхность для агента + тип контента для Мастерской: все смотрят на ОДИН экземпляр\n * игры, который создаётся в `mount()` и обнуляется в `destroy()`. Поэтому они получают не объект, а\n * доступ к текущему `game` — иначе после пересоздания сцены держали бы ссылку на мёртвую игру.\n */\nexport function createVoxelcraft(opts: GameOptions = {}): {\n  scene: EngineScene;\n  agent: ModuleAgentApi;\n  content: ContentTypeHandler;\n} {\n  let game: Game | null = null;\n  const scene = buildScene(\n    () => game,\n    (next) => {\n      game = next;\n    },\n    opts,\n  );\n  return {\n    scene,\n    agent: createVoxelcraftAgentApi(() => game),\n    content: createVoxelWorldContentType(() => game),\n  };\n}\n\nfunction buildScene(\n  getGame: () => Game | null,\n  setGame: (game: Game | null) => void,\n  opts: GameOptions,\n): EngineScene {\n  return {\n    surface: \"fullbleed-canvas\",\n    mount(ctx: SceneMountContext): void {\n      // The game reads its elements by id from the document; provide them inside the host surface.\n      ctx.host.innerHTML = VOXEL_DOM;\n      setGame(new Game(opts));\n    },\n    activate(): void {\n      getGame()?.setRunning(true);\n    },\n    suspend(): void {\n      getGame()?.setRunning(false);\n    },\n    capture(): Promise<Blob | null> {\n      return getGame()?.capture() ?? Promise.resolve(null);\n    },\n    destroy(): void {\n      getGame()?.destroy();\n      setGame(null);\n    },\n  };\n}\n\n/** @deprecated Используйте `createVoxelcraft()` — он отдаёт ещё и поверхность для агента. */\nexport function createVoxelScene(): EngineScene {\n  return createVoxelcraft().scene;\n}\n"
     },
     {
       "path": "shims.d.ts",

package/registry/modules/workshop.json

@@ -39,9 +39,9 @@
     "version": "0.1.0"
   },
   "dependencies": {
-    "@idosgames/core": "0.16.0",
-    "@idosgames/module-sdk": "0.3.3",
-    "@idosgames/react": "0.2.9",
+    "@idosgames/core": "0.17.0",
+    "@idosgames/module-sdk": "0.4.0",
+    "@idosgames/react": "0.2.10",
     "react": "19.2.7"
   },
   "contentHash": "01b9b8439ce44320e7ea8a1aa0a679b3773c291c784a5999c9eab7114c80339d",

package/registry/skills/idosgames-module-contract.json

@@ -1,6 +1,6 @@
 {
   "name": "idosgames-module-contract",
   "description": "Write or modify an iDosGames feature module against the module contract in @idosgames/module-sdk: the Module manifest, ModuleContext, EngineScene (Three/Phaser/vanilla), UiPanel (React), route registration, and the shared controller-box bridge between an imperative scene and React panels. Use this whenever a developer authors a NEW module, edits an existing one (board-game, idle-rpg, voxelcraft, game-hud, workshop), or asks about defineModule, registerScene/registerPanel/registerRoute, activate/suspend, SceneMountContext, sharedUi / ctx.sharedUi.shouldDraw, ctx.events / defineTopic, ctx.content / ContentTypeHandler (letting the Workshop publish and open the game's content), ctx.navigate, the --idos-safe-* layout variables, or the {camelCase(id)}Module export convention.",
-  "content": "---\nname: idosgames-module-contract\ndescription: >-\n  Write or modify an iDosGames feature module against the module contract in @idosgames/module-sdk:\n  the Module manifest, ModuleContext, EngineScene (Three/Phaser/vanilla), UiPanel (React), route\n  registration, and the shared controller-box bridge between an imperative scene and React panels.\n  Use this whenever a developer authors a NEW module, edits an existing one (board-game, idle-rpg,\n  voxelcraft, game-hud, workshop), or asks about defineModule, registerScene/registerPanel/registerRoute,\n  activate/suspend, SceneMountContext, sharedUi / ctx.sharedUi.shouldDraw, ctx.events / defineTopic,\n  ctx.content / ContentTypeHandler (letting the Workshop publish and open the game's content),\n  ctx.navigate, the --idos-safe-* layout variables, or the {camelCase(id)}Module export convention.\n---\n\n# The module contract (@idosgames/module-sdk)\n\nA module is a manifest the host installs once. It exports `{camelCase(id)}Module` from its\n`index.ts` (e.g. `board-game` → `boardGameModule`, `idle-rpg` → `idleRpgModule`) — the host seeder\nderives the import name from the id, so this convention is required.\n\n```ts\nimport { defineModule } from \"@idosgames/module-sdk\";\n\nexport const boardGameModule = defineModule({\n  id: \"board-game\",\n  meta: { name: \"Board Game\", type: \"game\", genre: \"board\", engine: \"three\" }, // engine: three|phaser|dom\n  setup(ctx) {\n    // ctx.client (shared, authed) · ctx.events (typed cross-module bus) · ctx.sharedUi · ctx.surface\n    ctx.registerScene(createScene(box)); // rendered engine scene (optional)\n    ctx.registerPanel({ id: \"root\", slot: \"overlay\", component: RootPanel }); // React UI (optional)\n    ctx.registerRoute({ id: \"board-game\", label: \"Board\", icon: \"🎲\" }); // nav/mode entry\n  },\n});\n```\n\nOptional static field: `sharedUi: { provides?: SharedUiRole[]; requires?: SharedUiRole[] }` — see\n\"Shared chrome\" below.\n\n`meta.type` is `game | app | ai-app`; `meta.engine` is `three | phaser | dom` (`dom` = no renderer —\na pure React/DOM app module). `setup` is called ONCE with `ctx: ModuleContext`.\n\n## EngineScene (the rendered part)\n\nA scene mounts into a bare `HTMLElement` (framework-free — this is why a vanilla Three game like\nvoxelcraft fits). The host's Mode Router drives it; only the active mode runs.\n\n```ts\nconst scene: EngineScene = {\n  surface: \"fullbleed-canvas\",\n  mount(ctx: SceneMountContext) {\n    controller = new Controller(ctx.host);\n    box.set(controller);\n  },\n  activate() {\n    controller?.setRunning(true);\n  }, // became the active mode → resume RAF\n  suspend() {\n    controller?.setRunning(false);\n  }, // hidden → stop RAF (invariant: only active ticks)\n  destroy() {\n    controller?.destroy();\n  }, // permanent teardown\n};\n```\n\n`mount` takes a context object (not a bare element) so it can grow — e.g. a host-shared renderer in\nthe composition era — without breaking the contract. A scene MUST stop its RAF on `suspend`.\n\nA module that registers a scene MUST also publish its debug surface — `ctx.exposeToAgent({ state,\nactions, describeActions })` — and must NOT gate controls on Pointer Lock (unavailable in the\npreview's cross-origin iframe). Nothing inside a `<canvas>` is observable from the DOM, so without\nthe surface neither the AI Coder nor a human reviewer can tell what the game is doing. See the\n`idosgames-agent-debug-surface` skill.\n\n## UiPanel (the React part)\n\nPanels are React components the host renders inside its provider stack (client + status already\nprovided). Use `@idosgames/react` hooks (`useIDosGamesClient`, `useUserState`) — do NOT re-create\nproviders.\n\n- `slot`: `hud | sidebar | overlay | modal`.\n- `activeOnly` (default true): show only while this module's mode is active. Set `false` for shared\n  chrome that stays across every mode (e.g. a persistent HUD).\n- `overlay`/`sidebar` layers sit between the shared HUD and the nav (the host measures both), so a\n  panel positioned `absolute` inside its layer never ends up under them. Things drawn outside the\n  layers use `var(--idos-safe-top, 0px)` / `var(--idos-safe-bottom, 0px)`.\n- A `hud` panel's wrapper is `display: contents`: the panel is a direct flex child of the HUD row\n  (can `flex: 1`) and must set `pointer-events: auto` only on its controls.\n\n## Shared chrome (`sharedUi`)\n\nRoles: `currency-bar` (virtual-currency balances), `wallet` (crypto wallet entry — `LazyWalletPanel`),\n`status` (the `useStatus()` line), `account` (Log out + player ID). A module that draws one for every\nmode declares `sharedUi: { provides: [...] }` on the module object — statically, so the host resolves\nowners before any `setup()` and the answer never depends on module order.\n\n**Rule for templates: yield every role you draw yourself.** Read it once in `setup()` and close over\nthe answer (it is fixed for the session):\n\n```ts\nsetup(ctx) {\n  const chrome = {\n    wallet: ctx.sharedUi.shouldDraw(\"wallet\"),\n    balances: ctx.sharedUi.shouldDraw(\"currency-bar\"),\n    status: ctx.sharedUi.shouldDraw(\"status\"),\n  };\n  ctx.registerPanel({ id: \"root\", slot: \"overlay\", component: makeRootPanel(box, chrome) });\n}\n```\n\nHide only the SHARED pieces — genre UI (the board's stage/tile/cycle chips) always stays. Never\nwrap your UI in your own `<StatusProvider>`: the host provides ONE, and a nested one would swallow\nyour messages so the shared status line never sees them. A module that needs a role but does not\ndraw it declares `sharedUi: { requires: [\"currency-bar\"] }`. `ctx.sharedUi.ownerOf(role)` names the\nprovider (or `null`).\n\n## Events (`ctx.events`)\n\nTyped topic tokens — `defineTopic(\"<your-id>:<event>@1\", shape({ … }))` from\n`@idosgames/module-sdk`; emit only your own namespace; to listen to another module, copy its topic\nand payload descriptor from the catalog into your own `defineTopic` (never import it); declare both\nin `module.meta.json` (`events.emits` / `events.listens`). **Subscribe in `setup()`**, not in a panel\neffect — `activeOnly` panels unmount with their mode and miss events; store what arrives in a small\nstore the panel reads. Full rules and examples: **idosgames-compose-modules** (\"Signals between\nmodules\"). The string overloads (`emit(\"x\", …)`) are deprecated.\n\n## Content types (`ctx.content`) and switching modes (`ctx.navigate`)\n\nA game whose players make things (worlds, levels, skins) registers a **content type handler** so the\nshared Workshop module can publish and open them — the Workshop never imports the game:\n\n```ts\nsetup(ctx) {\n  ctx.content.registerType({\n    type: \"voxelcraft.world\",   // = a key of Workshop.ContentTypes in the title config\n    label: \"VoxelCraft world\",\n    icon: \"⛏️\",\n    modeId: \"voxelcraft\",        // route to switch to after open()\n    async listLocal() { return saves.map((s) => ({ id: s.id, name: s.name, updatedAt: s.at })); },\n    async capture(localId) {     // roles/MIME types must fit the title's content type config\n      return { files: [{ role: \"main\", contentType: \"application/json\", data: json }],\n               thumbnail: { contentType: \"image/webp\", data: webp }, suggestedTitle: name };\n    },\n    async open(content) { importSave(content.files[0].data); },\n  });\n}\n```\n\nHandlers registered in `setup()` are removed with the module; `registerType` returns an unregister\nfunction for anything dynamic. `ctx.navigate(modeId)` switches the host to another module's route\n(the Workshop uses it to jump into the game after `open`); an unknown id is ignored. Details:\n**workshop-system**.\n\n## Bridging scene ↔ panel\n\nThe scene creates its controller at `mount` (needs the canvas), but panels render before that. Share\nit with a one-slot observable and read it with `useSyncExternalStore`:\n\n```ts\nexport function createControllerBox<T>() {\n  /* get/set/subscribe */\n}\n// panel: const controller = useSyncExternalStore(box.subscribe, box.get); if (!controller) return <Loading/>;\n```\n\nFor the module's controller React context use the shared factory instead of hand-writing it:\n\n```ts\nexport const [BoardControllerProvider, useBoardController] =\n  createControllerContext<BoardController>(\"BoardController\"); // from @idosgames/react\n```\n\n## Layout and boundaries\n\nA module is one folder, `src/modules/<id>/`. It imports only its own files, the game's shared code\nin `src/shared/` and npm packages — never another module's files or host files. Talk to other\nmodules through the shared `ctx.client` (durable state) and `ctx.events` (live signals, typed\ntopics `<module-id>:<event>@<major>` declared in `module.meta.json`). A module shipped in the catalog is fully self-contained — it never uses\n`src/shared/`, so it installs into any game; a game's own module may use it, and its shared code is\ncopied into it when it is published for other creators.\n\n```\nsrc/modules/<id>/\n  index.ts           export { <camelCaseId>Module } from \"./module\";\n  module.ts          defineModule({ … })\n  module.meta.json   manifest: type (template|feature), summary, provides, tags, version, author\n  components/  game/  data/  react/   — as needed\n```\n\nEvery module carries its own `module.meta.json` (the `ModuleManifest` shape), including a game's own\nmodules. The full standard — where a new feature goes, file size, documentation — is\n**idosgames-project-structure**.\n\n## Dependencies\n\nDeclare only the module's UNIQUE deps (e.g. `phaser` for idle-rpg, `three` for board/voxel) plus the\nshared baseline (react, @idosgames/*). The platform pins shared libs identically across modules; two\nmodules must not request different versions of one package (the build allowlist rejects it).\n\nStudy a real module via `get_module {id}` (MCP) before writing a new one.\n",
+  "content": "---\nname: idosgames-module-contract\ndescription: >-\n  Write or modify an iDosGames feature module against the module contract in @idosgames/module-sdk:\n  the Module manifest, ModuleContext, EngineScene (Three/Phaser/vanilla), UiPanel (React), route\n  registration, and the shared controller-box bridge between an imperative scene and React panels.\n  Use this whenever a developer authors a NEW module, edits an existing one (board-game, idle-rpg,\n  voxelcraft, game-hud, workshop), or asks about defineModule, registerScene/registerPanel/registerRoute,\n  activate/suspend, SceneMountContext, sharedUi / ctx.sharedUi.shouldDraw, ctx.events / defineTopic,\n  ctx.content / ContentTypeHandler (letting the Workshop publish and open the game's content),\n  ctx.navigate, the --idos-safe-* layout variables, or the {camelCase(id)}Module export convention.\n---\n\n# The module contract (@idosgames/module-sdk)\n\nA module is a manifest the host installs once. It exports `{camelCase(id)}Module` from its\n`index.ts` (e.g. `board-game` → `boardGameModule`, `idle-rpg` → `idleRpgModule`) — the host seeder\nderives the import name from the id, so this convention is required.\n\n```ts\nimport { defineModule } from \"@idosgames/module-sdk\";\n\nexport const boardGameModule = defineModule({\n  id: \"board-game\",\n  meta: { name: \"Board Game\", type: \"game\", genre: \"board\", engine: \"three\" }, // engine: three|phaser|dom\n  setup(ctx) {\n    // ctx.client (shared, authed) · ctx.events (typed cross-module bus) · ctx.sharedUi · ctx.surface\n    ctx.registerScene(createScene(box)); // rendered engine scene (optional)\n    ctx.registerPanel({ id: \"root\", slot: \"overlay\", component: RootPanel }); // React UI (optional)\n    ctx.registerRoute({ id: \"board-game\", label: \"Board\", icon: \"🎲\" }); // nav/mode entry\n  },\n});\n```\n\nOptional static field: `sharedUi: { provides?: SharedUiRole[]; requires?: SharedUiRole[] }` — see\n\"Shared chrome\" below.\n\n`meta.type` is `game | app | ai-app`; `meta.engine` is `three | phaser | dom` (`dom` = no renderer —\na pure React/DOM app module). `setup` is called ONCE with `ctx: ModuleContext`.\n\n## EngineScene (the rendered part)\n\nA scene mounts into a bare `HTMLElement` (framework-free — this is why a vanilla Three game like\nvoxelcraft fits). The host's Mode Router drives it; only the active mode runs.\n\n```ts\nconst scene: EngineScene = {\n  surface: \"fullbleed-canvas\",\n  mount(ctx: SceneMountContext) {\n    controller = new Controller(ctx.host);\n    box.set(controller);\n  },\n  activate() {\n    controller?.setRunning(true);\n  }, // became the active mode → resume RAF\n  suspend() {\n    controller?.setRunning(false);\n  }, // hidden → stop RAF (invariant: only active ticks)\n  destroy() {\n    controller?.destroy();\n  }, // permanent teardown\n};\n```\n\n`mount` takes a context object (not a bare element) so it can grow — e.g. a host-shared renderer in\nthe composition era — without breaking the contract. A scene MUST stop its RAF on `suspend`.\n\nA module that registers a scene MUST also publish its debug surface — `ctx.exposeToAgent({ state,\nactions, describeActions })` — and must NOT gate controls on Pointer Lock (unavailable in the\npreview's cross-origin iframe). Nothing inside a `<canvas>` is observable from the DOM, so without\nthe surface neither the AI Coder nor a human reviewer can tell what the game is doing. See the\n`idosgames-agent-debug-surface` skill.\n\n### `capture()` — the frame for \"Take a shot and share\"\n\nidosgames.com has a **Shot** button under the game: it asks the game for one frame, puts the\nplatform's branding and a QR code on it and offers to post it. A scene answers through the optional\n`capture?(): Promise<Blob | null>`. The host (`@idosgames/app-shell`) wires the request itself —\na module only has to return a picture of its active scene.\n\n**Implement it in any scene that renders to a canvas.** Without it the host falls back to reading\nthe `<canvas>` from outside, and for WebGL that is a trap: a renderer created WITHOUT\n`preserveDrawingBuffer` (the default, and the right default — the flag costs memory and a copy every\nframe) has already cleared its buffer by the time anyone reads it, so `toBlob()` returns a **fully\nblack** image and reports nothing. The host rejects single-colour frames, so the player gets the\ngame's cover instead of their moment.\n\nRender and read in the SAME tick:\n\n```ts\n// three.js\ncapture() {\n  return new Promise((resolve) => {\n    renderer.render(scene, camera);          // draw now…\n    renderer.domElement.toBlob(resolve, \"image/png\"); // …and read before the buffer is cleared\n  });\n},\n\n// Phaser — use its own snapshot, it handles the timing\ncapture() {\n  return new Promise((resolve) => {\n    setTimeout(() => resolve(null), 1500); // no frame came (context lost) → answer \"no\", don't hang\n    game.loop.wake();                       // a sleeping loop never draws again → snapshot never fires\n    game.renderer.snapshot((image) => {\n      if (!(image instanceof HTMLImageElement)) return resolve(null);\n      const c = document.createElement(\"canvas\");\n      c.width = image.naturalWidth || image.width;\n      c.height = image.naturalHeight || image.height;\n      c.getContext(\"2d\")?.drawImage(image, 0, 0);\n      c.toBlob(resolve, \"image/png\");\n    });\n  });\n},\n```\n\nAlways answer — with a Blob or `null`. A `capture()` that never settles makes the site wait out its\ntimeout before it falls back, and the player stares at a spinner.\n\nReturn `null` when there is nothing worth showing (loading, no scene yet) — the site then uses the\ncover. Only the scene is captured, not the React panels over it: a shot for a feed reads better\nwithout the HUD. DOM-only modules (no canvas) simply omit `capture`. Working references:\n`modules/board-game` and `modules/voxelcraft` (three), `modules/idle-rpg` (Phaser).\n\n## UiPanel (the React part)\n\nPanels are React components the host renders inside its provider stack (client + status already\nprovided). Use `@idosgames/react` hooks (`useIDosGamesClient`, `useUserState`) — do NOT re-create\nproviders.\n\n- `slot`: `hud | sidebar | overlay | modal`.\n- `activeOnly` (default true): show only while this module's mode is active. Set `false` for shared\n  chrome that stays across every mode (e.g. a persistent HUD).\n- `overlay`/`sidebar` layers sit between the shared HUD and the nav (the host measures both), so a\n  panel positioned `absolute` inside its layer never ends up under them. Things drawn outside the\n  layers use `var(--idos-safe-top, 0px)` / `var(--idos-safe-bottom, 0px)`.\n- A `hud` panel's wrapper is `display: contents`: the panel is a direct flex child of the HUD row\n  (can `flex: 1`) and must set `pointer-events: auto` only on its controls.\n\n## Shared chrome (`sharedUi`)\n\nRoles: `currency-bar` (virtual-currency balances), `wallet` (crypto wallet entry — `LazyWalletPanel`),\n`status` (the `useStatus()` line), `account` (Log out + player ID). A module that draws one for every\nmode declares `sharedUi: { provides: [...] }` on the module object — statically, so the host resolves\nowners before any `setup()` and the answer never depends on module order.\n\n**Rule for templates: yield every role you draw yourself.** Read it once in `setup()` and close over\nthe answer (it is fixed for the session):\n\n```ts\nsetup(ctx) {\n  const chrome = {\n    wallet: ctx.sharedUi.shouldDraw(\"wallet\"),\n    balances: ctx.sharedUi.shouldDraw(\"currency-bar\"),\n    status: ctx.sharedUi.shouldDraw(\"status\"),\n  };\n  ctx.registerPanel({ id: \"root\", slot: \"overlay\", component: makeRootPanel(box, chrome) });\n}\n```\n\nHide only the SHARED pieces — genre UI (the board's stage/tile/cycle chips) always stays. Never\nwrap your UI in your own `<StatusProvider>`: the host provides ONE, and a nested one would swallow\nyour messages so the shared status line never sees them. A module that needs a role but does not\ndraw it declares `sharedUi: { requires: [\"currency-bar\"] }`. `ctx.sharedUi.ownerOf(role)` names the\nprovider (or `null`).\n\n## Events (`ctx.events`)\n\nTyped topic tokens — `defineTopic(\"<your-id>:<event>@1\", shape({ … }))` from\n`@idosgames/module-sdk`; emit only your own namespace; to listen to another module, copy its topic\nand payload descriptor from the catalog into your own `defineTopic` (never import it); declare both\nin `module.meta.json` (`events.emits` / `events.listens`). **Subscribe in `setup()`**, not in a panel\neffect — `activeOnly` panels unmount with their mode and miss events; store what arrives in a small\nstore the panel reads. Full rules and examples: **idosgames-compose-modules** (\"Signals between\nmodules\"). The string overloads (`emit(\"x\", …)`) are deprecated.\n\n## Content types (`ctx.content`) and switching modes (`ctx.navigate`)\n\nA game whose players make things (worlds, levels, skins) registers a **content type handler** so the\nshared Workshop module can publish and open them — the Workshop never imports the game:\n\n```ts\nsetup(ctx) {\n  ctx.content.registerType({\n    type: \"voxelcraft.world\",   // = a key of Workshop.ContentTypes in the title config\n    label: \"VoxelCraft world\",\n    icon: \"⛏️\",\n    modeId: \"voxelcraft\",        // route to switch to after open()\n    async listLocal() { return saves.map((s) => ({ id: s.id, name: s.name, updatedAt: s.at })); },\n    async capture(localId) {     // roles/MIME types must fit the title's content type config\n      return { files: [{ role: \"main\", contentType: \"application/json\", data: json }],\n               thumbnail: { contentType: \"image/webp\", data: webp }, suggestedTitle: name };\n    },\n    async open(content) { importSave(content.files[0].data); },\n  });\n}\n```\n\nHandlers registered in `setup()` are removed with the module; `registerType` returns an unregister\nfunction for anything dynamic. `ctx.navigate(modeId)` switches the host to another module's route\n(the Workshop uses it to jump into the game after `open`); an unknown id is ignored. Details:\n**workshop-system**.\n\n## Bridging scene ↔ panel\n\nThe scene creates its controller at `mount` (needs the canvas), but panels render before that. Share\nit with a one-slot observable and read it with `useSyncExternalStore`:\n\n```ts\nexport function createControllerBox<T>() {\n  /* get/set/subscribe */\n}\n// panel: const controller = useSyncExternalStore(box.subscribe, box.get); if (!controller) return <Loading/>;\n```\n\nFor the module's controller React context use the shared factory instead of hand-writing it:\n\n```ts\nexport const [BoardControllerProvider, useBoardController] =\n  createControllerContext<BoardController>(\"BoardController\"); // from @idosgames/react\n```\n\n## Layout and boundaries\n\nA module is one folder, `src/modules/<id>/`. It imports only its own files, the game's shared code\nin `src/shared/` and npm packages — never another module's files or host files. Talk to other\nmodules through the shared `ctx.client` (durable state) and `ctx.events` (live signals, typed\ntopics `<module-id>:<event>@<major>` declared in `module.meta.json`). A module shipped in the catalog is fully self-contained — it never uses\n`src/shared/`, so it installs into any game; a game's own module may use it, and its shared code is\ncopied into it when it is published for other creators.\n\n```\nsrc/modules/<id>/\n  index.ts           export { <camelCaseId>Module } from \"./module\";\n  module.ts          defineModule({ … })\n  module.meta.json   manifest: type (template|feature), summary, provides, tags, version, author\n  components/  game/  data/  react/   — as needed\n```\n\nEvery module carries its own `module.meta.json` (the `ModuleManifest` shape), including a game's own\nmodules. The full standard — where a new feature goes, file size, documentation — is\n**idosgames-project-structure**.\n\n## Dependencies\n\nDeclare only the module's UNIQUE deps (e.g. `phaser` for idle-rpg, `three` for board/voxel) plus the\nshared baseline (react, @idosgames/*). The platform pins shared libs identically across modules; two\nmodules must not request different versions of one package (the build allowlist rejects it).\n\nStudy a real module via `get_module {id}` (MCP) before writing a new one.\n",
   "references": []
 }