Repository navigation
ZeqouX3D 0.17.7 Beta
Beta — ZeqouX3D is in active development; not a complete 3D engine yet.
Highlights since 0.17.4: FBX import (meshes, materials, textures, skeletons, animations — own parser, no FBX SDK), Sequencer (cutscenes on a timeline), behaviour tree editor, multi-selection and copy / paste in the editor.
Download ZeqouX3D-0.17.7-Beta-Setup.exe (installer) or the portable zip. Windows 10/11 x64, D3D12 GPU.
Full changelog (Russian) below.
0.17.7 — импорт FBX (M18) (2026-10-31)
- FBX-импорт своим кодом, без FBX SDK: binary FBX 7.x (7.4 и 7.5+ с 64-битными записями, сжатые массивы)
- меши: полигоны любой формы (веером), нормали, два набора UV, цвета вершин, несколько материалов на меш
- материалы Phong / Lambert → PBR (цвет, прозрачность, свечение; шероховатость и металл из файлов Blender),
текстуры цвета / нормалей / свечения — файлом или встроенные в FBX; перенесённые файлы ищутся по имени рядом
с моделью, вTextures,../Texturesи<имя>.fbm - иерархия узлов с пивотами, pre/post rotation и любым порядком поворотов; оси (Y-up, Z-up) и единицы файла
(сантиметры, метры) переводятся в метры движка - скелеты и скины (до 4 костей на вершину), анимации (каждый стек — клип; Blender-имена
Armature|Run→Run) - Import / двойной клик / перетаскивание
.fbxработают как с glTF; при копировании в проект текстуры
из соседних папок копируются рядом с моделью
- Не поддерживается пока: blend shapes (morph targets), ASCII FBX (сообщение с просьбой пересохранить в binary),
кубические кривые анимаций (между ключами — линейно; Blender, Maya с запеканием — точно) - Тесты FbxImport.*: сцена из Blender (
Tools/gen_fbx_testdata.py) в glTF и трёх вариантах FBX — позы скина
совпадают до 2 мм во всех клипах; реальная модель Quaternius; повреждённые и обрезанные файлы не роняют движок.
ManualFbx.CompareWithGltf(ZX_FBX_FILE / ZX_GLTF_FILE) сравнивает любой FBX с glTF той же сцены
0.17.6 — Sequencer и правки редактора (M18) (2026-10-31)
- Sequencer — кат-сцены и скриптованные изменения сцены на таймлайне (
.zseq, JSON в Content)- дорожки: Transform (Linear / Smooth / Step / Spline по позициям), Animation (клип с
speed,length,
loop; поза считается по времени, поэтому работает перемотка), Event (вfn onSequenceEvent(name)на цели
и её родителях), Camera (переключение на камеру, FOV, пустой ключ возвращает камеру игры), Audio (звук,
громкость, 3D в точке цели) - цель дорожки — имя сущности, путь
Parent/Child,@selfили@self/Child - компонент Sequence Player (Play On Start, Loop, Speed, Restore When Done), скрипты
entity.sequencePlay(from),
sequenceStop(),sequencePause(bool),sequenceTime(),sequencePlaying(); функция в Features:sequencer - окно Sequencer (Window > Sequencer, двойной клик по
.zseq, Content Browser > New Sequence, Create >
Cinematic, кнопка Edit Sequence у компонента, консольseq.edit/seq.status/seq.play/seq.reload):
линейка, дорожки, ключи, плейхед, Space — играть, K — ключ, Delete, Ctrl+Z / Ctrl+Y / Ctrl+S, snap к кадрам
(30/с), перетаскивание ключей, приближение колесом, панель настроек ключа, «взгляд через камеру кадра» во
вьюпорте, список проблем (нет цели в сцене, пустой клип/звук, два ключа в одно время) - превью меняет сцену только на время работы окна: перед Play, сохранением и очисткой сцены всё возвращается назад
- тесты Sequencer.* (формат, интерполяция, Apply/Restore с камерами, проигрыватель, регистрация)
- дорожки: Transform (Linear / Smooth / Step / Spline по позициям), Animation (клип с
- Скрипты на объекты понятнее:
.zs/.zgraphможно перетащить из Content Browser на объект во вьюпорте и в
Outliner или Details, «Add to Selected Entity» в меню файла Content Browser; одна проверка
и один шаг undo на все пути (AssignScript, тест ScriptAssignment.*) - Мультивыбор: Shift/Ctrl+клик во вьюпорте, в Outliner Ctrl — добавить, Shift — диапазон; гизмо двигает всю группу (дети выбранных не двигаются
дважды), обводка у всех выбранных, Delete и Ctrl+D работают с группой, один шаг undo - Ctrl+C / Ctrl+V: копирование объектов с детьми (в буфер обмена как JSON — можно вставлять между окнами редактора),
новые guid, вставка рядом; Edit > Copy / Paste - Content Browser: переименование файлов и папок (меню Rename, F2):
.zmetaи.znavпереезжают вместе с файлом,
проверка недопустимых символов и занятых имён - Графика сцены (File > Settings > Rendering): Fog (высотный и объёмный), Auto Exposure / Manual Exposure + EV100;
сохраняются в сцене и действуют в собранной игре - Исправлена сборка: повторный
= falseв определенииEditor::Select
0.17.5 — редактор Behaviour Trees (M18) (2026-10-24)
- Окно Behavior Tree (двойной клик по
.zbt, Content Browser > New Behavior Tree, кнопка Edit Tree у компонента,
консольbt.edit): дерево сверху вниз на холсте, дети выполняются слева направо (порядок = положение по горизонтали,
номер на узле)- добавление: правый клик или протянуть связь из нижнего пина в пустое место — меню с поиском по категориям
(композиты, декораторы, задачи) с подсказками; Alt+клик по пину — отсоединить; перетаскивание узлов, рамка,
Delete, Make Root, Ctrl+Z / Ctrl+Y, Ctrl+S - Arrange — аккуратная раскладка дерева; Frame — показать всё
- справа — настройки узла (ключ blackboard, сравнение, значение с типом, секунды, радиус, счётчик, текст),
слева — значения blackboard по умолчанию; список проблем (декоратор без ребёнка, композит без детей, задача без
ключа, несоединённые узлы) - отладка в Play: выбор ИИ, узлы подсвечиваются — выполняется (янтарный), последний успех (зелёный), неудача
(красный); живые значения blackboard; после сохранения работающие ИИ сразу берут новое дерево
- добавление: правый клик или протянуть связь из нижнего пина в пустое место — меню с поиском по категориям
- Стартовое дерево Guard теперь разложено аккуратно (
LayoutBehaviorTree) - Тест BehaviorTree.LayoutAndProblems