FAQ

Why is the scene blank when I start Darksun?

The Three.js scene waits for the physics worker to send the first snapshot. This usually takes a few seconds while assets load. If the canvas stays blank, check the browser console for shader or SharedArrayBuffer errors.

How do I update the documentation URL?

Set VITE_DOCS_URL in .env.local and restart the dev server. The top-bar Docs button opens whatever URL you configure.

Can I run missions without an internet connection?

Yes. Once dependencies and asset packs are installed, Darksun runs entirely offline. The AI copilot is the only feature that requires network access.

What range does the time warp control support?

The time-warp popover accepts values between 0.1× and 10,000,000×. Higher speeds are marked as experimental because worker snapshots arrive less frequently at those rates.

How precise are the physics models?

With IAS15 and full perturbations enabled, Darksun achieves machine-level energy conservation for long-duration missions. See the Physics Models page for details.

Can I import external ephemeris or spacecraft models?

Yes. Place additional ephemeris files in the data directory referenced in vercel.json, and add spacecraft models to public/3d_models/spacecraft. Re-run pnpm generate:spacecraft-manifest to include new assets.

Where are mission plans stored?

Mission planner scripts and window layouts are saved in browser storage. Use the Share window to capture the current session URL if you need to move a scenario to another machine.

Copilot says it cannot access a tool. What now?

Confirm that the Copilot service is connected (Stack Auth login) and retry the request. If the issue persists, check the browser console—tool execution errors are logged there.

How do I report bugs or request features?

Use the GitHub issue tracker linked in the footer. Include steps to reproduce, logs (if applicable), and screenshots or exported telemetry to help triage.