vimp-engine 0.40.0 → 0.42.0

package/src/host/PortMachine.js

@@ -145,6 +145,8 @@ export default class PortMachine {
       gameId: undefined,
       enabled: new Array(PORT_COUNT).fill(false),
       refreshing: false,
+      // соединение входило в матч (первый кадр или RESUME)
+      entered: false,
     };
 
     this._clients.set(socketId, state);
@@ -160,6 +162,8 @@ export default class PortMachine {
       gameId: undefined,
       enabled: new Array(PORT_COUNT).fill(false),
       refreshing: false,
+      // соединение входило в матч (первый кадр или RESUME)
+      entered: false,
       resumeTimer: null,
     };
 
@@ -218,6 +222,7 @@ export default class PortMachine {
       gameId,
       enabled: new Array(PORT_COUNT).fill(false),
       refreshing: false,
+      entered: true,
     };
 
     state.methods = this._buildPortMethods(socketId, state);
@@ -281,8 +286,14 @@ export default class PortMachine {
     }
 
     // обрыв без LEAVE (host-migration этап 4): место держится resumeGraceMs,
-    // если участнику есть куда вернуться (он вошёл в матч и получил ключ)
-    if (this._resumeGraceMs > 0 && this._host.detachUser(state.gameId)) {
+    // если соединение уже входило в матч — только из матча клиент умеет
+    // вернуться (SessionSupervisor). Ключ у грузящего карту есть ради точки
+    // смены хоста, но его обрыв до первого кадра снимает место сразу
+    if (
+      this._resumeGraceMs > 0 &&
+      state.entered &&
+      this._host.detachUser(state.gameId)
+    ) {
       this._startGrace(state.gameId);
       return;
     }
@@ -389,6 +400,7 @@ export default class PortMachine {
         this._stopGrace(gameId);
 
         state.gameId = gameId;
+        state.entered = true;
         state.enabled[PC_RESUME_REQUEST] = false;
         this._enableInGame(state);
 
@@ -397,6 +409,23 @@ export default class PortMachine {
       .catch(() => reject('auth'));
   }
 
+  // участник вошёл — с этого момента ему есть куда вернуться: секрет места
+  // (SESSION_DATA). Выдаётся при принятии авторизации, а не на первом
+  // кадре: смена хоста посреди загрузки карты не должна стоить места
+  _issueSession(socketId, gameId) {
+    if (this._resumeGraceMs <= 0 || !this._clients.has(socketId)) {
+      return;
+    }
+
+    const resumeKey = this._host.issueResumeKey(gameId);
+
+    // gameId — клиенту для RESUME_REQUEST: наблюдатель свой id больше
+    // ниоткуда не узнаёт
+    if (resumeKey) {
+      this._socketManager.sendSessionData(socketId, { resumeKey, gameId });
+    }
+  }
+
   // TOKEN_REFRESH { token }: токен принимается, только если он подписан
   // auth-сервисом и выдан на тот же ник, под которым участник вошёл
   _refreshToken(socketId, state, data) {
@@ -526,6 +555,7 @@ export default class PortMachine {
 
             host.createUser({ ...data, name }, socketId, createdId => {
               state.gameId = createdId;
+              this._issueSession(socketId, createdId);
             });
 
             socketManager.sendTechInform(socketId, 'loading');
@@ -549,23 +579,10 @@ export default class PortMachine {
       // 3: map ready
       () => host.mapReady(state.gameId),
 
-      // 4: first shot ready. Участник вошёл в матч — с этого момента ему
-      // есть куда вернуться после обрыва: секрет места (SESSION_DATA)
+      // 4: first shot ready: участник в матче — обрыв держит место
       () => {
+        state.entered = true;
         host.firstShotReady(state.gameId);
-
-        if (this._resumeGraceMs > 0) {
-          const resumeKey = host.issueResumeKey(state.gameId);
-
-          // gameId — клиенту для RESUME_REQUEST: наблюдатель свой id
-          // больше ниоткуда не узнаёт
-          if (resumeKey) {
-            socketManager.sendSessionData(socketId, {
-              resumeKey,
-              gameId: state.gameId,
-            });
-          }
-        }
       },
 
       // 5: keys data ('seq:action:name'; указатель — 'seq:aim:x:y:flags')

package/src/host/host.worker.js

@@ -402,18 +402,6 @@ self.onmessage = async event => {
       }
       break;
 
-    // плановая передача хоста (этап 8d): дождаться границы раунда (у игры
-    // с migration.midRound — ответ сразу)
-    case 'round_boundary_wait':
-      host?.awaitRoundBoundary(() =>
-        self.postMessage({ type: 'round_boundary' }),
-      );
-      break;
-
-    case 'round_boundary_cancel':
-      host?.cancelRoundBoundary();
-      break;
-
     case 'freeze':
       host?.freeze();
       break;
@@ -422,7 +410,7 @@ self.onmessage = async event => {
       host?.unfreeze();
       break;
 
-    // хост закрывает комнату («Leave server» последнего человека): закрыть
+    // хост закрывает комнату (Exit последнего человека): закрыть
     // игры участников и дождаться записи профилей — не дольше timeoutMs
     case 'shutdown': {
       const timeoutMs =

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

@@ -84,8 +84,6 @@ class RoundManager {
 
     // эстафета Worker'ов (Этап 5.2): колбэк переноса на границе раунда
     this._handoffCallback = null;
-    // плановая передача хоста ждёт границы раунда (host-migration этап 8d)
-    this._boundaryCallback = null;
   }
 
   get currentMap() {
@@ -325,18 +323,6 @@ class RoundManager {
     this._handoffCallback = null;
   }
 
-  // плановая передача хоста в игре без migration.midRound (host-migration
-  // этап 8d): колбэк сработает один раз, когда стартует следующий раунд.
-  // Раунд не придерживается — бета всё равно начнёт его заново из мягкой
-  // точки, а сорвавшаяся передача не должна оставить комнату без раунда
-  onRoundBoundary(cb) {
-    this._boundaryCallback = cb;
-  }
-
-  cancelRoundBoundary() {
-    this._boundaryCallback = null;
-  }
-
   // запуск нового раунда
   initiateNewRound() {
     this._timerManager.stopRoundTimer();
@@ -354,13 +340,6 @@ class RoundManager {
 
     this._startRound();
     this._timerManager.startRoundTimer();
-
-    if (this._boundaryCallback) {
-      const cb = this._boundaryCallback;
-
-      this._boundaryCallback = null;
-      cb();
-    }
   }
 
   // начало раунда
@@ -398,6 +377,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 +562,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 +635,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/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/modules/chat/systemMessages.js

@@ -30,7 +30,7 @@ export const ENGINE_MESSAGE_CODES = Object.freeze({
   // голосование «Change host» (host-migration этап 10): ведёт мастер,
   // сообщения добавляет сам клиент, по проводу они не ходят
   HOST_VOTE_USAGE: 'v:6', // 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
   HOST_VOTE_IS_HOST: 'v:7',
   HOST_VOTE_OFFLINE: 'v:8', // No connection to the master server
   HOST_VOTE_RECENT: 'v:9', // A host vote was held recently

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

@@ -46,15 +46,30 @@ export const ENGINE_CAPABILITIES = createRegistry('engine-capabilities', [
   // сервис пула `diagnostics` (журнал клиентских ошибок);
   // опционален — игра не пишет его в `requires`
   { value: 'diagnostics', since: '0.35.0' },
-  // контрольная точка хоста посреди раунда (host-migration этап 5):
-  // gameConfig.migration.midRound, хуки модулей serializeState/restoreState.
-  // Писать в `requires` не нужно: старый движок флаг просто игнорирует, и
-  // игра на нём мигрирует мягко
+  // контрольная точка хоста посреди раунда (host-migration этап 5): хуки
+  // модулей serializeState/restoreState. Писать в `requires` не нужно
   { value: 'host.migration', since: '0.36.0' },
   // голосовая связь (gameConfig.voice, порты VOICE_*, сервис пула `voice`,
   // хуки `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/gameConfigView.js

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