vimp-engine 0.22.1 → 0.24.0

package/src/lib/coreConfig.js

@@ -11,9 +11,9 @@ import wsports from '../config/wsports.js';
 
 /**
  * Собирает объект конфигурации ядра.
- * @param {Object} gameConfig - HostPlugin.gameConfig игры, загруженной
- *   динамически по GameManifest (Этап 6.4) — движок больше не знает игру
- *   статически.
+ * @param {Object} gameConfig - Представление HostPlugin.gameConfig
+ *   (lib/gameConfigView.js): поля игры плюс движковые умолчания. Прямой
+ *   gameConfig сюда не передаётся — он обходит умолчания (И2).
  * @param {Object} [overrides] - Переопределения плоским объектом (например,
  *   seed для воспроизводимых прогонов или friendlyFire) — распределяются
  *   по движковой/игровой половине автоматически.

package/src/lib/createHostRuntime.js

@@ -40,9 +40,11 @@ export async function createHostRuntime(room, options = {}) {
 
   const hostPlugin = await loadHostPlugin(room);
 
-  assertGameConfigShape(hostPlugin);
+  // одна view на прогон: она же валидирует обязательные поля gameConfig и
+  // подставляет умолчания для всего остального (lib/gameConfigView.js)
+  const configView = assertGameConfigShape(hostPlugin);
 
-  const game = applyRoomOverrides(room, hostPlugin);
+  const game = applyRoomOverrides(room, hostPlugin, configView);
 
   if (overrideGameConfig) {
     overrideGameConfig(game);
@@ -57,7 +59,7 @@ export async function createHostRuntime(room, options = {}) {
 
   const core = await hostPlugin.createCore(
     JSON.stringify(
-      buildCoreConfig(hostPlugin.gameConfig, {
+      buildCoreConfig(configView, {
         friendlyFire: game.parts.friendlyFire,
         seed,
       }),

package/src/lib/formControls.js

@@ -0,0 +1,89 @@
+import { createRegistry } from './registry.js';
+
+// Реестр значений `control` дескриптора формы (этап 3 плана
+// plugin-forward-compat). Активных контролов четыре — все нативные элементы
+// формы, их строит client/lib/formBuilder.js. Остальные четыре выведены из
+// эксплуатации в v3, но продолжают работать вечно (И1): игра, собранная под
+// v2, написала их в манифесте, и её dist больше никто не тронет.
+//
+// `patch` — то, чем алиас доливает дескриптор: без `numeric: true` бывшее
+// числовое поле стало бы свободным текстом, и валидация пропустила бы в
+// комнату строку вместо числа.
+export const formControls = createRegistry('formControls', [
+  { value: 'select', since: 1 },
+  { value: 'text', since: 1 },
+  { value: 'checkbox', since: 1 },
+  { value: 'radio', since: 1 },
+  {
+    value: 'range',
+    since: 1,
+    alias: 'text',
+    retiredIn: 3,
+    patch: { numeric: true },
+    note: 'нативного range нет; рисуется как numeric text',
+  },
+  {
+    value: 'number',
+    since: 1,
+    alias: 'text',
+    retiredIn: 3,
+    patch: { numeric: true },
+    note: 'нативного number нет; рисуется как numeric text',
+  },
+  {
+    value: 'toggle',
+    since: 1,
+    alias: 'checkbox',
+    retiredIn: 3,
+    note: 'то же поведение, нативный checkbox',
+  },
+  {
+    value: 'segmented',
+    since: 1,
+    alias: 'radio',
+    retiredIn: 3,
+    note: 'то же поведение, группа нативных radio',
+  },
+]);
+
+/**
+ * Разрешает `descriptor.control` в контрол, который умеет строить билдер.
+ * @param {string} control - Значение `control` из дескриптора.
+ * @returns {{control: string, patch: Object}|undefined} Активный контрол и
+ *   накладка на дескриптор, либо undefined для неизвестного имени.
+ */
+export function resolveControl(control) {
+  const chain = formControls.chain(control);
+
+  if (chain.length === 0) {
+    return undefined;
+  }
+
+  // накладки копятся по всей цепочке: алиас на алиас обязан донести обе
+  return {
+    control: chain.at(-1).value,
+    patch: Object.assign({}, ...chain.map(entry => entry.patch ?? {})),
+  };
+}
+
+/**
+ * Приводит дескриптор поля к активному контролу (разрешает алиас).
+ * @param {Object} descriptor - Дескриптор поля формы.
+ * @returns {Object} Тот же объект, если контрол активен или неизвестен
+ *   (последнее скажет билдер), иначе копия с активным `control` и накладкой
+ *   алиаса под явными полями игры.
+ */
+export function resolveDescriptor(descriptor) {
+  const resolved = resolveControl(descriptor?.control);
+
+  if (!resolved || resolved.control === descriptor.control) {
+    return descriptor;
+  }
+
+  // накладка идёт ПОД дескриптором: она уточняет контрол, а не переписывает
+  // схему игры (явный numeric:false остаётся за игрой)
+  return { ...resolved.patch, ...descriptor, control: resolved.control };
+}
+
+// имена, которые вправе написать новая игра (контракт-чекер, документация)
+export const ACTIVE_FORM_CONTROLS = formControls.values();

