Getting started
Learning paths through this topic
A phone call or crash while saving ruined the whole save file
If the app is killed at the exact moment it writes, the player may come back to an empty or broken save and lose everything. A simple habit of how the game writes and reads its save makes this survivable. Here is the small piece of logic to hand to your AI.
Players beat the best score I set for a level, what do I do with the stars?
Star ratings need a target number of moves, and the target you or a program found is sometimes not the real best. Players will find shorter ways and your stars then look silly. Here is a rule for the ratings that also notices when the target itself is out of date.
The store rejects my title or description for being too long
You count the letters, the store counts more, and the upload is refused at the last step. Emoji, line breaks and invisible characters are the usual reason. Here is a check your AI can run on all listing texts before you start the upload, written to be on the safe side.
The store says my new version is not newer than the old one
Stores want an ever-growing build number next to the version name people see, and they will not take a lower one, ever. Counting it by hand goes wrong sooner or later. Here is a way to derive the number from the version name, with the limits that make it fail early.
The store refuses my screenshots and I do not know why
Store screenshots must follow size and shape rules that are easy to break by accident, especially when they come from different devices or from an AI that renders them. Here is a check for a whole set at once, with a message per picture that says what to change.
Swipes are sometimes read as taps, or go the wrong way
A finger never moves in a perfectly straight line or stays perfectly still, so a game that compares two points naively mixes up taps, swipes and diagonal slips. Here is the set of rules your AI should use to tell them apart, and which doubtful cases to simply ignore.
The level timer keeps running while the player is in another app
A phone call or a message and the timed puzzle is lost, or the clock jumps by minutes when the player returns. Games must treat time away as paused time. Here is a stopwatch that survives pauses, and why one big frame step should never be allowed to count.
The undo button breaks the move counter or eats all the memory
Puzzle players love undo, and it quietly causes trouble: the move count goes wrong, redo shows moves that no longer fit, and long sessions grow without limit. Here is a small history your AI can drop in, with the rules for what undo and a new move must each do.
My word game marks repeated letters wrong, and German letters do not match
A guess with a letter twice, or an answer with a letter twice, is where hint colours go wrong in almost every first version. Capital letters, umlauts and the sharp s add their own surprises. Here is the two-pass method for the colours and a safe way to compare words.