An offline falling-blocks game for Android: climb 600 floors across 12 night-time districts, in three difficulties, every variant proven clearable.
Download · Features · Screenshots · How to play · Build · Architecture · Contributing
Block Night is a real-time falling-blocks game with a campaign. The city is a skyline of twelve districts, from Alfama to Parque das Nações. Each district is a tower of fifty floors, and each floor is a level with its own goal: clear lines, light up windows, dig through garbage, score a Quad or chain a combo, all within a piece budget. As you clear floors, the windows of the district light up on the home screen.
Every floor comes in Easy, Medium and Hard, and every one of the 1,800 variants ships with a solution certificate. An offline solver plays each variant with the same Kotlin engine that runs the game, and the build replays all the certificates. If a floor can no longer be cleared within its budget, the build fails.
A floor always deals the same pieces in the same order, so losing never changes your luck. The game has no network permission. There are no ads, no accounts and no analytics. Your progress stays on the device unless you export it.
Get the signed APK from the latest release and install it on a device running Android 8.0 or newer. You may need to allow installs from your browser or file manager.
Every release lists the SHA-256 of its APK. The APK is signed with this certificate:
CN=Tiago Correia, O=Block Night, C=PT
SHA-256: 8ddbca687d31f93928eb4d78a0247b232383c89ed1c1d46558cc2c9cda7d33fa
To check it: apksigner verify --print-certs block-night-<version>.apk
| 🏙️ Campaign | 600 floors in 12 districts of 50. Clear a floor to open the next one; one star is enough. Stars reward finishing in fewer pieces. |
| 🎯 Seven kinds of goals | Clear N lines, score N points, make Quads, make T-Spins, reach a combo, light every window, or clear all the garbage. |
| 🧱 Special cells | Garbage, concrete that cracks into garbage instead of clearing, lit target windows, garbage that rises every few pieces, and floors without Hold. |
| ⚖️ Three difficulties | Easy, Medium and Hard are separately tuned and certified variants with their own speed, piece budget and number of next pieces (5, 3 or 2). Each difficulty keeps its own progress. |
| 📅 Daily challenge | One certified floor per day and difficulty, chosen from the device date. No server involved. |
| ♾️ Free play | Marathon from level 1–10 up to 15, Sprint 40 against the clock, Ultra 2:00 for points, and Zen, where you never lose. |
| 🕹️ Modern rules | SRS rotation with wall kicks, 7-bag randomizer, Hold, ghost piece, lock delay, T-Spins (full and mini), back-to-back, combos and perfect clears. |
| ✋ Two control schemes | Touch gestures over the whole play area, or an on-screen pad with adjustable DAS and ARR. Both have a left-handed layout. |
| 🏆 Progress | Statistics per difficulty, records for each free mode, and local achievements. |
| 💾 Your data, your device | Matches are saved after every piece and resume exactly where you left off. Progress export and import go through the system file picker. |
| 🌍 Localized | English by default and Portuguese on Portuguese devices. |
The screenshots show the Portuguese interface. On other system languages the game runs in English.
 Home |
 District map |
 Another district |
 Playing a floor |
 Ghost piece and Hold |
 Floor cleared |
 Pause |
 Hard floor with garbage |
 Free play |
 Daily challenge |
 Statistics |
 Settings |
