Skip to content

ZeqouX3D 0.17.4 Beta

Choose a tag to compare

@Mishaadevv Mishaadevv released this 24 Oct 15:45
· 11 commits to main since this release

Beta — ZeqouX3D is in active development; not a complete 3D engine yet.

Highlights since 0.15.0: virtual shadow maps, time of day, dynamic GI (DDGI over a global SDF), baked lightmaps, SSGI, Lumen-lite, World Partition with HLOD (4x4 km open worlds), foliage, AI navigation (NavMesh, pathfinding, agents) and behaviour trees.

Download ZeqouX3D-0.17.4-Beta-Setup.exe (installer) or the portable zip. Windows 10/11 x64, D3D12 GPU.

Full changelog (Russian) below.

0.17.4 — Behaviour Trees: решения ИИ (M18) (2026-10-24)

  • Компонент Behavior Tree: дерево решений из файла .zbt (JSON в Content, перечитывается bt.reload)
    • композиты: Selector (реактивный: ветка с бо́льшим приоритетом, которая может выполняться, прерывает
      текущую — «погоня, как только увидел игрока»), Sequence (условия перед выполняющимся шагом проверяются
      каждый тик: потерял цель — погоня прерывается), Parallel
    • декораторы: Inverter, Succeeder, Repeat, Cooldown
    • задачи: Wait, MoveTo (точка или сущность из blackboard, через Nav Mesh Agent, перестраивает путь за движущейся
      целью), Stop, Condition, SetValue / ClearValue, RandomPoint (случайная достижимая точка), NextWaypoint (дети
      сущности-группы по порядку), FaceTarget, Event (fn onAIEvent(name) в скриптах), Log
  • Blackboard у каждого ИИ (bool, число, vec3, строка, сущность), значения по умолчанию в файле; скрипты:
    entity.bbGet(key) / entity.bbSet(key, value)
  • Зрение: дальность, угол обзора, высота глаз, линия видимости через физику; пишет target, targetVisible,
    targetLastSeen
  • Starter Content: AI/Guard.zbt — охранник патрулирует точки «Waypoints», гонится за Player, пока видит,
    осматривает место, где потерял, и возвращается к патрулю. Create > AI Agent создаёт агента с этим деревом и
    четыре точки патруля; Nav Mesh Bounds и AI Agent ставятся на землю под точкой создания
  • Консоль: bt.status (выполняющиеся узлы и blackboard каждого ИИ), bt.reload
  • Исправлено: компоненты Nav Mesh Bounds / Nav Mesh Agent из 0.17.3 не были зарегистрированы (их не было в
    Add Component, и они не сохранялись в сцену)
  • Тесты BehaviorTree.* (формат и проверка дерева, приоритеты и прерывания, Repeat / Cooldown, охранник патрулирует,
    догоняет и ищет)

0.17.3 — навигация ИИ: NavMesh, поиск пути, агенты (M18) (2026-10-24)

  • Новый модуль Nav — навигационный меш как в Recast: геометрия сцены вокселизируется (клетки 0.3 × 0.2 м),
    проходимыми остаются поверхности положе заданного уклона, над которыми помещается агент, без обрывов выше ступеньки;
    край отступает от стен на радиус агента, мелкие острова отбрасываются; клетки сливаются в выпуклые полигоны со
    связями (мосты и этажи друг над другом не склеиваются)
  • Поиск пути: A* по полигонам + алгоритм «воронки» (кратчайший путь по мешу) + срезание лишних углов лучом по
    мешу; недостижимая цель — путь до ближайшей точки (статус partial); Raycast по мешу, ближайшая точка на меше
  • Компоненты: Nav Mesh Bounds (коробка, где строить: радиус/рост агента, ступенька, уклон, размер клетки) и
    Nav Mesh Agent (скорость, ускорение, торможение у цели, поворот по ходу движения); с Character Controller агент
    управляет персонажем через физику, без него — двигает объект и ставит его на меш
  • Меш строится из Mesh Renderer с коллизией и террейнов (по их карте высот); динамические тела, персонажи и агенты не
    мешают. Сохраняется рядом со сценой (<сцена>.znav), игра его загружает; без файла строится при старте Play
  • Редактор: Build > Build Navigation, Show > Navigation (полигоны и пути агентов), Create > Nav Mesh Bounds /
    AI Agent; консоль nav.build, nav.show, nav.stats, nav.goto x y z, create navbounds|navagent
  • Скрипты: entity.navTo(pos), navStop(), navStatus(), navRemaining()
  • Тесты NavMesh.* и Navigation.* (эрозия, обход стены по кратчайшему пути, ступеньки/обрывы/крутые склоны, этажи,
    файл .znav, агент доходит до цели)

