Nuael Engine v0.2.1 — Pre-alpha

Nuael Editor v0.2.1 — Pre-alpha

Nuael Engine — a 2D game engine + editor on the Deno/JS stack. Windows x64 / Linux x64.

The window runtime library (WebUI) is bundled into the binary — no network is
required at launch; the editor runs offline.

Patch release — “it launches.” 0.2.1 changed not the cosmetics but the very fact
of starting: the editor now opens where it previously refused to, and explains itself
when it cannot.

Launch & diagnostics

• Window browser selection (bootstrap). dev — forces Chrome; release — a fallback
  chain Edge → Chrome → Firefox → any available. No Chrome (an old laptop, someone
  else's machine) — the window still opens.
• Loud failure, not silent hanging. If the window cannot be opened, the log and
  console receive the list of candidates, the result for each, and a recommendation; the
  process exits with code 1 instead of hanging forever.
• CLI flags (--help prints and exits): --debug (console visible, debug log
  level, DevTools), --browser edge|chrome|firefox|any (manual override of the chain),
  --log-level error|warn|info|debug. An unknown flag is a loud failure with a hint
  (“--debag — did you mean --debug?”), not a launch in an unclear mode. --dev is a
  deprecated alias of --debug.
• Clean boot log. Scaffolding removed (bare prints and the logger self-test); the
  real mode and active flags are the first line. Errors are no longer swallowed into
  {} — the logger expands them into text.

Offline & self-contained

• WebUI is bundled into the binary. Previously the editor reached out to
  github.com on EVERY start for the window's native library (and hung forever without
  a network). Now the library is embedded and its resolution is shimmed locally: ship
  the archive — it works offline, forever. At start the log shows
  [WEBUI] native library bundled: … — offline.
• Dependency manifest (vendor/webui/MANIFEST.md): the exact version and SHA-256 of
  the bundled library.

Platforms

• Linux x64 — a second target (NuaelEditor-v0.2.1-linux64.tar.gz), the same
  launch contract and fallback chain.

Artifact

• NuaelEditor-v0.2.1-win64.zip → NuaelEditor.exe (Windows x64), ≈ 108 MiB (exe).
• NuaelEditor-v0.2.1-linux64.tar.gz → NuaelEditor (Linux x64).
• SHA-256 (exe): 3eca341dc140829f455374cfe7c6863894be79489592080553f067a6766cf036
• Archive hashes are next to the artifacts: NuaelEditor-v0.2.1-win64.zip.sha256,
  NuaelEditor-v0.2.1-linux64.tar.gz.sha256.

Hotkeys

Editor: Ctrl+Z / Ctrl+Y — undo/redo; Delete — delete an entity (in the assets panel — an asset, with an impact dialog); Ctrl+S — save project; Ctrl+Shift+S — save scene as; Ctrl+N — new project; Ctrl+O — open project; Ctrl+Shift+Space — snippets.

Engine window (edit): Ctrl+Z / Ctrl+Y; Ctrl+D — duplicate entity; Ctrl+Shift+A — new entity; Delete — delete; G — global/local; PageUp / PageDown — Z-order.

Known limitations (post-release package)

• Bootstrap log line order and the “last resort” timeout (AnyBrowser) — cosmetics/UX.
• The shutdown protocol does not distinguish “worker busy” from “never started” (~5 s pause when the window fails to open).
• Headless Linux (no X11/Wayland) — a loud failure is expected; verification ahead.

Changes (recent history)

92093e7e chore(webui): lib version manifest, timeout guard, status line
95a08410 feat(webui): bundle the native WebUI library — offline launch
6d3d3b25 feat(release): linux target — build:linux + linux64.tar.gz in release:pack
cc8fe949 chore(log): drop scaffolding from the boot log + mark --dev deprecated
2a7395f7 feat(P1-bootstrap CLI): command-line flags as policy (v1)
1bd01d66 feat(P1-bootstrap): WebUI window — browser fallback chain + loud diagnostics
46d18b86 docs: editor screenshot for the README (docs/media/editor.png)

---

Русский

Нативная библиотека WebUI вшита в бинарник — сеть при запуске не требуется,
редактор работает офлайн.

Патч-релиз «запускаемость». 0.2.1 поменял не косметику, а сам факт запуска:
редактор теперь стартует там, где раньше отказывался, и объясняет, если не может.

