Skip to Content

Debugging tools

Target API: 5 · Target build: bbb6l5 (2026-11-20, production and preprod) · Status: Analyzed (production-bundle JavaScript analysis)

  • URL parameter ?renderer=lite — force the Lite (WebGPU) renderer (webgl2 / babylon also work; babylon is the old name for webgl2). Priority: URL parameter > localStorage bloxdRenderer > settings screen > default (webgl2). Invalid values are ignored with a warning. Overrides left in the URL or localStorage can break scenes that need WebGPU (lite) with “needs the new WebGPU renderer, so remove the renderer override…” (Loading errors)
  • URL parameter ?vconsole — on-screen console (VConsole). Handy for mobile device verification
  • URL parameter ?drawcalls=1 — adds a draw-statistics debug panel. Pick game objects from the debug console, or use drawCalls() / why() / configureDrawCallWatching(), to inspect overdrawing by large mechanisms (pack and otherwise) and approaches to the ~65,000-vertex limit per draw call — useful for isolating performance bottlenecks
  • Console shows noa-engine v0.33.0 and Renderer: lite from <source> — check these first to avoid render-path misdiagnosis
  • The WebGPU renderer locks “forced ON” while a pack applies. The “Disable Block Texture Atlas” setting also locks (atlas stays ON), and packs can’t apply at all on WebGPU-less devices. The basis for writing “needs a WebGPU browser” on distribution pages
  • Block textures are a 2D array texture (texture_2d_array), and the terrain sampler is nearest + repeat. The mesher also merges faces with matching material / AO / light into one rectangle (greedy meshing), so a merged face’s UV can exceed one tile width (edges inset by 0.0015). Hardware repeat addressing handles the tiling, so merged faces look seamless. Note that procedural detail keyed to vUV can break at merged-face boundaries — key it to world position (s.position + bloxdRenderOffset()) instead
  • Per-game-join runtime re-validation (checkCompilation) compiles real terrain materials in browser WebGPU (stricter than settings-screen static validation). Packs failing here are excluded from that game