Jogo de Carro
A pixel-art endless runner on a five-lane road: dodge traffic, stones, potholes and rolling logs, grab coins and power-ups and survive until the clock runs out.
▶ Play it in your browser: jogo.pericles.dev.br
Originally a 2022 team project at IFAL (Instituto Federal de Alagoas), rebuilt in 2026 on Python 3.14 and pygame-ce with new art, synthesized music, tests and cross-platform releases. The UI is in Brazilian Portuguese.
Play
In the browser: open jogo.pericles.dev.br, create an account (email or Google), pick a nickname and press Jogar. Runs there count for the public ranking, and you can add friends to race them live or challenge their recorded runs. It is made for a computer with a keyboard or a gamepad; the first load downloads the game (a few seconds).
Download: grab the zip for Windows, macOS (Apple Silicon) or Linux from Releases, unzip it and run jogo-de-carro (jogo-de-carro.app on macOS). The builds are not code-signed, so the first launch needs More info → Run anyway on Windows. On macOS, open the app once, then allow it in System Settings → Privacy & Security → Open Anyway (or run xattr -dr com.apple.quarantine jogo-de-carro.app).
From source (Python 3.12+, developed on 3.14; on Windows use py instead of python3):
git clone https://github.com/periclesanfe/jogo_de_carro.git
cd jogo_de_carro
python3 -m venv .venv && source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -e .
jogo-de-carro # or: python -m jogo_de_carro
Controls
| Action | Keyboard | Gamepad |
|---|
| Change lane | A D / ← → | Left stick / D-pad |
| Move up and down | W S / ↑ ↓ (hold up for +15% score) | Left stick / D-pad |
| Confirm | Enter / Space | A |
| Back / pause | Esc / P | B / Start |
| Give up the run | R | |
| Mute / fullscreen | M / F11 | |
Menus also work with the mouse, and there is a clickable pause button in the race HUD.
Modes
The four difficulties keep the win times of the 2022 version. Normal is the default.
| Mode | Survive for | Road |
|---|
| Fácil | 1:30 | Cars, stones, potholes and cones; vans and rolling logs later on; up to 2 lanes blocked per row |
| Normal | 3:00 | Adds vans, rolling logs and trucks as the run goes on; up to 3 lanes blocked |
| Difícil | 4:30 | Everything from the start, higher top speed; up to 4 lanes blocked |
| Infinito | 30:00 (the run cap) | Speed keeps climbing; 4 lanes can be blocked after 2:00 |
Features
- 68 cars, each with a record of its own, picked on a turntable in the garage: six free, and 62 paid ones from 300 to 8,000 coins (famous cars such as Herbie 53, DeLorean, KITT, Relâmpago McQueen, Batmóvel and Optimus Prime, Brazilian classics such as the Opala and the Brasília Amarela, oddities such as the sofa on wheels, eight motorbikes, from the delivery moto to Akira's, Tron's light cycle and the Ghost Rider's, and nine special paint jobs), bought in the garage with the coins online runs pay. The server keeps the wallet and the cars; every car races with the same hitbox.
- Contra o bot: the same road side by side against a FÁCIL, MÉDIO or DIFÍCIL bot; whoever lasts longer wins, then points decide. It sets no records.
- A spawner that always leaves a reachable free lane, sized for the lane-change time at the current speed and kept close to the lane you are in; a test checks 10,000 rows per mode with an independent solver.
- Traffic that signals with a blinker before changing lanes, logs that roll across lanes, potholes that only hurt in the middle.
- Coins, near misses (dodging at the last moment) that build a combo up to x5, and six power-ups that share one slot: ESCUDO (absorbs one hit), ESTRELA (smashes what it touches), FANTASMA (drives through everything), TURBO (the world runs 1.5x, protected), DEVAGAR (the world at half speed while you steer in real time) and VIDA EXTRA (keeps one hit, one per run). Infinito draws only the protecting ones.
- Scenery that changes every kilometre: Campo, Deserto, Neve, Cidade à noite and Vulcão. Reaching N km in one run unlocks the N-th, which the garage's CENÁRIOS tab can pick as the start. It is only scenery: the road, obstacles and score are the same in all.
- Countdown, slow-motion crash with screen shake and sparks, a victory lap with confetti, pause with a blurred backdrop.
- Best score per mode and per car saved as JSON in the user data folder; a corrupt save falls back to defaults.
- Fixed-step simulation (120 Hz) inside an async main loop, so the same code runs in the browser (pygbag).
Screenshots
What changed in v2
| 2022 | 2026 |
|---|
| Runtime | Python 3.10, Pygame 2.1.2 | Python 3.14, pygame-ce 2.5.8 |
| Code | 806 lines, global state in config.py, screens that call each other recursively | A package with a scene stack, a fixed-step loop, no mutable globals, type hints |
| Art and audio | Sprites drawn in Piskel, MP3 music | Pixel art, sound effects and music generated by tools/make_assets.py, keeping the six car colors and the flaming-tire icon |
| Gameplay | Dodge obstacles, survival timer | Adds lane tweening, a fair spawner, coins, shield, near-miss combos, signalling traffic, countdown, pause, records, gamepad |
| Quality | No tests | pytest suite, Ruff, GitHub Actions |
| Distribution | A ~110 MB Windows build committed to the repository | Zipped builds for Windows, macOS and Linux attached to each release |
The 2022 code is still in the git history (up to commit 7f1a41b).
This is the beginning of the README. Read the rest at the original. Read the full README ↗