0.17.2 — растительность: леса, кусты, камни, трава (M18) (2026-10-24)

  • Компонент Foliage: много копий одной модели (дерево, куст, камень, трава) на одной сущности — части модели
    (меш, материалы) берутся из её префаба, экземпляры (позиция, поворот, масштаб) хранятся упакованными; каждый
    экземпляр рисуется через GPU-driven путь (отсечение, LOD), дальше своей дистанции (Cull Distance) — не рисуется
  • Рассадка по правилам (ScatterFoliage): плотность, максимальный уклон, полоса высот, «пятна» (леса и поляны по
    шуму), разброс масштаба; детерминированно по сиду и месту
  • world.create теперь сажает мир: лиственные деревья в низинах, ели выше, кусты, камни, трава рядом с камерой
    (CC0-пак Quaternius Stylized Nature копируется в проект) — около 280 тыс. растений и камней на 4×4 км, по одной
    сущности Foliage на модель в каждой ячейке (стримятся вместе с ней)
  • Тест полёта по лесному миру 4×4 км: обновление мира в среднем 1.8 мс, максимум 31 мс, кадров > 50 мс — 0

0.17.1 — открытые миры, часть 1: World Partition, HLOD, мир 4×4 км (M18) (2026-10-24)

  • World Partition: сцена делится на ячейки (по умолчанию 256 м); корневые объекты с компонентом
    Spatially Loaded хранятся не в .zscene, а в файлах ячеек <сцена>_Cells/x_z.zcell и подгружаются вокруг
    камеры (в редакторе) или игровой камеры (в игре), а вдали выгружаются
    • файлы читаются и разбираются фоновыми задачами, объекты создаются по одному дереву в пределах бюджета кадра;
      новые тайлы террейна строятся по два за кадр — без длинных кадров
    • сохранение раскладывает объекты по ячейкам; ячейка, в которую попал новый объект, сначала догружается
      (ничего не теряется); пустые ячейки удаляются
    • в редакторе ячейки выгружаются только у сохранённой сцены (несохранённые правки остаются в памяти)
  • HLOD: на каждые 4×4 ячейки — один упрощённый меш их террейна (~16 м между точками, с юбками, чуть ниже
    настоящей земли); незагруженные группы в пределах 8 км показывают его — горизонт никогда не пустой, а весь мир —
    это 16 мешей вместо сотен
  • Террейн для больших миров: noiseOffset — тайлы с одинаковыми настройками продолжают холмы друг друга без швов
    (нормали на краях тоже считаются по генератору); у чанков террейна появилась цепочка LOD (каждая 2-я, 4-я…
    точка) с юбками против щелей
  • world.create [км] [тайл м] [seed] — генератор открытого мира: сетка тайлов террейна прямо в файлы ячеек,
    HLOD, небо, солнце, облака, время суток, инстанс материала со снегом только на вершинах; world.hlod, world.stats
  • world.flytest [с] [м/с] — проверка стриминга: камера летит по миру, замеряется время обновления мира на
    главном потоке. Мир 4×4 км (256 тайлов), 30 с на 60 м/с: в среднем 1.2 мс, максимум 38 мс, кадров > 50 мс — 0
  • Упакованная игра (ZXGame) стримит ячейки вокруг игровой камеры

