Gemme
An original match-3 puzzle game for Android, built with Godot: twenty levels with goals, special pieces and chain reactions, offline and without accounts.
Android
The idea
Gemme (Italian for “gems”) is the first game of a small collection of Android puzzle games I am building. It is a match-3: swap two neighbouring gems to line up three or more of the same colour, watch them vanish, and let the new ones fall into place, hoping for a chain reaction. The gems are drawn in code, with different shapes as well as different colours, so the board stays readable for colour-blind players.
The principles I set from the start for the whole collection: for teenagers and adults, offline and without accounts, Italian and English from day one, and a licence note for every asset. The code is open source under the MIT licence.
How it plays
- An 8×8 board and twenty levels, each with its own goal: reach a score, collect a number of gems of one colour, or create a given number of special pieces.
- A star rating for each level, based on how many moves you had left at the end.
- A level menu, and progress saved on the device.
- Special pieces that come from bigger matches:
- four in a line gives a piece that clears a whole row or column;
- five in a line gives a rainbow: swapped with a gem, it removes every gem of that colour;
- a 2×2 square, made by a swap, gives a piece that removes all the gems of one other colour, picked at random;
- an L or a T of five gives a bomb that clears the 3×3 square around it. Special pieces fire when they are cleared, by a match or by another effect, so they chain.
How it’s built
- Godot 4 with GDScript, exported to Android. One Godot project per game, plus a shared folder for what the games have in common (menus, saving, translations).
- The rules live in a pure logic file with no graphics: it resolves one step of a move at a time, so the same code serves the game, the tests and the tools.
- Headless tests check the rules, simulate a whole play-through and the touch input, and a bot plays every level to tune the difficulty: the goals are set from what the bot can reach, not by guessing.
- A layout that adapts to the screen, and a back button that behaves like on any other Android app.
Lessons so far
- Cascades can break the score. At first, squares formed by falling gems also created special pieces, and a first level worth about 2,900 points jumped to 23,000. Now only a square made by the player’s own swap counts.
- An ambiguous rule needs a decision. “A random symbol” could mean a single gem or a whole colour; I picked the colour and kept the choice written down, so it is easy to change.
- A test bot is a good game designer’s assistant. It shows at once when a level is too easy, or impossible.
Status
Work in progress since 17 November 2026: the game is playable on a real Android phone, with all twenty levels. Sound and music are on hold for now. Still to do before it can be released: a signing key and a developer account for the store.
Stack
Godot 4 · GDScript · Android