vimp-engine 0.31.0 → 0.32.1

package/core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "vimp-engine-core"
-version = "0.12.0"
+version = "0.14.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.31.0",
+  "version": "0.32.1",
   "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,17 @@ export default class SoundManager {
     // реестр всех зарегистрированных звуковых источников
     this._registeredSounds = new Map();
 
+    // экземпляры, уже переведённые на equalpower (непространственные):
+    // pannerAttr ставится один раз на экземпляр, а не каждый кадр
+    this._equalPowerIds = new Set();
+
+    // экземпляры, у которых PannerNode УЖЕ создан. Howler создаёт узел
+    // лениво — на первом pos()/pannerAttr(id) — и заканчивает создание
+    // парой pause()/play() (setupPanner в howler.js), то есть щелчком.
+    // Пока источник стоит в точке слушателя, паннер не нужен вовсе:
+    // сигнал идёт прямо в gain, сохраняя стерео сэмпла
+    this._pannedIds = new Set();
+
     // позиция слушателя
     this._listenerX = 0;
     this._listenerY = 0;
@@ -154,6 +168,12 @@ 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 на нулевой дистанции сворачивается
+   *   в гребенчатую окраску («гул»), а не в тишину панорамы. Такому звуку
+   *   PannerNode не создаётся вовсе — он идёт прямо в gain и остаётся
+   *   стерео.
    * @param {function} [callback] - Функция, вызываемая по завершении.
    * @returns {symbol | null} Уникальный ID звука или null, если звук не найден.
    */
@@ -168,6 +188,7 @@ export default class SoundManager {
 
     const id = Symbol(soundName);
     const registration = {
+      spatial: true,
       ...soundData.config,
       ...data,
       sound: soundData.sound,
@@ -308,6 +329,7 @@ export default class SoundManager {
               candidate.position.x,
               candidate.position.y,
               candidate.volume,
+              candidate.spatial,
             );
           }
         }
@@ -334,15 +356,29 @@ export default class SoundManager {
       if (!regSound) {
         sound.stop(soundId);
         this._activeInstances.delete(soundId);
+        this._equalPowerIds.delete(soundId);
+        this._pannedIds.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 +416,8 @@ export default class SoundManager {
           }
 
           this._activeInstances.delete(soundId);
+          this._equalPowerIds.delete(soundId);
+          this._pannedIds.delete(soundId);
         },
         soundId,
       );
@@ -397,6 +435,8 @@ export default class SoundManager {
     if (instanceData) {
       instanceData.sound.stop(soundId);
       this._activeInstances.delete(soundId);
+      this._equalPowerIds.delete(soundId);
+      this._pannedIds.delete(soundId);
     }
   }
 
