Repository navigation
ZeqouX3D 0.17.4 Beta
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
- композиты: Selector (реактивный: ветка с бо́льшим приоритетом, которая может выполняться, прерывает
- 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.statsworld.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; выключен по умолчанию
- для мощных видеокарт (UHD 620: ~17 мс, профиль Full): GI Quality Ultra или
- Приёмка 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)
- объекты раскладываются в атлас (4 текселя на метр, квадраты по масштабу объекта, ширина 1024, высота растёт
- В режиме 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;
в отладочных режимах просмотра выключен
- половинное разрешение, 4 луча на пиксель (косинусное распределение) идут по буферу глубины до 2.5 м; попадание
- На 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), подхватывается
при открытии сцены и в упакованной игре
- сетка проб подгоняется под всю статичную геометрию (шаг 1 м, растёт, если проб больше 24 000), поле
- Режим 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 по площади меша);
плотность текселей одинакова по всему мешу; вершины на краях карт дублируются - анимированные меши и тяжёлая виртуальная геометрия с органическими формами их не получают (швы мешали бы
упрощению кластеров) — они будут брать свет из проб
- треугольники растут в карты, пока нормали остаются в конусе 50° от первой (самой большой) грани — стены, пол,
- Второй 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 соседних проб с проверкой видимости
(тест Чебышёва) — свет не просачивается сквозь стены; пробы внутри стен отключаются сами
- глобальное поле расстояний сцены: статичная геометрия вокселизуется на видеокарте в 3 вложенных уровня
- Стоимость на 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...
- кнопки Dawn, Sunrise, Morning, Noon, Golden, Sunset, Dusk, Midnight — время ставится по настоящему восходу
- Консоль:
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— страницы
- уровни по 16k × 16k виртуальных текселей вокруг камеры, у каждого следующего тексели вдвое крупнее; пиксель
- Time of Day — смена дня и ночи (компонент в Add Component или команда
time <час> [длина суток в минутах]):- солнце движется как настоящее: высота и направление по часу, широте и дню года (на рассвете — восток, в полдень —
юг в северном полушарии); направление севера настраивается - во время игры часы идут (длина суток в реальных минутах), по желанию — и в редакторе
- закат и сумерки, потом ночь: небо гаснет, появляются звёзды и луна с фазами, лунный свет становится основным
светом (с тенями), автоэкспозиция не превращает ночь в день
- солнце движется как настоящее: высота и направление по часу, широте и дню года (на рассвете — восток, в полдень —