vimp-engine 0.19.0 → 0.21.0

package/src/config/lobby.js

@@ -44,12 +44,87 @@ export default {
     stateUrl: '/auth/state',
   },
 
+  // синхронизация профилей участников с мастером (snakes-v3 этап 3):
+  // пределами записи в БД владеет движок, а не игра — «игр сотни, серверов
+  // сотни», и одна игра, зовущая flushPlayerData() каждую секунду, не должна
+  // мочь положить auth-сервис. Игра может попросить синхронизацию, но не
+  // может участить её сверх minFlushInterval (кроме срочных границ:
+  // уход участника и destroy() комнаты)
+  playerData: {
+    // результат игры (PUT { points, best }); GET рангов больше не ходит
+    // сюда — три среза приезжают одним запросом на placementsUrl
+    rankUrl: '/auth/rank',
+    stateUrl: '/auth/state',
+    // агрегирующий роут мастера: { day, month, all } за один поход хоста
+    placementsUrl: '/auth/placements',
+    // точечный перезапрос одного среза (refreshPlacement)
+    placementUrl: '/auth/placement',
+    // ***** ОТКУДА ЭТО ЧИСЛО *****
+    //
+    // Целевой масштаб — 100 игр × 100 серверов × 8 игроков = 80 000 игроков
+    // одновременно. Участник со свежим результатом стоит двух запросов
+    // (PUT rank + PUT state) за интервал, поэтому весь мир пишет
+    //
+    //   80 000 × 2 / интервал.
+    //
+    //   60 с  → 2700 запросов/с — на каждый пишущая транзакция, и это без
+    //           единого всплеска: столько auth-сервис держать не обязан;
+    //   300 с → 530 запросов/с — с запасом, и запас этот нужен на всплески
+    //           (конец раунда синхронизирует комнату целиком).
+    //
+    // Платится за это СВЕЖЕСТЬЮ ГЛОБАЛЬНЫХ рейтингов, и только их: очки
+    // склеиваются в памяти комнаты (сумма складывается, максимум берётся
+    // максимумом — finishGame), поэтому не теряется ничего, а свои значения
+    // игрок видит сразу, локально. Срочные границы (уход участника, destroy
+    // комнаты) интервал обходят, так что «ушёл и потерял» тоже не про это.
+    minFlushInterval: 300000, // мс на участника
+    flushJitter: 0.2, // ±20 % на комнату: сотни серверов по круглому таймеру
+    // потолок очереди запросов комнаты. Держится СТРОГО НИЖЕ потолка
+    // мастера (master:playerData:writesPerMinute / 60 = 2/с): очередь должна
+    // тормозить сама, а не через 429 — отказ стоит round-trip'а и уводит в
+    // бэкофф всю комнату, то есть задерживает и тех, кто ни при чём.
+    // Комната на 32 при интервале в 5 минут выпускает 64 запроса — при 1/с
+    // это чуть больше минуты, вчетверо быстрее следующего интервала
+    maxRequestsPerSecond: 1,
+    // Пауза комнаты после 5xx/429/сетевого сбоя, экспоненциальная. Обе
+    // границы соразмерны minFlushInterval, и это не украшение: потолок НИЖЕ
+    // интервала не значил бы ничего — обычный flush и так ждёт интервал,
+    // пауза короче него не отложила бы ни одного запроса, и бэкофф оказался
+    // бы мёртвым кодом. Поэтому 30 с (заметно, но не наказание за одну
+    // осечку) → 15 минут (втрое дольше интервала: лежащий сервис комната
+    // перестаёт трогать почти совсем)
+    backoff: { baseMs: 30000, maxMs: 900000 },
+    placementTtl: 30000, // троттлинг refreshPlacement, мс
+  },
+
   // рейтинг игры (lobby-page-plan): публичный топ-N и позиция вызывающего,
   // проксируемые мастером под тем же origin — правки CSP не нужны
   leaderboardUrl: '/auth/leaderboard',
   placementUrl: '/auth/placement',
   leaderboardLimit: 10,
 
