vimp-engine 0.40.0 → 0.42.0

package/src/config/chatMessages.js

@@ -29,7 +29,7 @@ export default {
     'Vote passed',
     'Vote failed',
     'Usage: /changehost',
-    'You are the host — use “Hand over host” in the room menu',
+    'You are the host — the room hands the host role over automatically when needed',
     'No connection to the master server',
     'A host vote was held recently',
     'No other player can host',

package/src/config/lobby.js

@@ -24,17 +24,18 @@ export default {
     createDelayMaxMs: 2000,
   },
 
-  // меню комнаты внутри матча (только лобби-режим, roomMenu.pug)
+  // выход из комнаты внутри матча (только лобби-режим, roomMenu.pug)
   roomMenu: {
     elems: {
-      // кнопка меню живёт в панели, справа от таблицы
+      // кнопка Exit живёт в панели, справа от таблицы
       panelId: 'panel',
       menuId: 'room-menu',
-      toggleId: 'room-menu-toggle',
-      listId: 'room-menu-list',
-      leaveId: 'room-menu-leave',
-      handoverId: 'room-menu-handover',
+      exitId: 'room-menu-exit',
       statusId: 'room-menu-status',
+      // окно подтверждения «Leave the game?»
+      confirmId: 'room-exit-confirm',
+      confirmYesId: 'room-exit-confirm-yes',
+      confirmCancelId: 'room-exit-confirm-cancel',
     },
   },
 
@@ -206,16 +207,15 @@ export default {
   // взять последнюю периодическую; handoffSlowMs — нет handoff_go за это
   // время — «медленная связь» (передача продолжается); handoffDeadlineMs —
   // общий дедлайн плановой передачи от handoff_begin (master:room:
-  // handoffTimeoutMs + запас на дорогу ответа мастера); deferMaxMs — потолок
-  // ожидания границы раунда передачей в игре без migration.midRound (этап 8d);
+  // handoffBetaWaitMs + handoffTimeoutMs + запас на дорогу ответа мастера);
   // peersReportIntervalMs — период повтора room_peers хоста мастеру (кто
   // подключён по WebRTC; при смене состава отчёт уходит сразу, с дебаунсом);
   // minTokenLifetimeMs — вкладка, чей вход истечёт раньше, не объявляет
   // canHost и отказывается от промоушена (токен предъявляется мастеру
   // посреди матча; обычно его заранее продлевает TokenRenewer, порог работает,
   // пока продление не удаётся); tokenHandoffLeadMs — за столько до
-  // истечения входа хост с бетой сам передаёт роль (плановая передача на
-  // границе раунда); tokenHandoffRetryMs — через сколько повторить её, если
+  // истечения входа хост с бетой сам передаёт роль (плановая передача);
+  // tokenHandoffRetryMs — через сколько повторить её, если
   // беты ещё нет, идёт эстафета Worker'ов или передача сорвалась (повторы —
   // до истечения входа); leaveFlushTimeoutMs — сколько «Leave
   // server» хоста без людей ждёт записи очков участников перед закрытием
@@ -230,8 +230,7 @@ export default {
     standbyReopenMaxDelayMs: 10000,
     finalWaitMs: 3000,
     handoffSlowMs: 3000,
-    handoffDeadlineMs: 10000,
-    deferMaxMs: 30000,
+    handoffDeadlineMs: 12000,
     peersReportIntervalMs: 15000,
     minTokenLifetimeMs: 600000,
     tokenHandoffLeadMs: 300000,
@@ -240,14 +239,13 @@ export default {
 
     // автотриггеры передачи (этап 9b, HostHealthPolicy; сэмпл — сообщение
     // health Worker'а раз в ~1 с): мягкая перегрузка — среднее tickRate за
-    // overloadWindowMs ниже overloadTickRate (передача ждёт границы раунда);
-    // жёсткая — среднее за criticalWindowMs ниже criticalTickRate или
-    // lostMs > 0 у lostWindows сэмплов подряд (сразу); отложенная
-    // отменяется, когда все сэмплы за recoverWindowMs выше recoverTickRate
-    // (гистерезис); hiddenHandoffMs — скрытая вкладка хоста (этап 0:
-    // троттлинг Worker'а за 1–3 с); autoHandoffCooldownMs — между
-    // авто-передачами вкладки; minHostTenureMs — не отдавать роль, только
-    // что её получив; enabled — общий выключатель
+    // overloadWindowMs ниже overloadTickRate; жёсткая — среднее за
+    // criticalWindowMs ниже criticalTickRate или lostMs > 0 у lostWindows
+    // сэмплов подряд; передача в обоих случаях сразу; hiddenHandoffMs —
+    // скрытая вкладка хоста (этап 0: троттлинг Worker'а за 1–3 с);
+    // autoHandoffCooldownMs — между авто-передачами вкладки;
+    // minHostTenureMs — не отдавать роль, только что её получив; enabled —
+    // общий выключатель
     auto: {
       enabled: true,
       overloadTickRate: 100,
@@ -255,8 +253,6 @@ export default {
       criticalTickRate: 60,
       criticalWindowMs: 3000,
       lostWindows: 3,
-      recoverTickRate: 110,
-      recoverWindowMs: 5000,
       hiddenHandoffMs: 1500,
       autoHandoffCooldownMs: 90000,
       minHostTenureMs: 30000,
@@ -286,7 +282,9 @@ export default {
   // joinRetryWindowMs — сколько гость повторяет join_room на unknownRoom
   // после рестарта мастера, пока хост не вернёт комнату reclaim_host (больше
   // reconnect.maxDelay — бэкоффа сигналинга хоста — с запасом на его
-  // reclaim_host)
+  // reclaim_host); joinRetries — сколько раз повторить вход, каналы
+  // которого ни разу не открылись (сбой WebRTC-согласования, ICE), прежде
+  // чем показать «P2P connection failed» (задержки — бэкофф reconnect*)
   session: {
     reconnectWindowMs: 15000,
     reconnectBaseDelayMs: 500,
@@ -297,6 +295,7 @@ export default {
     linkWaitMaxMs: 90000,
     resumeSilenceGraceMs: 3000,
     joinRetryWindowMs: 45000,
+    joinRetries: 2,
   },
 
   // приёмник выгрузок отладочного контура:

package/src/config/menuName.js

@@ -0,0 +1,3 @@
+// формат имени личного меню: проверяется и хостом (ответ игрока), и клиентом
+// (данные недоверенного хоста)
+export const MENU_NAME_PATTERN = /^[a-z][a-zA-Z0-9]{0,15}$/;

package/src/devtools/ScenarioRunner.js

@@ -696,6 +696,7 @@ function buildReport(ctx) {
     hostState: inspectHost(host),
     participantLog,
     stepMs,
+    checkpointRestores,
   });
 
   return {

package/src/devtools/invariants.js

@@ -33,6 +33,7 @@ const CHECKS = [
   [10, 'roundLifecycle', 'round ends, winner announced, respawns happened'],
   [11, 'actorLeak', 'players_data() matches the active participants'],
   [12, 'determinism', 'two runs produce a byte-identical frame stream'],
+  [13, 'checkpointState', 'every host change carries the core dump'],
 ];
 
 const TITLES = new Map(
@@ -40,8 +41,8 @@ const TITLES = new Map(
 );
 
 /**
- * Выполняет проверки 1–11 по итогам прогона (12 — только по требованию,
- * см. checkDeterminism).
+ * Выполняет проверки 1–11 и 13 по итогам прогона (12 — только по
+ * требованию, см. checkDeterminism).
  * @param {Object} ctx
  * @param {Object} ctx.scenario - Нормализованный сценарий.
  * @param {Object} ctx.game - Конфиг игры хоста (после room-переопределений).
@@ -53,6 +54,8 @@ const TITLES = new Map(
  * @param {Array} ctx.participantLog - [{ who, socketId, gameId, joinTick,
  *   leaveTick }].
  * @param {number} ctx.stepMs
+ * @param {Array} [ctx.checkpointRestores] - [{ tick, mode, bytes }] смен
+ *   хоста прогона.
  * @returns {Array<Object>} Результаты проверок.
  */
 export function checkInvariants(ctx) {
@@ -69,6 +72,7 @@ export function checkInvariants(ctx) {
     roundLifecycle(ctx),
     actorLeak(ctx),
     result('determinism', SKIP, [], 'run with --determinism'),
+    checkpointState(ctx),
   ];
 }
 
@@ -629,6 +633,24 @@ function actorLeak({ core, hostState }) {
   return verdict('actorLeak', violations);
 }
 
+// 13: смена хоста продолжает раунд с того же тика; точка 'soft' значит,
+// что дамп ядра или serializeState модуля бросил, и раунд начался заново
+function checkpointState({ checkpointRestores = [] }) {
+  if (checkpointRestores.length === 0) {
+    return result('checkpointState', SKIP, [], 'no host change in this run');
+  }
+
+  const violations = checkpointRestores
+    .filter(restore => restore.mode !== 'midRound')
+    .map(
+      restore =>
+        `tick ${restore.tick}: checkpoint mode '${restore.mode}' — the core ` +
+        'dump or a module serializeState threw (see the [checkpoint] warning)',
+    );
+
+  return verdict('checkpointState', violations);
+}
+
 // ***** вспомогательное ***** //
 
 function result(name, status, violations, note) {

package/src/devtools/report.js

@@ -103,8 +103,8 @@ export function formatMarkdown(report) {
     }
   }
 
-  // смены хоста через контрольную точку: 'soft' у игры, которая ждала
-  // 'midRound', — первое, что автор должен увидеть
+  // смены хоста через контрольную точку: 'soft' (дамп ядра не снялся) —
+  // первое, что автор должен увидеть
   if (report.checkpointRestores?.length) {
     lines.push('');
     lines.push('## Host checkpoints');

package/src/host/GameCoreAdapter.js

@@ -10,7 +10,14 @@
 // (spawn_scripted_actor/remove_scripted_actor), человек — только танк
 // (spawn_actor/remove_actor).
 
-import { ABI_OP_DEBUG_JSON } from '../config/abiOps.js';
+import {
+  ABI_OP_ACTOR_FORGET,
+  ABI_OP_DEBUG_JSON,
+  ABI_OP_MATCH_RESET,
+  ABI_OP_MENU_ANSWER,
+  ABI_OP_STATE_PERSIST,
+  ABI_OP_STATE_RESTORE,
+} from '../config/abiOps.js';
 import { readCoreAbi, dispatchCoreOp } from '../lib/coreAbi.js';
 
 export default class GameCoreAdapter {
@@ -26,7 +33,7 @@ export default class GameCoreAdapter {
     this._core = core;
     this._participants = participants;
     this._onCoreEvent = onCoreEvent;
-    this._services = {}; // { vimp, panel } — инъекция как у Game.js
+    this._services = {}; // { vimp, panel, vote } — инъекция как у Game.js
 
     // Метода нет (или самоописание нечитаемо) — ядро собрано до появления
     // механизма. Это не ошибка: поколение 0, ни одного опционального опкода
@@ -44,7 +51,7 @@ export default class GameCoreAdapter {
     return this._abi;
   }
 
-  // получает сервисы (аналог Game.injectServices): { vimp, panel }
+  // получает сервисы (аналог Game.injectServices): { vimp, panel, vote }
   injectServices(services) {
     Object.assign(this._services, services);
   }
@@ -159,7 +166,7 @@ export default class GameCoreAdapter {
   // vimp }); 'custom' (игровой смысл вне словаря) — в HostPlugin.onCoreEvent
   _drainEvents() {
     const events = JSON.parse(this._core.take_events());
-    const { panel, vimp } = this._services;
+    const { panel, vimp, vote } = this._services;
 
     for (const event of events) {
       switch (event.type) {
@@ -182,6 +189,20 @@ export default class GameCoreAdapter {
           });
           break;
 
+        case 'menu':
+          this._pushPersonal(vote, event.id, { menu: event.menu });
+          break;
+
+        case 'menuClose':
+          this._pushPersonal(vote, event.id, { menuClose: event.name });
+          break;
+
+        case 'menuHint':
+          this._pushPersonal(vote, event.id, {
+            menuHint: { name: event.name, on: event.on },
+          });
+          break;
+
         case 'custom':
           this._onCoreEvent?.(event.data, this._services);
           break;
@@ -189,6 +210,60 @@ export default class GameCoreAdapter {
     }
   }
 
+  // личное сообщение меню адресату; получатель — только человек с сокетом
+  // (бот и ушедший id отбрасываются: у них нет личной очереди)
+  _pushPersonal(vote, id, payload) {
+    const gameId = String(id);
+
+    if (vote && this._participants.get(gameId)?.isNetworked) {
+      vote.pushPersonal(gameId, payload);
+    }
+  }
+
+  // ***** опкоды игры ***** //
+
+  // ответ игрока на личное меню; ядро без опкода молча игнорирует
+  menuAnswer(gameId, name, path) {
+    this._op(
+      ABI_OP_MENU_ANSWER,
+      encodeJson({ id: Number(gameId), name, path }),
+    );
+  }
+
+  // участник покинул матч (в том числе наблюдатель)
+  forgetActor(gameId) {
+    this._op(ABI_OP_ACTOR_FORGET, encodeJson({ id: Number(gameId) }));
+  }
+
+  // новая игра: движок обнулил счёт
+  resetMatch() {
+    this._op(ABI_OP_MATCH_RESET, encodeJson({}));
+  }
+
+  /**
+   * Состояние игры между раундами для мягкой миграции и эстафеты.
+   * @param {{roundOver: boolean}} request - `roundOver` — раунд закончился,
+   *   но ядро его ещё не подвело (эстафета на границе раунда).
+   * @returns {Object|null} JSON игры; `null` — ядро опкода не знает.
+   */
+  persistState({ roundOver }) {
+    const { handled, bytes } = this._op(
+      ABI_OP_STATE_PERSIST,
+      encodeJson({ roundOver }),
+    );
+
+    if (handled && bytes !== null) {
+      return JSON.parse(new TextDecoder().decode(bytes));
+    }
+
+    return null;
+  }
+
+  // отдаёт новому ядру JSON, снятый persistState
+  restorePersisted(state) {
+    this._op(ABI_OP_STATE_RESTORE, encodeJson(state));
+  }
+
   // ***** упаковка снапшота ***** //
 
   // пакует broadcast-тело кадра (один раз за отправляемый кадр)
@@ -333,6 +408,10 @@ export default class GameCoreAdapter {
   }
 }
 
+function encodeJson(value) {
+  return new TextEncoder().encode(JSON.stringify(value));
+}
+
 // JsError wasm-bindgen и обычный Error — у обоих есть message; строка из
 // throw внутри фейка — тоже ответ
 function errorText(e) {

package/src/host/HostGame.js

@@ -15,6 +15,7 @@ import CommandProcessor from './meta/core/CommandProcessor.js';
 import { sanitizeMessage } from '../lib/sanitizers.js';
 import { parseFloorMessage } from '../lib/voiceMessages.js';
 import closeCodes from '../config/closeCodes.js';
+import { MENU_NAME_PATTERN } from '../config/menuName.js';
 import clock from '../lib/clock.js';
 import { createResumeKey } from '../lib/resumeKey.js';
 import GameCoreAdapter from './GameCoreAdapter.js';
@@ -155,9 +156,6 @@ export default class HostGame {
     this._isDevMode = data.isDevMode || false;
     this._seed = seed;
 
-    // контрольная точка (host-migration этап 5): игра гарантирует, что дамп
-    // ядра и хуки модулей переносят всё её состояние посреди раунда
-    this._migrationMidRound = data.migration?.midRound === true;
     this._handoffFlushTimeoutMs = data.handoffFlushTimeoutMs ?? 3000;
     // промоушен преемника (host-migration этап 7.4): сколько восстановленный
     // матч ждёт возврата людей точки перед стартом
@@ -224,6 +222,7 @@ export default class HostGame {
       participants: this._participants,
       onCoreEvent: hostPlugin.onCoreEvent,
     });
+    this._participants.setAliveCheck(id => this._game.isAlive(id));
 
     this._panel = new Panel(data.panel);
     this._stat = new Stat(data.stat, this._teams);
@@ -307,6 +306,7 @@ export default class HostGame {
       vote: this._vote,
       chat: this._chat,
       timerManager: this._timerManager,
+      voteHoldTime: data.voteHoldTime,
     });
 
     this._roundManager = new RoundManager({
@@ -374,6 +374,9 @@ export default class HostGame {
     this._lastCheckpointAt = 0;
     this._checkpointRequest = null; // { final } — точка на ближайшем кадре
     this._checkpointCounter = 0;
+    // дамп упал на прошлой точке: повторный сбой не спамит консоль дважды в
+    // секунду, а успех снимает флаг — следующий сбой снова виден
+    this._dumpFailing = false;
     // матч поднят из точки и ждёт startAfterRestore: цикл и таймеры стоят
     this._restorePending = false;
     this._restoreMode = null; // 'midRound' | 'soft'
@@ -394,7 +397,11 @@ export default class HostGame {
 
     // внедрение зависимостей (ядро отдаёт панель/фасад события через адаптер)
     this._socketManager.injectServices(this._game, this._panel, this._stat);
-    this._game.injectServices({ vimp: this, panel: this._panel });
+    this._game.injectServices({
+      vimp: this,
+      panel: this._panel,
+      vote: this._vote,
+    });
     this._panel.injectTimerManager(this._timerManager);
 
     this._timerManager.startIdleCheckTimer();
@@ -924,23 +931,6 @@ export default class HostGame {
     this._roundManager.cancelHandoff();
   }
 
-  // плановая передача хоста (host-migration этап 8d): игра без
-  // migration.midRound переносит только мету — передача посреди раунда
-  // отняла бы его у всех, поэтому она ждёт следующего раунда. Игра с
-  // midRound продолжает у преемника с того же тика — ждать нечего
-  awaitRoundBoundary(cb) {
-    if (this._migrationMidRound) {
-      cb();
-      return;
-    }
-
-    this._roundManager.onRoundBoundary(cb);
-  }
-
-  cancelRoundBoundary() {
-    this._roundManager.cancelRoundBoundary();
-  }
-
   // финальная синхронизация профилей, но не дольше handoffFlushTimeoutMs:
   // зависший auth-сервис не должен держать эстафету — неотправленное едет
   // в состоянии (playerData) и уйдёт из нового Worker'а
@@ -1204,9 +1194,9 @@ export default class HostGame {
 
   /**
    * Собирает контрольную точку: мета (формат HANDOFF_VERSION 4) и дамп
-   * ядра. Ядро прикладывается только у игры с migration.midRound и только
-   * если дамп снялся — иначе режим 'soft' (восстановление начнёт раунд
-   * заново).
+   * ядра. Сетевая точка ('checkpoint') всегда пробует дамп; не снялся —
+   * режим 'soft' (восстановление начнёт раунд заново). Эстафета Worker'ов
+   * ('boundary') стоит на границе раунда и ядро не несёт.
    * @param {'checkpoint'|'boundary'} kind
    * @returns {{meta: Object, core: Uint8Array|null}}
    */
@@ -1214,14 +1204,19 @@ export default class HostGame {
     let core = null;
     let plugin = null;
 
-    if (kind === 'checkpoint' && this._migrationMidRound) {
+    if (kind === 'checkpoint') {
       try {
         plugin = this._serializeModules();
         core = this._game.serializeState();
+        this._dumpFailing = false;
       } catch (e) {
         // точка остаётся полезной и без ядра: аварийный преемник начнёт
         // раунд заново, а не потеряет комнату
-        console.warn(`[checkpoint] mid-round state skipped: ${e.message}`);
+        if (!this._dumpFailing) {
+          console.warn(`[checkpoint] mid-round state skipped: ${e.message}`);
+        }
+
+        this._dumpFailing = true;
         core = null;
         plugin = null;
       }
@@ -1264,6 +1259,20 @@ export default class HostGame {
     // преемник снимает их сам — иначе в мире остались бы бесхозные тела
     participants.dropped = dropped;
 
+    // малое состояние игры между раундами (опкод state.persist): ядро в
+    // точку не попало, а профили игры должны пережить мягкий перезапуск.
+    // Эстафета стоит на границе раунда — игра подводит закончившийся раунд
+    let persist = null;
+
+    if (core === null) {
+      try {
+        persist = this._game.persistState({ roundOver: kind === 'boundary' });
+      } catch (e) {
+        console.warn(`[checkpoint] persisted state skipped: ${e.message}`);
+        persist = null;
+      }
+    }
+
     const meta = {
       version: HANDOFF_VERSION,
       kind,
@@ -1303,6 +1312,7 @@ export default class HostGame {
       panel: this._panel.serialize(),
       playerData: this._playerDataSync.serialize(),
       plugin: plugin ?? {},
+      persist,
       // текст карточки лобби, выставленный модулем игры (lobby.setInfo):
       // модули нового Worker'а создаются с нуля и сами его не повторят
       lobbyInfo: this._lobbyInfoOverride,
@@ -1463,6 +1473,29 @@ export default class HostGame {
       this._restoreModules(meta.plugin);
     }
 
+    if (!midRound && meta.persist !== undefined && meta.persist !== null) {
+      try {
+        this._game.restorePersisted?.(meta.persist);
+      } catch (e) {
+        console.warn(`[checkpoint] persisted state skipped: ${e.message}`);
+      }
+    }
+
+    // участник точки, которого восстановление не вернуло (не попал в точку,
+    // restoreHuman/restoreScripted отказали), не должен оставить профиль в
+    // ядре: его унаследовал бы новичок с тем же gameId
+    const listed = [
+      ...meta.participants.humans.map(record => record.gameId),
+      ...meta.participants.scripted.map(record => record.gameId),
+      ...(meta.participants.dropped ?? []),
+    ];
+
+    for (const gameId of listed) {
+      if (!this._participants.get(gameId)) {
+        this._forgetActor(gameId);
+      }
+    }
+
     this._restoreMode = midRound ? 'midRound' : 'soft';
     this._restoredTimers = meta.timers ?? {};
     this._restorePending = true;
@@ -1614,25 +1647,27 @@ export default class HostGame {
     return this._frozen;
   }
 
-  // меняет и возвращает gameId наблюдаемого игрока
+  // gameId следующего (или предыдущего) наблюдаемого игрока по кругу. Остовы
+  // погибших в списке активных остаются до конца раунда, но камера на них не
+  // переключается; живых нет — наблюдатель остаётся на текущем
   _getNextActivePlayerForUser(gameId, back) {
     const currentId = this._participants.get(gameId)?.watchedGameId;
     const activeList = this._participants.getActiveList();
-    let key = activeList.indexOf(currentId);
+    const size = activeList.length;
+    const found = activeList.indexOf(currentId);
+    // текущего нет в списке: счёт идёт с края, в нужную сторону
+    const start = found === -1 ? (back ? 0 : -1) : found;
+    const step = back ? -1 : 1;
 
-    if (key !== -1) {
-      key = back ? key - 1 : key + 1;
+    for (let i = 1; i <= size; i += 1) {
+      const key = (((start + step * i) % size) + size) % size;
 
-      if (key < 0) {
-        key = activeList.length - 1;
-      } else if (key >= activeList.length) {
-        key = 0;
+      if (this._game.isAlive(activeList[key])) {
+        return activeList[key];
       }
-
-      return activeList[key];
     }
 
-    return activeList[0] || null;
+    return currentId ?? null;
   }
 
   // активирует тряску камеры у игрока (из события ядра)
@@ -1736,6 +1771,10 @@ export default class HostGame {
       this._game.removePlayer(gameId);
     }
 
+    // профиль игры (деньги и т.п.) живёт дольше танка: id ушедшего сразу
+    // достаётся новичку
+    this._forgetActor(gameId);
+
     this._participants.remove(gameId);
 
     this._chat.pushSystem('USER_LEFT', [user.name]);
@@ -1869,7 +1908,9 @@ export default class HostGame {
     } else if (typeof data === 'object' && data !== null) {
       const [type, value] = data;
 
-      if (type === 'mapChange') {
+      if (typeof type === 'string' && type.startsWith('menu:')) {
+        this._menuAnswer(gameId, type.slice(5), value);
+      } else if (type === 'mapChange') {
         if (this._participants.getHumans().length === 1) {
           this._roundManager.forceChangeMap(value);
         } else {
@@ -1884,6 +1925,29 @@ export default class HostGame {
     }
   }
 
+  // исключение ядра не должно прервать уход участника или миграцию
+  _forgetActor(gameId) {
+    try {
+      this._game.forgetActor?.(gameId);
+    } catch (e) {
+      console.warn(`[actor.forget] skipped: ${e.message}`);
+    }
+  }
+
+  // ответ игрока на личное меню: проверка формы и передача ядру игры;
+  // `id` — всегда отправитель, клиент его не указывает
+  _menuAnswer(gameId, name, path) {
+    if (
+      !MENU_NAME_PATTERN.test(name) ||
+      typeof path !== 'string' ||
+      !/^[1-9](\.[1-9])?$/.test(path)
+    ) {
+      return;
+    }
+
+    this._game.menuAnswer(gameId, name, path);
+  }
+
   // rank/state участника (Этап B4) — для игровых модулей и чат-команды /rank
   // (Этап B5, CommandProcessor)
   getPlayerRank(gameId) {
@@ -1999,7 +2063,7 @@ export default class HostGame {
   // транспорт участника оборвался без LEAVE: место держится до возврата.
   // Слот занят (isFull его считает), актор остаётся в мире, но все его
   // команды отпущены; RTT- и idle-кики его не трогают. false — держать
-  // нечего (не вошёл в матч, хост-игрок, уже отсоединён) — снимать сразу
+  // нечего (нет ключа места, хост-игрок, уже отсоединён) — снимать сразу
   detachUser(gameId) {
     const user = this._participants.get(gameId);