/** * Temporary always-on fluid shader debug panel (water + lava tabs). * Export JSON when you land on values you like. */ /** Shared across water + lava (top of debug panel). */ export const DEFAULT_FLUID_SHARED = Object.freeze({ /** Shader time steps per second; 0 = continuous. */ refreshRate: 0 }); export const DEFAULT_WATER_DEBUG = Object.freeze({ flowX: 0.17, flowY: 0.05, flowZ: 0.91, waveScale: 2.07, fbmAmp: 0.15, texAmp: 0.43, distort: 0.09, normalZ: 0.88, waveGain: 0.62, crestLo: 0.54, crestHi: 0.67, crestPow: 2.05, glitterPow: 13.1, crestGlitter: 1.3, glitterCap: 1, glitterMix: 1.24, shadeLo: 1.06, shadeHi: 1, bodyLo: 0.41, bodyHi: 0.85, litLo: 0.5, litHi: 0.86, litMix: 0.46, edgeDark: 0.37, lightDirX: -0.48, lightDirY: -0.63, lightDirZ: 0.78, normalEps: 0.21, foamStrength: 1, shoreClip: 0.55, /** 0 = baseline deep end; 1 = much darker deep water. */ deepDark: 0.4, /** <1 = more abrupt darkening toward deep (pow curve). */ deepAbrupt: 0.72 }); export const DEFAULT_LAVA_DEBUG = Object.freeze({ flowX: 0.08, flowY: 0.04, flowZ: 0.27, waveScale: 1.83, fbmAmp: 0.43, texAmp: 0.3, distort: 0.3, normalZ: 1.07, waveGain: 0.52, crestLo: 0.57, crestHi: 0.71, crestPow: 1.15, glitterPow: 7.5, crestGlitter: 1.19, glitterCap: 0.31, glitterMix: 0.51, shadeLo: 0.88, shadeHi: 1.07, bodyLo: 0.05, bodyHi: 1, litLo: 0.59, litHi: 0.74, litMix: 1, edgeDark: 0.55, lightDirX: -0.48, lightDirY: -0.63, lightDirZ: 0.78, normalEps: 0.09, bloomStrength: 0.9, shoreClip: 0.55 }); const SHARED_SLIDERS = [ { key: "refreshRate", label: "Refresh rate (Hz, 0=smooth)", min: 0, max: 24, step: 1 } ]; const WATER_SLIDERS = [ { key: "flowX", label: "Flow X", min: 0, max: 1, step: 0.01 }, { key: "flowY", label: "Flow Y", min: 0, max: 1, step: 0.01 }, { key: "flowZ", label: "Flow Z", min: 0, max: 1.5, step: 0.01 }, { key: "waveScale", label: "Wave scale", min: 0.2, max: 2.5, step: 0.01 }, { key: "fbmAmp", label: "FBM amp", min: 0.1, max: 1.5, step: 0.01 }, { key: "glitterPow", label: "Glitter pow", min: 1, max: 16, step: 0.1 }, { key: "glitterMix", label: "Glitter mix", min: 0, max: 1.5, step: 0.01 }, { key: "bodyLo", label: "Body lo", min: 0, max: 0.5, step: 0.01 }, { key: "bodyHi", label: "Body hi", min: 0.3, max: 1, step: 0.01 }, { key: "litMix", label: "Lit mix", min: 0, max: 1, step: 0.01 }, { key: "deepDark", label: "Deep darker", min: 0, max: 1, step: 0.01 }, { key: "deepAbrupt", label: "Deep abrupt", min: 0.35, max: 1.4, step: 0.01 }, { key: "foamStrength", label: "Foam", min: 0, max: 1, step: 0.01 }, { key: "shoreClip", label: "Shore clip", min: 0.1, max: 0.9, step: 0.01 }, { key: "edgeDark", label: "Edge dark", min: 0, max: 1, step: 0.01 } ]; const LAVA_SLIDERS = [ { key: "flowX", label: "Flow X", min: 0, max: 1, step: 0.01 }, { key: "flowY", label: "Flow Y", min: 0, max: 1, step: 0.01 }, { key: "flowZ", label: "Flow Z", min: 0, max: 1.5, step: 0.01 }, { key: "waveScale", label: "Wave scale", min: 0.2, max: 2.5, step: 0.01 }, { key: "fbmAmp", label: "FBM amp", min: 0.1, max: 1.5, step: 0.01 }, { key: "distort", label: "Distort", min: 0, max: 0.5, step: 0.01 }, { key: "glitterPow", label: "Heat pow", min: 1, max: 16, step: 0.1 }, { key: "glitterMix", label: "Heat mix", min: 0, max: 1.5, step: 0.01 }, { key: "glitterCap", label: "Heat cap", min: 0.1, max: 1, step: 0.01 }, { key: "bodyLo", label: "Body lo", min: 0, max: 0.5, step: 0.01 }, { key: "bodyHi", label: "Body hi", min: 0.3, max: 1, step: 0.01 }, { key: "litMix", label: "Lit mix", min: 0, max: 1, step: 0.01 }, { key: "bloomStrength", label: "Bloom", min: 0, max: 2, step: 0.01 }, { key: "shoreClip", label: "Shore clip", min: 0.1, max: 0.9, step: 0.01 }, { key: "edgeDark", label: "Edge dark", min: 0, max: 1, step: 0.01 } ]; let sharedParams = { ...DEFAULT_FLUID_SHARED }; let waterParams = { ...DEFAULT_WATER_DEBUG }; let lavaParams = { ...DEFAULT_LAVA_DEBUG }; let activeTab = "water"; let panelEl = null; export function getFluidSharedParams () { return { ...sharedParams }; } export function getWaterDebugParams () { return { ...waterParams }; } export function getLavaDebugParams () { return { ...lavaParams }; } /** * Quantized shader clock for water/lava (matches sprite-like refresh when rate > 0). * @param {number} [nowMs] */ export function fluidTimeSec (nowMs = performance.now()) { const t = nowMs / 1000; const rate = Number(sharedParams.refreshRate) || 0; if (rate <= 0) { return t; } return Math.floor(t * rate) / rate; } function uniformBagFrom (p, extras = {}) { return { u_flowX: p.flowX, u_flowY: p.flowY, u_flowZ: p.flowZ, u_waveScale: p.waveScale, u_fbmAmp: p.fbmAmp, u_texAmp: p.texAmp, u_distort: p.distort, u_normalZ: p.normalZ, u_waveGain: p.waveGain, u_crestLo: p.crestLo, u_crestHi: p.crestHi, u_crestPow: p.crestPow, u_glitterPow: p.glitterPow, u_crestGlitter: p.crestGlitter, u_glitterCap: p.glitterCap, u_glitterMix: p.glitterMix, u_shadeLo: p.shadeLo, u_shadeHi: p.shadeHi, u_bodyLo: p.bodyLo, u_bodyHi: p.bodyHi, u_litLo: p.litLo, u_litHi: p.litHi, u_litMix: p.litMix, u_edgeDark: p.edgeDark, u_lightDirX: p.lightDirX, u_lightDirY: p.lightDirY, u_lightDirZ: p.lightDirZ, u_normalEps: p.normalEps, ...extras }; } /** Uniform bag for the water ground fragment shader. */ export function waterDebugUniforms () { const p = waterParams; return uniformBagFrom(p, { u_foamStrength: p.foamStrength, u_shoreClip: p.shoreClip, u_deepDark: p.deepDark, u_deepAbrupt: p.deepAbrupt }); } /** Uniform bag for lava ground / bloom shaders. */ export function lavaDebugUniforms () { const p = lavaParams; return uniformBagFrom(p, { u_bloomStrength: p.bloomStrength, u_shoreClip: p.shoreClip }); } export function setWaterDebugParams (next) { waterParams = { ...DEFAULT_WATER_DEBUG, ...waterParams, ...next }; syncInputs(); } export function setLavaDebugParams (next) { lavaParams = { ...DEFAULT_LAVA_DEBUG, ...lavaParams, ...next }; syncInputs(); } export function setFluidSharedParams (next) { sharedParams = { ...DEFAULT_FLUID_SHARED, ...sharedParams, ...next }; syncInputs(); } function activeParams () { return activeTab === "lava" ? lavaParams : waterParams; } function activeSliders () { return activeTab === "lava" ? LAVA_SLIDERS : WATER_SLIDERS; } function syncInputs () { if (!panelEl) { return; } for (const { key } of SHARED_SLIDERS) { const input = panelEl.querySelector(`input[data-fluid-shared="${key}"]`); const valueEl = panelEl.querySelector(`[data-fluid-shared-value="${key}"]`); if (input) { input.value = String(sharedParams[key]); } if (valueEl) { valueEl.textContent = Number(sharedParams[key]).toFixed(0); } } for (const { key } of activeSliders()) { const input = panelEl.querySelector(`input[data-fluid-key="${key}"]`); const valueEl = panelEl.querySelector(`[data-fluid-value="${key}"]`); const params = activeParams(); if (input) { input.value = String(params[key]); } if (valueEl) { valueEl.textContent = Number(params[key]).toFixed(3); } } for (const btn of panelEl.querySelectorAll("[data-fluid-tab]")) { const on = btn.getAttribute("data-fluid-tab") === activeTab; btn.style.opacity = on ? "1" : "0.55"; btn.style.borderBottom = on ? "2px solid #9ec5ff" : "2px solid transparent"; } } function exportJson () { const isLava = activeTab === "lava"; const payload = { ...getFluidSharedParams(), ...(isLava ? getLavaDebugParams() : getWaterDebugParams()) }; const text = JSON.stringify(payload, null, 2); void navigator.clipboard?.writeText(text).catch(() => { }); const blob = new Blob([text], { type: "application/json" }); const url = URL.createObjectURL(blob); const a = document.createElement("a"); a.href = url; a.download = isLava ? "lava-debug.json" : "water-debug.json"; a.click(); URL.revokeObjectURL(url); const status = panelEl?.querySelector("[data-fluid-export-status]"); if (status) { status.textContent = "Exported"; setTimeout(() => { if (status.textContent === "Exported") { status.textContent = ""; } }, 2000); } } function rebuildSliderRows () { const scroll = panelEl?.querySelector(".fluid-debug-scroll"); if (!scroll) { return; } scroll.replaceChildren(); const params = activeParams(); for (const spec of activeSliders()) { const row = document.createElement("label"); row.style.cssText = "display:grid;grid-template-columns:1fr 48px;gap:2px 6px;align-items:center;"; row.innerHTML = ` ${spec.label} ${Number(params[spec.key]).toFixed(3)} `; const input = row.querySelector("input"); input.addEventListener("input", () => { const bag = activeTab === "lava" ? lavaParams : waterParams; bag[spec.key] = Number(input.value); const valueEl = row.querySelector(`[data-fluid-value="${spec.key}"]`); if (valueEl) { valueEl.textContent = Number(bag[spec.key]).toFixed(3); } }); scroll.appendChild(row); } } function setTab (tab) { activeTab = tab === "lava" ? "lava" : "water"; rebuildSliderRows(); syncInputs(); } /** * Always-visible temporary debug dock (pointer-events on panel only). */ export function initWaterDebugPanel () { if (panelEl) { return panelEl; } panelEl = document.createElement("aside"); panelEl.id = "fluid-debug-panel"; panelEl.innerHTML = `
`; Object.assign(panelEl.style, { position: "fixed", top: "8px", right: "8px", width: "250px", maxHeight: "calc(100vh - 16px)", zIndex: "9999", display: "flex", flexDirection: "column", gap: "4px", padding: "8px", background: "rgba(12, 16, 22, 0.92)", color: "#e8eef5", font: "11px/1.25 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace", border: "1px solid rgba(255,255,255,0.18)", borderRadius: "6px", boxShadow: "0 8px 24px rgba(0,0,0,0.45)", pointerEvents: "auto" }); const sharedBox = panelEl.querySelector(".fluid-debug-shared"); Object.assign(sharedBox.style, { display: "flex", flexDirection: "column", gap: "3px", paddingBottom: "4px", borderBottom: "1px solid rgba(255,255,255,0.12)" }); for (const spec of SHARED_SLIDERS) { const row = document.createElement("label"); row.style.cssText = "display:grid;grid-template-columns:1fr 48px;gap:2px 6px;align-items:center;"; row.innerHTML = ` ${spec.label} ${Number(sharedParams[spec.key]).toFixed(0)} `; const input = row.querySelector("input"); input.addEventListener("input", () => { sharedParams[spec.key] = Number(input.value); const valueEl = row.querySelector(`[data-fluid-shared-value="${spec.key}"]`); if (valueEl) { valueEl.textContent = Number(sharedParams[spec.key]).toFixed(0); } }); sharedBox.appendChild(row); } const scroll = panelEl.querySelector(".fluid-debug-scroll"); Object.assign(scroll.style, { overflowY: "auto", flex: "1 1 auto", display: "flex", flexDirection: "column", gap: "3px", paddingRight: "2px" }); for (const btn of panelEl.querySelectorAll("button")) { Object.assign(btn.style, { background: "transparent", color: "inherit", border: "1px solid rgba(255,255,255,0.22)", borderRadius: "4px", padding: "3px 8px", cursor: "pointer", font: "inherit" }); } for (const btn of panelEl.querySelectorAll("[data-fluid-tab]")) { btn.style.border = "none"; btn.style.borderRadius = "0"; btn.style.padding = "2px 4px"; btn.addEventListener("click", (event) => { event.preventDefault(); event.stopPropagation(); setTab(btn.getAttribute("data-fluid-tab")); }); } panelEl.querySelector("[data-fluid-reset]").addEventListener("click", (event) => { event.preventDefault(); event.stopPropagation(); sharedParams = { ...DEFAULT_FLUID_SHARED }; if (activeTab === "lava") { lavaParams = { ...DEFAULT_LAVA_DEBUG }; } else { waterParams = { ...DEFAULT_WATER_DEBUG }; } rebuildSliderRows(); syncInputs(); }); panelEl.querySelector("[data-fluid-export]").addEventListener("click", (event) => { event.preventDefault(); event.stopPropagation(); exportJson(); }); for (const type of ["mousedown", "mouseup", "click", "wheel", "contextmenu", "pointerdown"]) { panelEl.addEventListener(type, (event) => { event.stopPropagation(); }); } rebuildSliderRows(); syncInputs(); document.body.appendChild(panelEl); return panelEl; }