spoint 0.1.691 → 0.1.693

package/client/app.js

@@ -3244,6 +3244,11 @@ client.connect().then(async ()=>{
     const { createMeshDebugPanel } = await import('./hud/MeshDebugPanel.js')
     window.__app.meshDebugPanel = createMeshDebugPanel(uiRoot)
   }
+  // Optional on-screen render-toggle panel (?debugpanel=1) -- see client/hud/RenderDebugPanel.js.
+  if (_params.has('debugpanel')) {
+    const { createRenderDebugPanel } = await import('./hud/RenderDebugPanel.js')
+    window.__app.renderDebugPanel = createRenderDebugPanel(uiRoot, RenderControls)
+  }
   // Joiner side: WireweaveJoinClient.js's connect() (already resolved by the time
   // this .then() runs) constructs its own bridge and exposes it on window.__app.wireweave.
   // Mount the same room-wide voice widget the host gets below.

package/client/core/QualityPresets.js

@@ -62,8 +62,14 @@ const PRESETS = {
     grassWind: true,
     halfResWater: false,
     thc: false,
-    ssao: true,
-    bloom: true,
+    // ssao/bloom OFF by default on every tier (2026-08-10): live user-witnessed the half-res SSAO
+    // upsample producing a persistent dark ground-level smear/ghosting artifact anchored to nearby
+    // geometry silhouettes (confirmed via the live ?debugpanel=1 toggle A/B -- disabling ssao alone
+    // removed it). Both remain fully wired, live-toggleable RenderControls knobs (window.__renderControls
+    // .set('ssao', true) / the debug panel checkbox) for whoever fixes the underlying half-res-upsample
+    // artifact next -- this only flips the SHIPPED default, not the feature.
+    ssao: false,
+    bloom: false,
     ssr: false,
     toneMappingExposure: 1.0,
   },
@@ -78,8 +84,8 @@ const PRESETS = {
     grassWind: true,
     halfResWater: false,
     thc: false,
-    ssao: true,
-    bloom: true,
+    ssao: false,
+    bloom: false,
     ssr: false,
     toneMappingExposure: 1.0,
   },
@@ -94,8 +100,8 @@ const PRESETS = {
     grassWind: true,
     halfResWater: false,
     thc: false,
-    ssao: true,
-    bloom: true,
+    ssao: false,
+    bloom: false,
     ssr: true,
     toneMappingExposure: 1.0,
   },

package/client/core/RenderControls.js

@@ -412,6 +412,8 @@ const FLAGS = [
     doc: 'Join an existing wireweave room (given by ?room=) as a peer, instead of hosting a new one.' },
   { flag: '?meshdebug', kind: 'query', group: 'networking', readAt: 'client/app.js, client/hud/MeshDebugPanel.js',
     doc: 'Mount a live P2P mesh-topology panel (peer list, connection states, current app-layer host) on top of a ?room= session. window.__meshDebug.list()/.snapshot() are always available regardless of this flag (see client/core/MeshDebug.js) -- this only adds the on-screen visual.' },
+  { flag: '?debugpanel=1', kind: 'query', group: 'render-debug', readAt: 'client/app.js, client/hud/RenderDebugPanel.js',
+    doc: 'Mount an on-screen checkbox panel for live A/B-testing render subsystem suspects (sun shadow, SSAO, decal system, grass decals, shadow cascades, player VAT) without console commands -- built for live-tester bisection of visual artifacts.' },
   { flag: '?netsim=<preset>', kind: 'query', group: 'networking', readAt: 'client/app.js, src/transport/NetworkSimTransport.js',
     doc: 'Transport simulation harness: wraps the real WebSocket/WebTransport connection in NetworkSimTransport, injecting loss/latency/jitter/reorder so netcode is tuned against a real degraded link instead of localhost. Preset names: clean, broadbandGood, wifiTypical, cellular4g, roadmapTarget (150ms/3% loss), degradedWan, brutal (see NETWORK_SIM_PRESETS). Live-retune after connecting via window.__netSim.configure({lossPct,latencyMs,jitterMs,reorderPct}); inspect drop/reorder counts via window.__netSim.getStats().' },
   { flag: '?world=<name>', kind: 'query', group: 'world', readAt: 'client/app.js',

package/client/core/ShadowPipeline.js

@@ -68,7 +68,18 @@ export function createShadowPipeline(sun, opts = {}) {
   const scene = opts.scene || sun.parent || null
   const baseExtent = Number.isFinite(opts.extent) ? opts.extent : 60
   const requestedCascades = Number.isFinite(opts.cascades) ? opts.cascades : 1
-  const cascadeCount = Math.max(1, Math.min(MAX_CASCADES, Math.round(requestedCascades)))
+  // Cascade 0 IS `sun` (see the loop below) -- if sun.castShadow is false (the documented tree-flicker
+  // workaround, SceneSetup.js's sun.castShadow=false), cascade 0's light never renders a shadow map at
+  // all, so its shadow.needsUpdate stays true forever and _lastSnapped/target are never placed
+  // (_updateCascade's `if (!light.castShadow) return false` early-return, hit every call). A >1 cascade
+  // pipeline built on top of that still installs the per-fragment CascadeShadowSelect blend shader,
+  // which samples directionalShadowMap[0] -- an uninitialized/never-rendered depth texture -- for every
+  // fragment within cascade 0's band (near geometry: the player, close trees, close architecture),
+  // producing a visible ghosting/duplication artifact live-witnessed as a real ~2-week-old user-reported
+  // bug (2026-08-09). A multi-cascade pipeline is only coherent when every cascade actually renders;
+  // clamp to 1 cascade whenever sun.castShadow is off so this file's own multi-cascade code path is
+  // never reached with a permanently-dead cascade 0 in it.
+  const cascadeCount = sun.castShadow === false ? 1 : Math.max(1, Math.min(MAX_CASCADES, Math.round(requestedCascades)))
   // Sun-from-target offset: DIRECTION is the live light direction, LENGTH places the ortho camera.
   const offset = (opts.offset && opts.offset.isVector3) ? opts.offset.clone() : new THREE.Vector3(40, 80, 30)
   let offsetLen = offset.length()

package/client/hud/RenderDebugPanel.js

@@ -0,0 +1,99 @@
+// Live render-toggle debug panel (?debugpanel=1) -- lets a live tester binary-search a visual
+// artifact by flipping known suspect systems on/off, one at a time, without console commands.
+// Built for the 2026-08-09 shadow/decal-ghosting investigation: every toggle below is a candidate
+// this session ruled in/out by code inspection but could not confirm live (fps-degraded automation
+// tab, screenshot tooling only partially working) -- this panel lets the user do the live A/B
+// themselves and report which toggle changes the artifact.
+
+function ensureStyle() {
+  if (document.getElementById('render-debug-panel-style')) return
+  const s = document.createElement('style')
+  s.id = 'render-debug-panel-style'
+  s.textContent = `
+    .rdp-card{position:fixed;top:max(8px,env(safe-area-inset-top));right:max(8px,env(safe-area-inset-right));z-index:1000;width:min(280px,calc(100vw - 16px));pointer-events:all;display:flex;flex-direction:column;gap:4px;padding:10px;background:rgba(10,12,18,0.92);border:1px solid rgba(255,255,255,0.15);border-radius:8px;font:12px/1.5 ui-monospace,monospace;color:#e6e6e6}
+    .rdp-card .rdp-h{font-size:13px;font-weight:600;margin-bottom:4px}
+    .rdp-card label{display:flex;align-items:center;gap:6px;cursor:pointer;padding:2px 0}
+    .rdp-card input{cursor:pointer}
+  `
+  document.head.appendChild(s)
+}
+
+// Each toggle: label, get() current state, set(bool) apply. Wraps whatever mechanism the target
+// system actually uses (window.__renderControls for registered CONTROLS keys, a raw window.__flag
+// for systems with no RenderControls entry yet).
+function _toggles(renderControls) {
+  return [
+    {
+      label: 'Sun shadow (hostShadowOff)',
+      get: () => !(typeof window !== 'undefined' && window.__hostShadowOff),
+      set: (on) => { window.__hostShadowOff = !on },
+    },
+    {
+      label: 'SSAO',
+      get: () => !!renderControls?.get('ssao'),
+      set: (on) => renderControls?.set('ssao', on),
+    },
+    {
+      label: 'Decal system (bullet holes/tracers)',
+      get: () => !(typeof window !== 'undefined' && window.__decalsOff),
+      set: (on) => {
+        window.__decalsOff = !on
+        const ds = window.__app?.decals
+        if (ds && ds._pool) { for (const d of ds._pool) if (d.mesh) d.mesh.visible = on && d.mesh.visible }
+      },
+    },
+    {
+      label: 'Grass decals (scorch/trample overlay)',
+      get: () => !(typeof window !== 'undefined' && window.__grassDecalsOff),
+      set: (on) => { window.__grassDecalsOff = !on },
+    },
+    {
+      label: 'Shadow cascades: force to 1',
+      get: () => (window.__shadowPipeline?.cascadeCount ?? 1) <= 1,
+      set: (on) => {
+        if (!on) return
+        const sp = window.__shadowPipeline
+        if (sp && sp.lights) for (let i = 1; i < sp.lights.length; i++) sp.lights[i].castShadow = false
+      },
+    },
+    {
+      label: 'Player VAT crowd render',
+      get: () => !(typeof window !== 'undefined' && window.__playerVatOff),
+      set: (on) => { window.__playerVatOff = !on },
+    },
+  ]
+}
+
+export function createRenderDebugPanel(uiRoot, renderControls) {
+  ensureStyle()
+  const card = document.createElement('div')
+  card.className = 'rdp-card'
+  uiRoot.appendChild(card)
+
+  const toggles = _toggles(renderControls)
+  const title = document.createElement('div')
+  title.className = 'rdp-h'
+  title.textContent = 'Render Debug Toggles'
+  card.appendChild(title)
+
+  const hint = document.createElement('div')
+  hint.style.cssText = 'color:#999;font-size:11px;margin-bottom:6px'
+  hint.textContent = 'Uncheck one at a time to find what causes the ground-mark artifact.'
+  card.appendChild(hint)
+
+  for (const t of toggles) {
+    const label = document.createElement('label')
+    const input = document.createElement('input')
+    input.type = 'checkbox'
+    input.checked = t.get()
+    input.addEventListener('change', () => t.set(input.checked))
+    label.appendChild(input)
+    label.appendChild(document.createTextNode(t.label))
+    card.appendChild(label)
+  }
+
+  return {
+    node: card,
+    destroy() { card.remove() },
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spoint",
-  "version": "0.1.691",
+  "version": "0.1.693",
   "description": "Physics and netcode SDK for multiplayer game servers",
   "type": "module",
   "workspaces": [