A native pastel downhill tire game. Read the hill, pick a launch angle, and let it roll.
Version 0.6 playable beta, built with Godot 4.7.2 + Jolt at 120 Hz, Mobile renderer. Includes the complete title → course select → aim → roll → result → retry loop, 32 courses plus a tutorial, four worlds, four unlockable tires, daily rolls, local progress, settings, adaptive music and sound, and portrait/landscape layouts.
This is not a spec-complete store release. See FEATURE_STATUS.md for the remaining implementation and release gates, and MILESTONE.md for measured results.
On this machine, open build/macos/TREADFALL.app for version 0.6. It has an ad hoc local-testing signature. The TREADFALL-0.4.0-local.dmg installer is an older build. The previous notarized installer is retained as build/macos/TREADFALL-0.3.0-notarized.dmg. The source project also runs directly:
./tools/bootstrap.sh # macOS: pinned editor + official export templates
./tools/godot # play
./tools/godot --editor # editOn other systems, install the pinned Godot version and set GODOT_BIN to its executable. No package manager, runtime download, account, or network connection is needed by the game itself.
- Adjust Launch angle by dragging anywhere on the track or hill. Touching the track preserves your current angle; small finger jitter is ignored. Use the large − / + buttons for precise 0.1° steps. Releasing a drag keeps you in aim mode; tap Roll when ready.
- Each hill starts in a stabilized first-person tire view. Tap Course view (or V) for a closer overview that fits the full course above the controls; tap Tire view to return. Switching also works during a roll.
- Courses now include rolling crests, troughs, banked shoulders and a side-lane gap with a takeoff and a continuous center bypass. Boost pads carry speed; mud slows you; blue ice reduces grip; golden springs in Ember launch the wheel.
- Glass guards have marked openings. Shallow impacts rebound; sideways impacts at 4.8 m/s or more shatter the pane, cost some momentum and leave the edge exposed. Retry restores the walls. Land a gap jump or bank off glass for style.
- The short dotted launch guide stays on the ground. Gameplay fills the window, with no left control sidebar.
- During the roll, swipe left/right or use the nudge buttons. Two nudges, 0.5 s cooldown; a third attempt triggers TILT.
- Keyboard: ←/→ or A/D aim in 0.1° steps (hold Shift for 1°), or nudge during a roll; Space/Enter roll/retry; R retry; V switch view; Esc pause.
- Purist is available in the pause menu before launching. It disables nudges and awards three stars on a clear. Earn four stars in a world to open the next. Tires unlock at 0/3/8/16 total stars.
./tools/test.sh # asset ledger, units, real UI events, 20 runtime retries,
# win/miss hold and hazard lifecycle checks, plus 20 physics repeats in each of 3 fresh processes
./tools/test.sh --full # also 33 × 101 angles × 5 seeds, neutral bank + PNG heatmaps
./tools/godot --script tests/audio.gd -- --test # native music continuity
./tools/godot --script tests/glass_visual.gd -- --test # visible shatter/reset
./tools/godot -- --test --playtest
./tools/godot -- --test --perf # uncapped heaviest-course benchmark; exit fails above 16.6 ms p95
./tools/godot --headless --script tools/bake_course.gd -- meadow/01--test keeps the real save untouched. Reports and screenshots go in build/; this folder is excluded from git and exports. The solver fails on impossible hills, >50% angle-only clear rate on regular hills (>80% in the tutorial), a default launch winning on more than 20% of sampled seeds, any seed without a solution, or an unfinished simulation at the test-only 120-second observation limit. Gameplay has no roll timer. A tire that stays within a 12 cm radius for three seconds is BLOCKED; slow rolls that keep advancing continue. The dedicated level-3 regression reaches GOAL after 41 seconds. Both wins and misses freeze the tire and hold the camera. The solver uses the actual RollingTire scene behavior, not the reduced aim preview model.
Testing entry points:
./tools/godot -- --course coral/04 --state aim --seed 42 --aim 0.3 --view overview
./tools/godot -- --course neon/08 --state roll --seed 42
./tools/godot --resolution 450x800 -- --state aimThe optional baker writes an editable grayscale PNG and a terrain mesh/collider scene to build/baked. Feed its PNG back as a second argument to verify a round trip. Current shipped hills use the analytic low-poly heightfield at runtime; integrating an edited bake into production course metadata is a content-authoring follow-up.
./tools/export.sh macOS 0.5.0
./tools/sign-macos.sh build/macos/TREADFALL.app --dry-run
./tools/sign-macos.sh build/macos/TREADFALL.app --dmg
./tools/export.sh iOS 0.5.0
./tools/ios-simulator.sh
./tools/export.sh Windows 0.5.0
./tools/android.sh 0.4.0Godot and templates must both be 4.7.2. tools/export.sh records the git commit, build count, version and SHA-256. It verifies packaged bytes, including an observed Godot export issue that produced a zero-byte macOS executable: the verifier restores the byte-identical official universal release binary and fails if that binary is invalid. A successful engine exit alone is not treated as a working app.
The signing scripts were reused from ~/code/FloppyJam/scripts, as required. FoFoPedal and FoFoSoundBooster were absent; the available FoFoPedalVST setup was inspected. Credentials stay in the existing keychain/environment. --dry-run signs and verifies locally; it does not notarize. The second macOS command submits to Apple's notarization service and produces a stapled DMG. Windows Trusted Signing requires a Windows host, as in FloppyJam.
The iOS export is an Xcode project for com.sweetpapa.treadfall, team 6Y5SZ2K5XY. On this machine (Xcode 16.4), the supplied simulator library is x86_64 despite its dual-architecture manifest; the simulator script detects and builds that architecture. The app was installed and launched under the iPhone 16 Pro simulator. This does not establish performance, haptics, or installation on a physical iPhone. The iOS beta workflow now builds with Xcode 26.3/iOS 26.2, signs locally using the existing distribution identity, and uploads to TestFlight. A physical-device compile was also attempted: the engine arm64 object metadata identifies iOS SDK 26.1, and the installed Xcode 16.4/iOS 18.5 SDK cannot link its CADynamicRange/MTLTensorDomain references. tools/ios-device.sh checks for SDK 26.1+ and builds an unsigned arm64 release on a compatible host. Apple lists the required Xcode/macOS combinations.
Android builds require SDK platform 36, build tools and JDK 17 configured in Godot Editor Settings. tools/android.sh exports arm64 APKs, checks package contents, signs with a local test key stored in ignored .tools/, and verifies signatures and 16 KB library alignment. TREADFALL.apk is normal play; TREADFALL-playtest.apk has identical game bytes with automated launch arguments. Install through adb install -r and launch com.sweetpapa.treadfall/com.godot.game.GodotAppLauncher. Android uses the OpenGL compatibility renderer; the emulator's Vulkan presentation path failed during testing. The local signing key is not a Play Store release key. For store distribution, python3 tools/store/build-android.py creates an AAB and matching APK using the existing SPT upload key. Version 0.5.0 (15) passed exported-game and touch playtests and is saved on the closed alpha track as a draft. Google requires the remaining Play Console app setup before activation. See mobile release status.
For iOS simulator automation, launch with SIMCTL_CHILD_TREADFALL_PLAYTEST=1 xcrun simctl launch <device-id> com.sweetpapa.treadfall. This isolates save data and runs the game through both views, a complete roll, pause/resume, results, retry, settings and daily mode. Captures/report are in the app container's Documents/playtest/. The official x86 simulator template uses software OpenGL under Rosetta, so that environment uses a 480×1040 canvas and lighter 3D rendering. Physical iOS builds retain the normal renderer and native UI; simulator results do not establish phone performance.
Typed GDScript; no gameplay addons. src/core holds save/state support, src/course terrain and predictor, src/tire rigid-body behavior and four .tres variants, src/ui the adaptive interface, and src/audio, src/camera, src/feel, src/platform the presentation/platform layers. Each course has editable metadata and its own scene under courses/.
Kenney CC0 nature props and impact sounds, Google Fonts OFL Bungee/Nunito, and original procedural meshes, vector art, and synthesized music. All assets are shipped locally. ASSETS.md records each file's provenance and license; CREDITS.md includes the shipped notices.
Dependencies: Godot 4.7.2 provides rendering, Jolt physics, audio and exports; Python 3 and shell scripts provide local asset/build verification only. No third-party game plugins or analytics SDKs are included.
Release status and remaining Console steps. iPhone/iPad and native Android listing screenshots are in build/store/screenshots/ and uploaded to the existing store listings. No production release has been submitted.
