vimp-engine 0.36.0 → 0.37.0

package/package.json

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

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

@@ -17,6 +17,7 @@ export default class ChatModel {
     this._cacheMin = data.cacheMin || 200;
     this._cacheMax = data.cacheMax || 300;
     this._messages = data.messages || {};
+    this._defaults = data.defaultMessages || {};
 
     this._formatMessage = data.formatMessage;
     this._sanitizeMessage = data.sanitizeMessage;
@@ -49,6 +50,20 @@ export default class ChatModel {
     }
   }
 
+  // текст шаблона: строка игры важнее умолчания движка; '' — игра
+  // заглушила сообщение; null/нет индекса — английское умолчание
+  _template(group, index) {
+    const own = this._messages[group]?.[index];
+
+    if (typeof own === 'string') {
+      return own === '' ? null : own;
+    }
+
+    const fallback = this._defaults[group]?.[index];
+
+    return typeof fallback === 'string' && fallback !== '' ? fallback : null;
+  }
+
   // обновляет чат-лист. Данные могут быть 2-х видов:
   // - в виде строки '<группа шаблонов>:<номер шаблона>:<параметры>'
   // - в виде массива [<текст сообщения>,<имя автора>,<тип для класса>,
@@ -58,12 +73,14 @@ export default class ChatModel {
     if (typeof arr === 'string') {
       arr = arr.split(':');
 
+      const template = this._template(arr[0], arr[1]);
+
       // если сообщений не найдено
-      if (!this._messages[arr[0]] || !this._messages[arr[0]][arr[1]]) {
+      if (template === null) {
         return;
       }
 
-      let message = this._messages[arr[0]][arr[1]];
+      let message = template;
       const params = arr[2];
 
       // если есть параметры

package/src/client/main.js

@@ -50,6 +50,7 @@ import { dispatchSocketMessage } from './lib/socketDispatch.js';
 import { pickActiveGame, isGameAvailable } from './lib/pickActiveGame.js';
 import { readCoreAbi, dispatchCoreOp, ABI_UNKNOWN } from '../lib/coreAbi.js';
 import { ABI_OP_DEBUG_JSON } from '../config/abiOps.js';
+import engineChatMessages from '../config/chatMessages.js';
 import { createDebugApi, debugLog, DEBUG_PREFIX } from './debug.js';
 import { buildClientCoreConfig } from '../lib/clientCoreConfig.js';
 import { buildSnapshotKeysById } from '../lib/reconstructHot.js';
@@ -1147,6 +1148,7 @@ function runModules(data) {
     cacheMin: chatData.params.cacheMin,
     cacheMax: chatData.params.cacheMax,
     messages: chatData.params.messages,
+    defaultMessages: engineChatMessages,
     sanitizeMessage,
     formatMessage,
   });

package/src/config/chatMessages.js

@@ -0,0 +1,45 @@
+// Английские тексты движковых кодов чата по умолчанию (группы s, v, m, c, n);
+// индекс = номер кода. Лежат здесь, а не в clientDefaults: при слиянии
+// конфига массивы заменяются целиком, и массив `s` игры стёр бы умолчания.
+// Правило перекрытия: строка игры по тому же индексу важнее умолчания;
+// '' — игра заглушает сообщение; null/нет индекса — берётся умолчание.
+// Новый код движка добавляется в ENGINE_MESSAGE_CODES (host/meta/modules/chat/
+// systemMessages.js), сюда и в RESERVED правила B8 одним изменением —
+// за этим следит tests/config/chatMessages.test.js.
+export default {
+  s: [
+    'Team {0} is full. Your current team: {1}',
+    'Your team: {0}',
+    'Your new team: {0}',
+    'Your new status: spectator',
+    '{0} killed {1}',
+    '{0} joined the game',
+    '{0} left the game',
+    'Host changed',
+    'You are no longer the host (connection lost)',
+    'Host changed: the previous host was lagging',
+    'Host changed: the previous host went inactive',
+    'Host changed: the previous host had a poor connection',
+  ],
+  v: [
+    'A vote has been created',
+    'Voting has started',
+    'Your vote has been accepted',
+    'Voting is temporarily unavailable',
+    'Vote passed',
+    'Vote failed',
+    'Usage: /changehost',
+    'You are the host — use “Hand over host” in the room menu',
+    'No connection to the master server',
+    'A host vote was held recently',
+    'No other player can host',
+    'A host vote is already in progress',
+    'A host vote is not possible right now',
+    'Vote to change host passed ({0}/{1})',
+    'Vote to change host failed ({0}/{1})',
+    'Host vote cancelled',
+  ],
+  m: ['Current map: {0}', 'Next map: {0}'],
+  c: ['Command not found', 'Your rank: {0}'],
+  n: ['Invalid name', '{0} changed name to {1}'],
+};

package/src/devtools/contract/rules/b8-system-messages.js

@@ -3,8 +3,8 @@ import { ERROR, skip, verdict } from '../result.js';
 // Регистрация игровых кодов — слепой Object.assign поверх движкового
 // реестра: код в зарезервированном диапазоне затирает движковое сообщение
 // без предупреждения, и вместо «Vote passed» игрок видит игровой текст.
-// Диапазоны — длины движковых групп (client/config/chat messages).
-const RESERVED = { s: 11, v: 15, m: 1, c: 1, n: 1 };
+// Диапазоны — длины движковых групп (config/chatMessages.js).
+export const RESERVED = { s: 11, v: 15, m: 1, c: 1, n: 1 };
 
 export default {
   id: 'B8',

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

@@ -1,8 +1,9 @@
 // Реестр кодов системных сообщений чата. Движковые группы: s (статусы),
 // v (голосования), m (карты), c (команды), n (имена). Игровые коды
 // (у танков — группа b:*) добавляются через registerCodes и не должны
-// пересекаться с движковыми группами. Тексты шаблонов — на клиенте.
-const MESSAGE_CODES = {
+// пересекаться с движковыми группами. Английские тексты движковых кодов — config/chatMessages.js,
+// игровых — на клиенте (конфиг игры).
+export const ENGINE_MESSAGE_CODES = Object.freeze({
   TEAMS_TEAM_FULL: 's:0', // Team {0} is full. Your current team: {1}
   TEAMS_YOUR_TEAM: 's:1', // Your team: {0}
   TEAMS_NEW_TEAM: 's:2', // Your new team: {0}
@@ -48,7 +49,10 @@ const MESSAGE_CODES = {
 
   NAME_INVALID: 'n:0', // Invalid name
   NAME_CHANGED: 'n:1', // {0} changed name to {1}
-};
+});
+
+// изменяемый реестр: движковые коды + игровые из registerCodes
+const MESSAGE_CODES = { ...ENGINE_MESSAGE_CODES };
 
 /**
  * Регистрирует игровые коды системных сообщений (merge в реестр движка).

package/tests/fixtures/miniGame/config/client.js

@@ -57,41 +57,6 @@ export default {
     chat: {
       params: {
         messages: {
-          s: [
-            'Team {0} is full. Your current team: {1}',
-            'Your team: {0}',
-            'Your new team: {0}',
-            'Your new status: spectator',
-            '{0} killed {1}',
-            '{0} joined the game',
-            '{0} left the game',
-            'Host changed',
-            'You are no longer the host (connection lost)',
-            'Host changed: the previous host was lagging',
-            'Host changed: the previous host went inactive',
-            'Host changed: the previous host had a poor connection',
-          ],
-          v: [
-            'A vote has been created',
-            'Voting has started',
-            'Your vote has been accepted',
-            'Voting is temporarily unavailable',
-            'Vote passed',
-            'Vote failed',
-            'Usage: /changehost',
-            'You are the host — use “Hand over host” in the room menu',
-            'No connection to the master server',
-            'A host vote was held recently',
-            'No other player can host',
-            'A host vote is already in progress',
-            'A host vote is not possible right now',
-            'Vote to change host passed ({0}/{1})',
-            'Vote to change host failed ({0}/{1})',
-            'Host vote cancelled',
-          ],
-          m: ['Current map: {0}', 'Next map: {0}'],
-          c: ['Command not found'],
-          n: ['Invalid name', '{0} changed name to {1}'],
           g: ['{0} scripted participant(s) spawned'],
         },
       },