0.17.0 — веха M17 «Глобальное освещение» закрыта (2026-10-24)

  • Lumen-lite (прототип GI-2): непрямой свет считается для каждого пикселя (в половинном разрешении) — луч сначала
    идёт по экрану (точные детали у контактов, освещённый кадр), а если ушёл за экран или ничего не нашёл — по полю
    расстояний сцены, где попадание освещается солнцем, лампами и кэшем проб. Ближние попадания в поле (грубее двух
    вокселей) отдаются пробам. Больше контактных деталей: складки тканей, выступы, тени под карнизами
    • для мощных видеокарт (UHD 620: ~17 мс, профиль Full): GI Quality Ultra или r.GI.Lumen; выключен по умолчанию
  • Приёмка M17: Sponza с движущимся солнцем (утро / день / вечер) и непрямым светом в профиле Full — GI 8–10 мс
    на Intel UHD 620 (на GTX 1060 — около 1 мс); бейк освещения на Low (Lite): пробы Sponza за ~15 с, лайтмапы уровня
    Third Person
  • Аппаратная трассировка лучей (DXR) отложена: у машины разработки её нет (RT tier 0); весь трассирующий код идёт
    через одну функцию ShadeRay — путь RayQuery встанет туда, когда будет на чём проверить
  • README: раздел о глобальном освещении и скриншоты Sponza с GI и без

0.16.8 — лайтмапы (M17, GI-0) (2026-10-24)

  • Bake Lighting теперь запекает и лайтмапы — непрямой рассеянный свет по текселям для статичных мешей с UV
    лайтмапа (уровни, пропсы, встроенные фигуры); остальное (тяжёлая виртуальная геометрия, движущиеся объекты) берёт
    свет из запечённых проб
    • объекты раскладываются в атлас (4 текселя на метр, квадраты по масштабу объекта, ширина 1024, высота растёт
      до 8192), поверхности растеризуются в атлас консервативно (позиция и нормаль каждого текселя)
    • от каждого текселя 8 лучей × 32 итерации через поле расстояний с тем же освещением попаданий, что у проб;
      лучи, начавшиеся внутри геометрии (стыки стен и пола), не считаются; швы карт заливаются от соседей
    • атлас сохраняется в .zgi (формат 2), место каждого объекта — в его Mesh Renderer (сохраняется со сценой,
      бейк отменяется через Undo)
  • В режиме Baked (профиль Lite) объекты с лайтмапом берут непрямой свет из своих текселей — мягкие тени у стыков,
    цветные отскоки, без утечек света между пробами; прямое солнце остаётся в реальном времени
  • Встроенные фигуры (Cube, Sphere, Plane, Cylinder) получают настоящие UV лайтмапа (раньше UV1 = UV0, грани куба
    накладывались)
  • Строка инстанса на GPU 192 → 208 байт (данные лайтмапа)

0.16.7 — экранный GI (SSGI) (2026-10-24)

  • Screen Space GI: мелкий отражённый свет, который пробы (шаг 1–1.6 м) не видят — пол рядом с цветными
    предметами, свет от движущихся и светящихся объектов, отскок в углах
    • половинное разрешение, 4 луча на пиксель (косинусное распределение) идут по буферу глубины до 2.5 м; попадание
      берёт уже освещённый цвет кадра (прямой свет + пробы = ещё отскоки); промахи остаются пробам
    • накопление по кадрам с репроекцией и ограничением по соседям (без шлейфов); применяется в следующем кадре
    • профиль Full (нужны нормали G-буфера); File → Settings → Rendering → Screen Space GI, r.GI.ScreenSpace;
      в отладочных режимах просмотра выключен
  • На UHD 620 в Full ~4.4 мс (рассчитан на дискретные видеокарты)

0.16.6 — GI: пустые пробы не трассируются (2026-10-24)

  • Классификация проб: проба, рядом с которой (в пределах шага сетки) нет ни одной поверхности, никому не даёт
    свет — её лучи пускаются только раз в 8 её очередей, чтобы заметить появившуюся геометрию
  • Динамический GI на Intel UHD 620 (профиль Lite): открытая сцена Third Person 7.1 → 2.7 мс, Sponza 3.8 → 1.7 мс
    на кадр; картинка та же

