Repository navigation
Releases
0.10.2
Custom palettes
Beside the eighty built-in palettes, you can now make your own: four colors, darkest to lightest,
each set by its red, green and blue from 0 to 255.
Press Down on the Palette screen to open the palette editor. Each of the four shades has a row with
its three values and its color beside them. Press A on a value to edit it: Left and Right pick the
hundreds, tens or ones, Up and Down step the value, A keeps the change and B puts the old value back.
Every change is saved as you make it.
Ninety-nine preset slots keep your palettes. The preset selector picks a slot, and load preset,
save preset and clear preset act on it, asking first wherever a change can't be taken back.
An asterisk beside the editor's title means the palette you're editing has changes no slot holds.
Hold Select in the editor to see the palette as the game will draw it: the seven pieces, text as
selected, unselected and dimmed, and the brick wall beside the well. Let go and the editor is where
you left it.
Saved palettes join the Palette screen's selector after palette 80, as C01 to C99, and are chosen
the same way as the built-in ones.
Existing settings and top scores carry forward untouched. No custom palette is in use until you
choose one.
Windows: the download is unsigned, so SmartScreen will warn about an unrecognized publisher.
Choose More info → Run anyway. Signing is coming in a later release.
Kirpich contains no playable copyrighted content. On first start it asks for your own Game Boy
Tetris ROM.
0.10.1
This is an older release. You can find the latest release here
Rebindable controls
Each of the Game Boy's eight buttons — Up, Down, Left, Right, A, B, Start and Select — takes a
keyboard key and a controller button of your choosing. A moved button carries both of its meanings,
so moving A moves the clockwise rotation and the menu's confirm together.
The controls screen lists the eight buttons with a key column and a pad column. Choose a cell and
press the key or button you want; one another button already holds swaps with it, and Escape leaves
the binding as it was. Controller buttons are bound by where they sit on the pad and named as your
pad prints them. Restore defaults puts every binding back, after asking, and is dimmed while there
is nothing to restore.
The defaults are the controls every earlier release shipped, so nothing changes until you change it.
Settings, page one
The first settings page now reads Display, Palette, Controls and Exit Game. Display
holds fullscreen and the window size. Palette holds the palette selector with a swatch of its four
colors and the seven pieces drawn in it, so you see the game's own art in a palette before you leave.
Existing settings and top scores carry forward untouched.
Windows: the download is unsigned, so SmartScreen will warn about an unrecognized publisher.
Choose More info → Run anyway. Signing is coming in a later release.
Kirpich contains no playable copyrighted content. On first start it asks for your own Game Boy
Tetris ROM.
0.10
This is an older release. You can find the latest release here
Statistics
New: Kirpich now records stats as you play. Recording is always on — a settings switch, off by default, adds a stats item to the title screen.
Five branches: all-time totals, and one per mode with a picker that moves the figures under it. Each
combination keeps its own rounds, time, drops, score, lines by kind, the seven piece counts, and the
longest single round.
Because recording does not wait for the switch, you can leave it off, play for a month, and turn it
on to find that month already counted.
Attract-mode rounds are not counted. Quitting mid-round still records the round.
Achievements
Thirty-six across nine sections, reached from the stats menu. Badges are drawn from the game's own
art and shaded by whether they are earned; Pressing A on one gives its description, the date it was unlocked,
and your play time at that moment. A round that earns something shows each one on the way out.
The current achievements in Kirpich are inspired by RetroAchievements — the idea
itself and their sense of what is worth rewarding in this game. Nothing is taken from their
implementation: every condition is written against this port's own recorded statistics, and the
names, the descriptions and the badge art are original. Kirpich is not affiliated with
RetroAchievements and does not connect to their service.
Heart mode
The cartridge's faster gravity, hidden behind holding Down at Start. Kirpich's title screen had taken
that input for its menu, so the mode was unreachable in every release before this one.
Select on the title screen toggles it. The cursor becomes a heart while it is on, and a heart sits
beside the difficulty heading and beside the level in play. It stays on until you turn it off.
Heart rounds keep separate top scores and separate statistics. Once you have played one, the
statistics gain an all / normal / heart filter.
Resets
The settings gain a page of four: high scores, statistics, achievements, or all three. Each asks
first and clears only what it names.
Fixes
- A C-Type round that flew the rocket returned to the A-Type difficulty screen, and a new C-Type top
score entered its name over A-Type's leaderboard. Both now go to C-Type. - B now backs out of the game-type screen to the title. It was the one selection screen with no way
back, so leaving it meant playing a round.
Existing settings and top scores carry forward untouched.
Windows: the download is unsigned, so SmartScreen will warn about an unrecognized publisher.
Choose More info → Run anyway. Signing is coming in a later release.
Kirpich contains no playable copyrighted content. On first start it asks for your own Game Boy
Tetris ROM.
0.9.5
Important
This is an older release. Download the latest release for heart mode, achievements, gameplay statistics, configurable controls, and custom palettes
C-Type picks a Rise
A C-Type round is now picked as a level and a rise: six values — 16, 14, 12, 10, 8, 6 — easiest first. The rise is how many drops the floor waits before it comes up. Every level × rise pairing keeps its own top-score table.
Existing C-Type top scores are kept: they move to the Rise 10 slot, which is the pace every round played before this release ran at. The move happens on first launch, automatically.
Fixes
- The settings pages' page-up arrow now sits above the heading, where it reads as "there is another page" — over the text it read as the text scrolling.
Kirpich contains no playable copyrighted content. On first start it asks for your own Game Boy Tetris ROM.
0.9.4
This is an older release. You can find the latest release here
Type C keeps what you earn. The rise count is no longer capped at the interval: lines cleared beyond it bank, up to the two digits the panel shows, so a good stretch buys real room before the floor comes up.
Eighty colour palettes, thirty-two more than before. Every new one keeps a real colour in its darkest shade, no two are alike, and many cross from one hue to another on the way up — kingfisher, melon, poison, harbor dawn, synthwave.
An enhancements page. The settings screen's second page is named for what it holds, and every row on it opens a screen of its own: the ghost piece explains itself beside its switch, and a new fixes screen offers the cartridge's own quirks back — off by default, so the game stays faithful until you ask otherwise.
The first fix: the title keeps its music. On the cartridge, one attract demo silences the title screen for the rest of the session. Turn the fix on and the music returns when a demo ends.
The paused screen's RISE count is live. Pausing a Type C round shows the count as it stands, not the number the round started with.
Your saves carry forward. Settings and high scores from earlier versions are read and kept.
As before: the game asks for your Tetris ROM on first launch and reads its graphics and sound from it.
0.9.3
This is an older release. You can find the latest release here
A third game type. Type C is a marathon played over a rising floor. A count of drops sits on the panel under RISE: every drop takes one off it, every line you clear puts one back, and when it reaches zero the whole stack shifts up a row while a fresh line of garbage arrives underneath. One line per drop is breaking even. It has its own screen, its own starting level and its own high-score table, and it sits behind a settings switch that is off by default.
Sixteen new colour palettes, for forty-eight in all. The new ones keep a real colour in their darkest shade instead of bottoming out at black. That shade is what the well's walls and every locked block are drawn in, so it is most of what you look at.
Leaving is easier to find. Exit game now asks where you are going — back to the title screen, or out to the desktop — and B backs out of the question.
Your saves carry forward. Settings and high scores from earlier versions are read and kept.
As before: the game asks for your Tetris ROM on first launch and reads its graphics and sound from it.
0.9.2
This is an older release. You can find the latest release here
The falling piece can cast a shadow where it will land — the ghost piece. Off by default; turn it on from the settings screen's second page. It changes nothing about how a round plays.
Eight new colour palettes, for thirty-two in all: the eight schemes Windows 3.1 shipped in its Control Panel, named as it named them — Hot Dog Stand included.
Your saves carry forward. Settings and high scores from 0.9.0 and 0.9.1 are read and kept.
Downloads are now archives — the Linux and Windows builds ship as zips holding a single folder, and the Linux executables arrive ready to run. macOS remains a signed, notarized disk image.
As before: the game asks for your Tetris ROM on first launch and reads its graphics and sound from it.
0.9.1
This is an older release. You can find the latest release here
Fixes the v0.9.0 hang a Game B win could reach: the dancers screen now leaves for the point tally (or the launch) when its jingle ends, instead of holding forever.
First launch still asks for your own Game Boy Tetris ROM — nothing copyrighted ships here. Source is public — git clone --recursive, build with CMake. AGPL-3.0.
0.9.0
First public release.
This is an older release. You can find the latest release here
Game Boy Tetris, rebuilt as native C++ — runs directly on Windows, macOS, and Linux, no emulator.
What's in it
- The complete single-player game: menus, play, line clears, scoring
- High scores that survive between launches
- The attract-mode demo, and both bonus endings
- A settings screen — fullscreen, window size, 12 colour palettes
Not yet: two-player.
Getting started: grab your platform below. First launch asks for your own Game Boy Tetris ROM and extracts the graphics and sound from it — nothing copyrighted ships here.
Source is public — git clone --recursive, build with CMake. AGPL-3.0.