vimp-engine 0.39.0 → 0.41.0

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';
@@ -224,6 +225,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 +309,7 @@ export default class HostGame {
       vote: this._vote,
       chat: this._chat,
       timerManager: this._timerManager,
+      voteHoldTime: data.voteHoldTime,
     });
 
     this._roundManager = new RoundManager({
@@ -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();
@@ -858,9 +865,9 @@ export default class HostGame {
 
   /**
    * Публичный teardown матча: останов таймеров, финальная синхронизация
-   * профилей и снятие всех участников. Во вкладке матч умирает вместе с
-   * Worker'ом, а долгоживущему процессу (dedicated-сервер) нужен graceful
-   * shutdown — иначе таймеры держат процесс, а rank/state теряются.
+   * профилей и снятие всех участников. Его зовут Worker при закрытии
+   * комнаты и inline-хост solo при останове матча: без него таймеры
+   * переживают матч, а rank/state теряются.
    * @returns {Promise} Завершение финальной синхронизации профилей.
    */
   async destroy() {
@@ -1264,6 +1271,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 +1324,7 @@ export default class HostGame {
       panel: this._panel.serialize(),
       playerData: this._playerDataSync.serialize(),
       plugin: plugin ?? {},
+      persist,
       // текст карточки лобби, выставленный модулем игры (lobby.setInfo):
       // модули нового Worker'а создаются с нуля и сами его не повторят
       lobbyInfo: this._lobbyInfoOverride,
@@ -1463,6 +1485,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 +1659,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 +1783,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 +1920,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 +1937,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) {
@@ -2052,7 +2128,7 @@ export default class HostGame {
     };
   }
 
-  // есть ли у участника identity-токен: в standalone и dedicated личность
+  // есть ли у участника identity-токен: в standalone личность
   // гостевая, и обновлять там нечего
   hasToken(gameId) {
     const token = this._participants.get(gameId)?.token;

package/src/host/PortMachine.js

@@ -1,10 +1,9 @@
 // Хендшейк-машина клиента, вынутая из host.worker.js: автомат по клиентским
-// портам (таблица портов — docs.vimp.lgick.dev/en/snapshot). Изоморфна — ни
+// портам (таблица портов — VIMP docs: snapshot.md). Изоморфна — ни
 // self, ни postMessage, ни DOM: всё, что знает про транспорт, приходит через
 // makeSocket. Поэтому её крутит и Worker браузерного хоста, и inline-хост
-// standalone SDK, и Node-процесс dedicated-сервера: копий автомата быть не
-// должно, иначе они разъедутся ровно так, как разъезжались бы копии
-// createHostRuntime.
+// standalone SDK, и headless-прогон: копий автомата быть не должно, иначе
+// они разъедутся ровно так, как разъезжались бы копии createHostRuntime.
 
 import wsports from '../config/wsports.js';
 import closeCodes from '../config/closeCodes.js';
@@ -57,7 +56,7 @@ export default class PortMachine {
    * @param {Object} deps.identity - стратегия идентичности (./identity.js).
    * @param {number} [deps.resumeGraceMs] - сколько держать место участника,
    *   чей транспорт оборвался (host-migration этап 4); 0 — снимать сразу
-   *   (dedicated, standalone: поведение до этапа 4).
+   *   (standalone).
    * @param {number} [deps.resumeRequestTimeoutMs] - сколько ждать
    *   RESUME_REQUEST от возобновляющего соединения.
    */
@@ -466,22 +465,6 @@ export default class PortMachine {
     }
   }
 
-  /**
-   * @param {string} socketId
-   * @returns {boolean} Есть ли порт-машина у этого соединения.
-   */
-  has(socketId) {
-    return this._clients.has(socketId);
-  }
-
-  /**
-   * @param {string} socketId
-   * @returns {boolean} Дошёл ли клиент до созданного участника матча.
-   */
-  hasParticipant(socketId) {
-    return this._clients.get(socketId)?.gameId !== undefined;
-  }
-
   /**
    * @returns {Iterator<string>} socketId живых соединений (для
    *   host.completeHandoff(new Set(...))).

package/src/host/commandFailure.js

@@ -1,7 +1,7 @@
 // Отчёт о сбое чат-команды игры для приёмника диагностики
 // (HostGame.setDiagnosticSink): сообщение в одну строку и стек без текста
-// ошибки. Один отчёт на все среды — Worker (журнал платформы), dedicated
-// (лог процесса), standalone (консоль вкладки). Чистые функции, без DOM и
+// ошибки. Один отчёт на все среды — Worker (журнал платформы), standalone
+// (консоль вкладки), headless-прогон (лог процесса). Чистые функции, без DOM и
 // Node API: модуль работает в Worker'е
 
 // символы, подделывающие строки лога: управляющие (перевод строки, ESC),

package/src/host/identity.js

@@ -1,7 +1,7 @@
 // Стратегии идентичности хоста: как порт-машина (PortMachine.js) узнаёт,
 // под каким ником участник входит в комнату. Прод-лобби доверяет только
-// подписанному identity-токену центрального auth-сервиса; standalone- и
-// dedicated-контуры мастера не имеют вовсе и пускают гостей по нику из формы.
+// подписанному identity-токену центрального auth-сервиса; standalone-контур
+// мастера не имеет вовсе и пускает гостей по нику из формы.
 //
 // Контракт стратегии:
 //   { params: Array, errorField: string, resolve(data, socketId): Promise<string> }
@@ -61,7 +61,7 @@ export function createTokenIdentity({ jwksUrl, issuer }) {
 }
 
 /**
- * Гостевой вход (standalone/dedicated): ник — поле формы, которое хост
+ * Гостевой вход (standalone): ник — поле формы, которое хост
  * валидирует сам движковым isValidName, без кода игры.
  *
  * Ограничение (принимается осознанно): гостевые ники не уникальны и не

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

@@ -51,8 +51,8 @@ class CommandProcessor {
       return;
     }
 
-    // в Worker'е сбой стал бы необработанным reject'ом, в dedicated-процессе —
-    // uncaughtException, то есть падением матча всех игроков
+    // в Worker'е сбой стал бы необработанным reject'ом, то есть падением
+    // матча всех игроков
     try {
       const result = handler(this._ctx, gameId, arr);
 

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

@@ -398,6 +398,10 @@ class RoundManager {
     this._game.createMap(this._scaledMapData);
 
     for (const user of this._participants.getHumans()) {
+      // CLEAR уходит синхронно, личная очередь — по сообщению на кадр:
+      // меню и подсказка прошлого раунда не должны прийти после CLEAR
+      this._voteCoordinator.dropPersonal(user.gameId);
+
       if (user.isReady === false) {
         continue;
       }
@@ -579,6 +583,9 @@ class RoundManager {
         .filter(u => u.teamId !== this._spectatorId && u.gameId !== gameId)
         .length < 2
     ) {
+      // новая игра: ядро сбрасывает накопленное между раундами до
+      // removePlayersAndShots, который зовёт initiateNewRound
+      this._game.resetMatch?.();
       this._stat.reset();
       this.initiateNewRound();
       this._chat.pushSystemByUser(gameId, 'TEAMS_NEW_TEAM', [newTeam]);
@@ -649,7 +656,7 @@ class RoundManager {
 
     user.status = 'spectator';
     user.isWatching = true;
-    user.watchedGameId = this._participants.getActiveList()[0] || null;
+    user.watchedGameId = this._participants.firstWatchable();
     user.forceCameraReset = true;
     // слот освобождается вместе с актором, иначе он держится за наблюдателем
     user.respawnIndex = null;

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

@@ -2,14 +2,36 @@
 // Инфраструктура поверх Vote + TimerManager; не знает о round/map-логике
 // (вызывающие передают готовые payload и resultFunc).
 class VoteCoordinator {
-  constructor({ vote, chat, timerManager }) {
+  constructor({ vote, chat, timerManager, voteHoldTime = 0 }) {
     this._vote = vote;
     this._chat = chat;
     this._timerManager = timerManager;
+    this._voteHoldTime =
+      Number.isFinite(voteHoldTime) && voteHoldTime > 0 ? voteHoldTime : 0;
+    this._deferred = new Map(); // voteCategory → data голосования игры
+  }
+
+  // идут ли первые `voteHoldTime` мс раунда (удержание голосований)
+  isHeld() {
+    return (
+      this._voteHoldTime > 0 &&
+      this._timerManager.roundElapsed() < this._voteHoldTime
+    );
+  }
+
+  // убирает неотправленные личные сообщения меню игрока (старт раунда)
+  dropPersonal(gameId) {
+    this._vote.dropPersonal(gameId);
   }
 
   // проверяет возможность создать голосование в данной категории
   canCreateVote(voteCategory, gameId) {
+    if (gameId && this.isHeld()) {
+      this._chat.pushSystemByUser(gameId, 'VOTE_UNAVAILABLE');
+
+      return false;
+    }
+
     if (
       this._timerManager.isVoteBlocked(voteCategory) ||
       this._vote.hasVoteCategory(voteCategory)
@@ -29,6 +51,14 @@ class VoteCoordinator {
     const { voteName, voteCategory, payload, resultFunc, userList, gameId } =
       data;
 
+    // голосование игры откладывается до конца удержания; новое того же
+    // раздела заменяет отложенное
+    if (!gameId && this.isHeld()) {
+      this._defer(voteCategory, data);
+
+      return;
+    }
+
     // если голосование инициировано пользователем
     if (gameId) {
       this._chat.pushSystemByUser(gameId, 'VOTE_CREATED');
@@ -60,8 +90,33 @@ class VoteCoordinator {
     });
   }
 
+  // откладывает голосование игры на остаток удержания
+  _defer(voteCategory, data) {
+    this._deferred.set(voteCategory, data);
+
+    this._timerManager.startVoteHoldTimer(
+      () => this._releaseDeferred(),
+      this._voteHoldTime - this._timerManager.roundElapsed(),
+    );
+  }
+
+  // запускает отложенные голосования по окончании удержания
+  _releaseDeferred() {
+    const list = [...this._deferred];
+
+    this._deferred.clear();
+
+    for (const [category, data] of list) {
+      if (this.canCreateVote(category)) {
+        this.createVote(data);
+      }
+    }
+  }
+
   // сбрасывает активные и запланированные опросы и таймеры по ним
   reset() {
+    this._deferred.clear();
+    this._timerManager.stopVoteHoldTimer();
     this._timerManager.stopAllVoteTimers();
     this._timerManager.stopAllBlockedVoteTimers();
     this._vote.reset();

package/src/host/meta/modules/Accolades.js

@@ -234,7 +234,7 @@ export default class Accolades {
       // payload.nick, и PortMachine передаёт в createUser именно его), а не
       // то, что игрок написал в форме.
       //
-      // Меняет это в гостевом контуре (standalone/dedicated), где ник —
+      // Меняет это в гостевом контуре (standalone), где ник —
       // поле формы и «не защищён от подмены» по прямому признанию
       // createGuestIdentity. Токена у гостя нет, и сопоставление по нику
       // выдало бы ему чужую корону — стоит она ровно того, что значит.

package/src/host/meta/modules/TimerManager.js

@@ -82,6 +82,7 @@ class TimerManager extends AbstractTimer {
     this._stopRoundRestartDelay();
     this._stopMapChangeDelay();
     this._stopRttPingTimer();
+    this.stopVoteHoldTimer();
   }
 
   // запускает таймер до конца текущей карты (duration — остаток времени
@@ -141,9 +142,12 @@ class TimerManager extends AbstractTimer {
 
   // проверяет возможно сменить команду игроку в текущем раунде
   canChangeTeamInCurrentRound() {
-    const roundTime = this._now() - this._startRoundTime;
+    return this.roundElapsed() <= this._teamChangeGracePeriod;
+  }
 
-    return roundTime <= this._teamChangeGracePeriod;
+  // миллисекунды от старта раунда
+  roundElapsed() {
+    return this._now() - this._startRoundTime;
   }
 
   // логика одного "тика" игрового цикла
@@ -230,6 +234,16 @@ class TimerManager extends AbstractTimer {
     this._startTimer(`vote:${voteName}`, onEndCallback, this._voteTime);
   }
 
+  // запускает таймер конца удержания голосований (A18)
+  startVoteHoldTimer(onEndCallback, duration) {
+    this._startTimer('voteHold', onEndCallback, duration);
+  }
+
+  // останавливает таймер удержания голосований
+  stopVoteHoldTimer() {
+    this._stopTimer('voteHold');
+  }
+
   // останавливает все активные таймеры голосования
   stopAllVoteTimers() {
     for (const key of this._timers.keys()) {

package/src/host/meta/modules/Vote.js

@@ -56,6 +56,43 @@ class Vote {
     this._userList[gameId].push(arr);
   }
 
+  // добавляет личное сообщение меню/подсказки (`menu`, `menuClose`,
+  // `menuHint`). Ещё не отправленные сообщения того же вида и имени
+  // вытесняются: очередь не растёт от частых обновлений, порядок
+  // «закрыть → открыть» сохраняется. Списки `teams`/`maps` не трогаются
+  pushPersonal(gameId, payload) {
+    const queue = this._userList[gameId];
+
+    if (!queue) {
+      return;
+    }
+
+    const key = personalKey(payload);
+    const name = personalName(payload);
+
+    this._userList[gameId] = queue.filter(item => {
+      const itemKey = personalKey(item);
+
+      return (
+        itemKey === null ||
+        personalName(item) !== name ||
+        personalGroup(itemKey) !== personalGroup(key)
+      );
+    });
+
+    this._userList[gameId].push(payload);
+  }
+
+  // убирает неотправленные личные сообщения: CLEAR уходит синхронно, а
+  // очередь — по сообщению на кадр, и меню прошлого раунда пришло бы после
+  dropPersonal(gameId) {
+    const queue = this._userList[gameId];
+
+    if (queue) {
+      this._userList[gameId] = queue.filter(item => personalKey(item) === null);
+    }
+  }
+
   // возвращает данные
   shift() {
     return this._list.shift();
@@ -178,6 +215,34 @@ class Vote {
   }
 }
 
+const PERSONAL_KEYS = ['menu', 'menuClose', 'menuHint'];
+
+// ключ личного сообщения (`menu`/`menuClose`/`menuHint`) или null — это
+// список голосования (массив или шаблон)
+function personalKey(item) {
+  if (item === null || typeof item !== 'object' || Array.isArray(item)) {
+    return null;
+  }
+
+  return PERSONAL_KEYS.find(key => Object.hasOwn(item, key)) ?? null;
+}
+
+// имя меню, к которому относится личное сообщение
+function personalName(item) {
+  const key = personalKey(item);
+
+  if (key === 'menu') {
+    return item.menu.name;
+  }
+
+  return key === 'menuHint' ? item.menuHint.name : item[key];
+}
+
+// `menu` и `menuClose` вытесняют друг друга, `menuHint` — только себя
+function personalGroup(key) {
+  return key === 'menuHint' ? 'hint' : 'menu';
+}
+
 // Сброс синглтона. Нужен только тем, кто крутит больше одного матча в
 // процессе — headless-runner (devtools/resetHostSingletons.js) и тесты;
 // в браузерной вкладке матч всегда один, поэтому прод его не зовёт.

package/src/host/meta/player/ParticipantManager.js

@@ -24,6 +24,8 @@ class ParticipantManager {
     this._participants = new Map(); // gameId -> Participant
     this._teamSizes = {}; // team -> Set<gameId>
     this._activePlayersList = []; // gameId[]
+    // жив ли игрок в ядре; ядро появляется позже менеджера (setAliveCheck)
+    this._isAlive = () => true;
 
     this.resetTeamSizes();
   }
@@ -62,7 +64,7 @@ class ParticipantManager {
       team: this._joinTeam,
       teamId: this._joinTeamId,
       socketId,
-      watchedGameId: this._activePlayersList[0] || null,
+      watchedGameId: this.firstWatchable(),
       token: params.token,
       identityName: params.name,
     });
@@ -113,7 +115,7 @@ class ParticipantManager {
       team,
       teamId,
       socketId,
-      watchedGameId: this._activePlayersList[0] || null,
+      watchedGameId: this.firstWatchable(),
       token: record.token ?? null,
       identityName: record.identityName ?? null,
     });
@@ -335,11 +337,25 @@ class ParticipantManager {
     // перецепление наблюдателей на другого активного игрока
     for (const participant of this._participants.values()) {
       if (participant.watchedGameId === gameId) {
-        participant.watchedGameId = this._activePlayersList[0] || null;
+        participant.watchedGameId = this.firstWatchable();
       }
     }
   }
 
+  setAliveCheck(isAlive) {
+    this._isAlive = isAlive;
+  }
+
+  // первая цель наблюдателя: живой активный игрок; живых нет — первый из
+  // списка (остов), списка нет — null
+  firstWatchable() {
+    return (
+      this._activePlayersList.find(id => this._isAlive(id)) ??
+      this._activePlayersList[0] ??
+      null
+    );
+  }
+
   clearActive() {
     this._activePlayersList = [];
   }

package/src/lib/capabilities.js

@@ -55,6 +55,23 @@ export const ENGINE_CAPABILITIES = createRegistry('engine-capabilities', [
   // хуки `hooks.voiceSounds`/`hooks.voiceFilter`); опциональна — игра не
   // пишет её в `requires`
   { value: 'voice', since: '0.39.0' },
+  // личное меню игрока в окне `#vote` и подсказка под значком рации:
+  // события ядра menu/menuClose/menuHint, опкод `menu.answer`
+  { value: 'menu.personal', since: '0.41.0' },
+  // опкод `actor.forget`: участник покинул матч (в том числе наблюдатель);
+  // без него id ушедшего наследует новичок вместе с профилем игры
+  { value: 'actor.forget', since: '0.41.0' },
+  // опкод `match.reset`: новая игра (движок обнулил счёт); игра, чей баланс
+  // сбрасывается вместе со счётом, объявляет её в `requires`
+  { value: 'match.reset', since: '0.41.0' },
+  // опкоды `state.persist`/`state.restore`: состояние игры между раундами
+  // переживает мягкую миграцию хоста и эстафету Worker'а (мета `persist`)
+  { value: 'state.persist', since: '0.41.0' },
+  // поле конфига игры `voteHoldTime`: удержание голосований в начале раунда
+  { value: 'vote.hold', since: '0.41.0' },
+  // свойства ячейки панели (modules.panel.fields[]): label, labelFrom,
+  // hidden, format, prefix, suffix, emptyWhen, flashOnChange, countdown
+  { value: 'panel.cells', since: '0.41.0' },
 ]);
 
 // плоский список имён — то, чем правило контракта B2 проверяет `requires`

package/src/lib/createHostRuntime.js

@@ -31,7 +31,7 @@ import HostGame from '../host/HostGame.js';
  *   прогону (сценарий подкручивает networkSendRate и таймеры).
  * @param {boolean} [options.voiceRelay] - У контура есть ретранслятор голоса
  *   на транспортном уровне (браузерный хост лобби); без него связь
- *   выключается, даже если игра её объявила (standalone, headless, dedicated).
+ *   выключается, даже если игра её объявила (standalone, headless).
  * @returns {Promise<Object>} { hostPlugin, game, seed, core, clientCfg,
  *   socketManager, host }.
  */

package/src/lib/gameConfigView.js

@@ -68,6 +68,13 @@ const FIELDS = {
 
   spectatorTeam: { derive: deriveSpectatorTeam },
 
+  // мс от старта раунда, в которые голосования удерживаются: запущенное
+  // игроком для других отклоняется, запущенное игрой откладывается; 0 — без
+  // удержания. Поле верхнего уровня, а не `timers.*`: applyRoomOverrides
+  // сливает конфиг поверхностно, и игра, задавшая `timers`, потеряла бы
+  // остальные таймеры движка
+  voteHoldTime: { default: 0 },
+
   // смена хоста посреди раунда (host-migration этап 5): true — игра
   // гарантирует, что GameSim::serialize/deserialize и хуки модулей
   // serializeState/restoreState переносят всё её состояние. Без поля —