vimp-engine 0.40.0 → 0.41.0

package/src/client/style.css

@@ -177,6 +177,39 @@ body.hide-cursor {
   background-color: #333;
 }
 
+/* ячейки с подписью (panel.cells): подпись, значение и шкала */
+#panel table td {
+  position: relative;
+}
+
+#panel table td .panel-label {
+  opacity: 0.6;
+  margin-right: 0.4em;
+}
+
+#panel table td.is-empty {
+  opacity: 0.5;
+}
+
+#panel table td div.panel-gauge {
+  position: absolute;
+  left: 0;
+  bottom: 0;
+  width: 0;
+  height: 2px;
+  background-color: currentColor;
+}
+
+@keyframes panel-gauge-fill {
+  from {
+    width: 0;
+  }
+
+  to {
+    width: 100%;
+  }
+}
+
 /* bar-поля панели (type: 'bar' в схеме игры) — классы нейтральные,
    без привязки к игровым DOM-id */
 #panel table td div.panel-bar-wrapper {
@@ -211,6 +244,11 @@ body.hide-cursor {
   #panel table td div.panel-bar-blink {
     animation: none;
   }
+
+  #panel table td div.panel-gauge {
+    animation: none !important;
+    width: 100%;
+  }
 }
 
 /*stat*/
@@ -314,6 +352,29 @@ body.hide-cursor {
   text-align: right;
 }
 
+/*menu hint*/
+
+/* Подсказка личного меню (корзина) под местом HUD связи; игра
+   перестилизует её по #menu-hints и .menu-hint.is-on. Селектор по id
+   перебивает `.vimp-shell > * { display: none }` */
+#menu-hints {
+  display: block;
+  position: absolute;
+  right: 24px;
+  top: calc(50% + 44px);
+  z-index: 4;
+  pointer-events: none;
+  color: #fff;
+}
+
+#menu-hints .menu-hint {
+  display: none;
+}
+
+#menu-hints .menu-hint.is-on {
+  display: block;
+}
+
 /*voice*/
 
 /* Нейтральный вид HUD связи; игра перестилизует его по #voice-hud и
@@ -331,7 +392,7 @@ body.hide-cursor {
   gap: 8px;
   color: #fff;
   font-size: 14px;
-  text-shadow: 1px 1px 1px #000;
+  text-shadow: 0 0 1px #000;
 }
 
 #voice-hud.is-talking,
@@ -358,6 +419,12 @@ body.hide-cursor {
   display: flex;
 }
 
+/* тёмная обводка: серый и зелёный значок читаются на светлой карте */
+#voice-hud .voice-icon,
+#voice-hud .voice-ring {
+  filter: drop-shadow(0 0 1px #000);
+}
+
 #voice-hud .voice-icon {
   width: 32px;
   height: 32px;
@@ -375,17 +442,22 @@ body.hide-cursor {
   display: none;
 }
 
+#voice-hud .voice-mark {
+  position: relative;
+  display: flex;
+}
+
 #voice-hud .voice-ring {
   display: none;
   position: absolute;
-  left: -2px;
-  top: -2px;
+  left: 50%;
+  top: 50%;
   width: 36px;
   height: 36px;
   fill: none;
   stroke: currentColor;
   stroke-width: 2;
-  transform: rotate(-90deg);
+  transform: translate(-50%, -50%) rotate(-90deg);
 }
 
 #voice-hud.is-talking .voice-ring {
@@ -489,6 +561,11 @@ body.hide-cursor {
   overflow: hidden;
 }
 
+/* недоступный пункт личного меню */
+#vote .vote-list li.disabled {
+  opacity: 0.4;
+}
+
 #vote .vote-nav {
   padding: 0 0 0 5px;
   margin-top: 10px;

package/src/client/voice/MicCapture.js

@@ -186,7 +186,9 @@ export default class MicCapture {
     try {
       stream = await this._mediaDevices.getUserMedia({
         audio: {
-          echoCancellation: true,
+          // эхоподавление включает системную обработку голоса (macOS) и
+          // приглушает весь остальной звук на время открытия и закрытия
+          echoCancellation: false,
           noiseSuppression: true,
           autoGainControl: true,
           channelCount: 1,

package/src/config/abiOps.js

@@ -23,6 +23,43 @@ export const abiOps = createRegistry('abiOps', [
     payload: 'none',
     response: 'json',
   },
+  // ответ игрока на личное меню: { id, name, path } (путь листа «2.1»)
+  {
+    value: 'menu.answer',
+    since: 4,
+    payload: 'json',
+    response: 'none',
+  },
+  // участник покинул матч: { id } — ядро игры удаляет всё, что хранит о нём
+  {
+    value: 'actor.forget',
+    since: 4,
+    payload: 'json',
+    response: 'none',
+  },
+  // новая игра: движок обнулил счёт, ядро игры сбрасывает накопленное
+  // между раундами
+  {
+    value: 'match.reset',
+    since: 4,
+    payload: 'json',
+    response: 'none',
+  },
+  // состояние игры между раундами: запрос { roundOver }, ответ — JSON игры,
+  // который переживает мягкую миграцию хоста и эстафету Worker'а
+  {
+    value: 'state.persist',
+    since: 4,
+    payload: 'json',
+    response: 'json',
+  },
+  // тот же JSON обратно новому ядру до первого раунда
+  {
+    value: 'state.restore',
+    since: 4,
+    payload: 'json',
+    response: 'none',
+  },
 ]);
 
 // плоский список активных опкодов — то, что вправе позвать движок
@@ -33,5 +70,10 @@ export const ABI_OPS = abiOps.values();
 // опкод уехал бы в прод, не попав ни в слепок поверхности, ни в
 // CHANGELOG. Имя опкода читается ТОЛЬКО отсюда.
 export const ABI_OP_DEBUG_JSON = 'debug.json';
+export const ABI_OP_MENU_ANSWER = 'menu.answer';
+export const ABI_OP_ACTOR_FORGET = 'actor.forget';
+export const ABI_OP_MATCH_RESET = 'match.reset';
+export const ABI_OP_STATE_PERSIST = 'state.persist';
+export const ABI_OP_STATE_RESTORE = 'state.restore';
 
 export default abiOps;

package/src/config/menuName.js

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

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';
@@ -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();
@@ -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) {

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/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()) {