vimp-engine 0.30.1 → 0.31.0

package/core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "vimp-engine-core"
-version = "0.11.0"
+version = "0.12.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.31.0",
   "description": "VIMP — движок-приложение (мастер, P2P-транспорт, Worker-хост, мета, MVC-каркас клиента)",
   "license": "MIT",
   "repository": {

package/src/client/main.js

@@ -637,7 +637,7 @@ function applyMapData(data, { notifyHost = true } = {}) {
   const staticData = {};
   let staticIndex = 0;
 
-  const pushLayers = (levelLayers, levelMap, level, solid, floor) => {
+  const pushLayers = (levelLayers, levelMap, level, solid, floor, volumes) => {
     for (const [layer, tiles] of Object.entries(levelLayers || {})) {
       staticData[`s${staticIndex}`] = {
         type: 'static',
@@ -649,6 +649,9 @@ function applyMapData(data, { notifyHost = true } = {}) {
         level,
         solid,
         floor,
+        // визуальная высота слоя в уровнях: ядро её не знает, поле едет из
+        // карты прямо в парт. 0 — слой плоский
+        volume: Number(volumes?.[layer]) || 0,
         // прежнее имя оставлено для парта, который его уже читает
         physicsStatic,
         scale,
@@ -658,7 +661,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 +672,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,9 @@ function checkMap(name, map, violations) {
     }
   });
 
+  // 11. высоты объёмов уровня 0 живут в корне карты, как и его слои
+  checkVolumes(at, '0', map.layers, map.volumes, violations);
+
   const grid = map.map ?? [];
 
   for (const [key, level] of Object.entries(levels)) {
@@ -106,6 +122,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,6 +173,10 @@ function checkMap(name, map, violations) {
         );
       }
     }
+
+    // 12. рампа через несколько уровней не имеет права прошивать плиту
+    // промежуточного: танк на ней въехал бы внутрь чужого моста
+    checkRampSlabs(at, map, index, ramp, from, to, fromGrid ?? [], violations);
   }
 
   // 10. край плиты без перил — обрыв; приземлиться с него нужно на
@@ -309,7 +332,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 +352,76 @@ 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;
+}
+
+// клетки прогона рампы не должны лежать под плитой промежуточного уровня:
+// иначе подъём прошивает чужой мост
+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/lib/capabilities.js

@@ -27,6 +27,10 @@ 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' },
 ]);
 
 // плоский список имён — то, чем правило контракта B2 проверяет `requires`

package/src/lib/coreConfig.js

@@ -30,6 +30,7 @@ export const buildCoreConfig = (gameConfig, overrides = {}) => {
     friendlyFire: gameConfig.parts.friendlyFire,
     mapScale: gameConfig.mapScale,
     mapSetId: gameConfig.mapSetId,
+    mapFallTime: gameConfig.mapFallTime,
     models,
     weapons,
     playerKeys: gameConfig.playerKeys,
@@ -50,6 +51,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 },