Frequently Asked Questions

Here are answers to the most common questions regarding the BioSim Next-Gen simulator.

❓ General Questions

Q: Why is the simulation completely client-side?

A: Building it client-side ensures that the simulation runs instantly for anyone on GitHub Pages without requiring a paid server backend. Three.js does all the rendering in the browser, and the crew AI runs inside a local JavaScript loop.

Q: How do I change the crew archetype variables?

A: You can modify the crew properties and behavior metrics in js/app.js. Look for the initializeCrewFromSelection function to adjust baseline stress, metabolic rates, and roles.

Q: Can I run this offline?

A: Yes! The simulation page only uses CDNs for Three.js and OrbitControls. Once loaded, it can run offline. You can also run the local launcher via python3 serve.py.

🛠️ Troubleshooting

Q: The 3D view is blank or laggy. What should I do?

A: Ensure your browser has WebGL enabled and hardware acceleration turned on in your browser settings. Large viewport resolutions (such as 4K screens) may experience lower framerates on older GPUs.

Q: The iframe on the homepage does not load.

A: Check if your browser or an adblocker is blocking iframe embeds. You can always run the simulation in full screen by clicking the “Launch full-screen simulation” link or navigating directly to /sim.html in your address bar.