Skip to content

BradPerbs/Helios

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Helios

A WebGL space scene you can fly through. Pilot a ship past nebulae, planets, and asteroid fields with ambient audio and a reactive engine soundtrack.

Helios preview

Live demo · open index.html in a modern browser (or serve the folder over HTTP).

Tech

  • Three.js 0.160.1 — WebGL renderer, GLTF models, scene graph
  • GLSL shaders — custom nebula, suns, particles, streaks, filaments, orb, ship
  • Post-processingEffectComposer with UnrealBloomPass + custom color grade
  • Web Audio API — ambient track + procedural engine audio driven by throttle/velocity
  • Pure ES modules via <script type="importmap"> — no build step, no bundler

Run locally

No install required. Just serve the directory:

# any static server works
npx serve .
# or
python -m http.server 8000

Then open http://localhost:8000.

Controls

  • Mouse — aim / look
  • W / S — throttle
  • A / D — roll
  • Scroll — zoom
  • Space / Shift — vertical

Structure

index.html              entry + importmap + UI
src/main.js             bootstrap, render loop, system wiring
src/controls.js         ship input + camera rig
src/ship.js             ship model + dynamics
src/engineAudio.js      reactive engine audio
src/audio.js            ambient audio
src/nebula.js           volumetric nebula
src/planets.js          planets
src/asteroids.js        asteroid field
src/particles.js        starfield particles
src/phoenix.js          phoenix planet GLTF
src/trail.js            ship trails
src/streaks.js          speed streaks overlay
src/postfx.js           bloom + grade
src/shaders/            GLSL for each system
src/models/             GLTF assets (see per-model license.txt)

Sponsors

Cloudblast.io - Cloud VM Hosting

Credits

  • 3D models — free assets from Sketchfab. License terms are in each model folder under src/models/*/license.txt.
  • MusicHelios the Cosmic Stage (the project's namesake).