0.16.5 — запекание освещения (M17, GI-0: Baked) (2026-10-24)

  • File → Bake Lighting (или gi.bake [шаг м] [итераций]): свет статичной сцены запекается в пробы
    • сетка проб подгоняется под всю статичную геометрию (шаг 1 м, растёт, если проб больше 24 000), поле
      расстояний — 4 уровня вокруг неё
    • каждая проба: 256 лучей × 48 итераций с точным усреднением, отражения многократные — Sponza (11 616 проб)
      запекается за ~15 с на Intel UHD 620, прогресс в Output Log
    • результат сохраняется рядом со сценой (<сцена>.zgi; для несохранённой — Saved/BakedLighting), подхватывается
      при открытии сцены и в упакованной игре
  • Режим GI (File → Settings → Rendering → GI Mode, r.GI.Mode): Dynamic — пробы трассируются каждый кадр
    (движущееся солнце и лампы); Baked — запечённые пробы, 0 мс на GPU; динамические объекты освещаются ими же
    (пробы для динамики). Профиль Lite по умолчанию — Baked, если у сцены есть бейк
  • gi.clearbake — удалить бейк сцены; stat.scene показывает, какой GI работает

0.16.4 — UV для лайтмапов (M17, подготовка к запеканию света) (2026-10-24)

  • Генерация UV лайтмапов при импорте (как «Generate Lightmap UVs» в UE / Unity) для статичных мешей без своего
    второго UV-канала:
    • треугольники растут в карты, пока нормали остаются в конусе 50° от первой (самой большой) грани — стены, пол,
      грани округлых форм становятся отдельными картами
    • каждая карта проецируется на свою плоскость и поворачивается к минимальному прямоугольнику
    • карты пакуются полками в квадрат с промежутками в 3 текселя (опорное разрешение 32…1024 по площади меша);
      плотность текселей одинакова по всему мешу; вершины на краях карт дублируются
    • анимированные меши и тяжёлая виртуальная геометрия с органическими формами их не получают (швы мешали бы
      упрощению кластеров) — они будут брать свет из проб
  • Второй UV-канал теперь доходит до шейдеров: нода TexCoord 1 в материалах работает по-настоящему
  • r.ViewMode 10 — плотность UV лайтмапа (шахматка; красным — меши без UV лайтмапа)
  • Кэш импорта пересоберётся один раз (версия кукера 9)

0.16.3 — GI: пробы сами выходят из стен (2026-10-24)

  • Перемещение проб (как в RTXGI): проба, оказавшаяся внутри стены, колонны или за тонкой тканью, по своим же
    лучам находит ближайшую обратную сторону поверхности и выходит сквозь неё; слишком близкая к поверхности —
    отступает. Сдвиг не больше 45 % шага сетки, при прокрутке сетки сбрасывается
  • Убирает тёмные пятна и «протечки» у тонкой геометрии (знамёна Sponza) и оживляет пробы, которые раньше просто
    отключались

0.16.2 — динамическое глобальное освещение (M17, часть 1: DDGI на глобальном SDF) (2026-10-24)

  • Свет отражается от поверхностей в реальном времени: освещённый солнцем пол подсвечивает потолки и арки
    тёплым светом, ткани и стены «красят» свет вокруг, галереи и углы — тёмные, а не залиты ровным небом. Работает
    и с движущимся солнцем / Time of Day: свет перестраивается за пару секунд.
  • Как устроено:
    • глобальное поле расстояний сцены: статичная геометрия вокселизуется на видеокарте в 3 вложенных уровня
      128³ вокруг камеры (0.25 / 0.5 / 1 м), с цветом поверхностей (текстура на подходящем mip) и нормалями; расстояния
      считаются jump flooding. Уровень перестраивается, только когда камера уходит от его центра или меняется
      статичная сцена (не чаще раза в 20 кадров); движущиеся и анимированные объекты в поле не попадают
    • сетка проб (DDGI) вокруг камеры: каждая проба пускает лучи по полю расстояний; попадание освещается
      солнцем (тень из каскадов, дальше — мягкая тень по полю), точечными и прожекторными источниками и самими пробами
      прошлого кадра (многократные отражения), промах — небом. Пробы хранят освещённость (октаэдр 8×8) и расстояния
      (16×16) и смешивают кадры
    • освещение поверхностей: рассеянный «небесный» свет заменён светом 8 соседних проб с проверкой видимости
      (тест Чебышёва) — свет не просачивается сквозь стены; пробы внутри стен отключаются сами
  • Стоимость на Intel UHD 620: профиль Lite — около 3.5 мс (4000 проб, обновляется 1/8 за кадр); профиль Full —
    9408 проб, половина за кадр (рассчитан на дискретные видеокарты)
  • Настройки: File → Settings → Rendering → Global Illumination + GI Quality (Low…Ultra), окно Features →
    Global Illumination (для проекта); консоль r.GI, r.GI.Intensity, r.GI.Rays, r.GI.Stride, r.GI.Spacing;
    r.ViewMode 9 — только непрямой свет; stat.scene показывает пробы и перестройки поля
  • Графика эпох 2011 / 2008 — без динамического GI (2017 — с ним)

