vimp-engine 0.10.2 → 0.11.0

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.0",
   "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/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/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

@@ -36,6 +36,7 @@ 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 {
@@ -260,6 +261,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):
@@ -345,6 +350,10 @@ socketMethods[PS_CONFIG_DATA] = async data => {
     const availableServices = {
       renderer: app.renderer,
       soundManager,
+      // «свой ли это персонаж»: part сравнивает id своего экземпляра (четвёртый
+      // аргумент конструктора) со своим gameId. Игра без этого сервиса звучит
+      // одинаково за всех — чужие подборы и чужие смерти вперемешку со своими
+      localPlayer,
       // база ассетов игры — тем же каналом, что и путь к звукам (см. выше):
       // картинки карт живут в пакете игры (dist/img/), движок их не раздаёт.
       // part, объявивший сервис в componentDependencies, строит URL сам —
@@ -912,6 +921,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 +968,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));
 

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/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;
   }