vimp-engine 0.20.0 → 0.22.0

package/src/host/meta/modules/chat/Chat.js

@@ -26,9 +26,15 @@ class Chat {
     delete this._userList[gameId];
   }
 
-  // добавляет сообщение
-  push(message, name, teamId) {
-    this._list.push([message, name, teamId]);
+  // добавляет сообщение. color ('#rrggbb') — цвет ника, который игра задала
+  // через ParticipantManager.setChatColor; без него четвёртого элемента в
+  // массиве нет вовсе, и провод игры, которая цвет не задаёт, не меняется
+  push(message, name, teamId, color) {
+    if (typeof color === 'string') {
+      this._list.push([message, name, teamId, color]);
+    } else {
+      this._list.push([message, name, teamId]);
+    }
   }
 
   // добавляет системное сообщение для всех

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

@@ -7,6 +7,12 @@ class Participant {
     this.team = team;
     this.teamId = teamId;
     this.status = 'spectator'; // 'spectator' | 'active' | 'dead'
+
+    // цвет ника в чате ('#rrggbb') или null — тогда ник красит класс команды.
+    // Ставит его игра (ParticipantManager.setChatColor): движок не знает, чем
+    // игра различает игроков визуально, а команда для этого годится не всегда
+    // — в игре на одну команду все ники одного цвета
+    this.chatColor = null;
     // индекс точки респауна, занятой этим участником, или null. Раздаёт и
     // освобождает его RoundManager: размер команды для этого не годится —
     // он меняется на входах и выходах, а между попаданием в команду и

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

@@ -149,6 +149,22 @@ class ParticipantManager {
     this._participants.delete(gameId);
   }
 
+  // задаёт цвет ника в чате: '#rgb'/'#rrggbb' или null (цвет команды).
+  // Единственный вход для игры — HostGame отдаёт это значение в chat.push,
+  // а клиентская view кладёт его инлайновой переменной на строку
+  setChatColor(gameId, color) {
+    const participant = this._participants.get(gameId);
+
+    if (!participant) {
+      return;
+    }
+
+    participant.chatColor =
+      typeof color === 'string' && /^#(?:[0-9a-f]{3}|[0-9a-f]{6})$/i.test(color)
+        ? color
+        : null;
+  }
+
   get(gameId) {
     return this._participants.get(gameId);
   }

package/src/lib/validators.js

@@ -168,3 +168,50 @@ export const clampLimit = (value, fallback, max) => {
 
   return Number.isInteger(num) ? Math.min(Math.max(num, 1), max) : fallback;
 };
+
+// Сколько завершённых игр движок может склеить в один запрос: окно склейки
+// на его стороне — минута (lobbyConfig.playerData.minFlushInterval), столько
+// игр в неё не влезает.
+//
+// Множитель СВЯЗАН с rank.maxPoints auth-сервиса (packages/auth/src/config/
+// auth.js): мастер не должен пропускать то, что auth отклонит. Отклонённое
+// тело для хоста неустранимо — PlayerDataSync повторял бы его до конца жизни
+// комнаты, — поэтому при правке per-game maxGameScore проверяется и потолок
+// суммы на той стороне.
+const MERGED_GAMES_PER_WINDOW = 20;
+
+// клампит результат игры (snakes-v3 этап 3.3): `best` — очки ОДНОЙ игры,
+// `points` — сумма склеенных игр с прошлой синхронизации. Потолок одной
+// игры объявляет сама игра (master:games[].maxGameScore), потолок суммы —
+// это же значение на минутное окно синхронизации; всё, что больше, значит
+// либо взломанного клиента, либо неверно настроенную игру, и мастер режет
+// его перед проксированием, а не отклоняет запрос целиком: честная часть
+// результата не должна пропадать из-за одной аномальной строки.
+// Инвариант `best <= points` держится и после клампа — auth его требует
+export const clampGameResult = (points, best, maxGameScore) => {
+  const maxPoints = maxGameScore * MERGED_GAMES_PER_WINDOW;
+  const toInt = value => {
+    const num = Math.trunc(Number(value));
+
+    return Number.isFinite(num) ? Math.max(num, 0) : 0;
+  };
+  const cappedBest = Math.min(toInt(best), maxGameScore);
+  const cappedPoints = Math.min(toInt(points), maxPoints);
+
+  return {
+    points: cappedPoints,
+    // best > points — битый клиент: сумма не может быть меньше своего
+    // максимума. Поднимать сумму до максимума значило бы дорисовать
+    // месячному рейтингу очки, которых не было, поэтому режется best
+    best: Math.min(cappedBest, cappedPoints),
+    // превышение логируется вызывающим: это сигнал о сломанной игре
+    clamped: cappedBest !== toInt(best) || cappedPoints !== toInt(points),
+  };
+};
+
+// Ключ сопоставления ника с глобальным топом. Уникальность users.nick в auth
+// регистронезависимая (миграция 002), поэтому и сравнивать надо так же —
+// иначе «Alice» и «alice» разъедутся. Правило одно, а мест, где по нику
+// ищут, три (host/meta/modules/Accolades.js, client/components/model/Stat.js
+// и сам auth), поэтому оно живёт здесь, а не переписывается в каждом.
+export const nickKey = nick => String(nick ?? '').toLowerCase();