Oxidefall

Oxidefall is a falling-block puzzle game written in Rust. Its primary release is a static WebAssembly website rendered with eframe and egui. The same deterministic engine and interface also build as a native desktop app. An original adaptive industrial-electronic score and sound effects provide optional audio on both targets.

Run the website locally

Install the current stable Rust toolchain, the WebAssembly target, and Trunk:

rustup target add wasm32-unknown-unknown
cargo install --locked trunk
trunk serve

Then open http://127.0.0.1:8080. The production bundle is generated in dist/ with:

trunk build --release

The web release supports current desktop Chrome, Edge, Firefox, and Safari, plus current iOS Safari and Android Chrome. Phones use a purpose-built touch HUD in portrait or landscape; narrow keyboard windows use the same compact layout without touch controls. The official phone target starts at a 360 by 640 CSS-pixel screen. After browser chrome and safe-area insets, the playable canvas requires at least 320 by 500 logical pixels in portrait or 500 by 320 in landscape.

Run the native app

cargo run --release

The native build remains supported on macOS, Windows, and Linux. It keeps its session-only best score, while the primary web build stores the best score in the browser's local storage.

Controls

• Left and Right arrows: move
• Down arrow: soft drop
• Space: hard drop
• Up arrow or X: rotate clockwise
• Z: rotate counterclockwise
• C or Left Shift: hold
• Escape: pause or resume
• R: restart while paused or after game over
• M: mute or unmute sound

On touch devices, the lower controls provide Left, Soft Drop, Right, Hold, both rotations, and Hard Drop. Movement buttons support press-and-hold and sliding between directions. Hold and rotations fire on contact. Hard Drop fires only when the finger lifts inside its button, so sliding away cancels it. Every touch target is at least 48 by 48 CSS pixels, and independent contacts allow movement and rotation at the same time.

The mouse is used only for menus and overlay buttons. Losing focus, hiding the browser tab, or rotating a touch device automatically pauses the game and clears held input. Returning focus never resumes automatically. Ordinary mobile browser-toolbar resizing does not pause play.

The web title screen offers an optional Fullscreen action when the browser supports it, but normal in-browser play is the baseline. Reloading, closing, or navigating away abandons the active run without a confirmation dialog. Oxidefall has no accounts, analytics, cookies, service worker, or remote telemetry.

The speaker control opens separate Music and Effects sliders. M globally mutes or restores both without resetting the music timeline. Both volumes and the mute state are stored locally. Music starts with gameplay, follows level and stack danger, and suspends at the current position when the game pauses. Audio starts only after player interaction and never blocks gameplay.

Gameplay

Oxidefall uses a seven-bag randomizer, five-piece preview queue, hold, ghost piece, hard drop, soft drop, SRS rotation and kicks, modern scoring, combos, back-to-back bonuses, perfect clears, T-spins, and level-based gravity.

The engine runs at 60 simulation steps per second. Horizontal input uses engine-controlled delayed auto-shift and repeat timing, so operating-system keyboard repeat settings do not affect play.

See DESIGN.md for the complete rules and architecture.

Quality checks

cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test
cargo check --target wasm32-unknown-unknown
trunk build --release
python3 tools/check_web_bundle.py dist
npm ci
npx playwright install chromium
npm run test:web
python3 tools/generate_audio.py --check
python3 tools/generate_music.py --check

Run cargo run --features audio-lab to open the development-only soundboard. It previews individual cues, pitch and pan variants, compound scoring events, and every adaptive music tier. Regenerate the WAV effects with python3 tools/generate_audio.py. Regenerate the Ogg Vorbis music stems with python3 tools/generate_music.py; FFmpeg is preferred, with the repository's source-built Rust encoder available as a fallback.

The GitHub Actions workflow runs native quality gates, builds the release WebAssembly bundle, and exercises it in headless Chromium. Successful pushes to main or master deploy the static output to GitHub Pages. The repository must use GitHub Actions as its Pages source before the first deployment.

License

The source is available under either the MIT License or Apache License 2.0, at your option. See LICENSE-MIT and LICENSE-APACHE.

The source licenses do not grant rights to the Oxidefall name or branding. Generated sound effects, music stems, and composition data in assets/audio are separately dedicated to the public domain under CC0 1.0.

Saira Condensed ExtraBold and IBM Plex Mono Medium are bundled under the SIL Open Font License 1.1. Their license texts and source details are in assets/fonts.