vimp-engine 0.26.0 → 0.27.0

package/package.json

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

package/src/client/components/controller/Games.js

@@ -25,14 +25,17 @@ export default class GamesCtrl {
 
     vp.on('open-mine', 'openMine', this);
     vp.on('open-moderation', 'openModeration', this);
+    vp.on('lookup', 'lookup', this);
     vp.on('submit', 'submit', this);
     vp.on('update-version', 'updateVersion', this);
+    vp.on('delete', 'remove', this);
     vp.on('filter', 'filter', this);
     vp.on('stage', 'stage', this);
     vp.on('approve', 'approve', this);
     vp.on('reject', 'reject', this);
     vp.on('disable', 'disable', this);
     vp.on('load-versions', 'loadVersions', this);
+    vp.on('set-author', 'setAuthor', this);
 
     model.publisher.on('staged', 'staged', this);
   }
@@ -55,12 +58,17 @@ export default class GamesCtrl {
     this._model.loadMine();
   }
 
+  // «Moderation» — отдельная страница панели: карточка «My games» в этом
+  // режиме не видна, и запрос за её данными был бы холостым
   openModeration() {
     this._view.show(true);
-    this._model.loadMine();
     this._model.loadAdmin();
   }
 
+  lookup({ packageName, version }) {
+    this._model.lookup(packageName, version);
+  }
+
   submit(form) {
     this._model.submit(form);
   }
@@ -69,6 +77,10 @@ export default class GamesCtrl {
     this._model.requestVersion(id, version);
   }
 
+  remove({ id, scope }) {
+    this._model.remove(id, scope);
+  }
+
   filter(status) {
     this._model.setFilter(status);
   }
@@ -93,6 +105,10 @@ export default class GamesCtrl {
     this._model.loadVersions(id);
   }
 
+  setAuthor({ id, nick }) {
+    this._model.setAuthor(id, nick);
+  }
+
   staged(data) {
     this.publisher.emit('staged', data);
   }

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

@@ -99,6 +99,28 @@ export default class GamesModel {
     this._emitAdmin();
   }
 