+  // награды за место в глобальном топе (snakes-v3 этап 4): хост комнаты
+  // периодически спрашивает тот же публичный топ, что рисует лобби, и
+  // рассылает участникам их места. Награда про игрока, а не про комнату,
+  // поэтому источник глобальный, а сопоставление — по нику. Запрос идёт с
+  // If-None-Match: неизменившийся топ стоит 304 и ни одного обращения к БД
+  accolades: {
+    refreshInterval: 45000, // мс между опросами топа
+    // срезы, за которыми ходит хост: ключ ответа -> ?period=
+    periods: { daily: 'day', monthly: 'month' },
+  },
+
+  // rank-periods: срезы рейтинга и тот, что открыт по умолчанию. Порядок
+  // здесь — порядок кнопок; `id` едет в auth как ?period=, `title` идёт в
+  // заголовок списка. Значения должны совпадать с RANK_PERIODS auth-сервиса:
+  // на всё прочее он отвечает 400
+  leaderboardPeriods: [
+    { id: 'day', title: 'TODAY' },
+    { id: 'month', title: 'THIS MONTH' },
+    { id: 'all', title: 'ALL-TIME' },
+  ],
+  defaultLeaderboardPeriod: 'all',
+
   // переподключение сигнального WS хоста (комната без него выпадает из
   // выдачи мастера): экспоненциальный бэкофф от baseDelay до maxDelay (мс)
   reconnect: {
@@ -93,6 +168,12 @@ export default {
     serversContentId: 'lobby-servers-content',
     leaderboardContentId: 'lobby-leaderboard-content',
     leaderboardListId: 'lobby-leaderboard-list',
+    // кнопки срезов (rank-periods): id периода -> id элемента
+    periodBtnIds: {
+      day: 'btn-period-day',
+      month: 'btn-period-month',
+      all: 'btn-period-all',
+    },
     leaderboardTitleId: 'leaderboard-title',
     leaderboardTotalId: 'leaderboard-total',
     myPlacementId: 'lobby-my-placement',

package/src/config/master.js

@@ -29,6 +29,10 @@ export default {
   // пакетами @vimp-games/* из node_modules (master/localGames.js), чтобы
   // прилинкованная игра попадала в лобби без правки этого массива: он
   // публикуется вместе с пакетом vimp-engine
+  // maxGameScore (snakes-v3 этап 3.3, необязательное поле рядом с
+  // id/package) — потолок результата ОДНОЙ игры для этой игры; мастер
+  // клампит им `best`/`points` PUT /auth/rank. Не задан — дефолт
+  // master:playerData:maxGameScore
   games: [{ id: 'tanks', package: '@vimp-games/tanks' }],
 
   // список серверов (GET /servers)
@@ -60,6 +64,32 @@ export default {
     maxLimit: 100,
   },
 
+  // GET /auth/placement + агрегирующий GET /auth/placements (snakes-v3
+  // этап 3.3): место меняется медленно, а каждый вход участника стоит трёх
+  // срезов. Кэш здесь про round-trip до auth; стоимость самого запроса
+  // снята на стороне auth (RankDistribution)
+  placement: {
+    cacheTtl: 30000,
+  },
+
+  // пределы записи профилей в БД (snakes-v3 этап 3, решение пользователя 9):
+  // «игр сотни, серверов сотни» — минимальный интервал держит движок на
+  // стороне хоста, а мастер держит потолок для сломанного или злонамеренного
+  // сервера, который этот интервал обошёл
+  playerData: {
+    // PUT /auth/rank + /auth/state на комнату (проверенный hostId) в минуту.
+    // Честная комната на 32 при lobbyConfig.playerData.minFlushInterval в
+    // 5 минут пишет 64 запроса за эти 5 минут, то есть ~13/мин; остальное —
+    // запас на срочные границы (уход участника обходит интервал), и его
+    // хватает даже комнате, полностью сменившей состав дважды за минуту.
+    // Потолок держит не честную комнату, а сломанную или злонамеренную,
+    // поэтому запас считается от честной, а не «пусть будет побольше»
+    writesPerMinute: 120,
+    // потолок результата ОДНОЙ игры, если игра не объявила свой
+    // (master:games[].maxGameScore): обоснование — plan/snakes-v3/stage_2.md
+    maxGameScore: 10000,
+  },
+
   // рейтинг хостера комнаты (server-rating этап 2, plan/server-rating/
   // stage_2.md): /like·/unlike гостей комнаты вместо соц-модерации /ban.
   // Дефолт движка для всех игр; auth-сервис хранит и клампит рейтинг

package/src/config/opcodes.js

@@ -9,7 +9,9 @@
 // в plugin-api.md), движок больше не выводит контролы из типа значения
 // v3: набор control сокращён до нативных элементов — 'select'|'text'|
 // 'checkbox'|'radio' (были ещё 'range'/'number'/'toggle'/'segmented')
-export const ENGINE_API_VERSION = 3;
+// v4: порт ACCOLADES_DATA (места участников в глобальном топе) и пятый
+// сервис пула зависимостей клиента (`accolades`) — snakes-v3 этап 4
+export const ENGINE_API_VERSION = 4;
 
 // версия формата кадра: первый байт после порта;
 // увеличивать при любом изменении байтовой раскладки в ядре

package/src/config/wsports.js

@@ -19,6 +19,9 @@ export default {
     CHAT_DATA: 15,
     VOTE_DATA: 16,
     KEYSET_DATA: 17,
+    // места участников в глобальном топе (snakes-v3 этап 4): косметика
+    // для parts игры, в снапшот не идёт
+    ACCOLADES_DATA: 18,
   },
   // порты получения данных от клиента
   client: {

package/src/devtools/contract/rules/c11-stat-mode.js

@@ -0,0 +1,60 @@
+import { ERROR, skip, verdict } from '../result.js';
+
+// Режим статистики по Tab объявляется ДВАЖДЫ, и обе половины обязаны
+// совпадать (snakes-v3 этап 4):
+//
+//   gameConfig.statMode              — читает хост (host/HostGame.js);
+//   modules.stat.params.mode         — читает клиент (client/…/model/Stat.js).
+//
+// Рассинхронизация не падает и ничем себя не выдаёт, поэтому её ловит
+// правило, а не рантайм:
+//
+//   объявлен только клиент — хост каждый тик собирает и рассылает таблицу
+//     комнаты, которую клиент выбрасывает первой же строкой update();
+//   объявлен только хост — хост не шлёт таблицу вовсе, а клиент рисует ту
+//     самую таблицу комнаты и она навсегда остаётся пустой.
+//
+// Первое стоит трафика, второе — пустого экрана; оба варианта — дефект
+// конфигурации, а не выбор.
+export default {
+  id: 'C11',
+  name: 'statMode',
+  level: ERROR,
+  title: 'gameConfig.statMode and modules.stat.params.mode agree',
+
+  check(ctx) {
+    const params = ctx.clientConfig?.modules?.stat?.params;
+
+    if (!params || !ctx.gameConfig) {
+      return skip('no client stat params');
+    }
+
+    const client = params.mode ?? null;
+    const host = ctx.gameConfig.statMode ?? null;
+
+    if (client === host) {
+      return verdict([], client ? `both declare '${client}'` : 'the room table');
+    }
+
+    if (client && !host) {
+      return verdict([
+        `modules.stat.params.mode is '${client}', but gameConfig.statMode is ` +
+          'not set: the host keeps broadcasting the room table every tick and ' +
+          'the client throws every one of those messages away',
+      ]);
+    }
+
+    if (host && !client) {
+      return verdict([
+        `gameConfig.statMode is '${host}', but modules.stat.params.mode is ` +
+          'not set: the host sends no stat at all and the client draws the ' +
+          'room table, which stays empty forever',
+      ]);
+    }
+
+    return verdict([
+      `gameConfig.statMode is '${host}' and modules.stat.params.mode is ` +
+        `'${client}': the two halves of the same decision disagree`,
+    ]);
+  },
+};

package/src/devtools/contract/rules/c4-component-dependencies.js

@@ -1,13 +1,20 @@
 import { ERROR, WARN, skip, verdict } from '../result.js';
 
-// Движковых сервисов ровно четыре (client/main.js), но пул ими не
+// Движковых сервисов ровно пять (client/main.js), но пул ими не
 // исчерпывается: игра доливает туда свои через ClientPlugin.hooks.services(core)
 // — например геометрию предсказанной динамики карты
 // (docs/en/plugin-api.md «hooks.services»). Незнакомое имя не ошибка для
 // движка: part получает undefined и рисует пустоту — карта без assetsBase
 // выглядит как чистый холст без единой строки в консоли, ради этого правило
 // и существует.
-const SERVICES = ['renderer', 'soundManager', 'assetsBase', 'localPlayer'];
+const SERVICES = [
+  'renderer',
+  'soundManager',
+  'assetsBase',
+  'localPlayer',
+  // места в глобальном топе (snakes-v3 этап 4)
+  'accolades',
+];
 
 export default {
   id: 'C4',

package/src/devtools/contract/rules/c6-stat-columns.js

@@ -67,6 +67,19 @@ function styledColumns(styles, total) {
   return covered;
 }
 
+// Режим 'leaderboard' (snakes-v3 этап 4): движок даёт списку только
+// каркас, внешний вид — дело игры. Достаточно любого правила плагина про
+// `.stat-leaderboard` — раскладка колонок там на контейнере, а не на ячейках
+function styledLeaderboard(styles) {
+  for (const [, selector] of String(styles || '').matchAll(RULE)) {
+    if (selector.includes('.stat-leaderboard')) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
 export default {
   id: 'C6',
   name: 'statColumns',
@@ -74,12 +87,27 @@ export default {
   title: 'stat columns past the engine layout are styled by the plugin',
 
   check(ctx) {
-    const columns = ctx.clientConfig?.modules?.stat?.params?.columns;
+    const params = ctx.clientConfig?.modules?.stat?.params;
+    const columns = params?.columns;
 
     if (!columns) {
       return skip('no client stat columns');
     }
 
+    // snakes-v3 этап 4: в режиме 'leaderboard' движковых таблиц нет вовсе —
+    // рисуется один список `.stat-leaderboard`, и число колонок движковой
+    // раскладке ничего не говорит. Проверять здесь надо другое: привезла
+    // ли игра свои стили под этот список
+    if (params.mode === 'leaderboard') {
+      return styledLeaderboard(ctx.clientPlugin?.styles)
+        ? verdict([], 'leaderboard list, laid out by the plugin\'s own styles')
+        : verdict([
+            "stat declares mode 'leaderboard', but ClientPlugin.styles says " +
+              'nothing about #stat .stat-leaderboard: the engine CSS gives ' +
+              'the list only a bare three-column skeleton',
+          ]);
+    }
+
     // меньше пяти — движковых ширин просто хватает с запасом
     if (columns.length <= ENGINE_COLUMNS) {
       return verdict([]);

package/src/devtools/contract/rules/index.js

@@ -25,6 +25,7 @@ import c7 from './c7-key-sets.js';
 import c8 from './c8-baked-assets.js';
 import c9 from './c9-chat-messages.js';
 import c10 from './c10-auth-schema.js';
+import c11 from './c11-stat-mode.js';
 import d1 from './d1-snapshot-ids.js';
 import d2 from './d2-snapshot-classes.js';
 import d3 from './d3-snapshot-interp.js';
@@ -37,7 +38,7 @@ import e3 from './e3-sound-registry.js';
 export const rules = [
   a1, a2, a3, a4, a5, a6, a7,
   b1, b2, b3, b4, b5, b6, b7, b8, b9, b10,
-  c1, c2, c3, c4, c5, c6, c7, c8, c9, c10,
+  c1, c2, c3, c4, c5, c6, c7, c8, c9, c10, c11,
   d1, d2, d3,
   e1, e2, e3,
 ];

package/src/host/HostGame.js

@@ -1,4 +1,5 @@
 import Panel from './meta/modules/Panel.js';
+import Accolades from './meta/modules/Accolades.js';
 import PlayerDataSync from './meta/modules/PlayerDataSync.js';
 import Stat from './meta/modules/Stat.js';
 import Chat from './meta/modules/chat/index.js';
@@ -117,6 +118,10 @@ export default class HostGame {
     // endlessRound — раунд не перезапускается сам. Флаги независимы
     this._noSpectators = data.noSpectators === true;
     this._endlessRound = data.endlessRound === true;
+    // statMode — чем игра занимает экран по Tab. 'leaderboard' значит, что
+    // клиент рисует глобальный топ, который тянет сам: движковый stat в
+    // этом режиме никто не рисует, и платить за его рассылку незачем
+    this._statLeaderboard = data.statMode === 'leaderboard';
     this._spectatorTeam = this._noSpectators ? null : data.spectatorTeam;
     this._spectatorId = this._noSpectators
       ? null
@@ -146,6 +151,18 @@ export default class HostGame {
       // мастера) — подменяется только там, в проде остаётся глобальный fetch
       ...(playerDataFetch ? { fetchImpl: playerDataFetch } : {}),
     });
+    // места участников в глобальном топе (snakes-v3 этап 4): косметика для
+    // parts игры, движок не знает, какой знак игра нарисует за место
+    this._accolades = new Accolades({
+      participants: this._participants,
+      gameId: this._gameId,
+      // место и очки самого участника: их привозит PlayerDataSync на входе,
+      // и без них игрок вне топа-10 не увидел бы по Tab собственной строки
+      getRating: (id, period) => this._playerDataSync.getRating(id, period),
+      // headless-прогону некуда ходить за топом — тот же подмен, что и у
+      // PlayerDataSync
+      ...(playerDataFetch ? { fetchImpl: playerDataFetch } : {}),
+    });
     this._chat = new Chat();
     this._vote = new Vote();
 
@@ -344,9 +361,20 @@ export default class HostGame {
       removedPlayersList.pop();
     }
 
+    // фоновый опрос глобального топа: сам решает, пора ли (refreshInterval)
+    this._accolades.tick();
+
     const userList = this._participants.getNetworkedReady();
     const panelUpdates = this._panel.processUpdates();
-    const stat = this._stat.getLast();
+    // getLast() — ЕДИНСТВЕННЫЙ дренаж Stat: reset() в _lastBody только
+    // дописывает. Поэтому буфер осушается всегда, даже когда рассылки не
+    // будет: пропуск вызова в режиме leaderboard растил бы эти массивы всё
+    // время жизни комнаты (endlessRound — она живёт часами), а StatBridge
+    // пишет в них на каждый подобранный кристалл. Гейтится ОТПРАВКА
+    const lastStat = this._stat.getLast();
+    // в режиме leaderboard движковый stat не рисуется вовсе — не шлём
+    const stat = this._statLeaderboard ? null : lastStat;
+    const accolades = this._accolades.shift();
     const chat = this._chat.shift();
     const vote = this._vote.shift();
 
@@ -421,6 +449,10 @@ export default class HostGame {
         this._socketManager.sendStat(socketId, stat);
       }
 
+      if (accolades) {
+        this._socketManager.sendAccolades(socketId, accolades);
+      }
+
       const chatUser = chat || this._chat.shiftByUser(gameId);
       if (chatUser) {
         this._socketManager.sendChat(socketId, chatUser);
@@ -510,6 +542,20 @@ export default class HostGame {
     user.isReady = true;
     this._socketManager.sendTechInform(socketId);
     this._socketManager.sendFirstVote(socketId);
+
+    // топ и места в нём — целиком и лично, как и первый кадр stat.
+    // Периодическая рассылка (shift() в игровом цикле) уходит только тем,
+    // кто УЖЕ готов, а места новичка посчитаны на его входе, за всю загрузку
+    // карты до этой строки: та рассылка ушла бы без него и не повторилась
+    // бы — места с тех пор не менялись, — и ни знак, ни таблица по Tab не
+    // появились бы до первого чужого входа. В комнате, куда больше никто не
+    // заходит, никогда
+    const accoladesNow = this._accolades.current();
+
+    if (Object.keys(accoladesNow.places).length) {
+      this._socketManager.sendAccolades(socketId, accoladesNow);
+    }
+
     this._chat.pushSystem('USER_JOINED', [user.name]);
 
     // noSpectators: голосования за вход нет — участник уже в играющей
@@ -643,7 +689,11 @@ export default class HostGame {
     // иначе removeUser стартует второй flush с той же накопленной дельтой
     // (двойной зачёт рейтинга), а destroy разрешился бы раньше, чем эти
     // запросы уйдут
-    await this._playerDataSync.flushAll();
+    // незакрытые игры участников закрываются здесь: их очки иначе не
+    // попали бы ни в сумму, ни в максимум и пропали бы вместе с комнатой
+    // (правило 7 snakes-v3 этап 3 — запись гарантирована в destroy())
+    this._playerDataSync.finishAllGames();
+    await this._playerDataSync.flushAll({ urgent: true });
 
     // getAll() отдаёт копию — снятие внутри цикла реестр не ломает
     for (const user of this._participants.getAll()) {
@@ -863,6 +913,11 @@ export default class HostGame {
     // вход; сбой auth-сервиса оставляет участника с дефолтами
     this._playerDataSync.load(gameId, params.token);
 
+    // место новичка в глобальном топе: знак должен появиться сразу, а не
+    // на следующем периодическом опросе. Это пересчёт по уже известным
+    // срезам, а не поход за ними — за топом ходит только tick()
+    this._accolades.noteRoster();
+
     queueMicrotask(() => {
       cb(gameId);
     });
@@ -886,9 +941,12 @@ export default class HostGame {
     this._vote.removeUser(gameId);
     this._panel.removeUser(gameId);
 
-    // финальная синхронизация rank/state перед уходом участника (Этап B4)
+    // финальная синхронизация профиля перед уходом участника (Этап B4):
+    // незавершённая игра закрывается — второго шанса записать её очки не
+    // будет, — и интервал синхронизации эта граница обходит (urgent)
+    this._playerDataSync.finishGame(gameId);
     this._playerDataSync
-      .flush(gameId)
+      .flush(gameId, { urgent: true })
       .catch(err =>
         console.warn('[playerData] final flush failed:', err.message),
       )
@@ -1058,11 +1116,62 @@ export default class HostGame {
 
   // прибавка к рангу для игр, которые не эмитят CoreEvent::Death и потому
   // никогда не проходят через RoundManager.reportKill: прямая прокладка к
-  // PlayerDataSync, без раунд-логики и без проверки team-wipe
+  // PlayerDataSync, без раунд-логики и без проверки team-wipe.
+  // @deprecated snakes-v3: алиас addPlayerPoints
   addPlayerRank(gameId, delta) {
     this._playerDataSync.addRank(gameId, delta);
   }
 
+  // ***** результат игры (snakes-v3 этап 3) ***** //
+
+  // очки ТЕКУЩЕЙ игры участника: жизнь, раунд, матч — что игра называет
+  // игрой. В рейтинги они попадают только на finishPlayerGame
+  addPlayerPoints(gameId, delta) {
+    this._playerDataSync.addPoints(gameId, delta);
+  }
+
+  // игра участника закончилась: накопленные очки уходят в сумму (месячный
+  // рейтинг) и в максимум (дневной). Игра без раундов зовёт это сама — у
+  // игры с раундами обе границы закрывает RoundManager
+  finishPlayerGame(gameId) {
+    this._playerDataSync.finishGame(gameId);
+  }
+
+  // значения среза для показа: { value, placement, total } или null
+  getPlayerRating(gameId, period) {
+    return this._playerDataSync.getRating(gameId, period);
+  }
+
+  // приехал ли СРЕЗ с мастера: ноль незагруженного рейтинга и настоящий
+  // ноль — разные вещи, и игре, которая на них смотрит, надо их различать
+  isPlayerRatingLoaded(gameId, period) {
+    return this._playerDataSync.isRatingLoaded(gameId, period);
+  }
+
+  // точечный перезапрос места в срезе (чат-команда /rank): место меняют
+  // чужие игры, локально его не пересчитать. Троттлинг — в PlayerDataSync
+  refreshPlayerPlacement(gameId, period) {
+    return this._playerDataSync.refreshPlacement(gameId, period);
+  }
+
+  // синхронизация профилей (rank/state) всех участников на мастер прямо
+  // сейчас — для игр, у которых нет ни конца раунда, ни смены карты
+  // (`endlessRound` + карта, пересобираемая через overrideMapData): обе
+  // штатные границы flushAll живут в RoundManager, и такая игра не проходит
+  // ни через одну из них. Без этого накопленный за матч ранг уезжает в auth
+  // только на выходе участника, а закрытая вкладка хоста теряет его вовсе.
+  //
+  // Best-effort, как и весь PlayerDataSync: промис не отвергается, сбой
+  // логируется в `[playerData]` и повторится следующим flush'ем.
+  //
+  // snakes-v3 этап 3: это просьба, а не команда — участник, у которого с
+  // прошлой синхронизации прошло меньше lobbyConfig.playerData.
+  // minFlushInterval, пропускается. Срочные границы (уход участника,
+  // destroy комнаты) интервал обходят, игре они недоступны
+  flushPlayerData({ urgent = false } = {}) {
+    return this._playerDataSync.flushAll({ urgent });
+  }
+
   // hostId + per-room секрет комнаты, подтверждённые мастером при
   // register_host (кодревью №1) — не известны при создании HostGame (Worker
   // стартует раньше ответа мастера); нужны PlayerDataSync для атрибуции

package/src/host/meta/SocketManager.js

@@ -39,6 +39,7 @@ export default class SocketManager {
     this._PORT_CHAT_DATA = ports.CHAT_DATA;
     this._PORT_VOTE_DATA = ports.VOTE_DATA;
     this._PORT_KEYSET_DATA = ports.KEYSET_DATA;
+    this._PORT_ACCOLADES_DATA = ports.ACCOLADES_DATA;
 
     this._soundCues = soundCues;
     this._initialVote = initialVote;
@@ -337,6 +338,16 @@ export default class SocketManager {
     this._send(socketId, this._PORT_STAT_DATA, data);
   }
 
+  /**
+   * Отправка мест участников в глобальном топе (snakes-v3 этап 4). Движок
+   * раздаёт числа, знак за место рисует part игры.
+   * @param {string} socketId
+   * @param {Object} data - { [gameId]: { daily, monthly } }
+   */
+  sendAccolades(socketId, data) {
+    this._send(socketId, this._PORT_ACCOLADES_DATA, data);
+  }
+
   /**
    * Отправка сообщения чата.
    * @param {string} socketId

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

@@ -146,8 +146,11 @@ class RoundManager {
     this._stat.reset();
     this._voteCoordinator.reset();
 
-    // синхронизация накопленных rank/state на мастер перед сменой карты
-    // (Этап B4) — естественная граница жизненного цикла
+    // синхронизация накопленных профилей на мастер перед сменой карты
+    // (Этап B4) — естественная граница жизненного цикла. Смена карты
+    // заканчивает игру каждого участника (snakes-v3 этап 3): без этого у
+    // игры с раундами дневной максимум навсегда остался бы нулём
+    this._playerDataSync?.finishAllGames?.();
     this._playerDataSync?.flushAll();
 
     this._snapshotManager.reset();
@@ -696,8 +699,10 @@ class RoundManager {
       );
     }
 
-    // синхронизация накопленных rank/state на мастер по итогам раунда
-    // (Этап B4) — естественная граница жизненного цикла
+    // синхронизация накопленных профилей на мастер по итогам раунда
+    // (Этап B4) — естественная граница жизненного цикла. Конец раунда и
+    // есть конец игры участника (snakes-v3 этап 3)
+    this._playerDataSync?.finishAllGames?.();
     this._playerDataSync?.flushAll();
 
     if (winnerTeam) {