Запуск и диагностика

• Выбор браузера окна (bootstrap). dev — принудительно Chrome; релиз — цепочка
  фолбэков Edge → Chrome → Firefox → любой доступный. Нет Chrome (старый ноутбук,
  чужая машина) — окно всё равно открывается.
• Громкий отказ, а не глухое молчание. Если окно открыть не удалось — в лог и
  консоль идёт перечень кандидатов, результат по каждому и рекомендация; процесс
  завершается с кодом 1, а не висит.
• CLI-флаги (--help показывает и выход): --debug (консоль видна, лог уровня
  debug, DevTools), --browser edge|chrome|firefox|any (ручной оверрайд цепочки),
  --log-level error|warn|info|debug. Неизвестный флаг — громкий отказ с подсказкой
  («--debag — возможно, вы имели в виду --debug?»), а не запуск в непонятном
  режиме. --dev — устаревший синоним --debug.
• Чистый boot-лог. Убраны строительные леса (голые print и самотест логгера);
  реальный режим и активные флаги — первой строкой. Ошибки больше не превращаются в
  {} — логгер разворачивает их в текст.

Офлайн и самодостаточность

• WebUI вшит внутрь бинарника. Раньше редактор при КАЖДОМ старте ходил на
  github.com за нативной библиотекой окна (и висел вечно без сети). Теперь либа
  вшита, резолв шимится локально: скачал архив — работает офлайн, навсегда. В логе
  при старте — строка [WEBUI] нативная библиотека вшита … — офлайн.
• Манифест зависимостей (vendor/webui/MANIFEST.md): точная версия и SHA-256
  вшитой либы.

Платформы

• Linux x64 — второй таргет (NuaelEditor-v0.2.1-linux64.tar.gz), тот же
  контракт запуска и фолбэков.

Артефакт

• NuaelEditor-v0.2.1-win64.zip → NuaelEditor.exe (Windows x64), ≈ 108 МиБ (exe).
• NuaelEditor-v0.2.1-linux64.tar.gz → NuaelEditor (Linux x64).
• SHA-256 (exe): 3eca341dc140829f455374cfe7c6863894be79489592080553f067a6766cf036

Хоткеи

Редактор: Ctrl+Z / Ctrl+Y — undo/redo; Delete — удалить сущность (в панели ассетов — ассет, с impact-диалогом); Ctrl+S — сохранить проект; Ctrl+Shift+S — сохранить сцену как; Ctrl+N — новый проект; Ctrl+O — открыть проект; Ctrl+Shift+Space — сниппеты.

Окно движка (edit): Ctrl+Z / Ctrl+Y; Ctrl+D — дублировать сущность; Ctrl+Shift+A — новая сущность; Delete — удалить; G — глобально/локально; PageUp / PageDown — Z-порядок.

Известные ограничения (в пострелизный пакет)

• Порядок строк bootstrap-лога и таймаут «последней надежды» (AnyBrowser) — косметика/UX.
• Протокол shutdown не различает «воркер занят» и «не поднялся» (пауза ~5 с при отказе окна).
• Безголовый linux (нет X11/Wayland) — ожидается громкий отказ; проверка впереди.

---

Made by Tvortsa. Pre-alpha — we're just getting started.

Nuael Engine v0.2.0 — Pre-alpha

RELEASE_NOTES_v0.2.0.md

Nuael Engine v0.1.0 — Pre-alpha

Pre-alpha. First public build of Nuael Engine — a 2D game engine on the Deno/JS stack.

Downloads

File	What it is
NuaelEditor-v0.1.0-win64.zip	The editor (Windows 10/11, 64-bit)
Demo-SpaceShooter-win64.zip	Demo 1 — full game: splash → lobby → levels → win/lose
Demo-ZmlNpc-win64.zip	Demo 2 — NPCs trained locally with zml ML

Quick start

1. Unpack a zip and run the .exe.
2. Windows may show a SmartScreen warning (unsigned app) — click More info → Run anyway.
3. Something broken? Run NuaelEditor.exe --dev and share the console output + logs/nuael.log.

Highlights

• One-button build: game project → single native exe
• Prototypes (stamps): design once, stamp everywhere, propagate changes
• zml: train tiny NPC brains locally, no Python

All pre-alpha versions are free forever (see LICENSE).