package/src/lib/formUnit.js

@@ -0,0 +1,25 @@
+// Единица измерения числового поля формы: `unit: 's'` значит, что игра
+// хранит значение в миллисекундах, а игрок видит и вводит секунды.
+//
+// Определение общее на движок (как anchorPattern и normalizeOptions рядом):
+// конвертацию делают и билдер формы (client/lib/formBuilder.js), и
+// авторитетная валидация хоста (lib/validators.js) — min/max дескриптора
+// объявлены в единице ОТОБРАЖЕНИЯ, а по сети едет единица хранения. Две
+// копии этого правила разъехались бы молча: форма пропускала бы то, что
+// отбивает хост, или наоборот.
+
+/** Значение хранения → значение, в котором объявлены min/max и default. */
+export function toDisplay(descriptor, value) {
+  return descriptor.unit === 's' ? value / 1000 : value;
+}
+
+/** Обратное преобразование: то, что вводит игрок → то, что едет на хост. */
+export function toStored(descriptor, value) {
+  return descriptor.unit === 's' ? value * 1000 : value;
+}
+
+// числовое text-поле: unit задан или numeric:true. Правило одно на билдер и
+// на валидацию — иначе поле строится числовым, а проверяется как текст
+export function isNumericField(descriptor) {
+  return descriptor?.numeric === true || descriptor?.unit !== undefined;
+}

package/src/lib/gameConfigView.js