@@ -408,12 +448,27 @@ 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) {
+      // источник игрока: звук не принадлежит миру, он принадлежит игроку.
+      // Паннер ему не нужен ни в каком виде — ни HRTF (на нулевой
+      // дистанции это не тишина панорамы, а фронтальная свёртка:
+      // гребенчатая окраска, из-за которой двигатель слышен как гул), ни
+      // equalpower (тот схлопывает стерео сэмпла в моно). Пока узла нет,
+      // pos() не зовётся вовсе: Howler создал бы паннер и щёлкнул
+      // pause()/play()
+      sound.volume(volume, soundId);
+      this._recenterIfPanned(sound, soundId, true);
+
+      return;
+    }
+
     const distance = Math.hypot(x - this._listenerX, y - this._listenerY);
 
     if (distance >= PANNER_SETTINGS.maxDistance) {
@@ -427,9 +482,47 @@ export default class SoundManager {
     // если дистанция позволяет панорамировать звук
     if (distance > MIN_SPATIAL_DISTANCE) {
       sound.pos(x - this._listenerX, 0, y - this._listenerY, soundId);
+      this._pannedIds.add(soundId);
     } else {
-      sound.pos(0, 0, 0, soundId); // отключение панорамирования
+      // внутри дед-зоны звук идёт по центру. Экземпляру, у которого паннер
+      // ещё не создан, здесь не место его заводить: узел появится на
+      // первом же выходе из дед-зоны
+      this._recenterIfPanned(sound, soundId);
+    }
+  }
+
+  /**
+   * @private Возвращает в центр экземпляр, у которого PannerNode УЖЕ есть
+   * (источник успел побывать в стороне от слушателя). Экземпляр без узла
+   * не трогается: создание паннера — это лишний узел в цепочке, потеря
+   * стерео и щелчок от pause()/play() внутри setupPanner Howler'а.
+   * @param {boolean} [equalPower=false] - Перевести узел на equalpower:
+   *   так делается только для источника игрока, миру HRTF сохраняется —
+   *   он снова понадобится, как только источник выйдет из дед-зоны.
+   */
+  _recenterIfPanned(sound, soundId, equalPower = false) {
+    if (!this._pannedIds.has(soundId)) {
+      return;
+    }
+
+    if (equalPower) {
+      this._applyEqualPower(sound, soundId);
+    }
+
+    sound.pos(0, 0, 0, soundId);
+  }
+
+  /**
+   * @private Переводит экземпляр звука на equalpower — один раз на
+   * экземпляр: pannerAttr на каждом кадре пересобирал бы panner-узел.
+   */
+  _applyEqualPower(sound, soundId) {
+    if (this._equalPowerIds.has(soundId)) {
+      return;
     }
+
+    sound.pannerAttr({ panningModel: 'equalpower' }, soundId);
+    this._equalPowerIds.add(soundId);
   }
 
   /**
@@ -467,6 +560,8 @@ export default class SoundManager {
   reset() {
     Howler.stop();
     this._activeInstances.clear();
+    this._equalPowerIds.clear();
+    this._pannedIds.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,6 +641,10 @@ function applyMapData(data, { notifyHost = true } = {}) {
   const staticData = {};
   let staticIndex = 0;
 
+  // мировых единиц на уровень: партам нужен для параллакса слоёв и
+  // экструзии объёмов. 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}`] = {
@@ -652,6 +660,11 @@ function applyMapData(data, { notifyHost = true } = {}) {
         // визуальная высота слоя в уровнях: ядро её не знает, поле едет из
         // карты прямо в парт. 0 — слой плоский
         volume: Number(volumes?.[layer]) || 0,
+        levelHeight,
+        // прогоны рамп ЭТОГО уровня как объявлены в карте
+        // ({ tile, dir, from, to }): парт строит по ним клин с нарастающей
+        // высотой — грид уровня у него уже есть
+        ramps: (data.ramps || []).filter(ramp => (ramp.from ?? 0) === level),
         // прежнее имя оставлено для парта, который его уже читает
         physicsStatic,
         scale,

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

@@ -85,6 +85,18 @@ 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)) {
@@ -179,6 +191,11 @@ function checkMap(name, map, violations) {
     checkRampSlabs(at, map, index, ramp, from, to, fromGrid ?? [], violations);
   }
 
+  // 14. клетки разных рамп не пересекаются: ядро отдаёт общую клетку
+  // первой объявленной рампе, и поведение подъёма перестаёт выводиться
+  // из карты
+  checkRampOverlap(at, map, levels, grid, violations);
+
   // 10. край плиты без перил — обрыв; приземлиться с него нужно на
   // проходимую землю, иначе танк уезжает за карту (стены уровня 0 плите не
   // преграда) или приземляется внутри стены
@@ -368,6 +385,36 @@ function landingLevel(map, from, x, y) {
   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) {

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

@@ -31,6 +31,10 @@ export const ENGINE_CAPABILITIES = createRegistry('engine-capabilities', [
   // рампы через несколько уровней, правила уровня и падение у тел карты,
   // `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,12 +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: gameConfig.mapFallTime,
+    mapFallTime:
+      Number.isFinite(gameFallTime) && gameFallTime > 0
+        ? gameFallTime
+        : gameConfig.mapFallTime,
     models,
     weapons,
     playerKeys: gameConfig.playerKeys,