Vulcan native 3D engine
  • Zig 89.2%
  • GLSL 8.8%
  • Python 1.3%
  • C 0.6%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-09-04 17:21:58 +02:00
assets project cleanup - no NPCs, just cars 2026-08-30 18:09:57 +02:00
blender project cleanup - no NPCs, just cars 2026-08-30 18:09:57 +02:00
deps water update 2026-08-18 01:19:42 +02:00
docs upd 2026-08-30 18:46:51 +02:00
games project cleanup - no NPCs, just cars 2026-08-30 18:09:57 +02:00
shaders project cleanup - no NPCs, just cars 2026-08-30 18:09:57 +02:00
src project cleanup - no NPCs, just cars 2026-08-30 18:09:57 +02:00
tools phase 7.4 2026-08-23 15:01:19 +02:00
track-zero-next readme: reference engine repo via https url 2026-09-04 17:21:58 +02:00
.clangd Box3D, new car, torus tracks 2026-08-26 01:03:34 +02:00
.gitignore no pkg 2026-08-19 21:21:35 +02:00
.gitleaks.toml phase 7.4 2026-08-23 15:01:19 +02:00
build.zig Box3D, new car, torus tracks 2026-08-26 01:03:34 +02:00
build.zig.zon upd 2026-08-12 03:41:13 +02:00
BUILDING.md cleanup 2026-08-15 15:51:34 +02:00
compile_flags.txt Box3D, new car, torus tracks 2026-08-26 01:03:34 +02:00
Editor_Construction_Plan.md phase 7 finished 2026-08-23 17:17:55 +02:00
embedded_assets.zig project cleanup - no NPCs, just cars 2026-08-30 18:09:57 +02:00
icon.ico cleanup 2026-08-08 21:31:15 +02:00
Plan_Handoff.md phase 7 2026-08-22 20:29:53 +02:00
pyrightconfig.json Box3D, new car, torus tracks 2026-08-26 01:03:34 +02:00
README.md project cleanup - no NPCs, just cars 2026-08-30 18:09:57 +02:00
track_zero.rc SD 2026-08-08 12:41:36 +02:00

Track Zero

A Zig/Vulkan driving sandbox and in-world terrain editor.

The project is focused on cars, procedural terrain, construction, roads, and collaborative world editing. It contains no enemies, creatures, NPC AI, weapons, shooting, combat, or invasion mode.

Features

  • Box3D-powered cars with suspension, gears, wheel input, and force feedback
  • Procedural terrain, roads, rocks, water, tunnels, and authored structures
  • In-world editor for terrain, materials, objects, roads, pipes, construction, and car playtests
  • Vulkan 1.3 renderer with ray-traced shadows, SSGI, volumetrics, and GPU-driven scene culling
  • Optional eight-player car/editor relay with shared patch leases
  • Data cartridge packaging for assets and shaders

Build

Requirements: Zig 0.16, Vulkan 1.3 ray-query support, and the vendored dependencies in deps/.

zig build            # retail package
zig build run        # build and run
zig build test       # client, game, protocol, relay, and editor tests
zig build server     # headless multiplayer/editor relay

See BUILDING.md for platform setup and packaging details.

Controls

Input Action
WASD / arrows Move or drive
F Enter or exit the nearest car
R Ignition
Q / E Shift gear
Space Handbrake
Tab Switch car or utility camera
~ Open the world editor
Home Open the admin panel
End Open wheel setup
F1 Help
F2 Audio
F11 Fullscreen
F12 Performance stats

Left click is used only by editor tools and utility marker placement; it has no fire action.

Layout

  • src/engine/ — platform, rendering, physics, audio, assets, and core utilities
  • src/game/sim/vehicle.zig — car simulation and rendering extraction
  • src/game/editor/ — world editor and car playtest tools
  • src/game/world/ — procedural and authored world systems
  • src/game/net/ — car/editor multiplayer protocol and client
  • src/apps/client/ — desktop application
  • src/apps/relay/ — multiplayer/editor relay
  • games/track-zero/game.toml — world, vehicle, wheel, visual, and asset profile