vimp-engine 0.10.2 → 0.11.1

package/core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "vimp-engine-core"
-version = "0.3.2"
+version = "0.4.0"
 edition = "2024"
 description = "VIMP — движковый каркас симуляции (физика, карта, снапшот-фрейминг, интерполяция/предикт/raycast-примитивы, нав-утилиты). Без wasm-bindgen — обёртки для WASM-ABI собирает game-crate."
 license = "MIT"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vimp-engine",
-  "version": "0.10.2",
+  "version": "0.11.1",
   "description": "VIMP — движок-приложение (мастер, P2P-транспорт, Worker-хост, мета, MVC-каркас клиента)",
   "license": "MIT",
   "repository": {

package/src/client/InputListener.js

@@ -26,6 +26,24 @@ export default class InputListener {
     window.addEventListener('mousedown', emitMouse);
     window.addEventListener('mousemove', emitMouse);
 
+    // указатель: один набор Pointer Events закрывает мышь, палец и стилус —
+    // это и есть поддержка смартфона. Экранные координаты сырые: в мировые
+    // их переводит CanvasManager, у которого камера и масштаб полотна.
+    // Безаргументный mouseAction выше остаётся: на нём висит скрытие курсора
+    const emitPointer = type => event =>
+      this.publisher.emit('pointerAction', {
+        type,
+        x: event.clientX,
+        y: event.clientY,
+      });
+
+    window.addEventListener('pointerdown', emitPointer('down'));
+    window.addEventListener('pointermove', emitPointer('move'));
+    window.addEventListener('pointerup', emitPointer('up'));
+    // палец, уведённый системным жестом, up не даёт — без этого змейка
+    // осталась бы разогнанной с «прижатым» указателем
+    window.addEventListener('pointercancel', emitPointer('up'));
+
     window.addEventListener('resize', () =>
       this.publisher.emit('resize', {
         width: innerWidth,

package/src/client/components/controller/CanvasManager.js

@@ -19,6 +19,11 @@ export default class CanvasManagerCtrl {
     this._model.updateCoords(x, y, cameraReset, shakeData);
   }
 
+  // экранная точка указателя -> мировая (в координатах игрового полотна)
+  toWorld(clientX, clientY) {
+    return this._view.toWorld(this._model.pointerCanvasId, clientX, clientY);
+  }
+
   // обновляет размеры
   resize(data) {
     this._model.resize(data);

package/src/client/components/controller/Controls.js

@@ -24,6 +24,11 @@ export default class ControlsCtrl {
     this._model.removeKey(event);
   }
 
+  // добавляет ввод указателем (мышь/палец)
+  addPointer(data) {
+    this._model.addPointer(data);
+  }
+
   // задает текущий режим
   switchMode(data) {
     this._model.setMode(data.name, data.status);

package/src/client/components/model/CanvasManager.js

@@ -60,6 +60,10 @@ export default class CanvasManagerModel {
 
     const canvases = data.canvases || {};
 
+    // полотно, в системе координат которого считается указатель: имя из
+    // конфига либо первое объявленное (у игры оно, как правило, одно)
+    this._pointerCanvasId = data.pointerCanvas || Object.keys(canvases)[0];
+
     for (const canvasName in canvases) {
       if (Object.hasOwn(canvases, canvasName)) {
         const canvasData = canvases[canvasName];
@@ -81,6 +85,10 @@ export default class CanvasManagerModel {
     this.publisher = new Publisher();
   }
 
+  get pointerCanvasId() {
+    return this._pointerCanvasId;
+  }
+
   // рассчитывает размеры элементов с учетом пропорций
   resize(data) {
     const screenWidth = data.width;

package/src/client/components/model/Controls.js

@@ -16,11 +16,32 @@ export default class ControlsModel {
     this._modes = data.modes;
     this._cmds = data.cmds;
 
+    this._currentKeySetIndex = 0; // индекс текущего набора клавиш
     this._currentKeySet = this._keySetList[0]; // текущий набор клавиш
     this._currentModes = {}; // статусы режимов
     this._pressedKeys = {}; // объект для хранения состояния зажатых клавиш
     this._areKeysEnabled = false; // статус возможности нажатия клавиш
 
+    // канал указателя: игра, не объявившая modules.controls.pointer, его не
+    // получает вовсе — ни одного лишнего сообщения по проводу
+    this._pointer = data.pointer
+      ? {
+          doubleTapMs: data.pointer.doubleTapMs ?? 300,
+          doubleTapPx: data.pointer.doubleTapPx ?? 40,
+          sendIntervalMs: data.pointer.sendIntervalMs ?? 50,
+          // индексы наборов клавиш, в которых указатель живой; по умолчанию
+          // все (у наблюдателя рулить нечем, но это дело игры)
+          keySets: data.pointer.keySets ?? null,
+        }
+      : null;
+
+    this._isPointerDown = false; // указатель прижат
+    this._isPointerDoubled = false; // нажатие было вторым в двойном тапе
+    this._lastTapTime = 0;
+    this._lastTapX = 0;
+    this._lastTapY = 0;
+    this._lastAimTime = 0;
+
     this.publisher = new Publisher();
   }
 
@@ -101,20 +122,117 @@ export default class ControlsModel {
   setMode(mode, status) {
     if (status === 'opened') {
       this._currentModes[mode] = true;
+
+      // иначе змейка так и ехала бы к последней точке, пока игрок набирает
+      // сообщение в чат
+      this._releasePointer(this._lastTapX, this._lastTapY);
     } else if (status === 'closed') {
       this._currentModes[mode] = false;
     }
   }
 
+  // живой ли сейчас канал указателя: те же правила, что и у клавиш —
+  // ввод разрешён, ни один режим не открыт, набор клавиш игровой
+  _isPointerLive() {
+    if (!this._pointer || this._areKeysEnabled === false) {
+      return false;
+    }
+
+    if (
+      this._currentModes.chat ||
+      this._currentModes.stat ||
+      this._currentModes.vote
+    ) {
+      return false;
+    }
+
+    const { keySets } = this._pointer;
+
+    return keySets === null || keySets.includes(this._currentKeySetIndex);
+  }
+
+  // отпускает указатель (чат открылся, набор сменился, палец ушёл)
+  _releasePointer(x, y) {
+    if (!this._isPointerDown) {
+      return;
+    }
+
+    this._isPointerDown = false;
+    this._isPointerDoubled = false;
+    this._lastAimTime = 0;
+
+    this.publisher.emit('aim', { x, y, flags: 0 });
+  }
+
+  // добавляет ввод указателем (мышь/палец/стилус)
+  //
+  // Канал живёт от нажатия до отпускания: `move` без прижатого указателя не
+  // шлётся — иначе любое движение мыши перехватывало бы управление у клавиш
+  // и грузило провод. `flags`: бит 0 — прижат, бит 1 — двойной тап.
+  addPointer({ type, x, y }) {
+    if (!this._pointer) {
+      return;
+    }
+
+    if (!this._isPointerLive()) {
+      this._releasePointer(x, y);
+
+      return;
+    }
+
+    const { doubleTapMs, doubleTapPx, sendIntervalMs } = this._pointer;
+    const now = Date.now();
+
+    if (type === 'down') {
+      // dblclick тач-устройства не гарантируют — распознаём сами: два
+      // нажатия в пределах doubleTapMs и doubleTapPx
+      const dx = x - this._lastTapX;
+      const dy = y - this._lastTapY;
+
+      this._isPointerDoubled =
+        now - this._lastTapTime <= doubleTapMs &&
+        Math.sqrt(dx * dx + dy * dy) <= doubleTapPx;
+
+      this._isPointerDown = true;
+      this._lastTapTime = now;
+      this._lastTapX = x;
+      this._lastTapY = y;
+    } else if (type === 'up') {
+      this._releasePointer(x, y);
+
+      return;
+    } else if (!this._isPointerDown) {
+      return;
+    } else if (now - this._lastAimTime < sendIntervalMs) {
+      // move приходит с частотой опроса устройства; по проводу он идёт не
+      // чаще sendIntervalMs
+      return;
+    }
+
+    this._lastAimTime = now;
+
+    this.publisher.emit('aim', {
+      x,
+      y,
+      flags: 1 | (this._isPointerDoubled ? 2 : 0),
+    });
+  }
+
   // меняет набор клавиш
   changeKeySet(key) {
+    this._currentKeySetIndex = key;
     this._currentKeySet = this._keySetList[key];
     this._pressedKeys = {};
+    this._releasePointer(this._lastTapX, this._lastTapY);
   }
 
   // задаёт возможность нажатия клавиш
   // (stat и chat доступны при любом значении)
   setKeysEnabled(isEnabled) {
     this._areKeysEnabled = isEnabled;
+
+    if (isEnabled === false) {
+      this._releasePointer(this._lastTapX, this._lastTapY);
+    }
   }
 }

package/src/client/components/model/Game.js

@@ -30,6 +30,10 @@ export default class GameModel {
       data,
       this._assets.get(constructor),
       this._dependencies.get(constructor),
+      // контекст экземпляра: id той сущности, которую рисует part. Игра
+      // сравнивает его со своим gameId (сервис localPlayer) - без этого part
+      // не может отличить своего персонажа от чужого
+      { id },
     );
 
     this._data[constructor] = this._data[constructor] || {};
@@ -47,6 +51,8 @@ export default class GameModel {
       data,
       this._assets.get(constructor),
       this._dependencies.get(constructor),
+      // у эффекта нет id: запись кадра анонимна, живёт до конца анимации
+      { id: null },
     );
 
     this._managedEffects[constructor] =

package/src/client/components/model/Lobby.js

@@ -86,10 +86,14 @@ export default class LobbyModel {
     this._emitList();
   }
 
-  // пользователь выбрал сервер — во внешнего подписчика (P2P-подключение)
+  // пользователь выбрал сервер — во внешнего подписчика (P2P-подключение).
+  // gameId едет вместе с hostId: комната может быть по другой игре, и клиент
+  // обязан активировать её ClientPlugin до подключения
   join(hostId) {
-    if (this._servers.has(hostId)) {
-      this.publisher.emit('join', hostId);
+    const server = this._servers.get(hostId);
+
+    if (server) {
+      this.publisher.emit('join', { hostId, gameId: server.gameId });
     }
   }
 

package/src/client/components/view/CanvasManager.js

@@ -30,6 +30,39 @@ export default class CanvasManagerView {
     app.renderer.resize(sizes.width, sizes.height);
   }
 
+  // переводит экранную точку (clientX/clientY указателя) в мировую
+  //
+  // Считается по фактическому состоянию сцены, а не по копии камеры: stage
+  // уже несёт и смещение, и масштаб последнего updateCoords, а
+  // getBoundingClientRect закрывает случай, когда CSS растянул полотно
+  // не один к одному с его буфером.
+  toWorld(id, clientX, clientY) {
+    const app = this._apps[id];
+
+    if (!app) {
+      return null;
+    }
+
+    const rect = app.canvas.getBoundingClientRect();
+
+    if (!rect.width || !rect.height) {
+      return null;
+    }
+
+    const px = ((clientX - rect.left) * app.canvas.width) / rect.width;
+    const py = ((clientY - rect.top) * app.canvas.height) / rect.height;
+    const { position, scale } = app.stage;
+
+    if (!scale.x || !scale.y) {
+      return null;
+    }
+
+    return {
+      x: (px - position.x) / scale.x,
+      y: (py - position.y) / scale.y,
+    };
+  }
+
   // вычисляет координаты для отображения и обновляет полотно
   updateCoords({ id, coords, scale }) {
     const app = this._apps[id];

package/src/client/lib/gameActivator.js

@@ -0,0 +1,38 @@
+// Активная игра переключается в лобби на лету: ClientPlugin выбранной игры
+// (или игры комнаты, в которую заходим) грузится в момент клика, а не один раз
+// при бутстрапе. Это возможно потому, что всё пер-игровое состояние (Factory,
+// Pixi-приложения, clientCore) появляется только на старте матча, а после
+// матча lobby-режим перезагружает страницу — лобби всегда в чистом
+// до-матчевом состоянии.
+//
+// Вынесено из main.js (бутстрап, тестами не покрывается) отдельным модулем,
+// чтобы кеш и обработка отказа проверялись юнит-тестом.
+export function createGameActivator({ gamesById, loadClientPlugin }) {
+  // gameId -> промис загрузки: кешируется именно промис, иначе два быстрых
+  // клика подряд запустили бы импорт дважды
+  const plugins = new Map();
+
+  return async function activateGame(gameId) {
+    const manifest = gamesById.get(gameId);
+
+    if (!manifest) {
+      throw new Error(`unknown game "${gameId}"`);
+    }
+
+    let pending = plugins.get(gameId);
+
+    if (!pending) {
+      pending = loadClientPlugin(manifest).catch(e => {
+        // отказ не кешируем: сеть могла моргнуть, повторный клик обязан
+        // попробовать снова, а не переигрывать ту же ошибку вечно
+        plugins.delete(gameId);
+
+        throw e;
+      });
+
+      plugins.set(gameId, pending);
+    }
+
+    return { manifest, plugin: await pending };
+  };
+}

package/src/client/lib/localPlayer.js

@@ -0,0 +1,37 @@
+// Сервис пула зависимостей `localPlayer`: отвечает part'у на один вопрос —
+// «эта сущность моя или чужая?».
+//
+// Свой gameId знает только клиентское ядро (ClientCore.my_game_id()), а part
+// получает id своего экземпляра четвёртым аргументом конструктора
+// (GameModel.create → { id }). Свести одно с другим внутри игры было нечем:
+// поэтому сервис общий, а не переизобретается каждой игрой заново.
+//
+// Читает id ЛЕНИВО, на каждый вызов: player-блок приходит только с первым
+// бинарным кадром, а сущности создаются раньше — из FIRST_SHOT_DATA. Флаг,
+// вычисленный в конструкторе part'а, был бы для своего же персонажа ложным.
+//
+// getCore — геттер ядра, а не само ядро: ядро создаётся позже пула сервисов и
+// пересоздаётся на смене игры.
+export function createLocalPlayer(getCore) {
+  return {
+    // свой gameId или null, пока player-блок не пришёл (ядро отдаёт -1)
+    get id() {
+      const id = getCore()?.my_game_id?.();
+
+      return typeof id === 'number' && id >= 0 ? id : null;
+    },
+
+    // id сущности приходит в part ключом объекта кадра, то есть СТРОКОЙ —
+    // сравнение приводит обе стороны к строке, иначе '3' !== 3 и звук своего
+    // персонажа не отличить от чужого
+    is(id) {
+      const my = this.id;
+
+      if (my === null || id === null || id === undefined) {
+        return false;
+      }
+
+      return String(id) === String(my);
+    },
+  };
+}

package/src/client/main.js

@@ -31,11 +31,12 @@ import {
   mergeRoomDefaults,
   reportFormValidity,
 } from './lib/formBuilder.js';
-import { getHostGateState } from './lib/hostGate.js';
+import { createGameActivator } from './lib/gameActivator.js';
 import createAutostart from './lib/autostart.js';
 import { getBootConfig, resolveBootConfig } from './boot.js';
 import { ensureGameShell, ensureCanvas } from './views/gameShell.js';
 import { createContextTracker } from './lib/contextTracker.js';
+import { createLocalPlayer } from './lib/localPlayer.js';
 import { createDebugApi, debugLog, DEBUG_PREFIX } from './debug.js';
 import { buildClientCoreConfig } from '../lib/clientCoreConfig.js';
 import {
@@ -79,18 +80,36 @@ import lobbyConfig from '../config/lobby.js';
 import authClientConfig from '../config/authClient.js';
 import clientDefaults from '../config/clientDefaults.js';
 
-// Динамическая загрузка игры по каталогу мастера (Этап 6.3): активная для
-// host остаётся первой записью каталога (граница lobby-page-plan — динамика
-// загрузки ClientPlugin выбранной игры откладывается до появления второй
-// игры), но сам каталог манифестов (gamesManifest) теперь используется
-// целиком — селектором игр и Leaderboard (populateGameSelect/gamesById в
-// initLobby). ClientPlugin (parts, bakers, игровой CSS, хуки ядра) грузится
-// по entries.client её манифеста — движок больше не импортирует игру статически
+// Динамическая загрузка игры по каталогу мастера (Этап 6.3): ClientPlugin
+// (parts, bakers, игровой CSS, хуки ядра) грузится по entries.client манифеста
+// — движок не импортирует игру статически. Первой активируется gamesManifest[0]
+// (или boot.gameId), но активная игра не заморожена: выбор в #lobby-game и
+// вход в чужую комнату переключают её через gameActivator (см. bindActiveGame).
+// Переключение безопасно ровно до старта матча: всё пер-игровое состояние
+// (Factory, Pixi-приложения, clientCore, звук) появляется только в CONFIG_DATA,
+// а после матча lobby-режим перезагружает страницу
 let activeGameManifest;
 let clientPlugin;
-let parts;
 let gamesManifest;
 
+// узел игрового CSS: при переключении игры его текст заменяется, иначе стили
+// двух игр жили бы в head одновременно и конфликтовали селекторами
+let gameStyleNode = null;
+
+// единственная точка присвоения активной игры — и в бутстрапе, и при
+// переключении в лобби
+function bindActiveGame(manifest, plugin) {
+  activeGameManifest = manifest;
+  clientPlugin = plugin;
+
+  if (!gameStyleNode) {
+    gameStyleNode = document.createElement('style');
+    document.head.append(gameStyleNode);
+  }
+
+  gameStyleNode.textContent = plugin.styles ?? '';
+}
+
 // режим загрузки (Этап 2 плана standalone-sdk): lobby — прод с мастером,
 // solo — хост в этой же вкладке (standalone SDK), dedicated — прямой WS к
 // Node-серверу. Ветвлений ровно пять: манифест, сигналинг/лобби, транспорт,
@@ -137,12 +156,10 @@ try {
     throw new Error('master has no games in its catalog');
   }
 
-  clientPlugin = boot.clientPlugin ?? (await loadClientPlugin(activeGameManifest));
-  parts = clientPlugin.parts;
-
-  const gameStyle = document.createElement('style');
-  gameStyle.textContent = clientPlugin.styles;
-  document.head.append(gameStyle);
+  bindActiveGame(
+    activeGameManifest,
+    boot.clientPlugin ?? (await loadClientPlugin(activeGameManifest)),
+  );
 } catch (e) {
   document.body.textContent = `Failed to load the game: ${e.message}`;
   throw e;
@@ -260,6 +277,10 @@ const socketMethods = []; // методы для обработки сокет-
 // получении конфига; wasm — результат init() для zero-copy чтения памяти
 let clientCore = null;
 let wasm = null;
+
+// сервис пула зависимостей: «эта сущность моя или чужая?». Ядро читается
+// геттером — оно создаётся позже пула сервисов (см. lib/localPlayer.js)
+const localPlayer = createLocalPlayer(() => clientCore);
 let inputSeq = 0; // номер отправленного ввода (KEYS_DATA)
 
 // обратный индекс снапшот-схемы игры (CONFIG_DATA.snapshot):
@@ -291,7 +312,7 @@ socketMethods[PS_CONFIG_DATA] = async data => {
 
   // инициализация сущностей игры
   for (const entity of Object.keys(entitiesOnCanvas)) {
-    Factory.add({ [entity]: parts[entity] });
+    Factory.add({ [entity]: clientPlugin.parts[entity] });
   }
 
   gameInformer = document.getElementById(data.gameInform.id);
@@ -345,6 +366,10 @@ socketMethods[PS_CONFIG_DATA] = async data => {
     const availableServices = {
       renderer: app.renderer,
       soundManager,
+      // «свой ли это персонаж»: part сравнивает id своего экземпляра (четвёртый
+      // аргумент конструктора) со своим gameId. Игра без этого сервиса звучит
+      // одинаково за всех — чужие подборы и чужие смерти вперемешку со своими
+      localPlayer,
       // база ассетов игры — тем же каналом, что и путь к звукам (см. выше):
       // картинки карт живут в пакете игры (dist/img/), движок их не раздаёт.
       // part, объявивший сервис в componentDependencies, строит URL сам —
@@ -912,6 +937,10 @@ function runModules(data) {
     'mouseAction',
     modules.controls.resetCursorHideTimer.bind(modules.controls),
   );
+  inputListener.publisher.on(
+    'pointerAction',
+    modules.controls.addPointer.bind(modules.controls),
+  );
   inputListener.publisher.on(
     'resize',
     modules.canvasManager.resize.bind(modules.canvasManager),
@@ -955,6 +984,25 @@ function runModules(data) {
 
     sending(PC_KEYS_DATA, `${inputSeq}:${data}`);
   });
+
+  // указатель: экранная точка -> мировая (камера и масштаб полотна знает
+  // только движок), дальше тем же портом, что и клавиши
+  controlsModel.publisher.on('aim', ({ x, y, flags }) => {
+    const world = modules.canvasManager.toWorld(x, y);
+
+    if (!world) {
+      return;
+    }
+
+    const wx = Math.round(world.x * 100) / 100;
+    const wy = Math.round(world.y * 100) / 100;
+
+    inputSeq = (inputSeq + 1) >>> 0;
+    clientCore?.apply_aim?.(wx, wy, flags, performance.now());
+
+    // формат wire: 'seq:aim:x:y:flags' рядом с 'seq:action:name'
+    sending(PC_KEYS_DATA, `${inputSeq}:aim:${wx}:${wy}:${flags}`);
+  });
   chatModel.publisher.on('socket', handleChatSend);
   voteModel.publisher.on('socket', data => sending(PC_VOTE_DATA, data));
 
@@ -1796,13 +1844,62 @@ function populateRoomForm(manifest) {
   }
 }
 
-// каталог манифестов по id (lobby-page-plan): достаточно для формы и
-// leaderboard селектора игр — активная игра для host остаётся
-// gamesManifest[0] (граница задачи, plan/lobby-page-plan.md)
+// каталог манифестов по id: форма и leaderboard селектора игр, а также
+// активация игры перед созданием комнаты и входом в чужую
 const gamesById = new Map(gamesManifest.map(manifest => [manifest.id, manifest]));
 
-// заполняет #lobby-game всем каталогом манифестов мастера (lobby-page-plan) —
-// раньше туда попадал только gamesManifest[0], теперь селектор рабочий
+// ClientPlugin выбранной игры грузится в момент клика (создание комнаты /
+// вход в комнату), а не при смене селектора: просмотр каталога не должен
+// качать бандлы игр, в которые не станут играть
+const activateGame = createGameActivator({ gamesById, loadClientPlugin });
+
+// строка отказа в форме лобби: загрузка плагина восстановима (другая игра,
+// повторный клик), поэтому #tech-informer не годится — он кроет вкладку
+// непрозрачным слоем под терминальные причины
+function showLobbyError(text) {
+  const elem = document.getElementById(lobbyConfig.elems.errorId);
+
+  if (elem) {
+    elem.textContent = text;
+    elem.style.display = '';
+  }
+}
+
+function clearLobbyError() {
+  const elem = document.getElementById(lobbyConfig.elems.errorId);
+
+  if (elem) {
+    elem.textContent = '';
+    elem.style.display = 'none';
+  }
+}
+
+// активирует игру и перепривязывает манифест/плагин/CSS; false — отказ уже
+// показан игроку, лобби остаётся рабочим
+async function selectActiveGame(gameId) {
+  if (gameId === activeGameManifest.id) {
+    return true;
+  }
+
+  try {
+    const { manifest, plugin } = await activateGame(gameId);
+
+    bindActiveGame(manifest, plugin);
+    clearLobbyError();
+
+    return true;
+  } catch (e) {
+    console.error(`[game] failed to activate "${gameId}":`, e);
+    showLobbyError(
+      `Failed to load ${gamesById.get(gameId)?.title ?? gameId}: ${e.message}`,
+    );
+
+    return false;
+  }
+}
+
+// заполняет #lobby-game всем каталогом манифестов мастера — раньше туда
+// попадал только gamesManifest[0], теперь селектор рабочий
 function populateGameSelect() {
   const gameSelect = document.getElementById(lobbyConfig.elems.gameId);
 
@@ -1853,8 +1950,16 @@ function initLobby() {
     lobbyModel.resolvePong(msg.pingId, performance.now());
   });
 
-  // выбор сервера → установка P2P
-  lobbyModel.publisher.on('join', connectToHost);
+  // выбор сервера → активация игры комнаты и установка P2P. gameId нет у
+  // хостов старше 6.4 — тогда заходим на активной игре, как раньше: неизвестная
+  // версия не повод запретить вход
+  lobbyModel.publisher.on('join', async ({ hostId, gameId }) => {
+    if (gameId && gamesById.has(gameId) && !(await selectActiveGame(gameId))) {
+      return;
+    }
+
+    connectToHost(hostId);
+  });
 
   // Leaderboard (lobby-page-plan): контроллер сигнализирует, для какой игры
   // нужны свежие данные (смена #lobby-game или первое открытие вкладки).
@@ -1896,9 +2001,8 @@ function initLobby() {
   populateRoomForm(activeGameManifest);
   lobby.gameChanged(activeGameManifest.id, activeGameManifest.title);
 
-  // селектор игр (lobby-page-plan): работает с каталогом манифестов — меняет
-  // форму создания комнаты и Leaderboard, но НЕ активную игру для host
-  // (граница задачи, см. plan/lobby-page-plan.md)
+  // селектор игр: меняет форму создания комнаты и Leaderboard сразу
+  // (синхронно, без сети); сама игра активируется уже по клику
   const gameSelect = document.getElementById(lobbyConfig.elems.gameId);
 
   const hostBtn = document.getElementById(lobbyConfig.elems.hostBtnId);
@@ -1912,47 +2016,47 @@ function initLobby() {
 
     populateRoomForm(manifest);
     lobby.gameChanged(manifest.id, manifest.title);
-
-    if (hostBtn) {
-      const { disabled, title } = getHostGateState(manifest.id, activeGameManifest);
-
-      hostBtn.disabled = disabled;
-      hostBtn.title = title;
-    }
+    clearLobbyError();
   });
 
   const nameInput = document.getElementById(lobbyConfig.elems.nameId);
 
-  hostBtn?.addEventListener('click', () => {
-    // защита в глубину поверх hostBtn.disabled (code review lobby-page): клик
-    // не должен создать комнату с полями формы чужой игры, даже если
-    // disabled почему-то не выставился/был обойдён
-    if (gameSelect && getHostGateState(gameSelect.value, activeGameManifest).disabled) {
-      return;
-    }
-
+  hostBtn?.addEventListener('click', async () => {
     // нативная валидация (pattern/required) — единственная граница
     // room-формы: она едет клиенту как JSON манифеста, JS-валидаторы
     // (как в auth-форме) туда не сериализуются (docs/en/plugin-api.md
     // "Form schema"); авторитетный клампинг всё равно в applyRoomOverrides.js
-    // (вызывается из host.worker.js при создании комнаты)
+    // (вызывается из host.worker.js при создании комнаты). Проверяем до
+    // активации игры: неверная форма не должна стоить загрузки плагина
     if (
       !reportFormValidity(document.getElementById(lobbyConfig.elems.fieldsId))
     ) {
       return;
     }
 
+    const manifest = gamesById.get(gameSelect?.value) ?? activeGameManifest;
     const name =
       (nameInput?.value || '').trim() || lobbyConfig.create.defaultName;
-    const { roomDefaults } = activeGameManifest;
 
-    // дефолты манифеста перекрываются значениями сгенерированных полей
-    const overrides = { ...roomDefaults };
+    // значения формы снимаем до await: активация асинхронна, а roomFormFields
+    // пересобираются при смене игры — в комнату должно уехать то, что игрок
+    // видел в момент клика
+    const overrides = { ...manifest.roomDefaults };
 
     for (const [key, field] of roomFormFields) {
       overrides[key] = field.getValue();
     }
 
+    // повторный клик, пока грузится плагин, не должен поднять вторую комнату;
+    // при успехе лобби закрывается, разблокировка нужна только на отказе
+    hostBtn.disabled = true;
+
+    if (!(await selectActiveGame(manifest.id))) {
+      hostBtn.disabled = false;
+
+      return;
+    }
+
     connectAsHost({
       name,
       hostSocketId: lobbyConfig.create.hostSocketId,

package/src/client/style.css

@@ -619,6 +619,14 @@ body.hide-cursor {
   margin: 16px auto 0;
 }
 
+#lobby-error {
+  margin: 8px 0 0;
+  color: #d98282;
+  font-size: 12px;
+  line-height: 16px;
+  text-align: center;
+}
+
 #lobby-search {
   display: block;
   width: 100%;

package/src/client/views/gameShell.js

@@ -115,6 +115,9 @@ export function ensureCanvas(canvasId, size, container = document.body) {
     canvas.setAttribute('id', canvasId);
     canvas.width = size.width;
     canvas.height = size.height;
+    // палец на полотне ведёт игру, а не страницу: без этого браузер
+    // смартфона забирает жест себе — прокрутка, pull-to-refresh, зум
+    canvas.style.touchAction = 'none';
     container.appendChild(canvas);
   }
 

package/src/client/views/includes/lobby.pug

@@ -27,6 +27,11 @@ div#lobby(style='display:none')
         //- манифеста активной игры (docs/en/plugin-api.md "Form schema")
         div#lobby-fields
         input#lobby-host(type='button', value='Create server')
+        //- отказ загрузки плагина выбранной игры: восстановим (другая игра,
+        //- повторный клик), поэтому строкой в форме, а не #tech-informer —
+        //- тот кроет вкладку непрозрачным слоем и рассчитан на терминальные
+        //- причины
+        p#lobby-error(style='display:none')
     //- правая панель: вкладки Active Servers / Leaderboard (lobby-page-plan)
     div#lobby-browser-panel.card
       //- абсолютный слой: высоту .card задаёт форма слева (stretch), а

package/src/config/lobby.js

@@ -77,9 +77,11 @@ export default {
     emptyId: 'lobby-empty',
     nameId: 'lobby-name',
     hostBtnId: 'lobby-host',
-    // селектор игры (lobby-page-plan): заполняется всем каталогом мастера,
-    // выбор меняет активную форму/leaderboard, но не активную игру для host
-    // (граница задачи — см. plan/lobby-page-plan.md)
+    // строка отказа под кнопкой: загрузка ClientPlugin выбранной игры может
+    // не удаться, и лобби обязано остаться рабочим
+    errorId: 'lobby-error',
+    // селектор игры: заполняется всем каталогом мастера, выбор задаёт и
+    // форму/leaderboard, и игру, которая поднимется по «Create server»
     gameId: 'lobby-game',
     // контейнер полей комнаты: генерируются по ключам roomDefaults
     // манифеста активной игры (Д7) — движок не знает игровых полей

package/src/config/master.js

@@ -24,8 +24,11 @@ export default {
   // не в packages/engine — vimp-engine остаётся game-agnostic и не тянет
   // конкретную игру за собой (кодревью Этапов A, находка F1). Версию задаёт
   // именно эта зависимость, каталог берёт её из dist/manifest.json пакета.
-  // В проде список переопределяется переменной окружения GAMES_MATRIX (JSON),
-  // см. master/main.js
+  // Список переопределяется переменной окружения GAMES_MATRIX (JSON) — её
+  // задаёт деплой; вне прода каталог вдобавок дополняется собранными
+  // пакетами @vimp-games/* из node_modules (master/localGames.js), чтобы
+  // прилинкованная игра попадала в лобби без правки этого массива: он
+  // публикуется вместе с пакетом vimp-engine
   games: [{ id: 'tanks', package: '@vimp-games/tanks' }],
 
   // список серверов (GET /servers)
@@ -40,7 +43,11 @@ export default {
   // ограничения регистрируемых комнат
   host: {
     maxNameLength: 30, // длина имени комнаты
-    maxPlayersLimit: 8, // целевой размер комнаты (рамка P2P-плана)
+    // санитарная рамка вместимости комнаты для случая, когда игра комнаты
+    // неизвестна мастеру (gameId: null у старых хостов или id не из
+    // каталога). Потолок известной игры задаёт её манифест
+    // (roomDefaults.maxPlayers) — движок его не ограничивает
+    maxPlayersLimit: 8,
     heartbeatTimeout: 30000, // нет heartbeat дольше — комната удаляется
     sweepInterval: 10000, // период проверки протухших комнат
   },

package/src/devtools/ScenarioRunner.js

@@ -363,6 +363,23 @@ async function applyOp(op, ctx) {
       break;
     }
 
+    case 'aim': {
+      const entry = requireEntry(byParticipant, op.who);
+      const seq = (inputSeq.get(op.who) ?? 0) + 1;
+      const flags = op.flags ?? 1;
+
+      inputSeq.set(op.who, seq);
+      host.updateKeys(entry.gameId, `${seq}:aim:${op.x}:${op.y}:${flags}`);
+
+      // клиент предсказывает тот же ввод — как и с клавишами, иначе дрейф
+      // предикта не с чем сравнивать
+      clients
+        .get(entry.socketId)
+        ?.core.apply_aim?.(op.x, op.y, flags, virtualClock.monotonic());
+
+      break;
+    }
+
     case 'chat':
       host.pushMessage(requireEntry(byParticipant, op.who).gameId, op.text);
       break;

package/src/devtools/contract/rules/b7-chat-commands.js

@@ -1,15 +1,13 @@
 import { ERROR, skip, verdict } from '../result.js';
 
-// Движковые команды разбираются switch'ем раньше реестра игровых
-// (CommandProcessor.parseCommand): одноимённая команда плагина
-// регистрируется, но не вызывается никогда.
-const RESERVED = ['/name', '/nr', '/timeleft', '/mapname', '/rank'];
-
+// Своих команд у движка нет: реестр CommandProcessor наполняет только игра,
+// поэтому зарезервированных имён не существует. Проверяем форму: ведущий слэш
+// и отсутствие дублей — вторая регистрация одного имени молча затирает первую.
 export default {
   id: 'B7',
   name: 'chatCommands',
   level: ERROR,
-  title: 'chat commands do not shadow the engine commands',
+  title: 'chat commands are well-formed and unique',
 
   check(ctx) {
     const commands = ctx.hostPlugin?.chatCommands;
@@ -31,10 +29,8 @@ export default {
         continue;
       }
 
-      if (RESERVED.includes(name)) {
-        violations.push(
-          `chat command "${name}" is an engine command — it will never fire`,
-        );
+      if (typeof command.handler !== 'function') {
+        violations.push(`chat command "${name}" has no handler function`);
       }
 
       if (seen.has(name)) {

package/src/devtools/contract/rules/c4-component-dependencies.js

@@ -1,9 +1,9 @@
 import { ERROR, skip, verdict } from '../result.js';
 
-// Пул сервисов клиента ровно из трёх имён (client/main.js). Незнакомое имя
+// Пул сервисов клиента ровно из четырёх имён (client/main.js). Незнакомое имя
 // не ошибка для движка: part получает undefined и рисует пустоту — карта
 // без assetsBase выглядит как чистый холст без единой строки в консоли.
-const SERVICES = ['renderer', 'soundManager', 'assetsBase'];
+const SERVICES = ['renderer', 'soundManager', 'assetsBase', 'localPlayer'];
 
 export default {
   id: 'C4',

package/src/host/DebugRecorder.js

@@ -112,6 +112,10 @@ export default class DebugRecorder {
     this._pushFor(gameId, who => ({ op: 'key', who, action, name }));
   }
 
+  noteAim(gameId, x, y, flags) {
+    this._pushFor(gameId, who => ({ op: 'aim', who, x, y, flags }));
+  }
+
   noteChat(gameId, text) {
     this._pushFor(gameId, who => ({ op: 'chat', who, text }));
   }

package/src/host/GameCoreAdapter.js

@@ -88,6 +88,14 @@ export default class GameCoreAdapter {
     this._core.apply_input(gameId, seq, action, name);
   }
 
+  // ввод указателем: мировая точка + биты состояния (бит 0 — прижат,
+  // бит 1 — двойной тап). У трейта дефолтная пустая реализация, но ядро
+  // игры, собранное против крейта старше 0.4, метода не экспортирует
+  // вовсе — такой игре канал просто не доезжает, вместо падения хоста
+  applyAim(gameId, seq, x, y, flags) {
+    this._core.apply_aim?.(gameId, seq, x, y, flags);
+  }
+
   // ***** запросы состояния ***** //
 
   isAlive(gameId) {

package/src/host/HostGame.js

@@ -870,7 +870,9 @@ export default class HostGame {
     // финальная синхронизация rank/state перед уходом участника (Этап B4)
     this._playerDataSync
       .flush(gameId)
-      .catch(err => console.warn('[playerData] final flush failed:', err.message))
+      .catch(err =>
+        console.warn('[playerData] final flush failed:', err.message),
+      )
       .finally(() => this._playerDataSync.removeUser(gameId));
 
     // если не наблюдатель — удалить танк из ядра (null-маркер ставит ядро)
@@ -883,7 +885,8 @@ export default class HostGame {
     this._chat.pushSystem('USER_LEFT', [user.name]);
   }
 
-  // обновляет команды (формат wire: 'seq:action:name')
+  // обновляет команды (формат wire: 'seq:action:name', указатель —
+  // 'seq:aim:x:y:flags')
   updateKeys(gameId, keyStr) {
     const user = this._participants.get(gameId);
 
@@ -891,7 +894,33 @@ export default class HostGame {
       return;
     }
 
-    const [seq, action, name] = keyStr.split(':');
+    const [seq, action, name, aimY, aimFlags] = keyStr.split(':');
+
+    // ввод указателем: наблюдателю рулить нечем, живому актору — мировая
+    // точка и биты состояния указателя
+    if (action === 'aim') {
+      this._recorder?.noteAim(
+        gameId,
+        Number(name),
+        Number(aimY),
+        Number(aimFlags) >>> 0,
+      );
+
+      user.lastActionTime = clock.now();
+      user.lastInputSeq = Number(seq) >>> 0;
+
+      if (user.isWatching !== true) {
+        this._game.applyAim(
+          gameId,
+          user.lastInputSeq,
+          Number(name),
+          Number(aimY),
+          Number(aimFlags) >>> 0,
+        );
+      }
+
+      return;
+    }
 
     this._recorder?.noteKey(gameId, action, name);
 

package/src/host/PortMachine.js

@@ -270,7 +270,7 @@ export default class PortMachine {
       // 4: first shot ready
       () => host.firstShotReady(state.gameId),
 
-      // 5: keys data ('seq:action:name')
+      // 5: keys data ('seq:action:name'; указатель — 'seq:aim:x:y:flags')
       keyEventString => {
         if (typeof keyEventString === 'string') {
           host.updateKeys(state.gameId, keyEventString);

package/src/host/meta/core/CommandProcessor.js

@@ -1,16 +1,19 @@
-// Обработчик чат-команд. Движковое ядро: /name, /nr, /timeleft, /mapname,
-// /rank; игровые команды (HostPlugin.chatCommands) регистрируются через
-// registerCommand и получают контекст меты: handler(ctx, gameId, args).
+// Обработчик чат-команд. Своих команд у движка НЕТ: реестр целиком наполняет
+// игра через HostPlugin.chatCommands, а обработчик получает контекст меты —
+// handler(ctx, gameId, args). Одно и то же имя (/name, /bot, /timeleft …) в
+// разных играх может делать разное или отсутствовать вовсе; незнакомая
+// команда — COMMANDS_NOT_FOUND.
+//
+// Всё, что раньше разбирал движковый switch, доступно играм через контекст:
+// roundManager (смена ника, новый раунд, текущая карта), timerManager
+// (остаток времени карты), playerDataSync (ранг), chat, isDevMode.
 class CommandProcessor {
   constructor(deps) {
     this._chat = deps.chat;
-    this._roundManager = deps.roundManager;
-    this._timerManager = deps.timerManager;
-    this._playerDataSync = deps.playerDataSync;
-    this._isDevMode = deps.isDevMode;
 
     // контекст игровых команд (participants, chat, scripted, roundManager,
-    // voteCoordinator, teams, spectatorTeam, spectatorId, …)
+    // voteCoordinator, timerManager, playerDataSync, teams, spectatorTeam,
+    // spectatorId, isDevMode)
     this._ctx = deps;
 
     this._commands = new Map();
@@ -31,67 +34,12 @@ class CommandProcessor {
 
     const arr = message.split(' ');
     const cmd = arr.shift();
+    const handler = this._commands.get(cmd);
 
-    switch (cmd) {
-      // смена ника
-      case '/name':
-        this._roundManager.changeName(gameId, arr.join(' '));
-        break;
-
-      // новый раунд
-      case '/nr':
-        if (this._isDevMode) {
-          this._roundManager.initiateNewRound();
-        } else {
-          this._chat.pushSystemByUser(gameId, 'COMMANDS_NOT_FOUND');
-        }
-        break;
-
-      // время карты
-      case '/timeleft': {
-        function getTime(ms) {
-          const totalSeconds = Math.floor(ms / 1000);
-          let minutes = Math.floor(totalSeconds / 60);
-          let seconds = totalSeconds % 60;
-
-          if (minutes < 10) {
-            minutes = '0' + minutes;
-          }
-
-          if (seconds < 10) {
-            seconds = '0' + seconds;
-          }
-
-          return `${minutes}:${seconds}`;
-        }
-
-        this._chat.pushSystemByUser(gameId, [
-          getTime(this._timerManager.getMapTimeLeft()),
-        ]);
-        break;
-      }
-
-      // название текущей карты
-      case '/mapname':
-        this._chat.pushSystemByUser(gameId, [this._roundManager.currentMap]);
-        break;
-
-      // ранг игрока (Этап B4/B5: PlayerDataSync, подгружен с auth-сервиса)
-      case '/rank':
-        this._chat.pushSystemByUser(gameId, 'RANK', [
-          this._playerDataSync.getRank(gameId),
-        ]);
-        break;
-
-      default: {
-        const handler = this._commands.get(cmd);
-
-        if (handler) {
-          handler(this._ctx, gameId, arr);
-        } else {
-          this._chat.pushSystemByUser(gameId, 'COMMANDS_NOT_FOUND');
-        }
-      }
+    if (handler) {
+      handler(this._ctx, gameId, arr);
+    } else {
+      this._chat.pushSystemByUser(gameId, 'COMMANDS_NOT_FOUND');
     }
   }
 }

package/tests/fixtures/miniGame/host/fakeCore.js

@@ -112,6 +112,23 @@ export default class FakeGameCore {
     }
   }
 
+  // ввод указателем: миниигра просто запоминает последнюю точку и биты —
+  // движковым тестам важно, что канал доходит до ядра
+  apply_aim(gameId, seq, x, y, flags) {
+    const actor = this._actors.get(gameId);
+
+    if (!actor) {
+      return;
+    }
+
+    actor.lastInputSeq = seq;
+    actor.aim = { x, y, flags };
+  }
+
+  aim_of(gameId) {
+    return this._actors.get(gameId)?.aim ?? null;
+  }
+
   last_input_seq(gameId) {
     return this._actors.get(gameId)?.lastInputSeq ?? 0;
   }

package/src/client/lib/hostGate.js

@@ -1,16 +0,0 @@
-// Пока хост всегда поднимает activeGameManifest (динамическая загрузка
-// ClientPlugin по выбору игры отложена — граница задачи, plan/lobby-page-plan.md),
-// нельзя дать создать комнату с полями формы игры, отличной от активной
-// (code review lobby-page 2.1). Вынесено в чистую функцию, чтобы поведение
-// было проверяемо юнит-тестом отдельно от main.js (main.js — бутстрап, тестами
-// не покрывается).
-export function getHostGateState(selectedGameId, activeGameManifest) {
-  if (selectedGameId === activeGameManifest.id) {
-    return { disabled: false, title: '' };
-  }
-
-  return {
-    disabled: true,
-    title: `Hosting ${activeGameManifest.title} — switch back to create a server`,
-  };
-}