AI/tesla-stuntz
Watch
3
0
Fork
You've already forked tesla-stuntz
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
14 commits 1 branch 0 tags 14 MiB
  • Kotlin 98.8%
  • GLSL 0.9%
  • Python 0.3%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Adam Outler 9d6002d829
Some checks failed
Tesla Stuntz CI / build-and-test (push) Failing after 26s
Details
feat(physics): implement first-principles 3D free driving, arena grid pad, and contact shadow grounding
2026-10-21 15:04:16 -04:00
.gitea/workflows feat(tesla-stuntz): initial release with 60Hz physics, GLES 3.0 renderer, Compose HUD, all 4 game modes, and commercial licensing (TESLA-8..TESLA-11) 2026-10-17 15:22:09 -04:00
.github/workflows feat(tesla-stuntz): initial release with 60Hz physics, GLES 3.0 renderer, Compose HUD, all 4 game modes, and commercial licensing (TESLA-8..TESLA-11) 2026-10-17 15:22:09 -04:00
app feat(physics): implement first-principles 3D free driving, arena grid pad, and contact shadow grounding 2026-10-21 15:04:16 -04:00
core-physics feat(physics): implement first-principles 3D free driving, arena grid pad, and contact shadow grounding 2026-10-21 15:04:16 -04:00
core-renderer-gles30 feat(physics): implement first-principles 3D free driving, arena grid pad, and contact shadow grounding 2026-10-21 15:04:16 -04:00
docs feat(physics): implement first-principles 3D free driving, arena grid pad, and contact shadow grounding 2026-10-21 15:04:16 -04:00
feature-ui-compose feat(playground): complete replacement of time trial with 3D Stunt Playground and 110-scenario physics suite 2026-10-20 21:08:04 -04:00
gradle feat(tesla-stuntz): initial release with 60Hz physics, GLES 3.0 renderer, Compose HUD, all 4 game modes, and commercial licensing (TESLA-8..TESLA-11) 2026-10-17 15:22:09 -04:00
scripts feat(physics,renderer,ux): complete skill-based gameplay, camera stabilization, and visual overhaul 2026-10-17 23:59:06 -04:00
.gitignore feat(tesla-stuntz): initial release with 60Hz physics, GLES 3.0 renderer, Compose HUD, all 4 game modes, and commercial licensing (TESLA-8..TESLA-11) 2026-10-17 15:22:09 -04:00
build.gradle.kts feat(tesla-stuntz): initial release with 60Hz physics, GLES 3.0 renderer, Compose HUD, all 4 game modes, and commercial licensing (TESLA-8..TESLA-11) 2026-10-17 15:22:09 -04:00
GEMINI.md feat(tesla-stuntz): initial release with 60Hz physics, GLES 3.0 renderer, Compose HUD, all 4 game modes, and commercial licensing (TESLA-8..TESLA-11) 2026-10-17 15:22:09 -04:00
gradle.properties feat(tesla-stuntz): initial release with 60Hz physics, GLES 3.0 renderer, Compose HUD, all 4 game modes, and commercial licensing (TESLA-8..TESLA-11) 2026-10-17 15:22:09 -04:00
gradlew feat(tesla-stuntz): initial release with 60Hz physics, GLES 3.0 renderer, Compose HUD, all 4 game modes, and commercial licensing (TESLA-8..TESLA-11) 2026-10-17 15:22:09 -04:00
LICENSE feat(tesla-stuntz): initial release with 60Hz physics, GLES 3.0 renderer, Compose HUD, all 4 game modes, and commercial licensing (TESLA-8..TESLA-11) 2026-10-17 15:22:09 -04:00
NOTICE feat(tesla-stuntz): initial release with 60Hz physics, GLES 3.0 renderer, Compose HUD, all 4 game modes, and commercial licensing (TESLA-8..TESLA-11) 2026-10-17 15:22:09 -04:00
README.md feat(tesla-stuntz): initial release with 60Hz physics, GLES 3.0 renderer, Compose HUD, all 4 game modes, and commercial licensing (TESLA-8..TESLA-11) 2026-10-17 15:22:09 -04:00
settings.gradle.kts feat(tesla-stuntz): initial release with 60Hz physics, GLES 3.0 renderer, Compose HUD, all 4 game modes, and commercial licensing (TESLA-8..TESLA-11) 2026-10-17 15:22:09 -04:00

README.md

Tesla Stuntz

Native Android 3D stunt-racing game (Kotlin + Jetpack Compose + OpenGL ES 3.0) set in the SpaceX / Giga Proving Grounds, starring the Tesla Roadster (SpaceX Cold-Gas Thruster & Suction Fan Package).

Core Roadster Capabilities

  1. Auto-Activating Suction Fan & Smooth Wall / Ceiling Driving: Automatically engages when approaching smooth vertical walls or inverted ceilings, holding normal load until fanGripRemainingTicks depletes.
  2. Upside-Down Ceiling Driving: Full tire traction while inverted at 180° using a Rotation-Minimizing Bishop Frame (TrackSpline).
  3. Cold-Gas Thruster Spins & Electronic Tire-Landing Controller: High-speed mid-air barrel rolls and spins backed by a critically damped quaternion PD controller (AttitudeStabilizer) that ensures the Roadster always lands squarely on all four tires.
  4. Cold-Gas Thruster Jump & Mid-Air Vectoring: Instant vertical jump bursts, mid-air lateral shifts, forward boost, and passive cold-air COPV pressure recharge.
  5. Post-Landing Stability Impairment ("Computer Compensation"): After a thruster jump or boost touchdown, the vehicle experiences transient harmonic steering/attitude oscillation as the electronics compensate—upgradeable via Stability in the Workshop.

Game Modes

  • Mode 1 — Stuntz Trials: Deterministic, frame-reproducible proving-ground runs with timed telemetry prompts (THRUST JUMP, BARREL ROLL, VECTOR MOVE, FAN LATCH, BOOST) reproducing the signature Elon demo sequence and advanced stunt trials.
  • Mode 2 — Free Race: Multi-car circuit racing against conventional non-thruster AI supercars with configurable difficulty and opponent count.
  • Mode 3 — Stunt Mode: Predefined obstacle course with vertical wall climbs, inverted ceiling tunnels, barrel-roll chasms, stunt scoring, and a finish line.
  • Mode 4 — Giga Workshop: Upgrade 8 vehicle systems using earned credits: Fan Grip Time, Thruster Power, Thruster Regen, Wheels, Motor, Acceleration, Thruster Boost, and Stability.

Architecture & Modules

  • :core-physics: Pure Kotlin deterministic 60Hz physics, spline, AI, and game-mode engine.
  • :core-renderer-gles30: OpenGL ES 3.0 3D renderer and deterministic QA frame synthesizer.
  • :feature-ui-compose: Jetpack Compose SpaceX telemetry HUD, Timed Stunt Reticle, and Workshop UI.
  • :app: Android application entrypoint and end-to-end verification tests.