This is me playing with ammo.js and threejs to attempt a KISS 3D physics car sim. This is my nth attempt so don't expect too much...

• intro
  • load/save params to localStorage, reloading page (toggle shadows, map, quality, etc.)
  • present dialog with basic intro text
• car
  • play with car rig (dimensions, materials and params)
  • car mods and visuals (rally, offroad, bus)
  • EVENTUALLY gears/rpms and their overlays (more relevant once engine sounds exist)
• physics
  • basic contact collision
  • detect passing through waypoints ONGOING
• controls
  • support keys
  • support gamepad
  • support virtual gamepad with touch
  • reposition car, change cam
• camera
  • fixed point - (improve: have several world positions, pick closest to car)
  • onboard
  • chase cam
• GUI
  • basic velocimeter overlay
• sound generation
  • engine sound
  • braking
  • collisions
• eyecandy
  • decals
  • particle generation for dirt and/or smoke
• track
  • load from heightmap + texture map
  • load objects (trees, buildings, etc.)
  • parametric roads

• threejs docs
• bullet docs
  API,
  pdf SO [ammo.js] SO [bulletphysics]

npx http-server .

What triggered this was watching a twitch stream of some crazy Euro Truck Simulator 2 custom map (possibly promods?) where the bus was in the edge of rolling over. It's interesting that I started this experiment with fun in mind, assuming I would plateau super fast and drop it. Started from ammo.js examples, heavily refactoring them. Then started to tackle small objectives, trying to keep the game fun and stable. It's coming along great!

One thing that is helping a lot is using this lazy TypeScript inference with // @ts-check. (one has to open all relevant js and d.ts files and vscode does the rest). Imported/hacked some typings in global.d.ts.

One abstraction that has been paying off is abstracting input as a generic structure of axis and buttons (exposed in window.controller). Both keyboard, gamepad and virtual gamepad (via touch events) interfaces are updating this structure. TODO: Manage button up/down immediate events being polled in a simple manner.

• noise generation

  • https://github.com/josephg/noisejs

• texture loading

  • https://github.com/image-js/fast-png TODO (16 bit heightmap loading)

• helping samples and articles on ammo.js / bulletphysics

  • https://medium.com/@bluemagnificent/collision-detection-in-javascript-3d-physics-using-ammo-js-and-three-js-31a5569291ef

• d.ts

  • https://www.typescriptlang.org/dt/search?search=
  • https://github.com/kripken/ammo.js/blob/main/ammo.idl
  • https://github.com/giniedp/webidl2ts
  • https://github.com/giniedp/ammojs-typed
  • https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/three

• terrain/map generation

  • http://www.fracterra.com/wilbur.html
  • https://www.world-machine.com/features.php

• engine sounds

  • https://github.com/Antonio-R1/engine-sound-generator
  • https://antonio-r1.github.io/engine-sound-generator/src/engine_sound_generator/sounds_worklet.htm