Repository navigation
Releases
v0.51.0-pre.alpha — editable models and Source export fixes
Development pre-release of wavelength's accumulated editor and model-authoring work.
The core Source 1 workflow supports importing or creating editable model assets, shared and unique variants, attachment/detachment, source-part management, pivot editing, collision snapshots, named revisions, and profile-aware publishing with owned materials and portable editable packages.
This release also includes the accumulated terrain, profile, surface-editing, Source-to-CS2 conversion, native export-inclusion and build/deployment changes recorded in the handbook feature ledger.
A captured HL2 server stack overflow was traced to the test fixture's legacy scalar angle key. Source exports now write vector angles automatically. A rebuilt map with its packed blue model and material was observed running in HL2.
Verification passed 271 unit tests, documentation and feature-inventory checks, native patch reconstruction, and an isolated packaged Windows install/status/repair/uninstall cycle. Uninstall restored the original executable byte-for-byte.
The Windows installer supports the exact Blender 5.2.3 LTS Release Candidate build 32ede9dba158, with original executable SHA-256 19e60200c51e981aa48a515ffc22c46d9192ea0538e249b2891394a425bd855b. It includes a private Python runtime, editable source, the add-on and a checksum-bound native patch.
Extract the Windows installer ZIP, close Blender, and run the following from its extracted folder.
.\wavelength-installer.cmd install --force --require-native --blender "C:/path/to/blender.exe" --yesThe source ZIP bootstraps its pinned Python runtime. The add-on ZIP is provided for environments with the compatible native build already installed. Updated HTML and PDF handbooks accompany the release. SHA256SUMS lists the download hashes.
Physics, animation, doors and broader GMod runtime acceptance remain incomplete. Procedural-material baking, full LOD/socket authoring and the publishing dialog for native browser drops remain open work. Collision preview is a manually refreshed snapshot and still needs visual acceptance. Source 2 and other transfer adapters retain their documented limitations. Linux native compatibility is historical and was not revalidated for this release.
wavelength v0.50.0-pre.alpha — Source 2 maps and CS2 materials
Source 2 map and material IO
- Import editable text and binary VMAP polygon meshes, preserving transforms, UVs and per-face material assignments.
- Export editable CS2 VMAP geometry with native VMAT references, or generated VMAT/PNG sidecars for Blender materials.
- Browse installed CS2 materials with background thumbnails and cached compiled-texture decoding.
- File → Import/Export → wavelength IO opens Blender's file browser directly with a format selector. The CS2 profile defaults to VMAP.
- Godot 4 GLB mesh/texture export remains available.
This release also collects the authoring milestones since v0.19.1: inherited custom profiles, context controls, Geometry Nodes generation, pencil clipping, CSG, visual geometry diagnostics, terrain tooling, entity/model workflows and the Markdown/HTML/PDF handbook. Some terrain and model workflows remain experimental; consult the included TODO and release notes.
Downloads and installation
Windows installer: download wavelength-v0.50.0-pre.alpha-windows-x86_64.zip, extract it, close Blender, and run:
.\wavelength-installer.cmd install --force --require-native --blender "C:\path\to\blender.exe" --yesThe native Windows patch is checksum-bound to Blender 5.2.3 LTS Release Candidate, commit 32ede9dba158. Other Blender binaries are not interchangeable. This is a Windows-tested release; no newly verified Linux native build is claimed.
The source archive omits the bundled Python runtime and bootstraps the pinned runtime when launched. The addon-only archive does not install the required native Blender patch. Standalone handbook PDF and HTML downloads are included. Verify downloads against SHA256SUMS.
CS2 scope and dependencies
Configure the CS2 game/csgo and game/bin/win64 paths. Binary VMAP input and version-compatible map metadata use the installed CS2 DMX tools/editor scaffold. Compiled material decoding requires the separately installed Source 2 Viewer CLI; put it and its companion DLLs in %LOCALAPPDATA%/wavelength/tools/source2viewer/ or set WAVELENGTH_SOURCE2_VIEWER to the executable path. It is not bundled in these downloads.
Source 2 IO covers editable map meshes and materials. Entities, placed model instances, prefabs, compiled-map decompilation and subdivided surfaces are outside this implementation. Specialized/layered CS2 shaders are approximated in Blender, while their original native VMAT references are preserved for engine rendering. Custom Blender shader conversion currently exports base color and scalar roughness.
Verification
- 226 automated tests passed.
- Imported a shipped CS2 binary VMAP and verified mesh/material/transform/UV round trips through Valve's binary DMX converter.
- Generated a CS2 map that compiled and packed successfully: 14 resources compiled, 0 failed.
- Verified CS2 compiled VMAT/VTEX decoding, saved material thumbnails and custom VMAT/PNG re-import.
- Verified native file-browser format controls, CS2 Asset Browser, normal Blender startup, and HTML/PDF handbook generation.
Game maps, materials, textures, model caches, credentials and private local profile settings are not included.
Wavelength v0.19.1-pre.alpha - Garrys Mod Windows profile
Wavelength v0.19.1-pre.alpha
Adds a dedicated Garry's Mod Windows engine profile with Steam App ID 4000, automatic game/texture discovery, 64-bit VBSP/VVIS/VRAD compiler defaults, and garrysmod.fgd entity definitions.
Select the Garry's Mod Windows engine when creating a profile, then refresh Source defaults to detect your Steam installation. Game files and personal profiles are not distributed.
Validated with 154 automated tests and the installed Blender addon: all three GMod compilers start, 564 entity definitions load, and 5,516 supported texture previews are cached from 6,016 indexed materials; 500 unsupported materials are skipped. Warm cache reuse was verified.
Downloads:
- windows-x86_64.zip: full installer with private Python runtime and native patch.
- windows-x86_64-source.zip: source/bootstrap installer.
- wavelength-addon-*.zip: Python addon only.
- SHA256SUMS: asset checksums.
The unchanged native patch targets only Blender 5.2.3 LTS Release Candidate 32ede9dba158. Close Blender before installing. Extract the full installer and run:
.\wavelength-installer.cmd install --force --require-native --blender "C:\path\to\blender.exe" --yesFor portable installation add --addons "C:\path\to\5.2\scripts\addons_core".
Wavelength v0.19.0-pre.alpha - Windows authoring and interactive sun
Wavelength v0.19.0-pre.alpha
What changed
- Blender-native workflow: map/build settings in Scene Properties, entities and assemblies in Object Properties, contextual geometry/face actions, compact profile/grid/build controls.
- External texture libraries generated by a separate worker. Browsing the full game catalog does not create thousands of materials in the map. Saved previews are reused between sessions.
- Debounced texture search; corrected drag-and-drop shader/UV setup on brushes and ordinary meshes; editable imports and linked-placeholder repair.
- Windows Steam discovery through configured paths and the registry, without PATH edits.
- Interactive sun: real Blender Sun lights, draggable heading/elevation rings, live shadows, synchronized engine metadata, and excluded preview lights.
Downloads
- windows-x86_64.zip: full Windows installer with private Python runtime, editable source and matching native patch.
- windows-x86_64-source.zip: source and bootstrap installer, without the private runtime.
- wavelength-addon-*.zip: Python add-on only; use the full installer when native grid support is needed.
- SHA256SUMS: checksums for all supplied assets.
The Windows native patch is unchanged from v0.16.2 and targets only Blender 5.2.3 LTS Release Candidate 32ede9dba158 (original executable SHA-256 19e60200c51e981aa48a515ffc22c46d9192ea0538e249b2891394a425bd855b). Other executables require a matching patch. Linux compatibility remains historical; no new Linux installer is included.
Close Blender, extract the full Windows installer, and run:
.\wavelength-installer.cmd install --force --require-native --blender "C:\path\to\blender.exe" --yesFor portable installation add --addons "C:\path\to\5.2\scripts\addons_core".
Validation
152 automated tests; real Blender checks for native external-library browsing, all 6,519 supported HL2 previews, warm-cache reuse, no map-material growth while browsing, material drop shader/UV correctness, debounced search, Steam command construction, sun direction/color/export synchronization, viewport shadows and add-on reload.
The first HL2 cache build took about 74 seconds in a separate worker; subsequent source validation took about 2.2 seconds. 366 unsupported materials are reported as skipped. Game assets, personal profiles and local caches are not included. Sun preview brightness is an editor approximation, not a replacement for compiler-baked lighting.
v0.16.2-pre.alpha — tested Windows native grid
v0.16.2-pre.alpha — tested Windows native-grid installer
Builds and installs Wavelength's native grid for the exact Blender 5.2.3 LTS Release Candidate Windows x64 build 32ede9dba158 (original executable SHA-256 19e60200c51e981aa48a515ffc22c46d9192ea0538e249b2891394a425bd855b). Other Blender executables require their own matching patch.
- Compiles the native Blender renderer with MSVC and reuses the candidate's existing oneAPI AOT kernel DLL, fixing the earlier missing JIT DLL startup failure.
- Fixes Windows installer file flushing and loose Source material path enumeration.
- Includes the Python add-on, editable source, native binary patch, and pinned private Python runtime. No separate Blender runtime is distributed.
- Verified native RNA startup, real OpenGL grid rendering on AMD Radeon(TM) Graphics, yellow parent lines, grey subdivisions, orthographic/perspective occlusion, workspace restoration, installed add-on loading, and brush creation.
- Verified a real install/uninstall/reinstall cycle; uninstall restored the original executable byte-for-byte. Original backups and receipts are retained by the installer.
Close Blender, extract the Windows installer ZIP, and run:
.\wavelength-installer.cmd install --force --require-native --blender "C:\path\to\blender.exe" --yesTo keep the add-on inside that Blender folder, additionally pass --addons "C:\path\to\5.2\scripts\addons_core". Otherwise the installer uses Blender's normal user add-on directory. Enable Wavelength in Preferences and enter its workspace.
The previous Windows 5.2.2 preview remains available in historical releases; this release does not certify or repair that build. Linux retains its existing source and compatibility entry; no newly tested Linux installer or Vulkan certification is claimed here.
Validation: all 147 Windows automated tests passed.
v0.16.1-pre.alpha — authoring and diagnostics
v0.16.1-pre.alpha — current authoring tools and Blender diagnostics
- Incorporates v0.16.0 authoring updates: brush creation, editable primitives,
asset and entity browsing, texture handling, and transform synchronization. - Blender Diagnostics includes persistent rotating logs and View, Copy, Clear,
and Export controls with error references and tracebacks. - Updates the Linux native grid's parent-line color and opacity from v0.16.0.
- Corrects the Linux patch download URL to match its updated checksum.
- Synchronizes shared source and the Windows launcher into the private Pro tree.
Linux x86_64 installer and add-on/source downloads are supplied. This release
does not rebuild Blender. The Windows v0.15 preview has a reported missing
cycles_kernel_oneapi_jit.dll failure during startup verification and remains
blocked; no new Windows installer is supplied. The Windows installer executable
fingerprint also differs from the supported ZIP fingerprint. Do not bypass checks.
Earlier validation claims below describe their respective historical releases.
v0.15.0-pre.alpha — Windows native-grid patch preview (historical)
The Windows package now includes a native Blender grid binary patch, not just the
standalone grid-math helper. It bundles Windows Python and installs through
wavelength-installer.cmd. Linux retains the tested v0.14 native patch.
Windows is published for manual verification: the C++ code is compiled and
binary patch reconstruction is checked, but Windows installation, injection, and
rendering have not been tested. No Wine/Proton or Windows Blender runtime tests
were run by the maintainer.
Windows x86_64
Target: official Blender 5.2.2 Windows x64 ZIP executable, with the exact hash
recorded in patches/native/manifest.json. Close Blender, extract the Windows
installer ZIP, and run PowerShell in the extracted folder:
.\wavelength-installer.cmd install --force --blender "C:\path\to\blender.exe" --yesUse an Administrator terminal for a Program Files target, or install into a writable
portable Blender folder. Reopen the same executable, enable Wavelength, and enter
its workspace. Follow the Windows verification guide and report errors.
.\wavelength-installer.cmd status
.\wavelength-installer.cmd repair --force --yes
.\wavelength-installer.cmd uninstall --yesLinux x86_64
./wavelength-installer install --force --blender /home/moe/Applications/blender-5.2.2-linux-x64/blender --yesThe Linux native payload is unchanged from v0.14.0, where real install, repair,
byte-exact uninstall, native grid spacing, occlusion, and workspace restoration passed.
Installation behavior
Both packages contain source, a private platform-specific Python runtime, and native
binary differences. No replacement Blender distribution, system Python, or compiler
is required. The installer checks input/output hashes and probes native API startup
before committing installation. It retains the original executable for rollback and
uninstall. --force does not bypass binary matching or the startup check.
Only listed executable fingerprints are supported. Other Blender versions, modified
executables, ARM64, and macOS need separate patches. The read-only diagnose command
now recognizes native patch fingerprints on both platforms.
v0.15.0-pre.alpha — Windows native patch preview
v0.15.0-pre.alpha — Windows native-grid patch preview
The Windows package now includes a native Blender grid binary patch, not just the
standalone grid-math helper. It bundles Windows Python and installs through
wavelength-installer.cmd. Linux retains the tested v0.14 native patch.
Windows is published for manual verification: the C++ code is compiled and
binary patch reconstruction is checked, but Windows installation, injection, and
rendering have not been tested. No Wine/Proton or Windows Blender runtime tests
were run by the maintainer.
Windows x86_64
Target: official Blender 5.2.2 Windows x64 ZIP executable, with the exact hash
recorded in patches/native/manifest.json. Close Blender, extract the Windows
installer ZIP, and run PowerShell in the extracted folder:
.\wavelength-installer.cmd install --force --blender "C:\path\to\blender.exe" --yesUse an Administrator terminal for a Program Files target, or install into a writable
portable Blender folder. Reopen the same executable, enable Wavelength, and enter
its workspace. Follow the Windows verification guide and report errors.
.\wavelength-installer.cmd status
.\wavelength-installer.cmd repair --force --yes
.\wavelength-installer.cmd uninstall --yesLinux x86_64
./wavelength-installer install --force --blender /home/moe/Applications/blender-5.2.2-linux-x64/blender --yesThe Linux native payload is unchanged from v0.14.0, where real install, repair,
byte-exact uninstall, native grid spacing, occlusion, and workspace restoration passed.
Installation behavior
Both packages contain source, a private platform-specific Python runtime, and native
binary differences. No replacement Blender distribution, system Python, or compiler
is required. The installer checks input/output hashes and probes native API startup
before committing installation. It retains the original executable for rollback and
uninstall. --force does not bypass binary matching or the startup check.
Only listed executable fingerprints are supported. Other Blender versions, modified
executables, ARM64, and macOS need separate patches. The read-only diagnose command
now recognizes native patch fingerprints on both platforms.
v0.14.0-pre.alpha — Linux native patch
v0.14.0-pre.alpha — installable Linux native-grid patch
The installer now applies a checksum-bound binary patch to the selected Blender
executable and installs the Python add-on in one transaction. Users keep launching
their existing Blender. This release does not distribute a Blender runtime.
Install on Linux x86_64
Close Blender, extract the Linux installer archive, open a terminal in that folder:
./wavelength-installer install --force --blender /home/moe/Applications/blender-5.2.2-linux-x64/blender --yesThen launch that same Blender executable. Enable Wavelength in Preferences →
Add-ons if needed, and use the Wavelength workspace. [ / ] adjust grid spacing.
Yellow lines are the selected parent spacing; grey lines are its subdivisions.
Leaving Wavelength restores Blender's regular grid.
./wavelength-installer status
./wavelength-installer repair --force --yes
./wavelength-installer uninstall --yesThe original executable and previous add-on are backed up. Uninstall restores them;
external modifications are protected. --force permits experimental installation
and reconciles previous installer state, but never bypasses patch checksums or the
native startup check. Unsupported binaries fail before installing the add-on.
Scope
This release targets the exact Linux Blender 5.2.2 executable identified in
patches/native/manifest.json. This initial payload is experimental and built for
the tested Linux host; other distributions may fail its startup compatibility check.
Windows installer groundwork and cross-compilation tooling are included as source.
Windows native-grid injection is not provided or claimed as working in this Linux milestone.
The archive contains the source tree, the native binary difference, and a pinned
private Python runtime. A source-only checkout downloads the same checksum-pinned
patch on demand. Internal Blender builds are development tools only.
v0.13.0-pre.alpha
v0.13.0-pre.alpha — native grid renderer
- Moves grid drawing into Blender’s native C++/shader grid pass. Python supplies
per-viewport state and the text label; it no longer draws grid geometry. - Preserves world-aligned yellow parent intervals, grey profile subdivisions,
meter-based neutral mode, adjustable spacing, and[/]shortcuts. - Restores Blender’s original grid on workspace exit. Old files receive valid
dormant defaults; saving does not leave wavelength rendering enabled without
the add-on. - Adds a separate Linux Blender package with
Launch-wavelength, the matching
add-on, source patch, and a corresponding Blender source archive. Your regular
Blender installation is not replaced by this launcher. - New installer bundles verify the actual native API and do not apply the old
shader-color patch.--forcestill permits Python-only installation on an
unsupported host, with an explicit missing-grid message. - Verified 137 automated tests; real OpenGL and Vulkan pixel/depth tests; UI
shortcuts, saving and workspace checks; and real-runtime install/repair/remove.
Use: extract wavelength-native-v0.13.0-pre.alpha-linux-x86_64.tar.gz and run
Launch-wavelength. Open wavelength → Grid & Units. The ordinary add-on ZIP
alone cannot provide the new renderer.
Preview limits: built on Debian sid (glibc 2.43 / GCC 16.2), Linux x86-64-v2.
Older systems may need a source build. Cycles CPU is included; CUDA/HIP/oneAPI/
OptiX device backends are disabled in this preview. See
native validation.
v0.12.1-pre.alpha — profile grid and shortcuts
- wavelength owns both parent lines and grey subdivisions in its workspace. Engine profiles default to eight subdivisions; Blender/metric mode defaults to a one-meter parent interval and ten subdivisions. The subdivision count is configurable and saved with profiles/projects.
[halves and]doubles grid spacing. Engine spacing retains its 1–256 unit range; metric spacing uses meters. Shortcuts are workspace-scoped.- Native grid plane visibility is restored when leaving the workspace, disabling the grid/add-on, or saving/loading files. Blender axis colors remain intact.
- Added the nine-milestone / 101-package roadmap status document.
- Validation: 133 unit tests passed; Blender 5.2.2 UI checks covered rendering, spacing, bounds, shortcut bindings, workspace restoration and cleanup.
- Existing experimental native shader patches can still tint Blender's own grid. The development host was structurally reverted to pristine shaders, with a backup, and visually checked. That local executable change is not part of the add-on download. The optional legacy native coloring patch should not be reapplied for this workspace grid.
v0.12.0-pre.alpha — installer lifecycle
- Replacement is the default for an existing install; versions can be upgraded, downgraded or reinstalled while retaining the original backup chain. Interactive installs offer replace, side-by-side or cancel.
- Side-by-side instances have separate add-ons, receipts and Blender executable copies. Only one wavelength add-on should be enabled in Blender at a time. A copy that cannot be created requires
--forcefor Python-only fallback;--require-nativestill fails. uninstall(removealias) now removes adopted native shader patches too. Exact original bytes are restored from an intact original backup; adopted patches are structurally reverted to pristine shader behavior, without claiming byte identity.repairrestores add-on files with edit backups, repairs recognized native states, and rolls back interrupted transactions. Unknown external binary replacements or corrupt receipts require--force; corrupt receipts also require explicit target paths.- Managed runtimes with intact full inventories are removed. User backups/stale archives are preserved outside the removed instance. Unknown or changed runtimes are retained and reported.
- Validation: 129 automated tests passed. New native lifecycle checks use synthetic ELF fixtures with startup probes mocked; this release does not certify compatibility with any real Blender build. Both deliberate mutations (skipping replacement and skipping structural revert) were caught by the new tests.
v0.11.3-pre.alpha — playable HL2 validation milestone
- Adds a sealed, textured Source room with editable stairs, arch and 80-face sphere, plus an opt-in Blender build regression.
- Rejects renamed BSPs whose embedded default cubemaps still refer to a different map name. Rebuild instead of renaming the compiled file.
- Source build filenames now follow the same lowercase rule as launching.
- Verified real Blender export and VBSP/VVIS/VRAD compilation, followed by visible HL2 gameplay and client sign-on. Local .blend, BSP and screenshot are in maps/hl2-playable outside the source repository.
- Automated movement/collision verification, Build & Play, and launch monitoring were stopped at the user's request and are not included. The legacy custom-map failure's full cause is not established; freshly rebuilt test geometry loads successfully.
v0.11.2-pre.alpha — installer force mode
install --forcenow installs Python even when native preparation or writing fails.--require-nativerestores strict rollback.- Structural shader classification recognizes current and known legacy patches, including shared shader strings. Existing patches are adopted without rewriting.
- Reinstalls retain original backups; stale state is archived. Healthy recovery is a no-op. Removal preserves adopted patches and external edits.
- Added local discovery, read-only
diagnose, verbose summaries, and a lightweight source ZIP with the same installer launcher. - Verified isolated install/reinstall/removal and startup on the actual already-patched Blender 5.2.2; binary unchanged. This does not certify native rendering or fresh AppImage patching.
v0.11.0-pre.alpha
Adds a dedicated persistent Wavelength workspace, independent world-aligned map-unit highlights preserving Blender's native grid, scoped toggles, transactional engine-grid object movement and move gizmos. Stops registering the old settle-time transform correction timer.
Adds native Asset Browser publishing for game materials, entity templates and labelled model/sound/effect proxies; user profile CRUD/import/export in user configuration; persistent editable stairs, arches and 20/80-face convex spheres; independent private Pro source synchronization with drift checks. See MILESTONES-1-2.md for usage, validation and explicit limits.
v0.10.33-pre.alpha
Fix Source compiler argument defaults when switching engine profiles. Empty values saved by earlier versions also recover as empty argument lists. Retains the v0.10.32 gallery, scrollbar, grid-setting restoration, and consistent Source map filenames. Custom HL2 map gameplay remains unverified and unresolved.
0.10.32-pre.alpha
- Source materials use the shared thumbnail gallery; gallery rows and native scrollbar now share the same height (applies to WAD browsing too).
- Reapply engine grid units/subdivisions after loading scenes and creating viewports, correcting stale saved settings in the experimental shader path.
- Discover HL2's combined game directory; migrate launch directory for older profiles. Explicit singleplayer mode for Tools++ VBSP.
- Preserve the final Source map basename throughout compilation and launching so embedded asset paths are not renamed out from under the BSP.
- Source runtime investigation remains unresolved: stock map reached gameplay, custom-map tests exited before the gameplay marker. Do not interpret a successful compile or Spawn Server as a successful load.
- Preserve Source compiler arguments in saved project files.
0.10.31-pre.alpha
- Source-tree distribution doubles as the installer; release archive includes private Python, source checkouts bootstrap the same pinned runtime.
- Explicit experimental/force mode bypasses the verified whole-file allowlist while retaining structural shader fingerprints, exact byte/hash validation, startup checks, backups and recovery.
- Experimental AppImage deployment extracts and patches the payload, installs a reversible launcher, and records prototype limitations in receipts. C++ per-view renderer bridge remains unfinished.
- HL2 VPK/VMT/VTF texture previews and searchable material names, real texture dimensions, entity output editing, side-reference remapping and Tools++ compiler support.
- Real installed-game Blender workflow and native BSP/VIS/RAD compilation tested; Steam HL2 spawned the generated map.
- Repairs the missing live-texture state helper; verified projection follows brush movement.
- Full Source 1/Hammer parity is not complete: see SOURCE1.md for remaining displacement/model/instance and advanced rendering work.
0.10.30-pre.alpha
- Native grid experiment highlights only the exact selected spacing; other levels retain native gray/emphasis colors.
- Adds HL2 Source 1 Linux/Windows profiles, VMF brush/entity import/export, Source material-name assignment and VBSP/VVIS/VRAD build orchestration.
- Adds BSP20 header/lump validation and Steam App ID 220 launch configuration.
- Tested format round-trips and Blender integration, including fake-compiler orchestration. Real HL2 compilation/runtime validation remains pending installed SDK tools.
- VTF/VPK previews, displacements and a full Source I/O editor are not implemented.
0.10.29-pre.alpha
- Adds an exact-build native shader experiment and interactive Wavelength grid demo.
- Yellow snap-interval lines rendered in a copied Blender; step changes and top/front/right/perspective capture scripts available.
- Original Blender untouched; generated recipe deliberately unverified. Production native installer support and C++ state bridge remain unfinished.
0.10.28-pre.alpha
- Bundled CPython Linux insta...
v0.12.1-pre.alpha
v0.12.1-pre.alpha — profile grid and shortcuts
- wavelength owns both parent lines and grey subdivisions in its workspace. Engine profiles default to eight subdivisions; Blender/metric mode defaults to a one-meter parent interval and ten subdivisions. The subdivision count is configurable and saved with profiles/projects.
[halves and]doubles grid spacing. Engine spacing retains its 1–256 unit range; metric spacing uses meters. Shortcuts are workspace-scoped.- Native grid plane visibility is restored when leaving the workspace, disabling the grid/add-on, or saving/loading files. Blender axis colors remain intact.
- Added the nine-milestone / 101-package roadmap status document.
- Validation: 133 unit tests passed; Blender 5.2.2 UI checks covered rendering, spacing, bounds, shortcut bindings, workspace restoration and cleanup.
- Existing experimental native shader patches can still tint Blender's own grid. The development host was structurally reverted to pristine shaders, with a backup, and visually checked. That local executable change is not part of the add-on download. The optional legacy native coloring patch should not be reapplied for this workspace grid.
v0.12.0-pre.alpha — installer lifecycle
- Replacement is the default for an existing install; versions can be upgraded, downgraded or reinstalled while retaining the original backup chain. Interactive installs offer replace, side-by-side or cancel.
- Side-by-side instances have separate add-ons, receipts and Blender executable copies. Only one wavelength add-on should be enabled in Blender at a time. A copy that cannot be created requires
--forcefor Python-only fallback;--require-nativestill fails. uninstall(removealias) now removes adopted native shader patches too. Exact original bytes are restored from an intact original backup; adopted patches are structurally reverted to pristine shader behavior, without claiming byte identity.repairrestores add-on files with edit backups, repairs recognized native states, and rolls back interrupted transactions. Unknown external binary replacements or corrupt receipts require--force; corrupt receipts also require explicit target paths.- Managed runtimes with intact full inventories are removed. User backups/stale archives are preserved outside the removed instance. Unknown or changed runtimes are retained and reported.
- Validation: 129 automated tests passed. New native lifecycle checks use synthetic ELF fixtures with startup probes mocked; this release does not certify compatibility with any real Blender build. Both deliberate mutations (skipping replacement and skipping structural revert) were caught by the new tests.
v0.11.3-pre.alpha — playable HL2 validation milestone
- Adds a sealed, textured Source room with editable stairs, arch and 80-face sphere, plus an opt-in Blender build regression.
- Rejects renamed BSPs whose embedded default cubemaps still refer to a different map name. Rebuild instead of renaming the compiled file.
- Source build filenames now follow the same lowercase rule as launching.
- Verified real Blender export and VBSP/VVIS/VRAD compilation, followed by visible HL2 gameplay and client sign-on. Local .blend, BSP and screenshot are in maps/hl2-playable outside the source repository.
- Automated movement/collision verification, Build & Play, and launch monitoring were stopped at the user's request and are not included. The legacy custom-map failure's full cause is not established; freshly rebuilt test geometry loads successfully.
v0.11.2-pre.alpha — installer force mode
install --forcenow installs Python even when native preparation or writing fails.--require-nativerestores strict rollback.- Structural shader classification recognizes current and known legacy patches, including shared shader strings. Existing patches are adopted without rewriting.
- Reinstalls retain original backups; stale state is archived. Healthy recovery is a no-op. Removal preserves adopted patches and external edits.
- Added local discovery, read-only
diagnose, verbose summaries, and a lightweight source ZIP with the same installer launcher. - Verified isolated install/reinstall/removal and startup on the actual already-patched Blender 5.2.2; binary unchanged. This does not certify native rendering or fresh AppImage patching.
v0.11.0-pre.alpha
Adds a dedicated persistent Wavelength workspace, independent world-aligned map-unit highlights preserving Blender's native grid, scoped toggles, transactional engine-grid object movement and move gizmos. Stops registering the old settle-time transform correction timer.
Adds native Asset Browser publishing for game materials, entity templates and labelled model/sound/effect proxies; user profile CRUD/import/export in user configuration; persistent editable stairs, arches and 20/80-face convex spheres; independent private Pro source synchronization with drift checks. See MILESTONES-1-2.md for usage, validation and explicit limits.
v0.10.33-pre.alpha
Fix Source compiler argument defaults when switching engine profiles. Empty values saved by earlier versions also recover as empty argument lists. Retains the v0.10.32 gallery, scrollbar, grid-setting restoration, and consistent Source map filenames. Custom HL2 map gameplay remains unverified and unresolved.
0.10.32-pre.alpha
- Source materials use the shared thumbnail gallery; gallery rows and native scrollbar now share the same height (applies to WAD browsing too).
- Reapply engine grid units/subdivisions after loading scenes and creating viewports, correcting stale saved settings in the experimental shader path.
- Discover HL2's combined game directory; migrate launch directory for older profiles. Explicit singleplayer mode for Tools++ VBSP.
- Preserve the final Source map basename throughout compilation and launching so embedded asset paths are not renamed out from under the BSP.
- Source runtime investigation remains unresolved: stock map reached gameplay, custom-map tests exited before the gameplay marker. Do not interpret a successful compile or Spawn Server as a successful load.
- Preserve Source compiler arguments in saved project files.
0.10.31-pre.alpha
- Source-tree distribution doubles as the installer; release archive includes private Python, source checkouts bootstrap the same pinned runtime.
- Explicit experimental/force mode bypasses the verified whole-file allowlist while retaining structural shader fingerprints, exact byte/hash validation, startup checks, backups and recovery.
- Experimental AppImage deployment extracts and patches the payload, installs a reversible launcher, and records prototype limitations in receipts. C++ per-view renderer bridge remains unfinished.
- HL2 VPK/VMT/VTF texture previews and searchable material names, real texture dimensions, entity output editing, side-reference remapping and Tools++ compiler support.
- Real installed-game Blender workflow and native BSP/VIS/RAD compilation tested; Steam HL2 spawned the generated map.
- Repairs the missing live-texture state helper; verified projection follows brush movement.
- Full Source 1/Hammer parity is not complete: see SOURCE1.md for remaining displacement/model/instance and advanced rendering work.
0.10.30-pre.alpha
- Native grid experiment highlights only the exact selected spacing; other levels retain native gray/emphasis colors.
- Adds HL2 Source 1 Linux/Windows profiles, VMF brush/entity import/export, Source material-name assignment and VBSP/VVIS/VRAD build orchestration.
- Adds BSP20 header/lump validation and Steam App ID 220 launch configuration.
- Tested format round-trips and Blender integration, including fake-compiler orchestration. Real HL2 compilation/runtime validation remains pending installed SDK tools.
- VTF/VPK previews, displacements and a full Source I/O editor are not implemented.
0.10.29-pre.alpha
- Adds an exact-build native shader experiment and interactive Wavelength grid demo.
- Yellow snap-interval lines rendered in a copied Blender; step changes and top/front/right/perspective capture scripts available.
- Original Blender untouched; generated recipe deliberately unverified. Production native installer support and C++ state bridge remain unfinished.
0.10.28-pre.alpha
- Bundled CPython Linux installer builder, isolated launcher and terminal menu.
- Paired native/Python install, remove and recovery with receipts, exact hashes and original backups.
- Transaction tests cover failures, pre-existing add-ons, user edits and external Blender updates.
- Native renderer patch and AppImage deployment backend remain unavailable; real installations refuse before modifying either component.
0.10.27-pre.alpha
- Corrects an inherited ignore rule that excluded the Python
source/build/package from Git. - Release validation now requires all three build modules and refuses ignored Python source.
- Retains the first published tag unchanged; this is the complete source distribution.
0.10.26-pre.alpha
- Consolidates the latest 0.10.25 add-on edits and native installer workspace into one repository, retaining previous Git history and tags.
- Includes current native-grid/text indicator, GoldSrc profile/catalog, origin, texture caching, and UI source changes from the local working baseline.
- Adds validation, ZIP packaging, annotated tag/commit/atomic-push automation and GitHub Actions validation/artifact packaging.
- Identifies AppImage containers separately from renderer payloads.
- Pins official Blender 5.2.1 source and documents CPU/shader/RNA integration points and the missing native renderer bridge.
The C++ library is a grid-math prototype. No native renderer hook, supported binary patch, or AppImage host replacement is released in this version.