+  // разбор пакета для формы заявки: мастер качает тарболл, читает манифест
+  // и отдаёт то, что раньше человек вводил руками. Отдельный запрос, а не
+  // часть submit: предпросмотр обязан быть виден ДО отправки заявки
+  async lookup(packageName, version) {
+    const query = new URLSearchParams({ package: packageName });
+
+    if (version) {
+      query.set('version', version);
+    }
+
+    const { ok, json } = await this._request(
+      `${this._config.urls.lookup}?${query}`,
+    );
+
+    if (!ok) {
+      this._fail('mine', json);
+      return;
+    }
+
+    this.publisher.emit('looked-up', json);
+  }
+
   async submit(form) {
     const { ok, json } = await this._request(this._config.urls.submit, {
       method: 'POST',
@@ -133,6 +155,26 @@ export default class GamesModel {
     await this.loadMine();
   }
 
+  // удаление игры. scope решает, чей список перечитать: карточка автора и
+  // очередь модерации показывают разные проекции одной строки
+  async remove(id, scope = 'mine') {
+    const { ok, json } = await this._request(this._config.urls.remove(id), {
+      method: 'DELETE',
+    });
+
+    if (!ok) {
+      this._fail(scope, json);
+      return;
+    }
+
+    if (scope === 'admin') {
+      await this.loadAdmin();
+      return;
+    }
+
+    await this.loadMine();
+  }
+
   // «Test»: мастер качает версию и кладёт её в каталог не раздаваемой.
   // Манифест едет наружу — по нему вкладка админа поднимает комнату
   async stage(id, version) {
@@ -170,6 +212,12 @@ export default class GamesModel {
     }
   }
 
+  // переназначение автора — тот же PATCH, что и решение модератора: наружу
+  // едет ник, пустой означает «снять автора»
+  async setAuthor(id, nick) {
+    await this.moderate(id, { authorNick: nick === '' ? null : nick });
+  }
+
   _emitAdmin() {
     this.publisher.emit('admin-changed', {
       games: this._all.filter(game => game.status === this._filter),

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

@@ -19,6 +19,8 @@ const ERROR_MESSAGES = {
   gameExists: 'A game with this id already exists',
   tooManyGames: 'Too many submissions from one author',
   unknownGame: 'Game is not in the registry',
+  gamePublished: 'Published game — ask an admin to disable it first',
+  unknownUser: 'No player with this nick',
   invalidGameId: 'Invalid game id',
   invalidPackageName: 'Invalid npm package name',
   invalidVersion: 'Invalid version',
@@ -71,6 +73,19 @@ export default class GamesView {
     this._mineList = document.getElementById(elems.mineListId);
     this._submitForm = document.getElementById(elems.submitFormId);
     this._submitError = document.getElementById(elems.submitErrorId);
+    this._submitBtn = document.getElementById(elems.submitBtnId);
+    this._lookupBtn = document.getElementById(elems.lookupBtnId);
+    this._preview = document.getElementById(elems.previewId);
+    this._versionList = document.getElementById(elems.versionListId);
+
+    this._mine = document.getElementById(elems.mineId);
+    this._title = document.getElementById(elems.titleId);
+    this._switch = document.getElementById(elems.switchBtnId);
+    // текущая страница панели: от неё зависит, куда уводит переключатель
+    this._isModeration = false;
+    // последний разобранный `${packageName}@${version}` — защита от парного
+    // разбора одного и того же пакета, см. _emitLookup
+    this._lastLookup = null;
 
     this._moderation = document.getElementById(elems.moderationId);
     this._adminList = document.getElementById(elems.adminListId);
@@ -99,17 +114,34 @@ export default class GamesView {
     this._openMine.onclick = () => this.publisher.emit('open-mine');
     this._openModeration.onclick = () => this.publisher.emit('open-moderation');
     this._close.onclick = () => this.hide();
+    // переключатель страниц панели: без него выход из «Moderation» в
+    // «My games» шёл бы только через лобби
+    this._switch.onclick = () =>
+      this.publisher.emit(this._isModeration ? 'open-mine' : 'open-moderation');
 
     this._submitForm.onsubmit = e => {
       e.preventDefault();
       this.publisher.emit('submit', this._readForm());
     };
 
+    const packageField = this._fields.get('packageName');
+
+    // разбор пакета по кнопке И по уходу из поля: заполнять форму
+    // предпросмотром — обычный путь, а не отдельное действие
+    this._lookupBtn.onclick = () => this._emitLookup();
+    packageField.onblur = () => this._emitLookup();
+    // правка пакета обесценивает показанный предпросмотр: заявка ушла бы с
+    // разобранным ранее пакетом, а человек читал бы карточку другого
+    packageField.oninput = () => this.clearPreview();
+
+    this.clearPreview();
+
     this._renderFilters();
 
     const mp = model.publisher;
 
     mp.on('submitted', 'clearForm', this);
+    mp.on('looked-up', 'renderPreview', this);
     mp.on('mine-changed', 'renderMine', this);
     mp.on('admin-changed', 'renderAdmin', this);
     mp.on('error', 'renderError', this);
@@ -120,12 +152,21 @@ export default class GamesView {
   // (main.js по LobbyAuthModel.getRole())
   setAdmin(isAdmin) {
     this._openModeration.style.display = isAdmin ? '' : 'none';
+    this._switch.style.display = isAdmin ? '' : 'none';
   }
 
+  // Панель — две страницы, а не одна: «My games» и «Moderation»
+  // показываются по одной. Общая шапка (заголовок, переключатель и
+  // «Back to lobby») живёт над карточками и переживает переключение
   show(moderation = false) {
+    this._isModeration = moderation;
     this._panel.style.display = 'flex';
     this._lobby.style.display = 'none';
+    this._mine.style.display = moderation ? 'none' : 'block';
     this._moderation.style.display = moderation ? 'block' : 'none';
+    this._title.textContent = moderation ? 'Moderation' : 'My games';
+    // подпись переключателя называет ту страницу, куда он уводит
+    this._switch.value = moderation ? 'My games' : 'Moderation';
   }
 
   hide() {
@@ -145,6 +186,68 @@ export default class GamesView {
     this._fields.forEach(field => {
       field.value = '';
     });
+    this.clearPreview();
+  }
+
+  // предпросмотра нет — отправлять нечего: мастер всё равно откажет, а
+  // человек не увидит, за какую игру он ручается
+  clearPreview() {
+    this._preview.textContent = '';
+    this._versionList.textContent = '';
+    this._submitBtn.disabled = true;
+    // предпросмотра нет — значит, и запрета на повторный разбор быть не
+    // должно: правка поля обесценивает прошлый вердикт
+    this._lastLookup = null;
+  }
+
+  /**
+   * Карточка разобранного пакета: то, что раньше человек вводил руками.
+   * @param {Object} data - Ответ мастера на /games/lookup.
+   */
+  renderPreview({ id, title, version, versions, repoUrl, engineApi, errors }) {
+    this._preview.textContent = '';
+    this._submitError.textContent = '';
+
+    this._preview.appendChild(
+      this._line(`${title ? `${title} · ` : ''}${id ?? '—'}`, 'games-item-title'),
+    );
+    this._preview.appendChild(this._line(`Version: ${version ?? '—'}`));
+    this._preview.appendChild(this._line(`Engine API: ${engineApi ?? '—'}`));
+    this._appendRepo(this._preview, repoUrl);
+
+    // список опубликованных версий — подсказка поля, а не отдельный контрол
+    this._versionList.textContent = '';
+    (versions || []).forEach(value => {
+      const option = document.createElement('option');
+
+      option.value = value;
+      this._versionList.appendChild(option);
+    });
+
+    // резолвнутая мастером версия: 'latest' в поле осталась бы ссылкой,
+    // которая завтра означает другой пакет
+    if (version) {
+      this._fields.get('version').value = version;
+    }
+
+    // разрешённая версия в поле меняет `${packageName}@${version}`, и
+    // следующий blur прошёл бы как «другой пакет»: запрет повтора обновляется
+    // фактическим ответом мастера
+    this._lastLookup = `${this._fields.get('packageName').value.trim()}@${
+      this._fields.get('version').value.trim()
+    }`;
+
+    const problems = errors || [];
+
+    if (problems.length) {
+      renderFormErrors(
+        this._submitError,
+        problems.map(error => ({ name: 'package', label: 'package', error })),
+      );
+    }
+
+    // заявка на заведомо нерабочий пакет реестру не нужна
+    this._submitBtn.disabled = problems.length > 0 || !id;
   }
 
   renderMine(games) {
@@ -184,6 +287,11 @@ export default class GamesView {
 
       item.appendChild(version);
       item.appendChild(send);
+      item.appendChild(
+        this._deleteButton(() =>
+          this.publisher.emit('delete', { id: game.id, scope: 'mine' }),
+        ),
+      );
       this._mineList.appendChild(item);
     });
   }
@@ -232,6 +340,23 @@ export default class GamesView {
     // у игр, засеянных миграцией, автора нет вовсе: без запасного прочерка
     // в строке печаталось бы литеральное "null"
     item.appendChild(this._line(`Author: ${game.authorNick ?? game.authorUserId ?? '—'}`));
+
+    // переназначение автора: игры платформы засеяны без него, и «My games»
+    // у их автора пуст, пока админ не проставит ник здесь. Пустое поле —
+    // снять автора
+    const author = document.createElement('input');
+
+    author.type = 'text';
+    author.className = 'field-text games-author-input';
+    author.placeholder = 'Author nick';
+    author.value = game.authorNick ?? '';
+
+    item.appendChild(author);
+    item.appendChild(
+      this._button('Set author', () =>
+        this.publisher.emit('set-author', { id: game.id, nick: author.value.trim() }),
+      ),
+    );
     this._appendRepo(item, game.repoUrl);
     item.appendChild(
       this._line(
@@ -282,6 +407,9 @@ export default class GamesView {
         this.publisher.emit('load-versions', { id: game.id }),
       ),
     );
+    item.appendChild(
+      this._deleteButton(() => this.publisher.emit('delete', { id: game.id, scope: 'admin' })),
+    );
 
     return item;
   }
@@ -331,6 +459,27 @@ export default class GamesView {
     });
   }
 
+  // Удаление необратимо и уносит рейтинги игры, поэтому кнопка требует
+  // второго нажатия: первое переводит её в «Confirm delete», второе публикует
+  // событие. Повторная отрисовка списка возвращает её в исходное состояние —
+  // незавершённое подтверждение не переживает перерисовку
+  _deleteButton(onConfirm) {
+    const btn = this._button('Delete', () => {
+      if (btn.dataset.armed !== '1') {
+        btn.dataset.armed = '1';
+        btn.value = 'Confirm delete';
+        btn.classList.add('games-delete-armed');
+        return;
+      }
+
+      onConfirm();
+    });
+
+    btn.className = 'games-delete-btn';
+
+    return btn;
+  }
+
   _button(value, onclick) {
     const btn = document.createElement('input');
 
@@ -353,6 +502,22 @@ export default class GamesView {
     return line;
   }
 
+  // Один и тот же пакет не разбирается дважды: blur поля и клик по «Load»
+  // приходят парой (mousedown → blur → click), а каждый разбор стоит мастеру
+  // скачанного тарболла и единицы общего лимитера заявок (5/мин на человека)
+  _emitLookup() {
+    const packageName = this._fields.get('packageName').value.trim();
+    const version = this._fields.get('version').value.trim();
+    const ref = `${packageName}@${version}`;
+
+    if (!packageName || ref === this._lastLookup) {
+      return;
+    }
+
+    this._lastLookup = ref;
+    this.publisher.emit('lookup', { packageName, version });
+  }
+
   _readForm() {
     const form = {};
 

package/src/client/main.js

@@ -1978,11 +1978,6 @@ function populateRoomForm(manifest) {
   }
 }
 
-// роли, которым лобби показывает кнопку «Moderation» (master-game-registry,
-// этап 4). Это подсказка интерфейсу: доступ к данным проверяет мастер, а
-// запись — auth-сервис, перечитывая роль из БД
-const ADMIN_ROLES = ['admin', 'superadmin'];
-
 // каталог манифестов по id: форма и leaderboard селектора игр, а также
 // активация игры перед созданием комнаты и входом в чужую
 const gamesById = new Map(
@@ -2240,7 +2235,10 @@ function initLobby() {
   const gamesView = new GamesView(gamesModel, lobbyConfig.games);
   const games = new GamesCtrl(gamesModel, gamesView);
 
-  games.setAdmin(ADMIN_ROLES.includes(lobbyAuthModel.getRole()));
+  // кнопку «Moderation» лобби показывает роли admin (master-game-registry,
+  // этап 4). Это подсказка интерфейсу: доступ к данным проверяет мастер, а
+  // запись — auth-сервис, перечитывая роль из БД
+  games.setAdmin(lobbyAuthModel.getRole() === 'admin');
 
   // «Test»: манифест застейдженной версии кладётся в каталог вкладки, и
   // админ поднимает по нему комнату обычной кнопкой Create server

package/src/client/style.css

@@ -1081,11 +1081,17 @@ body.hide-cursor {
   text-align: left;
 }
 
-/* заголовок панели и кнопка возврата в одной строке */
+/* заголовок панели, переключатель страниц и кнопка возврата в одной
+   строке; шапка лежит НАД карточками, поэтому ширину и поля повторяет
+   за ними — иначе flex-end колонки увёл бы её вправо от карточки */
 .games-head {
   display: flex;
   align-items: center;
   justify-content: space-between;
+  gap: 8px;
+  width: 700px;
+  padding: 0 10px;
+  box-sizing: border-box;
 }
 
 .games-list {
@@ -1141,6 +1147,18 @@ body.hide-cursor {
   color: #eee;
 }
 
+/* удаление необратимо: взведённое подтверждение обязано отличаться от
+   первого нажатия не только подписью */
+.games-delete-btn {
+  color: #d66;
+}
+
+.games-delete-armed {
+  background: #802020;
+  border-color: #d66;
+  color: #fee;
+}
+
 /* кнопки входа в панель стоят рядом с Sign out в бейдже пользователя */
 .lobby-user-actions {
   display: flex;
@@ -1150,7 +1168,8 @@ body.hide-cursor {
 
 @media (max-width: 900px) {
   #games-mine,
-  #games-moderation {
+  #games-moderation,
+  .games-head {
     width: 100%;
   }
 }

package/src/client/views/includes/games.pug

@@ -5,32 +5,32 @@
 //- Подписи — по-английски, как и остальное лобби
 div#games-panel(style='display:none')
   div.lobby-column
+    //- Шапка панели, а не карточки: карточки «My games» и «Moderation»
+    //- показываются по одной (панель — это две разные страницы), и
+    //- кнопка выхода в лобби обязана пережить переключение между ними
+    div.games-head
+      h3#games-title.lobby-section-title= 'My games'
+      input#games-switch(type='button', value='Moderation', style='display:none')
+      input#games-close(type='button', value='Back to lobby')
+
     div.card#games-mine
-      div.games-head
-        h3.lobby-section-title= 'My games'
-        input#games-close(type='button', value='Back to lobby')
       ul#games-mine-list.games-list
+      //- Заявка спрашивает только пакет и версию: id, title и репозиторий
+      //- мастер читает из самого пакета и показывает предпросмотром
       form#games-submit-form
-        div.form-row
-          label.form-label(for='games-field-id')= 'Game id'
-          input#games-field-id.field-text(type='text', name='id', maxlength='32', autocomplete='off')
         div.form-row
           label.form-label(for='games-field-package')= 'npm package'
           input#games-field-package.field-text(type='text', name='packageName', maxlength='214', autocomplete='off')
+          input#games-lookup(type='button', value='Load')
         div.form-row
           label.form-label(for='games-field-version')= 'Version'
-          input#games-field-version.field-text(type='text', name='version', maxlength='64', autocomplete='off')
-        div.form-row
-          label.form-label(for='games-field-repo')= 'Repository URL'
-          input#games-field-repo.field-text(type='text', name='repoUrl', maxlength='256', autocomplete='off')
-        div.form-row
-          label.form-label(for='games-field-title')= 'Title'
-          input#games-field-title.field-text(type='text', name='title', maxlength='64', autocomplete='off')
+          input#games-field-version.field-text(type='text', name='version', maxlength='64', autocomplete='off', placeholder='latest', list='games-version-list')
+          datalist#games-version-list
+        div#games-preview.games-preview
         div#games-submit-error.form-error
         input#games-submit(type='submit', value='Submit for review')
 
     div.card#games-moderation(style='display:none')
-      h3.lobby-section-title= 'Moderation'
       div#games-filters.games-filters
       ul#games-admin-list.games-list
       div#games-admin-error.form-error

package/src/config/lobby.js

@@ -201,10 +201,16 @@ export default {
     urls: {
       // заявки вызывающего со статусами и замечаниями модератора
       mine: '/games/mine',
+      // разбор npm-пакета для формы заявки: id, title, версии и репозиторий
+      // мастер читает сам — человек вводит только пакет и версию
+      lookup: '/games/lookup',
       // заявка на новую игру платформы (валидируется мастером до записи)
       submit: '/games/submit',
       // заявка на новую версию уже заведённой игры
       version: id => `/games/mine/${encodeURIComponent(id)}/version`,
+      // удаление игры: и «My games» (автор), и «Moderation» (админ) ходят
+      // одним URL — право решает auth
+      remove: id => `/games/mine/${encodeURIComponent(id)}`,
       // очередь модерации целиком плюс локальное состояние на этом мастере
       admin: '/admin/games',
       // манифесты застейдженных версий — по ним админ поднимает тестовую
@@ -247,13 +253,21 @@ export default {
       submitFormId: 'games-submit-form',
       submitErrorId: 'games-submit-error',
       submitBtnId: 'games-submit',
+      // форма спрашивает ровно две вещи; id, title и репозиторий приезжают
+      // предпросмотром из разобранного пакета
       fieldIds: {
-        id: 'games-field-id',
         packageName: 'games-field-package',
         version: 'games-field-version',
-        repoUrl: 'games-field-repo',
-        title: 'games-field-title',
       },
+      lookupBtnId: 'games-lookup',
+      previewId: 'games-preview',
+      versionListId: 'games-version-list',
+
+      // карточки панели показываются по одной; заголовок общий, как и
+      // переключатель страниц (виден только админу)
+      mineId: 'games-mine',
+      titleId: 'games-title',
+      switchBtnId: 'games-switch',
 
       // модерация
       moderationId: 'games-moderation',

package/src/devtools/pluginLoader.js

@@ -54,12 +54,14 @@ export async function loadGameForSim({ game = null, core = null } = {}) {
 }
 
 // путь --game указывает либо на пакет игры, либо прямо на манифест; сама
-// загрузка общая с dedicated-сервером (lib/loadGamePackage.js)
+// загрузка общая с dedicated-сервером (lib/loadGamePackage.js).
+// client: true — прогону виртуальные клиенты обязательны, и отказ на
+// загрузке пакета лучше отказа посреди сценария
 async function loadFromManifest(game, core) {
   const target = game.endsWith('.json')
     ? path.resolve(game)
     : path.resolve(game, 'dist');
-  const pkg = await loadGamePackage(target, { core });
+  const pkg = await loadGamePackage(target, { core, client: true });
 
   return { ...pkg, source: pkg.manifestPath };
 }

package/src/lib/loadGamePackage.js

@@ -21,10 +21,17 @@ import { ENGINE_CAPABILITIES } from './capabilities.js';
  * @param {Object} [options]
  * @param {string} [options.core] - Путь к node-сборке ядра, перекрывающий
  *   entries.wasmNode манифеста.
- * @returns {Promise<Object>} { id, manifest, hostPlugin, clientPlugin, wasmUrl,
- *   distDir, manifestPath }.
+ * @param {(boolean|'lazy')} [options.client] - Когда грузить клиентскую
+ *   половину: 'lazy' (умолчание) — только по вызову loadClientPlugin(),
+ *   true — сразу вместе с host-половиной.
+ * @returns {Promise<Object>} { id, manifest, hostPlugin, clientPlugin,
+ *   loadClientPlugin, wasmUrl, distDir, manifestPath }. В ленивом режиме
+ *   clientPlugin равен null, а половину отдаёт loadClientPlugin().
  */
-export async function loadGamePackage(distDir, { core = null } = {}) {
+export async function loadGamePackage(
+  distDir,
+  { core = null, client = 'lazy' } = {},
+) {
   // манифест под нестандартным именем нужен headless-прогону (--game
   // <path>/manifest-variant.json); dedicated-сервер всегда даёт каталог
   const manifestPath = distDir.endsWith('.json')
@@ -47,18 +54,53 @@ export async function loadGamePackage(distDir, { core = null } = {}) {
     baseDir,
     manifest.entries.host,
     assetsBase,
-  );
-  const clientPlugin = await importDefault(
-    baseDir,
-    manifest.entries.client,
-    assetsBase,
+    manifestPath,
   );
 
+  // Клиентская половина в Node нужна только виртуальным клиентам
+  // headless-прогона; dedicated-сервер её не касается вовсе (в браузер она
+  // едет статикой, и pixi.js там резолвится import map'ом). Грузить её
+  // безусловно значило бы требовать от игры самодостаточной клиентской
+  // сборки — а правило контракта A1 держит pixi.js внешним намеренно.
+  //
+  // Размен ленивого режима: расхождение engineApi между манифестом и
+  // клиентской сборкой в Node-контуре ничего не ломает — клиента собирает
+  // браузер, совместимость манифеста уже проверена checkPluginCompatibility
+  // выше, а структуру пакета проверяет checkGamePackage на стороне
+  // GameStore.
+  const clientPlugin =
+    client === true
+      ? await importDefault(
+          baseDir,
+          manifest.entries.client,
+          assetsBase,
+          manifestPath,
+        )
+      : null;
+
   assertPluginMatchesManifest(manifest, {
     host: hostPlugin,
-    client: clientPlugin,
+    ...(clientPlugin ? { client: clientPlugin } : {}),
   });
 
+  // одна форма результата при любом режиме: потребитель зовёт
+  // loadClientPlugin() и не разбирается, была ли половина уже импортирована
+  let clientLoad = clientPlugin ? Promise.resolve(clientPlugin) : null;
+  const loadClientPlugin = () => {
+    clientLoad ??= importDefault(
+      baseDir,
+      manifest.entries.client,
+      assetsBase,
+      manifestPath,
+    ).then(plugin => {
+      assertPluginMatchesManifest(manifest, { client: plugin });
+
+      return plugin;
+    });
+
+    return clientLoad;
+  };
+
   const nodeCore = core ?? manifest.entries.wasmNode ?? null;
 
   if (!nodeCore) {
@@ -88,6 +130,7 @@ export async function loadGamePackage(distDir, { core = null } = {}) {
     manifest,
     hostPlugin,
     clientPlugin,
+    loadClientPlugin,
     wasmUrl: pathToFileURL(corePath).href,
     distDir: baseDir,
     manifestPath,
@@ -195,10 +238,34 @@ function resolveNames(names) {
   );
 }
 
-function importDefault(baseDir, entry, assetsBase) {
+// Половина плагина, загружаемая в Node, обязана быть самодостаточной:
+// node_modules резолвятся вверх по дереву от файла, а пакет игры лежит там,
+// куда его положил реестр (VIMP_GAMES_DIR), — вне node_modules движка.
+// Сырой ERR_MODULE_NOT_FOUND называет только ненайденный пакет и молчит о
+// том, чья половина и какого пакета игры его просит
+function importDefault(baseDir, entry, assetsBase, manifestPath) {
   const file = path.resolve(baseDir, stripBase(entry, assetsBase));
 
-  return import(pathToFileURL(file).href).then(module => module.default);
+  return import(pathToFileURL(file).href).then(
+    module => module.default,
+    err => {
+      if (err?.code !== 'ERR_MODULE_NOT_FOUND') {
+        throw err;
+      }
+
+      // имя ненайденного пакета — из текста ошибки; не нашлось — не
+      // подставляем
+      const missing = /Cannot find package '([^']+)'/.exec(err.message)?.[1];
+
+      throw new Error(
+        `${manifestPath}: entry '${entry}'` +
+          `${missing ? ` imports '${missing}', which` : ''} cannot be ` +
+          'resolved by Node — a plugin half loaded in Node must be ' +
+          'self-contained; external dependencies (pixi.js) are allowed only ' +
+          'in the client half and only in the browser',
+      );
+    },
+  );
 }
 
 // entries.host/client — URL-ы, какими их видит браузер (`assetsBase` + путь