Type about:config in the Firefox address bar and press Enter.
Search for webgl.disabled — if it shows true, click the toggle icon to set it to false.
Go to Firefox Settings → General → Performance → uncheck "Use recommended performance settings" → enable "Use hardware acceleration when available".
On Linux: ensure GPU drivers (Mesa/libGL) are installed:
sudo apt install mesa-utils (or your distro equivalent).
Restart Firefox and reload this page.

'; return{title:'WebGL is disabled in Firefox',steps:steps}; } if(isEdge||isChrome){ var br=isEdge?'Edge':'Chrome',sc=isEdge?'edge':'chrome'; var steps2='

Type '+sc+'://settings/system in the address bar and press Enter.
Enable "Use hardware acceleration when available", then click Relaunch.
If still failing, open '+sc+'://gpu and check for driver errors.

'; return{title:'WebGL is disabled in '+br,steps:steps2}; } return{title:'WebGL is not available',steps:'

Your browser does not support WebGL, which is required for 3D rendering. Please try the latest Chrome or Firefox with hardware acceleration enabled.

'}; } if(!wgl.available){ var ins=cgWebGLInstructions(); var wb=document.createElement('div'); wb.id='cg-webgl-banner'; wb.style.cssText='position:fixed;inset:0;z-index:999998;background:#07080e;color:#e2e8f0;display:flex;flex-direction:column;align-items:center;justify-content:center;font-family:sans-serif;padding:32px;box-sizing:border-box;border:4px solid #f59e0b;'; wb.innerHTML='

' +'

⚠️ '+ins.title+'

' +'

Cosmos Genesis requires WebGL for 3D rendering. It appears to be disabled or unavailable in your browser.

' +'

'+ins.steps+'

' +'

' +'' +'' +'' +'

' +'

'; document.body.appendChild(wb); var wbSt=document.getElementById('cg-wb-st'); document.getElementById('cg-wb-retry').onclick=function(){ var s2=cgCheckWebGL();window.__webglStatus=s2; if(s2.available){wb.remove();} else{if(wbSt)wbSt.textContent='Still unavailable — WebGL may need to be enabled in browser settings.';} }; document.getElementById('cg-wb-report').onclick=function(){ if(wbSt)wbSt.textContent='Sending…'; var rpt={timestamp:new Date().toISOString(),userDescription:'WebGL unavailable on page load',browserInfo:{browserName:(navigator.userAgent.match(/Chrome|Firefox|Safari|Edge|Opera/)||['Unknown'])[0],platform:navigator.platform||'Unknown',screenResolution:screen.width+'x'+screen.height,language:navigator.language},systemInfo:{hardwareConcurrency:navigator.hardwareConcurrency||0},graphicsInfo:{renderer:'UNAVAILABLE',vendor:'UNAVAILABLE',webglAvailable:false},sceneState:{activeContainer:null,containerType:null,cameraMode:null},telemetry:{fps:null,frameTimeMs:null,objectsLoaded:0},consoleErrors:window.__earlyErrors.slice(0,20),userAgent:navigator.userAgent}; fetch(API+'/bug-reports/submit',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify(rpt)}).then(function(r){return r.json();}).then(function(r){if(wbSt)wbSt.textContent=r.reportId?'Sent! ID: '+r.reportId:'Sent!';}).catch(function(){if(wbSt)wbSt.textContent='Could not reach server — check your network connection.';}); }; document.getElementById('cg-wb-close').onclick=function(){wb.remove();}; }else if(wgl.software){ /* Software rendering: show a non-blocking amber warning badge */ var sw=document.createElement('div'); sw.id='cg-sw-badge'; sw.style.cssText='position:fixed;bottom:32px;right:16px;z-index:9999;background:#78350f;border:1px solid #f59e0b;border-radius:6px;color:#fde68a;font-size:11px;font-family:monospace;padding:6px 10px;pointer-events:none;'; sw.textContent='⚠ Software rendering ('+wgl.renderer.slice(0,30)+')'; document.body.appendChild(sw); setTimeout(function(){if(sw.parentNode)sw.remove();},8000); } setTimeout(function(){ if(window.__appInitialized)return; var errs=window.__earlyErrors; var info={timestamp:new Date().toISOString(),userDescription:null,browserInfo:{browserName:(navigator.userAgent.match(/Chrome|Firefox|Safari|Edge|Opera/)||['Unknown'])[0],platform:navigator.platform||'Unknown',screenResolution:screen.width+'x'+screen.height,language:navigator.language},systemInfo:{hardwareConcurrency:navigator.hardwareConcurrency||0},graphicsInfo:{renderer:wgl.renderer||'N/A (pre-init)',vendor:wgl.vendor||'N/A',webglAvailable:wgl.available,softwareRendering:wgl.software},sceneState:{activeContainer:null,containerType:null,cameraMode:null},telemetry:{fps:null,frameTimeMs:null,objectsLoaded:0},consoleErrors:errs.slice(0,50),userAgent:navigator.userAgent}; var ov=document.createElement('div'); ov.id='cg-emergency-modal'; ov.style.cssText='position:fixed;inset:0;z-index:999999;background:#07080e;color:#e2e8f0;display:flex;flex-direction:column;align-items:center;justify-content:center;font-family:monospace;padding:32px;box-sizing:border-box;border:4px solid #ef4444;'; var errPreview=errs.length?'

'+errs.slice(0,5).map(function(s){return s.replace(//g,'>');}).join('\n')+'

':''; var webglNote=!wgl.available?'

⚠ WebGL was not available when this page loaded.

':wgl.software?'

⚠ Running in software rendering mode.

':''; ov.innerHTML='

Cosmos Genesis failed to load

The application did not initialise within 5 seconds.

'+webglNote+'

Browser: '+navigator.userAgent.slice(0,100)+'

Screen: '+screen.width+'x'+screen.height+'

Errors captured: '+errs.length+'

'+errPreview+'

'; document.body.appendChild(ov); var st=document.getElementById('cg-em-st'); document.getElementById('cg-em-send').onclick=function(){if(st)st.textContent='Sending…';fetch(API+'/bug-reports/submit',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify(info)}).then(function(r){return r.json();}).then(function(r){if(st)st.textContent=r.reportId?'Sent! ID: '+r.reportId:'Sent!';}).catch(function(){try{var m='mailto:support@cosmosgenesis.com?subject=Bug+Report+Emergency&body='+encodeURIComponent(JSON.stringify(info,null,2).slice(0,2000));if(st)st.textContent='API failed — opening email…';window.open(m);}catch(e2){if(st)st.textContent='API and email failed — use Copy or Download.';}});}; document.getElementById('cg-em-copy').onclick=function(){navigator.clipboard.writeText(JSON.stringify(info,null,2)).then(function(){if(st)st.textContent='Copied!';}).catch(function(){if(st)st.textContent='Clipboard unavailable — please Download instead.';});}; document.getElementById('cg-em-dl').onclick=function(){var b=new Blob([JSON.stringify(info,null,2)],{type:'application/json'});var u=URL.createObjectURL(b);var a=document.createElement('a');a.href=u;a.download='cg-emergency-report-'+Date.now()+'.json';a.click();URL.revokeObjectURL(u);if(st)st.textContent='Downloaded!';}; document.getElementById('cg-em-close').onclick=function(){ov.remove();}; },TIMEOUT); })();

REST API Reference