vimp-engine 0.20.0 → 0.21.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vimp-engine",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "VIMP — движок-приложение (мастер, P2P-транспорт, Worker-хост, мета, MVC-каркас клиента)",
   "license": "MIT",
   "repository": {

package/src/client/components/model/Stat.js

@@ -1,27 +1,67 @@
 import Publisher from '../../../lib/Publisher.js';
+import { nickKey } from '../../../lib/validators.js';
 
 // Singleton StatModel
 
 let statModel;
 
 export default class StatModel {
-  constructor(data) {
+  // data — params схемы игры; deps — то, чего у модуля своего нет: топ,
+  // привезённый хостом, свой gameId и свой ник (режим 'leaderboard')
+  constructor(data, deps = {}) {
+    // Синглтон переиспользуется, но НЕ замораживается: runModules зовётся на
+    // каждый вход в матч (порт CONFIG_DATA), и вернуть старый экземпляр
+    // как есть значило бы играть в snakes с параметрами tanks — режим,
+    // период и число строк приезжают из схемы КОНКРЕТНОЙ игры
     if (statModel) {
+      statModel._configure(data, deps);
+
       return statModel;
     }
 
     statModel = this;
 
+    this.publisher = new Publisher();
+    this._configure(data, deps);
+  }
+
+  // всё, что зависит от схемы игры и её сервисов: выделено из конструктора
+  // ровно затем, чтобы переиспользованный синглтон обновлялся, а не врал
+  _configure(data, deps = {}) {
     this._heads = data.heads;
     this._bodies = data.bodies;
     this._sortList = data.sortList;
-    this.publisher = new Publisher();
+
+    // snakes-v3 этап 4: режим 'leaderboard' — по Tab показывается не
+    // таблица комнаты, а глобальный топ игры. Данные хоста в этом режиме не
+    // рисуются (хост их и не шлёт), список приезжает портом ACCOLADES_DATA
+    this._mode = data.mode ?? null;
+    this._period = data.period ?? 'day';
+    this._limit = data.limit ?? 10;
+
+    // сервисы движка, а не сеть: топ уже привезён хостом (см.
+    // client/lib/accolades.js), свой gameId знает клиентское ядро
+    this._accolades = deps.accolades ?? null;
+    this._localPlayer = deps.localPlayer ?? null;
+    this._getNick = deps.getNick ?? (() => null);
+
+    this._rows = [];
+  }
+
+  get isLeaderboard() {
+    return this._mode === 'leaderboard';
   }
 
   // открывает статистику
   open() {
     this.publisher.emit('open');
     this.publisher.emit('mode', { name: 'stat', status: 'opened' });
+
+    if (this.isLeaderboard) {
+      // сети здесь нет вовсе: рисуется последняя рассылка хоста, а
+      // следующая перерисует список сама (см. applyAccolades)
+      this.refreshLeaderboard();
+    }
   }
 
   // закрывает статистику
@@ -32,6 +72,11 @@ export default class StatModel {
 
   // обновляет данные статистики
   update(data) {
+    // в режиме 'leaderboard' данные комнаты не рисуются вовсе
+    if (this.isLeaderboard) {
+      return;
+    }
+
     const tBodiesData = data[0];
     const tHeadData = data[1];
     const fullStatFlag = data[2];
@@ -74,4 +119,80 @@ export default class StatModel {
       }
     }
   }
+
+  // пришла новая рассылка мест и топа (порт ACCOLADES_DATA). Перерисовывать
+  // список стоит только пока статистика открыта? — нет: сборка строк это
+  // десяток объектов, а держать модель в актуальном виде дешевле, чем
+  // объяснять, почему первый Tab показывает вчерашнее
+  applyAccolades() {
+    if (this.isLeaderboard) {
+      this.refreshLeaderboard();
+    }
+  }
+
+  // Пересобирает список из того, что привёз хост. Ни одного запроса: в
+  // матче клиент с мастером не разговаривает (см. client/lib/accolades.js).
+  // Пустой список до первой рассылки — нормальное состояние
+  refreshLeaderboard() {
+    if (!this._accolades) {
+      return;
+    }
+
+    const board = this._accolades.boardOf(this._period);
+    const rows = board.slice(0, this._limit).map(row => ({
+      place: row.place,
+      nick: row.nick,
+      score: row.score,
+      isSelf: false,
+    }));
+
+    this._rows = this._withSelf(rows);
+
+    this.publisher.emit('leaderboard', this._rows);
+  }
+
+  // Своя строка: если игрок в топе — подсвечивается на своём месте, если
+  // нет — заменяет последнюю (решение пользователя 7). Неранжированный за
+  // период получает прочерк вместо места и свои очки (то есть 0).
+  //
+  // `rows` здесь ВСЕГДА чистый топ от хоста, а не результат прошлого прохода:
+  // подставленная своя строка в него не попадает, и сравнение по нику
+  // поэтому честное. Раньше список пересобирался поверх самого себя, и
+  // синтетическая строка выдавала себя за строку из топа — своё место потом
+  // не обновлялось никогда
+  _withSelf(rows) {
+    const nick = this._getNick();
+    const lower = nick ? nickKey(nick) : null;
+    const marked = rows.map(row => ({
+      ...row,
+      isSelf: lower !== null && nickKey(row.nick) === lower,
+    }));
+
+    if (marked.some(row => row.isSelf)) {
+      return marked;
+    }
+
+    // в топе игрока нет — его собственное место знает только рассылка хоста
+    const myId = this._localPlayer?.id ?? null;
+    const mine = myId === null ? null : this._accolades.selfOf(myId, this._period);
+
+    if (!mine || !nick) {
+      return marked;
+    }
+
+    const self = {
+      place: mine.place ?? null,
+      nick,
+      score: mine.score ?? 0,
+      isSelf: true,
+    };
+
+    if (marked.length < this._limit) {
+      marked.push(self);
+    } else {
+      marked[this._limit - 1] = self;
+    }
+
+    return marked;
+  }
 }

package/src/client/components/view/Stat.js

@@ -17,6 +17,8 @@ export default class StatView {
     const { elems, params } = config;
 
     this._stat = document.getElementById(elems.stat);
+    // контейнер списка глобального топа — только в режиме 'leaderboard'
+    this._leaderboard = null;
 
     // DOM scoreboard генерируется по схеме игры: произвольное число
     // команд (bodies) и колонок (columns)
@@ -31,12 +33,24 @@ export default class StatView {
     this._mPublic.on('tHead', 'updateTableHead', this);
     this._mPublic.on('tBody', 'updateTableBody', this);
     this._mPublic.on('clearBodies', 'clearBodies', this);
+    this._mPublic.on('leaderboard', 'updateLeaderboard', this);
   }
 
   // генерирует шапку и таблицы по схеме (замена хардкода stat.pug)
   _buildStat(params) {
     const { columns, bodies } = params;
 
+    // snakes-v3 этап 4: режим 'leaderboard' — один список глобального топа
+    // вместо шапки и таблиц команд. Строки рисует updateLeaderboard, здесь
+    // заводится только контейнер
+    if (params.mode === 'leaderboard') {
+      this._leaderboard = document.createElement('div');
+      this._leaderboard.className = 'stat-leaderboard';
+      this._stat.appendChild(this._leaderboard);
+
+      return;
+    }
+
     const head = document.createElement('div');
 
     head.className = 'stat-head';
@@ -77,6 +91,35 @@ export default class StatView {
     this._stat.appendChild(tables);
   }
 
+  // перерисовывает список глобального топа (режим 'leaderboard'):
+  // место · ник · очки, своя строка помечена is-self. Список короткий и
+  // приходит целиком — точечное обновление строк тут не окупается
+  updateLeaderboard(rows) {
+    if (!this._leaderboard) {
+      return;
+    }
+
+    this._leaderboard.textContent = '';
+
+    for (const row of rows) {
+      const line = document.createElement('div');
+
+      line.className = row.isSelf ? 'stat-row is-self' : 'stat-row';
+
+      // неранжированный за период игрок места не имеет — прочерк вместо
+      // числа честнее, чем выдуманная позиция
+      for (const value of [row.place ?? '—', row.nick, row.score]) {
+        const cell = document.createElement('span');
+
+        // String(): ноль очков — это «0», а не пустая ячейка
+        cell.textContent = String(value);
+        line.appendChild(cell);
+      }
+
+      this._leaderboard.appendChild(line);
+    }
+  }
+
   // открывает статистику
   open() {
     this._stat.style.display = 'block';

package/src/client/lib/accolades.js

@@ -0,0 +1,56 @@
+// Сервис пула зависимостей `accolades` (snakes-v3 этап 4): всё, что комната
+// знает о глобальном топе игры.
+//
+// Отвечает на три вопроса:
+//   placeOf(id)        — какое место у этой сущности в топе-10 (для part'а,
+//                        который рисует за место знак);
+//   boardOf(period)    — сам топ строками (для режима stat 'leaderboard');
+//   selfOf(id, period) — место и очки самого игрока, чтобы он видел свою
+//                        строку, даже когда в топ не входит.
+//
+// ЗА ТОПОМ ХОДИТ ХОСТ, А НЕ КЛИЕНТ. Места и таблицу считает
+// host/meta/modules/Accolades.js по тому же публичному топу, что рисует
+// лобби, и шлёт их портом ACCOLADES_DATA только когда они изменились. Клиент
+// в матче не обращается к мастеру вовсе: игрок разговаривает со своим игровым
+// сервером. На целевом масштабе (100 игр × 100 серверов × 8 игроков) разница
+// между «спрашивает каждый клиент» и «спрашивает комната» — четыре порядка на
+// самом дорогом запросе схемы, см. комментарий в хостовом модуле.
+//
+// Движок не знает, что игра нарисует за место: он раздаёт числа, а знак —
+// дело part'а.
+//
+// Ключи приходят строками (gameId на стороне движка — строка), поэтому
+// placeOf/selfOf приводят запрошенный id к строке: у part'а id экземпляра
+// может быть числом ключа кадра.
+export function createAccolades() {
+  let places = {};
+  let boards = {};
+  let self = {};
+
+  return {
+    // применяет рассылку хоста целиком: она всегда полная, а не дельта
+    apply(data) {
+      places = data?.places || {};
+      boards = data?.boards || {};
+      self = data?.self || {};
+    },
+
+    // { daily, monthly } — всегда объект: незнакомый id (бот, гость,
+    // сущность без игрока) не в топе, и это не аварийный случай
+    placeOf(id) {
+      return places[String(id)] || { daily: null, monthly: null };
+    },
+
+    // [{ place, nick, score }] среза ('day'/'month'); пустой массив, пока
+    // первая рассылка не пришла — это нормальное состояние, а не сбой
+    boardOf(period) {
+      return boards[period] || [];
+    },
+
+    // { place, score } игрока в срезе или null: место есть только у
+    // ранжированного за период участника с проверенной личностью
+    selfOf(id, period) {
+      return self[String(id)]?.[period] ?? null;
+    },
+  };
+}

package/src/client/main.js

@@ -35,6 +35,7 @@ import { getBootConfig, resolveBootConfig } from './boot.js';
 import { ensureGameShell, ensureCanvas } from './views/gameShell.js';
 import { createContextTracker } from './lib/contextTracker.js';
 import { createLocalPlayer } from './lib/localPlayer.js';
+import { createAccolades } from './lib/accolades.js';
 import { createDebugApi, debugLog, DEBUG_PREFIX } from './debug.js';
 import { buildClientCoreConfig } from '../lib/clientCoreConfig.js';
 import {
@@ -181,6 +182,7 @@ const PS_STAT_DATA = wsports.server.STAT_DATA;
 const PS_CHAT_DATA = wsports.server.CHAT_DATA;
 const PS_VOTE_DATA = wsports.server.VOTE_DATA;
 const PS_KEYSET_DATA = wsports.server.KEYSET_DATA;
+const PS_ACCOLADES_DATA = wsports.server.ACCOLADES_DATA;
 
 // PC (client ports): порты получения данных от клиента
 const PC_CONFIG_READY = wsports.client.CONFIG_READY;
@@ -279,6 +281,9 @@ let wasm = null;
 // сервис пула зависимостей: «эта сущность моя или чужая?». Ядро читается
 // геттером — оно создаётся позже пула сервисов (см. lib/localPlayer.js)
 const localPlayer = createLocalPlayer(() => clientCore);
+// сервис пула зависимостей: «какое место у этой сущности в глобальном
+// топе?». Места считает хост, part рисует за них знак (см. lib/accolades.js)
+const accolades = createAccolades();
 let inputSeq = 0; // номер отправленного ввода (KEYS_DATA)
 
 // обратный индекс снапшот-схемы игры (CONFIG_DATA.snapshot):
@@ -376,6 +381,9 @@ socketMethods[PS_CONFIG_DATA] = async data => {
       // аргумент конструктора) со своим gameId. Игра без этого сервиса звучит
       // одинаково за всех — чужие подборы и чужие смерти вперемешку со своими
       localPlayer,
+      // места в глобальном топе: знак за место рисует part игры, движок
+      // раздаёт только числа (см. lib/accolades.js)
+      accolades,
       // база ассетов игры — тем же каналом, что и путь к звукам (см. выше):
       // картинки карт живут в пакете игры (dist/img/), движок их не раздаёт.
       // part, объявивший сервис в componentDependencies, строит URL сам —
@@ -639,6 +647,16 @@ socketMethods[PS_STAT_DATA] = data => {
   modules.stat.update(data);
 };
 
+// accolades data: места участников в глобальном топе, сам топ и место
+// игрока в нём. Рассылка приходит от ХОСТА и только когда что-то из этого
+// изменилось — в матче клиент за топом к мастеру не ходит (см.
+// client/lib/accolades.js)
+socketMethods[PS_ACCOLADES_DATA] = data => {
+  accolades.apply(data);
+  // stat в режиме 'leaderboard' рисует ровно эту таблицу
+  modules.stat?.applyAccolades?.();
+};
+
 // chat data
 socketMethods[PS_CHAT_DATA] = data => {
   modules.chat.add(data);
@@ -917,7 +935,13 @@ function runModules(data) {
   // Stat Module
   //==========================================//
 
-  const statModel = new StatModel(statData.params);
+  // режим 'leaderboard' (snakes-v3 этап 4) рисует топ, привезённый хостом:
+  // ни одного запроса из матча — сервисы, а не сеть
+  const statModel = new StatModel(statData.params, {
+    accolades,
+    localPlayer,
+    getNick: () => lobbyAuthModel?.getNick() ?? null,
+  });
 
   // StatView генерирует шапку и таблицы по схеме игры ({ elems, params })
   const statView = new StatView(statModel, statData);
@@ -1789,7 +1813,13 @@ async function fetchServers({ offset, limit, search }) {
 }
 
 // топ-N рейтинга игры (lobby-page-plan) — публичный эндпоинт, доступен и до
-// логина, поэтому без Authorization
+// логина, поэтому без Authorization.
+//
+// Зовётся только ЛОББИ. Из матча за топом ходит хост комнаты и раздаёт его
+// портом ACCOLADES_DATA (host/meta/modules/Accolades.js): 80 000 игроков,
+// спрашивающих мастер лично, и 10 000 комнат, спрашивающих за них, — разные
+// порядки величин. Там же живёт и If-None-Match: валидатор имеет смысл
+// рядом с повторяющимся запросом, а лобби открывают по одному разу
 async function fetchLeaderboard(gameId, period) {
   const params = new URLSearchParams({
     game: gameId,
@@ -1798,7 +1828,6 @@ async function fetchLeaderboard(gameId, period) {
     // значение всегда из lobbyConfig.leaderboardPeriods
     period,
   });
-
   try {
     const res = await fetch(`${lobbyConfig.leaderboardUrl}?${params}`);
 
@@ -1811,7 +1840,7 @@ async function fetchLeaderboard(gameId, period) {
 // позиция вызывающего в рейтинге игры (lobby-page-plan) — требует identity-
 // токена, как и остальные /auth/* запросы игрока (rank/state)
 async function fetchPlacement(gameId, period) {
-  const token = lobbyAuthModel.getToken();
+  const token = lobbyAuthModel?.getToken();
 
   if (!token) {
     return null;

package/src/client/style.css

@@ -286,6 +286,25 @@ body.hide-cursor {
   text-align: right;
 }
 
+/* snakes-v3 этап 4: режим stat 'leaderboard' — не таблицы комнаты, а один
+   список глобального топа. Движок даёт только каркас (три колонки:
+   место, ник, очки), внешний вид игра доопределяет своим ClientPlugin.styles */
+
+#stat .stat-leaderboard {
+  width: 92%;
+  margin: 3% auto;
+}
+
+#stat .stat-row {
+  display: grid;
+  grid-template-columns: 15% 1fr 20%;
+  padding: 1%;
+}
+
+#stat .stat-row span:nth-child(3) {
+  text-align: right;
+}
+
 /*vote*/
 
 #vote {

package/src/config/lobby.js

@@ -44,12 +44,76 @@ 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-сервиса:

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',