vimp-engine 0.30.1 → 0.32.0

package/core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "vimp-engine-core"
-version = "0.11.0"
+version = "0.13.0"
 edition = "2024"
 description = "VIMP — движковый каркас симуляции (физика, карта, снапшот-фрейминг, интерполяция/предикт/raycast-примитивы, нав-утилиты). Без wasm-bindgen — обёртки для WASM-ABI собирает game-crate."
 license = "MIT"

package/package.json

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

package/src/client/SoundManager.js

@@ -3,8 +3,11 @@ import { Howl, Howler } from 'howler';
 // глобальный лимит звуков
 const WORLD_VOICE_LIMIT = 30;
 
-// минимальная дистанция для панорамирования
-const MIN_SPATIAL_DISTANCE = 1;
+// дед-зона панорамирования, в мировых пикселях (порядка половины тайла).
+// Порог по НАПРАВЛЕНИЮ, а не по громкости: азимут в Web Audio зависит от
+// вектора на источник, а не от расстояния до него, поэтому расхождение
+// камеры и источника в пару пикселей давало полную панораму и её рывки
+const MIN_SPATIAL_DISTANCE = 16;
 
 // настройки пространственного звука
 const PANNER_SETTINGS = {
@@ -36,6 +39,10 @@ export default class SoundManager {
     // реестр всех зарегистрированных звуковых источников
     this._registeredSounds = new Map();
 
+    // экземпляры, уже переведённые на equalpower (непространственные):
+    // pannerAttr ставится один раз на экземпляр, а не каждый кадр
+    this._equalPowerIds = new Set();
+
     // позиция слушателя
     this._listenerX = 0;
     this._listenerY = 0;
@@ -154,6 +161,10 @@ export default class SoundManager {
    * @param {object} data.position - { x: number, y: number }.
    * @param {number} [data?.rate] - Скорость воспроизведения.
    * @param {number} [data?.volume] - Громкость.
+   * @param {boolean} [data?.spatial=true] - Принадлежит ли звук миру.
+   *   `false` — источник игрока (двигатель и выстрел своего танка): он
+   *   стоит ровно на слушателе, и HRTF на нулевой дистанции сворачивается
+   *   в гребенчатую окраску («гул»), а не в тишину панорамы.
    * @param {function} [callback] - Функция, вызываемая по завершении.
    * @returns {symbol | null} Уникальный ID звука или null, если звук не найден.
    */
@@ -168,6 +179,7 @@ export default class SoundManager {
 
     const id = Symbol(soundName);
     const registration = {
+      spatial: true,
       ...soundData.config,
       ...data,
       sound: soundData.sound,
@@ -308,6 +320,7 @@ export default class SoundManager {
               candidate.position.x,
               candidate.position.y,
               candidate.volume,
+              candidate.spatial,
             );
           }
         }
@@ -334,15 +347,28 @@ export default class SoundManager {
       if (!regSound) {
         sound.stop(soundId);
         this._activeInstances.delete(soundId);
+        this._equalPowerIds.delete(soundId);
         continue;
       }
 
-      const { position, volume, rate } = regSound;
+      const { position, volume, rate, spatial } = regSound;
 
-      this._updateSpatialSound(sound, soundId, position.x, position.y, volume);
+      this._updateSpatialSound(
+        sound,
+        soundId,
+        position.x,
+        position.y,
+        volume,
+        spatial,
+      );
 
-      if (typeof rate === 'number') {
+      // rate только на изменение: Howler на каждый вызов делает два seek(),
+      // переписывает _rateSeek/_playStart и пересоздаёт таймер конца петли
+      // — на 60 Гц это лишняя нагрузка и лишние события 'end' на каждом
+      // обороте
+      if (typeof rate === 'number' && rate !== activeInstance.rate) {
         sound.rate(rate, soundId);
+        activeInstance.rate = rate;
       }
     }
   }
@@ -380,6 +406,7 @@ export default class SoundManager {
           }
 
           this._activeInstances.delete(soundId);
+          this._equalPowerIds.delete(soundId);
         },
         soundId,
       );
@@ -397,6 +424,7 @@ export default class SoundManager {
     if (instanceData) {
       instanceData.sound.stop(soundId);
       this._activeInstances.delete(soundId);
+      this._equalPowerIds.delete(soundId);
     }
   }
 
@@ -408,12 +436,24 @@ export default class SoundManager {
    * @param {number} x - Координата X источника звука.
    * @param {number} y - Координата Y источника звука.
    * @param {number} volume - Громкость звука.
+   * @param {boolean} [spatial=true] - Принадлежит ли звук миру.
    */
-  _updateSpatialSound(sound, soundId, x, y, volume) {
+  _updateSpatialSound(sound, soundId, x, y, volume, spatial = true) {
     if (!sound || typeof soundId !== 'number') {
       return;
     }
 
+    if (spatial === false) {
+      // источник игрока: звук не принадлежит миру, он принадлежит игроку.
+      // equalpower вместо HRTF — HRTF на нулевой дистанции даёт гребенчатую
+      // окраску («гул»), а не тишину панорамы
+      this._applyEqualPower(sound, soundId);
+      sound.pos(0, 0, 0, soundId);
+      sound.volume(volume, soundId);
+
+      return;
+    }
+
     const distance = Math.hypot(x - this._listenerX, y - this._listenerY);
 
     if (distance >= PANNER_SETTINGS.maxDistance) {
@@ -432,6 +472,19 @@ export default class SoundManager {
     }
   }
 
+  /**
+   * @private Переводит экземпляр звука на equalpower — один раз на
+   * экземпляр: pannerAttr на каждом кадре пересобирал бы panner-узел.
+   */
+  _applyEqualPower(sound, soundId) {
+    if (this._equalPowerIds.has(soundId)) {
+      return;
+    }
+
+    sound.pannerAttr({ panningModel: 'equalpower' }, soundId);
+    this._equalPowerIds.add(soundId);
+  }
+
   /**
    * @private
    * Удаляет из реестра одноразовые звуки, которые были заявлены,
@@ -467,6 +520,7 @@ export default class SoundManager {
   reset() {
     Howler.stop();
     this._activeInstances.clear();
+    this._equalPowerIds.clear();
 
     // луп переживает reset: его владелец жив, и ближайший
     // processAudibility() запустит звук заново. Одноразовый — нет:

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

@@ -167,8 +167,19 @@ export default class VoteModel {
           const value = this._currentValues[number];
 
           if (value) {
-            this.publisher.emit('socket', [this._voteName, value]);
+            const name = this._voteName;
+
+            // Своё голосование закрывается ДО отправки ответа. Транспорт
+            // бывает синхронным (solo/standalone — хост живёт в том же
+            // потоке), и тогда ответ хоста приходит прямо внутри
+            // emit('socket'): смена карты сразу присылает новое
+            // голосование (initialVote, «выбери команду»), оно ставит
+            // _waitingValues и запрашивает значения. Прежний порядок
+            // «отправить, потом complete()» сбрасывал этот флаг уже
+            // ПОСЛЕ создания нового голосования, и пришедшие значения
+            // отбрасывались в updateValues — диалог не открывался вовсе
             this.complete();
+            this.publisher.emit('socket', [name, value]);
           }
         }
       }

package/src/client/main.js

@@ -591,6 +591,10 @@ function applyMapData(data, { notifyHost = true } = {}) {
         // разъедется с авторитетным молча
         levels: data.levels,
         ramps: data.ramps,
+        // высота уровня в мировых единицах: от неё зависит уклон рампы, а
+        // значит и предсказание подъёма. Не доехав до клиентской `MapLevels`,
+        // она дала бы другой уклон, чем у хоста, — расхождение молчаливое
+        levelHeight: data.levelHeight,
       }),
     );
   } catch (e) {
@@ -637,7 +641,11 @@ function applyMapData(data, { notifyHost = true } = {}) {
   const staticData = {};
   let staticIndex = 0;
 
-  const pushLayers = (levelLayers, levelMap, level, solid, floor) => {
+  // мировых единиц на уровень: партам нужен для параллакса слоёв и
+  // экструзии объёмов. 0/undefined — движок подставил размер тайла
+  const levelHeight = (Number(data.levelHeight) || step) * scale;
+
+  const pushLayers = (levelLayers, levelMap, level, solid, floor, volumes) => {
     for (const [layer, tiles] of Object.entries(levelLayers || {})) {
       staticData[`s${staticIndex}`] = {
         type: 'static',
@@ -649,6 +657,14 @@ function applyMapData(data, { notifyHost = true } = {}) {
         level,
         solid,
         floor,
+        // визуальная высота слоя в уровнях: ядро её не знает, поле едет из
+        // карты прямо в парт. 0 — слой плоский
+        volume: Number(volumes?.[layer]) || 0,
+        levelHeight,
+        // прогоны рамп ЭТОГО уровня как объявлены в карте
+        // ({ tile, dir, from, to }): парт строит по ним клин с нарастающей
+        // высотой — грид уровня у него уже есть
+        ramps: (data.ramps || []).filter(ramp => (ramp.from ?? 0) === level),
         // прежнее имя оставлено для парта, который его уже читает
         physicsStatic,
         scale,
@@ -658,7 +674,7 @@ function applyMapData(data, { notifyHost = true } = {}) {
     }
   };
 
-  pushLayers(layers, map, 0, physicsStatic, []);
+  pushLayers(layers, map, 0, physicsStatic, [], data.volumes);
 
   for (const [key, levelData] of Object.entries(data.levels || {})) {
     const level = Number(key);
@@ -669,6 +685,7 @@ function applyMapData(data, { notifyHost = true } = {}) {
       level,
       levelData.walls || [],
       levelData.floor || [],
+      levelData.volumes,
     );
   }
 

package/src/devtools/contract/rules/e4-map-layers.js

@@ -40,12 +40,25 @@ export default {
 
 const RAMP_DIRS = ['north', 'south', 'west', 'east'];
 
+// Зеркало `vimp_engine_core::map::MAX_LEVELS`: уровни занимают биты 0..7
+// маски Rapier, бит 8 отдан статике. Константа живёт в Rust, поэтому здесь
+// она — копия, и расходится она молча: сторожем стоит фикстура
+// `bad-levels-too-many.json` общего корпуса.
+const MAX_LEVELS = 8;
+
 function checkMap(name, map, violations) {
   const at = `map "${name}"`;
   const levels = map.levels ?? {};
   // уровень 0 живёт в map/physicsStatic/layers и в `levels` не значится
   const levelCount = Object.keys(levels).length + 1;
 
+  // 0. потолок уровней: больше битов у маски нет
+  if (levelCount > MAX_LEVELS) {
+    violations.push(
+      `${at}: ${levelCount} levels, at most ${MAX_LEVELS} supported`,
+    );
+  }
+
   // 1. ключи — целые >= 1, подряд от 1
   const keys = Object.keys(levels).map(Number);
 
@@ -69,6 +82,21 @@ function checkMap(name, map, violations) {
     }
   });
 
+  // 11. высоты объёмов уровня 0 живут в корне карты, как и его слои
+  checkVolumes(at, '0', map.layers, map.volumes, violations);
+
+  // 13. высота уровня в мировых единицах: от неё зависит уклон рампы, а
+  // значит тяга в горку, наклон корпуса и пыль. Ноль превращает подъём в
+  // плоскость, NaN растекается по физике и по рендеру
+  if (map.levelHeight !== undefined) {
+    if (!Number.isFinite(map.levelHeight) || map.levelHeight <= 0) {
+      violations.push(
+        `${at}: levelHeight ${map.levelHeight} is not a finite number ` +
+          'greater than 0',
+      );
+    }
+  }
+
   const grid = map.map ?? [];
 
   for (const [key, level] of Object.entries(levels)) {
@@ -106,6 +134,9 @@ function checkMap(name, map, violations) {
 
     // 8. тайл рендер-слоя обязан существовать в тайл-листе по индексу
     checkLayerFrames(at, `level ${key}`, level?.layers, map.spriteSheet, violations);
+
+    // 11. высоты объёмов уровня
+    checkVolumes(at, key, level?.layers, level?.volumes, violations);
   }
 
   for (const [index, ramp] of (map.ramps ?? []).entries()) {
@@ -154,8 +185,17 @@ function checkMap(name, map, violations) {
         );
       }
     }
+
+    // 12. рампа через несколько уровней не имеет права прошивать плиту
+    // промежуточного: танк на ней въехал бы внутрь чужого моста
+    checkRampSlabs(at, map, index, ramp, from, to, fromGrid ?? [], violations);
   }
 
+  // 14. клетки разных рамп не пересекаются: ядро отдаёт общую клетку
+  // первой объявленной рампе, и поведение подъёма перестаёт выводиться
+  // из карты
+  checkRampOverlap(at, map, levels, grid, violations);
+
   // 10. край плиты без перил — обрыв; приземлиться с него нужно на
   // проходимую землю, иначе танк уезжает за карту (стены уровня 0 плите не
   // преграда) или приземляется внутри стены
@@ -309,7 +349,12 @@ function checkLevelEdges(at, map, violations) {
             continue;
           }
 
-          if (groundWalkable(map, nx, ny)) {
+          // сосед вне плиты — обрыв: под ним обязана быть проходимая
+          // поверхность того уровня, на который тело приземлится (плита
+          // этажом ниже — законный обрыв, а не дыра)
+          const landing = landingLevel(map, Number(key), nx, ny);
+
+          if (walkable(map, landing, nx, ny)) {
             continue;
           }
 
@@ -324,6 +369,106 @@ function checkLevelEdges(at, map, violations) {
   }
 }
 
+// зеркало `MapLevels::landing_level` (и `config_landing_level` валидатора
+// ядра): ближайший уровень строго ниже `from` с плитой в этой клетке, иначе
+// земля
+function landingLevel(map, from, x, y) {
+  for (let level = from - 1; level >= 1; level -= 1) {
+    const cfg = (map.levels ?? {})[String(level)];
+    const tile = cellAt(cfg?.map ?? [], x, y);
+
+    if (tile !== undefined && (cfg?.floor ?? []).includes(tile)) {
+      return level;
+    }
+  }
+
+  return 0;
+}
+
+// зеркало проверки пересечения прогонов в `validate_levels`: клетка,
+// объявленная двумя рампами, достаётся первой из них — молча
+function checkRampOverlap(at, map, levels, grid, violations) {
+  const claimed = new Map();
+
+  for (const [index, ramp] of (map.ramps ?? []).entries()) {
+    const from = ramp?.from ?? 0;
+    const fromGrid = from === 0 ? grid : levels[String(from)]?.map;
+
+    (fromGrid ?? []).forEach((row, y) => {
+      row.forEach((tile, x) => {
+        if (tile !== ramp?.tile) {
+          return;
+        }
+
+        const key = `${x},${y}`;
+        const first = claimed.get(key);
+
+        if (first === undefined) {
+          claimed.set(key, index);
+        } else if (first !== index) {
+          violations.push(
+            `${at}: ramps ${first} and ${index} share cell (${x}, ${y})`,
+          );
+        }
+      });
+    });
+  }
+}
+
+// клетки прогона рампы не должны лежать под плитой промежуточного уровня:
+// иначе подъём прошивает чужой мост
+function checkRampSlabs(at, map, index, ramp, from, to, grid, violations) {
+  const low = Math.min(from, to);
+  const high = Math.max(from, to);
+
+  for (let level = low + 1; level < high; level += 1) {
+    const cfg = (map.levels ?? {})[String(level)];
+
+    if (!cfg) {
+      continue;
+    }
+
+    grid.forEach((row, y) => {
+      row.forEach((tile, x) => {
+        if (tile !== ramp?.tile) {
+          return;
+        }
+
+        const over = cellAt(cfg.map ?? [], x, y);
+
+        if (over !== undefined && (cfg.floor ?? []).includes(over)) {
+          violations.push(
+            `${at}: ramp ${index} climbs ${from}->${to} through level ` +
+              `${level} floor at (${x}, ${y})`,
+          );
+        }
+      });
+    });
+  }
+}
+
+// высота рендер-слоя: ключ обязан быть ключом `layers` того же уровня,
+// значение — конечная высота в уровнях. Ядро высоты не использует, поэтому
+// опечатка в ключе даёт плоскую карту и ни одной строки в консоли
+function checkVolumes(at, key, layers, volumes, violations) {
+  for (const [layer, height] of Object.entries(volumes ?? {})) {
+    if (!Object.hasOwn(layers ?? {}, layer)) {
+      violations.push(
+        `${at}: level ${key} volumes names layer ${layer}, which is not a ` +
+          'render layer',
+      );
+      continue;
+    }
+
+    if (!Number.isFinite(height) || height <= 0 || height > MAX_LEVELS) {
+      violations.push(
+        `${at}: level ${key} volumes layer ${layer} height ${height} is not ` +
+          `in (0, ${MAX_LEVELS}]`,
+      );
+    }
+  }
+}
+
 function checkLayerFrames(at, where, layers, spriteSheet, violations) {
   const frames = spriteSheet?.frames;
 

package/src/host/meta/core/RoundManager.js

@@ -27,6 +27,11 @@ function scaleMapData(mapData) {
     physicsDynamic,
     respawns,
     scale,
+    // высота уровня — мировая величина, как и step: ядро получает эти
+    // данные со scale: 1 и повторно её не масштабирует
+    ...(mapData.levelHeight === undefined
+      ? {}
+      : { levelHeight: mapData.levelHeight * scale }),
   };
 }
 

package/src/lib/capabilities.js

@@ -27,6 +27,14 @@ export const ENGINE_CAPABILITIES = createRegistry('engine-capabilities', [
   // слоёные карты: `levels`/`ramps` в формате карты, маски уровней в
   // физике, уровень участника (`set_actor_level`), слоёный нав-граф
   { value: 'map.layers', since: '0.25.0' },
+  // многоуровневые карты: уровней до MAX_LEVELS = 8 (бит на уровень),
+  // рампы через несколько уровней, правила уровня и падение у тел карты,
+  // `z`/`level` в строке динамики, `volumes` (высота рендер-слоя)
+  { value: 'map.levelsN', since: '0.31.0' },
+  // высота уровня карты в мировых единицах (`levelHeight`): безразмерный
+  // уклон рампы в ядре, поле `levelHeight` в контексте статического парта,
+  // прогоны рамп уровня (`ramps`) там же, коллайдеры-стражи прогона
+  { value: 'map.levelHeight', since: '0.32.0' },
 ]);
 
 // плоский список имён — то, чем правило контракта B2 проверяет `requires`

package/src/lib/coreConfig.js

@@ -25,11 +25,22 @@ import wsports from '../config/wsports.js';
 export const buildCoreConfig = (gameConfig, overrides = {}) => {
   const { models, weapons } = gameConfig.parts;
 
+  // длительность падения — одна на всю экосистему: траекторию ящика карты
+  // считает движок, траекторию танка и предсказание того же ящика на
+  // клиенте — ядро игры. Игра, объявившая своё `coreParams.levels.fallTime`,
+  // владеет обеими: иначе ящик у хоста и у его же клиента летит с разной
+  // скоростью, и расходятся они молча
+  const gameFallTime = Number(gameConfig.coreParams?.levels?.fallTime);
+
   const flat = {
     timeStep: hostDefaults.timers.timeStep / 1000,
     friendlyFire: gameConfig.parts.friendlyFire,
     mapScale: gameConfig.mapScale,
     mapSetId: gameConfig.mapSetId,
+    mapFallTime:
+      Number.isFinite(gameFallTime) && gameFallTime > 0
+        ? gameFallTime
+        : gameConfig.mapFallTime,
     models,
     weapons,
     playerKeys: gameConfig.playerKeys,
@@ -50,6 +61,9 @@ export const buildCoreConfig = (gameConfig, overrides = {}) => {
       timeStep: flat.timeStep,
       mapScale: flat.mapScale,
       mapSetId: flat.mapSetId,
+      // движковый ключ, а не coreParams: траектория падения одна на танки и
+      // на тела карты, подменять её игровой половиной нельзя
+      mapFallTime: flat.mapFallTime,
       snapshot: flat.snapshot,
       seed: flat.seed,
     },

package/src/lib/gameConfigView.js

@@ -28,6 +28,9 @@ const FIELDS = {
   mapsInVote: { default: 1 },
   mapScale: { default: 1 },
   mapSetId: { default: null },
+  // секунды падения на уровень высоты (FallModel ядра): игра, не знающая о
+  // многоуровневых картах, получает движковое умолчание и не замечает поля
+  mapFallTime: { default: 0.35 },
 
   // лимит комнаты: без него берётся движковый (hostDefaults.maxPlayers)
   'roomDefaults.maxPlayers': { default: hostDefaults.maxPlayers },