@@ -0,0 +1,214 @@
+import hostDefaults from '../config/hostDefaults.js';
+
+// Единственная точка чтения HostPlugin.gameConfig движком (этап 2 плана
+// plugin-forward-compat). До неё движок разыменовывал конфиг игры россыпью
+// по коду, и каждое новое поле немедленно становилось обязательным —
+// прямое нарушение И2 («ничто новое не обязательно»).
+//
+// View — обычный объект (не класс): applyRoomOverrides делает по нему
+// structuredClone и spread, а те не переживают прототипы и геттеры-ловушки.
+// Поля игры, о которых движок не знает, копируются как есть — игра вправе
+// держать в gameConfig что угодно сверх контракта.
+
+// Каждая строка ниже — обещание совместимости: поле, которого нет в конфиге
+// старой игры, отдаёт умолчание, а не роняет загрузку (И2). Умолчание
+// обязано быть безопасным для игры, которая о поле не знает.
+//
+// Ключ — путь через точку, значение — { default } либо { derive(config) }.
+// Список может только РАСТИ: перенос поля отсюда в REQUIRED отверг бы уже
+// опубликованные игры.
+const FIELDS = {
+  // название в лобби; null → вызывающий берёт plugin.id
+  title: { default: null },
+
+  // карты везёт мастер (room.maps), у игры их может не быть вовсе
+  maps: { default: {} },
+  currentMap: { default: null },
+  // сколько карт попадает в голосование; 1 — минимальный осмысленный набор
+  mapsInVote: { default: 1 },
+  mapScale: { default: 1 },
+  mapSetId: { default: null },
+
+  // лимит комнаты: без него берётся движковый (hostDefaults.maxPlayers)
+  'roomDefaults.maxPlayers': { default: hostDefaults.maxPlayers },
+
+  // игра без оружия — не экзотика: @vimp-games/snakes уже такая
+  'parts.weapons': { default: {} },
+  // огонь по своим — опция игры; «нет опции» значит «выключено»
+  'parts.friendlyFire': { default: false },
+
+  // пустая панель рисуется корректно: Panel читает её через Object.keys.
+  // fields — словарь «имя → { key, value }», поэтому пусто здесь это {}
+  'panel.fields': { default: {} },
+  'panel.activeKey': { default: null },
+
+  // таблица статистики и стартовые данные участника — целиком игровые
+  stat: { default: {} },
+  scripted: { default: {} },
+  playerState: { default: {} },
+
+  soundCues: { default: {} },
+  // голосование на входе (обычно 'teamChange'); null — входим молча
+  initialVote: { default: null },
+
+  // чем игра занимает экран по Tab: движковая таблица или свой лидерборд
+  statMode: { default: 'table' },
+  // opt-in-флаги: их отсутствие всегда означало «выключено»
+  noSpectators: { default: false },
+  endlessRound: { default: false },
+
+  spectatorTeam: { derive: deriveSpectatorTeam },
+};
+
+// Все пути gameConfig, которые движок читает: объявленные игрой поля плюс
+// те, за которые он подставляет умолчание. Раздел слепка поверхности
+// (contract/surface.json → gameConfigFields): исчезнувший отсюда путь —
+// нарушение И1, потому что игра могла его написать.
+export const KNOWN_GAME_CONFIG_PATHS = Object.keys(FIELDS);
+
+// ЗАМОРОЖЕНО (И2). Этот список может только СОКРАЩАТЬСЯ.
+// Добавление сюда отвергнет все ранее опубликованные игры — вместо этого
+// заведи поле в FIELDS с умолчанием. Страж: tests/devtools/surface.test.js.
+export const REQUIRED_GAME_CONFIG_PATHS = [
+  'parts.models', // из чего состоит участник; синтезировать нечем
+  'playerKeys', // без них ядро не знает ввода
+  'snapshot', // раскладка кадра; движок её не придумывает
+  'teams', // ParticipantManager выбирает команду входа
+];
+
+// Единственный признак «команда наблюдателей», который есть в данных, —
+// её имя: teams это словарь «имя → id», флагов в нём нет. Игра, объявившая
+// наблюдателей как-то иначе, обязана назвать spectatorTeam явно.
+const SPECTATOR_TEAM_NAME = 'spectators';
+
+function deriveSpectatorTeam(config, gameId) {
+  // наблюдателей нет как концепции — связывать нечего
+  if (config.noSpectators === true) {
+    return null;
+  }
+
+  if (Object.hasOwn(config.teams ?? {}, SPECTATOR_TEAM_NAME)) {
+    return SPECTATOR_TEAM_NAME;
+  }
+
+  // null — рабочее значение (ParticipantManager заводит участника в первую
+  // команду), но почти наверняка не то, чего хотела игра: предупреждаем
+  console.warn(
+    `game "${gameId}": gameConfig.spectatorTeam is not set and teams has ` +
+      `no "${SPECTATOR_TEAM_NAME}" key — everyone joins the first team ` +
+      `(${Object.keys(config.teams ?? {})[0] ?? '—'}); declare ` +
+      'spectatorTeam or noSpectators to say what you meant',
+  );
+
+  return null;
+}
+
+function getPath(source, dottedPath) {
+  return dottedPath.split('.').reduce((value, key) => value?.[key], source);
+}
+
+// copy-on-write: умолчание вкладывается в копию ветки, объект игры не
+// правится — gameConfig принадлежит плагину и переживает перезапуск матча
+function setPath(target, dottedPath, value) {
+  const keys = dottedPath.split('.');
+  let node = target;
+
+  for (const key of keys.slice(0, -1)) {
+    node[key] =
+      node[key] === undefined || node[key] === null ? {} : { ...node[key] };
+    node = node[key];
+  }
+
+  node[keys.at(-1)] = value;
+}
+
+/**
+ * Строит представление gameConfig с умолчаниями и проверяет обязательное.
+ * @param {Object} gameConfig - HostPlugin.gameConfig игры как есть.
+ * @param {string} [gameId] - id плагина; попадает в текст ошибок.
+ * @returns {Object} Конфиг: поля игры плюс умолчания движка. Заморожен
+ *   ПОВЕРХНОСТНО — вложенные ветки (parts, roomDefaults) правятся; глубокая
+ *   заморозка стоила бы обхода всего конфига игры на каждом старте матча, а
+ *   единственный потребитель (applyRoomOverrides) и так делает structuredClone.
+ * @throws {Error} Если нет поля из REQUIRED_GAME_CONFIG_PATHS или конфиг
+ *   внутренне противоречив (spectatorTeam вне teams, noSpectators при двух
+ *   командах).
+ */
+export function createGameConfigView(gameConfig, gameId = 'unknown') {
+  const source = gameConfig ?? {};
+
+  // null проходил бы проверку присутствия, хотя ни одно из этих полей не
+  // бывает пустым по контракту: движок разыменовывает их сразу, и гейт,
+  // заведённый ради текста вместо TypeError, сам отвечал бы TypeError
+  const missing = REQUIRED_GAME_CONFIG_PATHS.filter(path => {
+    const value = getPath(source, path);
+
+    return value === undefined || value === null;
+  });
+
+  if (missing.length > 0) {
+    throw new Error(
+      `game "${gameId}": gameConfig is missing required field(s): ` +
+        missing.join(', '),
+    );
+  }
+
+  const view = { ...source };
+
+  for (const [path, spec] of Object.entries(FIELDS)) {
+    const value = getPath(source, path);
+
+    if (value !== undefined && value !== null) {
+      continue;
+    }
+
+    setPath(
+      view,
+      path,
+      spec.derive ? spec.derive(source, gameId) : spec.default,
+    );
+  }
+
+  assertConsistent(view, source, gameId);
+
+  return Object.freeze(view);
+}
+
+// Проверки внутренней согласованности того, что игра УЖЕ прислала. Это не
+// новые требования (И2): поле, которого нет, здесь не проверяется вовсе.
+function assertConsistent(view, source, gameId) {
+  const { teams } = view;
+
+  // noSpectators: связывать нечего — зато команда обязана быть ровно одна.
+  // Вторая играющая команда без наблюдателей означала бы вход «куда-нибудь»,
+  // а ParticipantManager выбирает команду входа однозначно
+  if (view.noSpectators === true) {
+    if (Object.keys(teams).length !== 1) {
+      throw new Error(
+        `game "${gameId}": noSpectators requires exactly one team, ` +
+          `got ${Object.keys(teams).length} (${Object.keys(teams).join(', ')})`,
+      );
+    }
+
+    return;
+  }
+
+  // spectatorTeam — имя ключа внутри teams, и опечатка даёт spectatorId ===
+  // undefined, после чего участник заходит в несуществующую команду
+  // (ParticipantManager.createHuman валится на её счётчике). Проверяем
+  // только объявленное игрой: выведенное значение уже согласовано
+  const declared = source.spectatorTeam;
+
+  if (
+    declared !== undefined &&
+    declared !== null &&
+    teams[declared] === undefined
+  ) {
+    throw new Error(
+      `game "${gameId}": spectatorTeam '${declared}' is not a ` +
+        `key of teams (${Object.keys(teams).join(', ')})`,
+    );
+  }
+}
+
+export default createGameConfigView;

