Repository navigation
Releases
Northlight 0.3.218.9 - Compact captures (Windows, macOS, Linux)
Reduce diagnostic capture size by storing repeated binary data once, without changing image precision or rendering behavior.
Changes
- New diagnostic sessions store unique payloads in
.capture-blobs/<sha256>; ordinary image, shader and constant filenames contain short checked references. Journals and metadata stay readable. - Preserve full before/after evidence, float precision, shader bytes and constant banks. Image dimensions and format are part of the content identity; row padding is excluded.
- Include
app/scripts/capture_files.pyin every platform package, plus a standalone download. It compacts older captures and restores ordinary files for existing analysis tools, checking blob sizes and SHA-256. Inputs are left unchanged. - Retain every change from .6, .7 and .8, including room-lighting preservation, M2 light-bank handling, local lamp shadow ownership and smooth shadow filtering.
Measured size and validation
| Supplied capture | Previous ZIP | Compact ZIP | Reduction |
|---|---|---|---|
| Wintergarde inn | 476.3 MB | 104.3 MB | 78.1% |
| Tower | 184.0 MB | 67.6 MB | 63.2% |
All 9,395 restored files match the original archives byte-for-byte. Final validation covers 18 source checks, 35 architecture checks, 3 GPU capture checks and 8 packaging checks in strict mode, plus verification of the actual three release archives. GPU export tests cover exact images/constants, device state, MSAA and failure paths.
Deduplication runs only during explicit capture; it adds capture-time hashing, with no new normal-frame pass or GPU buffer allocation. This is a storage reduction, not a claim of lower VRAM use or improved game FPS. macOS/Linux package contents are checked on Windows; native gameplay was not run on those systems.
The separate diagnostics log allow-list audit still rejects an existing AO/HDR fallback warning. The same test failure was reproduced on .8 and is recorded in the release manifest; it is not counted as passing coverage.
See format, roundtrip results and pipeline buffer audit.
Capture sharing and analysis
ZIP the entire session folder, including .capture-blobs. Individual .fgr, .bin or .f32 reference files are insufficient by themselves.
Restore a compact session folder or ZIP before using older analysis tools:
python capture_files.py unpack capture.zip new-analysis-directory
From an unpacked Windows release package, no separate Python installation is needed:
runtime\python.exe -I -B -X utf8 app\scripts\capture_files.py unpack capture.zip new-analysis-directory
On macOS/Linux, use runtime/bin/python3 -I -B -X utf8 app/scripts/capture_files.py unpack capture.zip new-analysis-directory. Replace unpack with pack to compact an older session or ZIP into a new ZIP.
Install or update
Close the target game, then use Install.cmd on Windows, Install Northlight.command on macOS, or install.sh on Linux. Each archive includes the matching DLL/resource pair, converted Forever atmosphere and capture utility.
For a manual update, replace both d3d9.dll and northlight-assets.bin. Linux/Wine requires WINEDLLOVERRIDES="d3d9=n,b". Checksums are in SHA256SUMS.txt.
Northlight 0.3.218.8 - Interior lighting and local lamp shadows (Windows, macOS, Linux)
Fix red room lighting and local lamps shining through WMO walls and floors in the supplied Wintergarde inn and tower captures.
Changes
- Preserve native room lighting on lit WMO receivers whose ambient/directional bank differs from the outdoor context. This covers the captured material variant missing from the stock shader catalog. M2 room objects use their own, reversed light-bank layout.
- Remove every matched selected lamp from supported depth-writing WMO material layers before adding the shadowed local-light contribution. Previously these blended layers fell back to a two-source correction, leaving other lamps unshadowed.
- Retain the changes from .6 stable, .6 interior preview and .7, including continuous contact/soft-shadow filtering. Unknown shaders and unsupported blend modes keep their existing fallback.
Validation and performance
The final commit passes 17 source checks, 34 architecture checks, 5 focused GPU checks and the receiver proof CPU regression. The source, architecture and GPU suites pass in strict mode without skips; the CPU regression runs directly with its Windows Zig compiler path. GitHub Source contracts CI also passes. GPU checks cover Windows D3D9, DXVK 2 and DXVK 3; exact captured WMO/M2 shader registration, four-lamp removal, SDR/HDR composition, and the .7 local-shadow continuity regression are included in the validation evidence.
Both captures were replayed on all three backends using their recorded buffers and cube maps. Paired component and 2560x1440 screen-pipeline timings were measured before committing. The material-enabled pipeline is approximately unchanged on D3D9 SDR and faster in the other measured cases. The no-material case adds up to 0.024 ms on D3D9, 0.006 ms on DXVK 2 and 0.009 ms on DXVK 3. The tested native WMO lamp handoff is faster than the old endpoint correction.
These are scoped GPU/CPU measurements, not gameplay FPS. The captures cannot reconstruct the full scene, and macOS/Linux gameplay was not run on this Windows host. All three archives pass package verification. See the capture findings and timing table and the attached release manifest for evidence and limits.
Install or update
Use the archive for your platform: Install.cmd on Windows, Install Northlight.command on macOS, or install.sh on Linux. Close the target game before installation. Each archive includes the matching DLL/resource pair and converted Forever atmosphere.
For a manual update, replace both d3d9.dll and northlight-assets.bin. Linux/Wine requires WINEDLLOVERRIDES="d3d9=n,b". Verify downloads with SHA256SUMS.txt.
Northlight 0.3.218.10 - Streaming memory, relief and interior lighting
Keep Northlight effects available during world streaming, restore interior fill and make material relief survive receiver marking and capture.
Changes
- Reduce x86 memory peaks: world/static shadow buffers and cutout textures use DEFAULT resources; neighboring regions share byte-identical immutable CPU texels needed by GI.
- Recover discarded upload data from the retained local BVH after Reset, keep the seven managed GI textures and resume static shadows only when world geometry is drawable.
- Restore POM/displacement admission for registered WMO shaders and Northlight receiver stencil tags. Complex WMO variants select a height representation supported by both native rendering and material capture.
- Preserve authored room illumination. GI brightness -100 no longer makes every resident probe appear fully occluded; GI corrections clamp before probe-residency blending, including at 240% strength.
- Retain smooth terrain normals, allow eligible nearby torch shadows and include the menu rendering, hue and edge fixes committed since .9.
Validation
18 source, 39 architecture, 9 graphics/state and 8 packaging checks pass in strict mode for the release commit. The three actual installer archives are verified, including their DLL/resource pair, pinned dependencies, launchers and converted atmosphere. Source CI passes on Ubuntu/Python 3.9 and Windows/Python 3.13.
The real Dalaran cache/worker stand passes at 4K/MSAA 8x: a replacement region shares 164.15 MiB of texels while the previous mesh remains drawable. Capture/repeated-Reset recovery also passes with 273 MiB of available x86 address space and all seven GI textures retained. These are correctness/resource checks, not gameplay FPS measurements. macOS/Linux archive contents were checked on Windows; gameplay on those systems was not run.
Install or update
Close the target client and run Install.cmd (Windows), Install Northlight.command (macOS) or install.sh (Linux). Personal settings are preserved.
For a manual update, replace both d3d9.dll and northlight-assets.bin. Checksums are in SHA256SUMS.txt. Compact captures still require the whole session folder, including .capture-blobs; the standalone capture_files.py utility is included.
Details: effect continuity and room fill, material relief, shadow memory and Reset.
Northlight 0.3.218.7 - Smooth local shadows (Windows, macOS, Linux)
Northlight 0.3.218.7
Fix coarse pixel steps on nearby local-light shadows, especially character silhouettes projected onto walls.
Changes
- Interpolate the four contact-shadow comparisons instead of averaging point samples with equal weights. Moving across a shadow texel no longer snaps between quarter-visibility levels.
- Grow the soft-shadow footprint continuously from the contact filter. Interpolated samples also cross cube-face edges and corners without introducing a hard seam.
- Keep the existing shadow-map resolution, caster selection, bias and emitter-size model. The directional and native-material shadow paths are unchanged by this fix.
- Include the preceding interior prelit-classification, GI continuity/coarse coverage, directional receiver and frame-snapshot corrections already on
main.
Validation
The new regression sweeps 432 cases per backend across six cube faces, both axes, cube centres/edges/corners, contact/wider penumbras and three resolutions. It compares contact coverage with an analytical result and retains the previous filter as a failing control. On the authored sweep, the largest adjacent visibility step falls from 0.5 to 0.00349.
Actual caster/receiver checks also cover hard and soft shadows, translated geometry, grazing planes and independent blockers: 648 cases per mode and backend, with no false shadowing on the clear samples. Device checks run on Windows system D3D9, DXVK 2.7.1 and DXVK 3.1.1. Source and packaging checks and production archive verification are recorded in release-manifest.json.
The production PCSS path also passes with actual Draenei lamp and weighted HumanMale geometry, three controlled poses and an independent box on all three backends. The broader city matrix is not a passing gate: its Stormwind street fixture reports zero box/character cube texels on both this build and the previous source snapshot, before receiver filtering. That pre-existing failure remains unresolved; no full-city validation is claimed.
The supplied Telredor video has no build ID or captured frame inputs; these checks reproduce the filtering defect rather than replaying that exact scene. Wider soft penumbras use more filtered comparisons, while contact filtering keeps its existing texture-read count. No game FPS improvement or new macOS/Linux gameplay validation is claimed.
Install or update
Download the archive for your platform and close the target game before installation. Use Install.cmd on Windows, Install Northlight.command on macOS, or install.sh on Linux. Each archive includes the matching DLL/resource pair and converted Forever atmosphere.
For a manual update, replace both d3d9.dll and northlight-assets.bin. Linux/Wine requires WINEDLLOVERRIDES="d3d9=n,b". Checksums are in SHA256SUMS.txt.
Northlight 0.3.218.6 - Material cache upload reuse (Windows, macOS, Linux)
Northlight 0.3.218.6
Reuse the material disk-cache upload surface across different map sizes, reducing repeated CPU/driver allocations while preserving exact pixels.
Changes
- Keep one staging surface large enough for previously uploaded maps. Smaller maps copy only their written rectangle; a size change no longer forces reallocation when the map fits.
- Retain the existing 512x512 / 1 MiB maximum. Memory pressure, reset, failed copies and nonblocking busy-resource fallback keep their existing behavior.
- Preserve map resolution, precision, mip generation, shader output and GPU cache budgets.
- Add a runtime cache inventory, including ownership, invalidation, shared geometry, persistent maps, GI, lighting, weather and remaining measured priorities.
Validation and performance
61 selected tests passed without skips: source, architecture, material cache and packaging. Additional disk-cache GPU scenarios passed across native D3D9, DXVK 2.7.1 and DXVK 3.1.1, covering separate-process restart, corrupt files, recipe changes, RGBA/DXT sources and mip levels. GitHub source CI passed on Windows and Ubuntu.
For 96 mixed-size uploads the frozen 0.3.218.5 uploader creates 96 staging surfaces; the new uploader creates one. Every compared output pixel matches the requested data. Initial ABBA CPU submission medians for those 96 uploads were 2.842 -> 0.625 ms on native D3D9, 15.238 -> 2.745 ms on DXVK 2.7.1 and 14.879 -> 2.770 ms on DXVK 3.1.1. Target creation and image readback are outside these timings. This is a component improvement, not a measured gameplay FPS gain; frames without disk-map uploads do not benefit from this particular change.
The Windows, macOS and Linux archives passed package verification. GPU checks ran on Windows; new macOS/WoWSilicon and Linux/Wine gameplay testing is not claimed.
Install or update
Download the archive for your platform. Each contains the matching DLL and resource bundle, converted Forever atmosphere, profiles, client-data generators and platform dependencies.
Close the target game before installation. Windows: Install.cmd; macOS: Install Northlight.command; Linux: install.sh. Existing user settings are preserved. Linux/Wine requires WINEDLLOVERRIDES="d3d9=n,b".
For manual updates replace both d3d9.dll and northlight-assets.bin. The atmosphere file is attached separately as well. On macOS use the installer for the mods/ DLL layout. Artifact hashes and validation scope are recorded in SHA256SUMS.txt and release-manifest.json.
Northlight 0.3.218.5 - Sparse buffer synchronization (Windows, macOS, Linux)
Northlight 0.3.218.5
Reduce command-stream synchronization when oversized dynamic vertex/index buffers receive repeated updates in separate regions.
Changes
- Retain up to eight exact byte ranges instead of replacing the only cached range on every disjoint write. Repeated partial writes use ordered deferred uploads without draining the replay thread.
- Preserve the existing memory limits: 4 MiB retained data per buffer and 8 MiB globally. Unknown data, readonly locks, GPU-written buffers and allocation failures retain their exact fallback.
- Preserve geometry, shader output, shadow detail and quality settings. No effects are disabled to obtain this improvement.
- Document the supplied town/ziggurat and Zangarmarsh QA logs in the performance review. The older rotation run shows ineffective range-cache reuse and expensive CPU capture/synchronization; current-build gameplay measurements are still needed.
Validation
57 selected tests passed without skips: source, architecture, stream buffers and packaging. Full command-stream scenarios cover ordered replay, partial writes, DISCARD, eviction, memory limits, GPU mutation and reentrant waits. Source CI passed on Windows and Ubuntu.
In the real Windows D3D9/DXVK test, 1,024 sparse vertex/index-buffer updates cause 2,048 synchronous calls in 0.3.218.4 and zero in this version. The complete rendered images match byte for byte, including all eight regions' expected final colors and geometry. This is a focused correctness/synchronization result, not a measured game FPS increase or proof that every reported spike is fixed.
Actual Windows, macOS and Linux archives passed package verification. GPU checks ran on Windows; macOS/WoWSilicon and Linux/Wine gameplay were not tested in this release.
Downloads and installation
Northlight-0.3.218.5-Windows.zip: Windows installer, Python/StormLib, DXVK 3.1.1 and fallback 2.7.1.Northlight-0.3.218.5-macOS.zip: Apple Silicon/WoWSilicon installer and dependencies.Northlight-0.3.218.5-Linux.zip: x86_64 Linux/Wine or Proton installer and dependencies.
Every package includes the matching DLL and northlight-assets.bin, converted Forever atmosphere, celestial/expansion profiles and client-data generators. Existing settings are preserved; client-specific caches/art are generated from the selected client's own archives.
Close the target game and run the package's installer. For a manual update, replace both d3d9.dll and northlight-assets.bin; the atmosphere file is attached separately too. On macOS use the installer for the mods/ DLL layout. Linux/Wine requires WINEDLLOVERRIDES="d3d9=n,b".
SHA256SUMS.txt and release-manifest.json identify the artifacts, source commit and validation scope.
Northlight 0.3.218.4 - Rendering optimizations (Windows, macOS, Linux)
Northlight 0.3.218.4
Rendering optimizations since 0.3.218.3, now packaged for Windows, macOS and Linux.
Changes
- Reduce CPU material capture work through shared admission snapshots, grass batching and cheaper deferred state comparisons.
- Share world-composite inputs and combine lighting smoothing with temporal accumulation. Retain backend-specific optimizations only where GPU comparisons support them.
- Combine world/actor shadow visibility filtering, reuse weather shelter results, and keep celestial/godray controls independent. The experimental common fine shadow cascade is not enabled by this release.
- Skip radiance and history reads for zero-weight GI probes while preserving residency coverage, indoor occlusion and authored-lighting blending. Probe count, texture precision and quality settings are unchanged.
- Audit all 228 offline shader entries across 20 HLSL sources. Exclude seven unused shader resources from the shipped bundle while retaining their canonical test oracles. See the complete shader audit.
- Include the matching DLL/resource bundle, converted Forever atmosphere, expansion atmosphere/emissive rules, celestial profiles and client-data generators in every platform package.
Validation and performance
66 selected tests passed with no skips: source, architecture, lighting/composite, GI contracts and packaging. Actual archives passed package verification, including bundled dependencies, licenses, launcher syntax and DLL/resource pairing. GitHub source CI passed on Windows and Ubuntu.
The new GI shader matched every compared output component in 57 FP16 and 57 FP32 cases across native D3D9, DXVK 2.7.1 and DXVK 3.1.1. Its synthetic 1920x1080 pass was 7-23% faster on DXVK 3.1.1 than commit 423f4da; separate A/A controls measured about 1% variation on that backend. These are pass timings with Forever running in the background, not a measured game FPS increase.
GPU checks ran on Windows. macOS and Linux archives were verified on Windows; this release has no new macOS/WoWSilicon or Linux/Wine gameplay acceptance. Linux remains untested in game.
Download
Northlight-0.3.218.4-Windows.zip: Windows 10/11, bundled DXVK 3.1.1 and fallback DXVK 2.7.1.Northlight-0.3.218.4-macOS.zip: Apple Silicon macOS with WoWSilicon.Northlight-0.3.218.4-Linux.zip: x86_64 Linux, glibc 2.17+, with the game running through Wine/Proton.
Each archive includes its own Python and StormLib. World-cache and art files are generated from the target client's archives; another client's cache or personal INI files are not distributed.
Install or update
- Close the target game and extract the package outside its folder.
- Windows: run
Install.cmd. macOS: runbash "Install Northlight.command". Linux: runbash install.sh. - Select the folder containing
Wow.exe. The installer preserves current cache data when compatible and retains existing user settings. It never modifiesWow.exe. - Linux/Wine: configure
WINEDLLOVERRIDES="d3d9=n,b"; with Steam/Proton useWINEDLLOVERRIDES="d3d9=n,b" %command%.
For manual updates, replace both d3d9.dll and northlight-assets.bin with the matching release files. forever-atmosphere.bin is also attached and included in all installers. macOS installs the renderer under mods/, with the resource file in the game root; use the macOS installer for migration.
Uninstall with the package's uninstall launcher to restore its recorded changes. File hashes are in SHA256SUMS.txt; release-manifest.json records the source commit, resource identity and validation scope.
Northlight 0.3.218.6-interior-color - Interior lighting fix (Windows preview)
Preserve baked interior lighting when a modified world shader changes identity but still passes the world-coordinate and baked-RGB proofs. Previously, losing the prelit mask could apply directional-light subtraction to authored lighting and produce a dark red surface.
This Windows prerelease contains the exact source snapshot used for build eeee9c658899 and the previously prepared GI/shadow changes in that snapshot:
- Preserve prelit receiver classification and report prelit/unlit draw counts.
- Retain GI visibility during same-map replacement, distinguish solved invalid probes from missing probes, and add bounded coarse-grid GI coverage.
- Reject directional light leaking across back-facing receivers and preserve coherent snapshot reads around disjoint executable sections.
- Allow configured GI ambient removal while retaining current local lights and fog.
Validation: source contracts 17/17, architecture contracts 34/34, and the new prelit registration/compositor GPU regression on system D3D9, DXVK 2 and DXVK 3 in SDR and HDR. The regression reproduces a red shift when the prelit mask is missing and preserves colour with the corrected classification. The production DLL/resource pair and Windows archive passed package verification.
These checks are not a replay of the supplied Wintergarde Keep scene or a game-performance measurement. The screenshots came from another installation; a fresh log and matched scene captures are still needed to confirm that installation's cause. An additional name-mask test retains an unrelated baseline failure: its banner assertion expects version 0.3.217, while the renderer already identifies as 0.3.218.
Install with Install.cmd from the Windows archive after closing the target game. For a manual update, replace both d3d9.dll and northlight-assets.bin. The existing converted atmosphere is not included in this targeted package. No new macOS or Linux package is supplied.
Northlight 0.3.218.3 - Sky background continuity
Fix a sky background pass that could disappear for a whole frame when the first foreground draw had not established world context. This made the imported sky depend on draw order.
- Read the current validated sky camera independently; retain same-map projection/palette validation and the original foreground boundary.
- Keep world capture admission and sun/moon visibility independent from background composition.
- Add sampled SKY_BACKGROUND diagnostics and restore the sky-only camera test to the architecture suite.
- Include the GI/fog streaming fixes from 0.3.218.2 and the complete installer payload: DLL, shader/weather/font bundle, converted Forever atmosphere, expansion atmosphere/emissive rules, celestial profiles and client-data generators.
Validation: source, architecture and packaging suites; sky image/state tests on native D3D9, DXVK 2.7.1 and DXVK 3.1.1; actual Windows ZIP verification. Details and video evidence are in docs/lighting-streaming-20261114.md.
The local video has now been inspected. The skipped sky pass is reproduced by a regression test, but gameplay confirmation of this fix is still pending. This release does not claim improved game FPS or removal of geometry memory-admission stalls.
0.3.218.2 — lighting continuity during streaming
Fix two lighting switches when streaming retires a geometry region:
- Keep the GI ambient fallback active while mesh/probe data is unavailable. Empty-coverage scenes now match exactly across geometry availability in SDR/HDR, both GI shader paths and MSAA 0/2.
- Require usable directional shadow maps for direct fog scattering. A mesh without shadow ownership no longer turns sunlight/moonlight in fog on and off. Covers ordinary fog, Forever raymarch and the Forever volume atlas.
- Log GI, probe and direct-fog readiness separately for subsequent gameplay diagnosis.
Includes the complete Windows installer, standalone DLL, northlight-assets.bin and converted Forever atmosphere. Existing expansion atmosphere, emissive rules, celestial profiles and installer-generated client data remain included.
The supplied gameplay log uses DXVK 3.1.1. Its geometry gaps were 1.7–11.5 seconds under address-space pressure; the memory reserve and retention bounds are preserved. These changes fix the reproduced lighting gates, not the streaming stalls or measured game FPS. The linked Discord video was unavailable (HTTP 403).
Validation: full screen-effects GPU oracle on DXVK 3.1.1 at MSAA 0/2, source/architecture/packaging suites and verification of the actual installer. On native D3D9 the new image cases pass, but the wider volume-cache test hits the same c154–c156 restoration failure as the prior binary; full native acceptance is not claimed. See docs/lighting-streaming-20261114.md for evidence.