# Vehicle assets

## Playable Roadster

`roadster.glb` — modeled for this project in Blender from the user's front, rear
and side references and the [reveal photo gallery](https://electronmotion.com/2026/10/15/tesla-roadster-reveal/).
This is a newly generated mesh, not a downloaded Tesla model. Reference photographs
are not embedded in the GLB. Dimensions are estimated from the images.

The optimized export contains 38,631 triangles and six materials. Wheel and wing
pivots, paint and trim-specific thrusters remain independently controllable.
See [`outputs/roadster-v2/README.md`](../../outputs/roadster-v2/README.md) for the
editable Blender source, scripts and validation details.

## Cybertruck

`cybertruck.glb` — **Cybertruck**, by **Mobolaji**, downloaded 2026-10-16.

- Source: https://poly.pizza/m/Jpar3f32mt
- Author: https://poly.pizza/u/Mobolaji
- License: Creative Commons Attribution 3.0 Unported, https://creativecommons.org/licenses/by/3.0/
- Original download: https://static.poly.pizza/bd53628e-9ef8-4809-a8e1-8aa680186d0f.glb

The source GLB is unchanged. At runtime we recenter and resize the mesh to gameplay dimensions (5.7 m long, 2.1 m wide, 1.9 m high), bake mirrored transforms, consolidate materials for instancing, brighten lights, and deform the struck instance. These are game adaptations, not manufacturer specifications. Attribution is also linked from the title screen.

## Model 3 Highland (2024)

`model-3-highland.glb` — **2024 Tesla Model 3**, by **RBLXSupercars** (author recorded in the source GLB), downloaded 2026-10-16.

- Original model: https://sketchfab.com/3d-models/2024-tesla-model-3-fd22be415215453693d67e33aa7812d0
- Download listing, uploaded by **brandonleong28**: https://sketchfab.com/3d-models/tesla-model-3-2024-36c52f3f89f6439c90310f14e8ff33f2
- License: Creative Commons Attribution 4.0 International, https://creativecommons.org/licenses/by/4.0/
- Source GLB copy: https://raw.githubusercontent.com/erictfree/Carbon-Footprint-AI-Visualizer/af4bef33ca371b24c1f043486f09a13571f4919b/models/tesla-model-3-2024/source/2024_tesla_model_3.glb
- Source SHA-256: `6ef6933d93ee0812d4049446a38e9b46273cab03b21be1e2ef1d502eccdb684b`

Adapted to a 4.7 × 2.02 × 1.44 m gameplay envelope, rotated to face -Z, simplified to 22,862 triangles and separated into body, trim, glass and lights. Texture detail is baked into vertex colors; paint and lights are adapted at runtime. The original model listing may be unavailable; the author and license remain recorded in the source GLB.

## Model Y Juniper (2025)

`model-y-juniper.glb` — **2025 Tesla Model Y**, by **BloxBloger**, downloaded 2026-10-16.

- Source: https://sketchfab.com/3d-models/2025-tesla-model-y-619601e7800d418da5922c4fa7833f74
- License: **Creative Commons Attribution-NonCommercial 4.0 International**, https://creativecommons.org/licenses/by-nc/4.0/
- Converted GLB and material/axis preparation: **aditano / Tesla Studio**, https://github.com/aditano/tesla-studio/tree/dc4a2ec1ae9ed61ddcb885c03d84214be51cb083/public/models/juniper
- Source GLB copy: https://raw.githubusercontent.com/aditano/tesla-studio/dc4a2ec1ae9ed61ddcb885c03d84214be51cb083/public/models/juniper/model.glb
- Source SHA-256: `0813f6f75ead4a7713cab819114802eda86ce2668140554e0f0c233fa65805c2`

**Noncommercial use only. Replace this asset or obtain the author's permission before commercial use of the game.** Meshopt compression was unpacked for Blender. Adapted to a 4.75 × 2.12 × 1.62 m gameplay envelope, simplified to 39,267 triangles and consolidated into four rendering parts. Body and glass surfaces retain their original topology; most reduction comes from wheel and trim detail. Original material colors are baked into vertex colors; body paint, glass and lights are adapted for the game.

## Tesla Semi

`tesla-semi.glb` — **Tesla Semi**, by **Aleksei Rozumnyi**, downloaded 2026-10-16.

- Source: https://sketchfab.com/3d-models/tesla-semi-39ffc7c746184e0c9ebd5bbcd0b405dd
- License: Creative Commons Attribution 4.0 International, https://creativecommons.org/licenses/by/4.0/
- Credited source repository: https://github.com/wass08/r3f-3d-slideshow/blob/999289d77623b8e9f872a8f712338eb01a9163e9/README.md
- Source GLB copy: https://raw.githubusercontent.com/wass08/r3f-3d-slideshow/999289d77623b8e9f872a8f712338eb01a9163e9/public/models/semi_scene.glb
- Source SHA-256: `d7138e200a70c9dc40ec20401556f92f6fbccc88649ece15d077830e869cad71`

The trailer, trailer wheels, cones and barriers were removed. The tractor was rotated, simplified to 19,994 triangles, consolidated into four rendering parts and resized to 7.8 × 2.4 × 3.1 m. The cab occupies the front 3.6 m to match the existing collision shape. The chassis skirt is narrowed to expose the rear axles, and wheels retain circular profiles on the lengthened deck. Colors and lights are adapted for gameplay; the struck instance uses local mesh deformation.

## Rebuilding the adapted assets

All dimensions above are game adaptations, not manufacturer specifications. Original downloads are not bundled; use the pinned source links and checksums above. These commands were verified with Blender 5.2.2 and the project's installed Three.js decoder. Run from the repository root after saving source files outside `public/`:

```sh
node scripts/unpack-meshopt.mjs /tmp/roadster-juniper-source.glb /tmp/roadster-juniper-unpacked.glb
blender --background --factory-startup --disable-autoexec --python scripts/prepare-traffic-model.py -- highland /tmp/roadster-highland-source.glb public/models/model-3-highland.glb
blender --background --factory-startup --disable-autoexec --python scripts/prepare-traffic-model.py -- juniper /tmp/roadster-juniper-unpacked.glb public/models/model-y-juniper.glb
blender --background --factory-startup --disable-autoexec --python scripts/prepare-traffic-model.py -- semi /tmp/roadster-semi-source.glb public/models/tesla-semi.glb
```

On macOS, use `/Applications/Blender.app/Contents/MacOS/Blender` if `blender` is not on PATH. `npm test` loads the actual adapted GLBs and checks their parts, colors, triangle budgets and collision envelopes.

This is an unofficial fan project, with no affiliation to or endorsement by Tesla or the model authors. Credits are linked from the title screen.