package/src/lib/gamePlugin.js

@@ -1,4 +1,5 @@
-import { ENGINE_API_VERSION } from '../config/opcodes.js';
+import { ENGINE_CAPABILITIES } from './capabilities.js';
+import { createGameConfigView } from './gameConfigView.js';
 
 // Динамическая загрузка игры по GameManifest мастера (Этап 6.3): клиент
 // больше не импортирует игру статически (gameRegistry.static.js) — вместо
@@ -28,102 +29,101 @@ export async function fetchGameManifest(url) {
   return res.json();
 }
 
-// несовпадение engineApi — плагин собран под другую версию контрактов
-// движка (§3.7 PLAN.md); загружать его небезопасно
-export function assertEngineApiCompatible(manifest) {
-  if (manifest.engineApi !== ENGINE_API_VERSION) {
-    throw new Error(
-      `game "${manifest.id}" requires engine API v${manifest.engineApi}, ` +
-        `this engine build is v${ENGINE_API_VERSION}`,
-    );
+// Совместимость плагина с этой сборкой движка (этап 5 плана
+// plugin-forward-compat). Числа больше не сравниваются: `engineApi` заморожен
+// на 4 и остался меткой поколения контракта, а не гейтом. Плагин отвергается,
+// только если просит возможность, которой в этой сборке нет (то есть он
+// НОВЕЕ движка) — движок не может выдать того, чего в нём не существует.
+// Плагин любого возраста принимается: поверхность append-only (И1), и имя,
+// которое он написал, работает вечно.
+//
+// Функция возвращает вердикт, а не бросает: у четырёх входов (каталог
+// мастера, Node-загрузчик, браузерный клиент, standalone SDK) разная
+// правильная реакция — каталог помечает игру недоступной и продолжает
+// раздавать остальные, остальные три бросают.
+export function checkPluginCompatibility(manifest) {
+  const wanted = manifest.requires;
+
+  // `requires` пишет ЧУЖОЙ репозиторий игры, и его форме нельзя доверять:
+  // строка или объект вместо массива давали здесь TypeError, который уходил
+  // из конструктора GameCatalog и не давал стартовать мастеру целиком —
+  // одна битая игра уносила весь каталог. Битый манифест обязан вести себя
+  // как несовместимый (вердикт), а не как краш движка
+  if (wanted !== undefined && wanted !== null) {
+    if (
+      !Array.isArray(wanted) ||
+      wanted.some(name => typeof name !== 'string')
+    ) {
+      return {
+        ok: false,
+        reason: 'bad-manifest',
+        missing: [],
+        text:
+          `game "${manifest.id}": manifest.requires must be an array of ` +
+          'capability names — rebuild the game package',
+      };
+    }
   }
-}
-
-// поля gameConfig, которые движок читает до какой-либо игровой логики
-// (applyRoomOverrides/coreConfig/buildClientConfig) — недостающее валится
-// непрозрачной ошибкой глубоко в onInit; проверяем контракт §HostPlugin API
-// (docs/en/plugin-api.md) сразу после import, рядом с engineApi-гейтом
-const REQUIRED_GAME_CONFIG_PATHS = [
-  'roomDefaults.maxPlayers',
-  'snapshot',
-  'parts.models',
-  'parts.weapons',
-  'parts.friendlyFire',
-  'panel.fields',
-  'playerKeys',
-  // без них HostGame разыменовывает undefined (this._teams[spectatorTeam])
-  // и игра умирает тремя разными сообщениями вместо одного контрактного
-  'teams',
-];
-
-// spectatorTeam обязателен ровно до тех пор, пока игра не объявила
-// noSpectators: там наблюдателей нет как концепции и ключа тоже нет
-const SPECTATOR_CONFIG_PATH = 'spectatorTeam';
-
-function getPath(obj, dottedPath) {
-  return dottedPath
-    .split('.')
-    .reduce((value, key) => value?.[key], obj);
-}
-
-// бросает при отсутствии обязательных полей HostPlugin.gameConfig
-export function assertGameConfigShape(hostPlugin) {
-  // null проходил бы проверку присутствия, хотя ни одно из этих полей не
-  // бывает пустым по контракту: движок разыменовывает их сразу, и гейт,
-  // заведённый ради текста вместо TypeError, сам отвечал бы TypeError
-  const noSpectators = hostPlugin.gameConfig?.noSpectators === true;
-  const required = noSpectators
-    ? REQUIRED_GAME_CONFIG_PATHS
-    : [...REQUIRED_GAME_CONFIG_PATHS, SPECTATOR_CONFIG_PATH];
 
-  const missing = required.filter(p => {
-    const value = getPath(hostPlugin.gameConfig, p);
+  const missing = (wanted ?? []).filter(name => !ENGINE_CAPABILITIES.has(name));
 
-    return value === undefined || value === null;
-  });
-
-  if (missing.length > 0) {
-    throw new Error(
-      `game "${hostPlugin.id}": gameConfig is missing required field(s): ` +
-        missing.join(', '),
-    );
+  if (missing.length === 0) {
+    return { ok: true };
   }
 
-  // единственная связь между полями, которую стоит проверять здесь:
-  // spectatorTeam — имя ключа внутри teams, и опечатка даёт spectatorId ===
-  // undefined, после чего участник заходит в несуществующую команду
-  // (ParticipantManager.createHuman валится на её счётчике)
-  const { teams, spectatorTeam } = hostPlugin.gameConfig;
-
-  // noSpectators: связывать нечего — зато команда обязана быть ровно одна.
-  // Вторая играющая команда без наблюдателей означала бы вход «куда-нибудь»,
-  // а ParticipantManager выбирает команду входа однозначно
-  if (noSpectators) {
-    if (Object.keys(teams).length !== 1) {
-      throw new Error(
-        `game "${hostPlugin.id}": noSpectators requires exactly one team, ` +
-          `got ${Object.keys(teams).length} (${Object.keys(teams).join(', ')})`,
-      );
-    }
+  return {
+    ok: false,
+    reason: 'engine-too-old',
+    missing,
+    // текст обязан называть сторону, которую надо обновить: это единственный
+    // оставшийся режим отказа, и он должен быть однозначным
+    text:
+      `game "${manifest.id}" needs engine capabilities this build does ` +
+      `not have: ${missing.join(', ')} — update the engine`,
+  };
+}
 
-    return;
-  }
+// Имя, на которое ссылается существующий код и тесты (И1 действует и на
+// экспорты движка): та же проверка, но бросающая.
+export function assertEngineApiCompatible(manifest) {
+  const compat = checkPluginCompatibility(manifest);
 
-  if (teams[spectatorTeam] === undefined) {
-    throw new Error(
-      `game "${hostPlugin.id}": spectatorTeam '${spectatorTeam}' is not a ` +
-        `key of teams (${Object.keys(teams).join(', ')})`,
-    );
+  if (!compat.ok) {
+    throw new Error(compat.text);
   }
 }
 
-// динамический import ClientPlugin игры (client-entry её сборки). Манифест и
-// плагин собираются одной сборкой (build-game-manifest.js читает то же
-// entries.client) и их engineApi всегда совпадает — проверяем только
-// манифест (дешевле: до сетевого import), плагин сверяем после загрузки как
-// защиту от рассинхрона сборки, а не как отдельный путь отказа
+// Обязательные поля gameConfig и умолчания для всего остального живут в
+// lib/gameConfigView.js (этап 2 плана plugin-forward-compat) — здесь только
+// имена, на которые мог сослаться чужой код, и тонкая обёртка над view.
+export { REQUIRED_GAME_CONFIG_PATHS } from './gameConfigView.js';
+
+// spectatorTeam перестал быть обязательным (у него есть умолчание) —
+// константа остаётся именем пути, а не требованием
+export const SPECTATOR_CONFIG_PATH = 'spectatorTeam';
+
+/**
+ * Проверяет gameConfig плагина и возвращает представление с умолчаниями.
+ * Гейт стоит сразу после import — рядом с engineApi-гейтом: недостающее
+ * обязательное поле иначе валится непрозрачной ошибкой глубоко в onInit.
+ * @param {Object} hostPlugin - Загруженный HostPlugin игры.
+ * @returns {Object} Результат createGameConfigView (одна view на прогон).
+ */
+export function assertGameConfigShape(hostPlugin) {
+  return createGameConfigView(hostPlugin.gameConfig, hostPlugin.id);
+}
+
+// динамический import ClientPlugin игры (client-entry её сборки). Сначала —
+// вердикт совместимости по манифесту (дешевле: до сетевого import): игра,
+// требующая возможности, которой в этой сборке нет, не заработает и после
+// загрузки бандла. Сверка engineApi манифеста с плагином ниже — про
+// рассинхрон сборки внутри пакета, а не про версию движка
 export async function loadClientPlugin(manifest) {
-  assertEngineApiCompatible(manifest);
+  const compat = checkPluginCompatibility(manifest);
+
+  if (!compat.ok) {
+    throw new Error(compat.text);
+  }
 
   const module = await import(/* @vite-ignore */ manifest.entries.client);
   const plugin = module.default;

package/src/lib/loadGamePackage.js

@@ -1,7 +1,7 @@
 import { access, readFile } from 'node:fs/promises';
 import path from 'node:path';
 import { pathToFileURL } from 'node:url';
-import { assertEngineApiCompatible } from './gamePlugin.js';
+import { checkPluginCompatibility } from './gamePlugin.js';
 
 // Загрузка пакета игры в Node по его собранному dist/ (Этап 4 плана
 // standalone-sdk). В браузере плагин грузится по URL из GameManifest мастера;
@@ -32,7 +32,14 @@ export async function loadGamePackage(distDir, { core = null } = {}) {
   const baseDir = path.dirname(manifestPath);
   const manifest = JSON.parse(await readFile(manifestPath, 'utf8'));
 
-  assertEngineApiCompatible(manifest);
+  // игра одна и подменить её нечем — вердикт несовместимости здесь
+  // терминальный (в отличие от каталога мастера, который помечает игру
+  // недоступной и продолжает раздавать остальные)
+  const compat = checkPluginCompatibility(manifest);
+
+  if (!compat.ok) {
+    throw new Error(`${manifestPath}: ${compat.text}`);
+  }
 
   const { assetsBase } = manifest;
   const hostPlugin = await importDefault(