Pieces fall into a well 10 cells wide. Complete a row to clear it. Each floor tells you its goal at the top, and the number in the top right corner is how many pieces you have left. Reach the goal before the pieces run out or the stack reaches the top.
| Gesture | Action |
|---|---|
| Drag left or right | Move the piece one column at a time |
| Tap the right half of the board | Rotate clockwise |
| Tap the left half of the board | Rotate counter-clockwise |
| Drag down and hold | Soft drop |
| Quick swipe down | Hard drop |
| Quick swipe up, or tap HOLD | Hold the piece (once per piece) |
The whole play area takes gestures, so you can drag below or beside the board without covering it with your thumb. If you prefer buttons, switch Settings → Controls to Buttons for a pad with ← → ↓ ⟲ ⟳, Hold and Drop. The pad and the side column can be mirrored for left-handed play.
Back or the pause button pauses the match, and so does leaving the app. Resuming always starts with a 3-2-1 countdown.
You earn 1 star for clearing a floor, and 2 or 3 stars for clearing it within the floor's piece targets. The objective card always shows the best rating still within reach.
| Clear | Points × level |
|---|---|
| Single · Double · Triple · Quad | 100 · 300 · 500 · 800 |
| T-Spin · Single · Double · Triple | 400 · 800 · 1,200 · 1,600 |
| T-Spin Mini · Single · Double | 100 · 200 · 400 |
| Perfect clear (1–4 lines) | 800 · 1,200 · 1,800 · 2,000 |
Back-to-back Quads and T-Spins are worth ×1.5. Each consecutive clear adds a combo bonus of 50 × combo × level. Lighting a target window is worth 150 and cracking concrete 50 per cell.
| Tool | Version |
|---|---|
| JDK | 17 or newer (the project is built with JDK 21) |
| Android SDK | Platform android-37.1, build tools 37 |
| Gradle | Wrapper included (9.8.0) |
| Python 3 | Only for the optional scripts in tools/ |
No emulator is needed. The game logic is tested on the JVM.
git clone https://github.com/SyscallBrain/block-night.git
cd block-night
export JAVA_HOME=/path/to/jdk-21 # any JDK 17+
export ANDROID_HOME=/path/to/android-sdk # or create local.properties with sdk.dir=...
./gradlew :app:assembleDebug
adb install app/build/outputs/apk/debug/app-debug.apk./gradlew :app:assembleRelease builds an unsigned release APK. To sign it, define blockNight.release.storeFile, storePassword, keyAlias and keyPassword (all with the blockNight.release. prefix) in your own ~/.gradle/gradle.properties. Never commit them.
Every build checks the floor catalog first. It validates the 600 floors and replays all 1,800 certificates before packaging them, so the first build takes a little longer. Later builds reuse the result until something in content/ changes.
bash tools/verify.shThis runs the unit tests of all three modules, strict catalog validation, certificate replay, Android lint and the debug APK build. It reports the real exit code of each step and writes the logs to logs/.
flowchart LR
subgraph core [":core — pure Kotlin/JVM"]
E[Engine · SRS · 7-bag]
O[Objectives · Scoring · Snapshots]
P[Placements · Progress · Backup]
end
subgraph leveltool [":leveltool — CLI"]
B[build] --> V[validate] --> C[verify-certificates] --> X[export-assets]
end
subgraph app [":app — Android"]
S[GameSession · 60 Hz ticks] --> UI[Compose UI]
S --> D[(Profile and saved match)]
end
content[(content/<br>catalog · floors · certificates)] --> leveltool
core --> leveltool
core --> app
X -- "verified assets" --> app
| Module | Role |
|---|---|
core/ |
Deterministic rules engine with no Android dependencies: SRS rotation and kicks, a seeded 7-bag randomizer, gravity, lock delay, T-Spin detection, scoring, objectives, special cells, snapshots, progress reducers and backup parsing. |
leveltool/ |
Content CLI that uses the same engine to generate floors from structural families, solve them with a beam search, certify, rebalance, report and export the packaged assets. |
app/ |
Jetpack Compose UI, the real-time GameSession, gesture and button input, atomic saves, sound and haptics. |
content/ |
The floor catalog: 600 floor files and 1,800 certificates. |
tools/ |
Verification, sound generation and the floor-title script. |
fastlane/ |
Store listing (texts, icon, feature graphic, screenshots) used by F-Droid. |
Some design choices:
- One engine everywhere. The solver, the certificate checker and the game all run the same
:corecode, so a certified solution is replayed exactly as a player would play it. - Fixed 60 Hz ticks. The engine advances in discrete ticks with explicit commands. Frame rate never changes gravity, lock delay or scoring, and a match can be saved and restored exactly.
- The phone never solves. All the search happens at build time; the APK only ships floors that passed validation and replay.
- Crash-safe progress. The match is saved after every locked piece with atomic writes. An unreadable profile is kept aside and never overwritten silently.
Floors live in content/ as plain JSON, one file per floor with its three variants, and one certificate per variant.
./gradlew :leveltool:validateCatalog # structure, rules and counts
./gradlew :leveltool:verifyCertificates # replay all 1,800 certificates
./gradlew :leveltool:run --args='report --root content --output report.md'build generates and certifies floors from structural families, for a whole district or a range of floors. Run ./gradlew :leveltool:run without arguments to see every command and option.
Block Night declares a single permission, VIBRATE. It has no internet access, collects no data and contains no third-party SDKs. Progress is stored in the app's private storage and is excluded from cloud backups. Exporting or importing progress happens only when you choose to, through the Android system picker.
Bug reports, translations and pull requests are welcome. Please read CONTRIBUTING.md first. It covers the development setup, coding conventions and the rules for changing floor content.
- Design and development: Tiago Correia
- Fonts: Figtree and Bricolage Grotesque, both under the SIL Open Font License (texts in
app/src/main/assets/licenses). - Sound effects: original tones synthesized by
tools/generate_sounds.py.
Block Night is an independent project and is not affiliated with or endorsed by The Tetris Company.
Released under the MIT License. Copyright © 2026 Tiago Correia.