0.16.1 — настройки теней и времени суток в интерфейсе, мягкие виртуальные тени (2026-10-24)

  • Directional Light → раздел Shadows (как в UE):
    • Source Angle — видимый размер солнца: больше = мягче тени вдали от контакта (настоящее солнце — 0.53°)
    • Shadow Distance — на сколько метров вокруг камеры солнце отбрасывает тени (0 = как в профиле движка)
    • Shadow Bias — сдвиг от поверхности: выше — против полос («acne»), ниже — если тень отрывается от объекта
    • Contact Shadows — галочка + длина короткой экранной тени там, где предметы касаются земли
  • File → Settings → Rendering:
    • Shadow Method: Default / Cascades (каскады, дёшево) / Virtual (виртуальные карты теней, резко и близко, и далеко)
    • Shadow Quality теперь управляет и виртуальными тенями: плотность текселей, дальность (120–400 м), сколько
      страниц перерисовывать за кадр
    • Contact Shadows — вкл/выкл
    • настройки применяются только при изменении, поэтому консольные r.* больше не перетираются каждый кадр
  • Мягкие виртуальные тени (Shadow Quality Ultra или профиль Full): тень резкая у самого контакта и размывается
    с расстоянием до заслоняющего объекта; широкая полутень берётся с более грубого уровня, поэтому стоимость не растёт;
    выборки переходят через границы страниц без швов
  • Разметка страниц стала дешевле (на UHD 620 0.33 → 0.23 мс; с мягкими тенями 1.45 → 0.35 мс): атомарная запись
    только если страница ещё не отмечена, грубые уровни отмечаются реже
  • Time of Day:
    • кнопки Dawn, Sunrise, Morning, Noon, Golden, Sunset, Dusk, Midnight — время ставится по настоящему восходу
      и закату этого дня и широты
    • под кнопками: восход, закат, долгота дня (полярный день / полярная ночь), высота солнца и луны, фаза луны
    • консоль: time golden, time sunset, time dusk...
  • Консоль: r.Shadows.Virtual.Distance; select понимает _ вместо пробела (select Time_of_Day)

0.16.0 — веха M16 закрыта: виртуальные карты теней и смена дня и ночи (2026-10-18)

  • Виртуальные карты теней (VSM) для солнца — чёткие тени и у самых ног, и вдали:
    • уровни по 16k × 16k виртуальных текселей вокруг камеры, у каждого следующего тексели вдвое крупнее; пиксель
      берёт уровень под свой размер на экране
    • рисуются только нужные экрану страницы 128 × 128 (GPU отмечает их сам), страницы кэшируются, пока в них ничего
      не движется; движущиеся объекты перерисовывают только свои страницы
    • камни и другие меши ZNano рисуются в тени кластерами — тени тоже детальные
    • когда солнце поворачивается, тени для нового положения собираются в фоне и подменяют старые целиком — тени
      смещаются ступеньками, но никогда не пропадают
    • включены по умолчанию в профиле Full; в Lite — r.Shadows.Virtual 1 (там остаются каскады)
    • режим вида Cascades (r.ViewMode 5) раскрашивает уровни; stat.scene — страницы
  • Time of Day — смена дня и ночи (компонент в Add Component или команда time <час> [длина суток в минутах]):
    • солнце движется как настоящее: высота и направление по часу, широте и дню года (на рассвете — восток, в полдень —
      юг в северном полушарии); направление севера настраивается
    • во время игры часы идут (длина суток в реальных минутах), по желанию — и в редакторе
    • закат и сумерки, потом ночь: небо гаснет, появляются звёзды и луна с фазами, лунный свет становится основным
      светом (с тенями), автоэкспозиция не превращает ночь в день