01The game at a glance
- Every round has one secret code made of different digits, and all players try to crack the same code.
- A match has 2, 3 or 4 players and is best of three rounds.
- Players take turns guessing. After each guess, the player who made it gets private feedback on every digit. Everyone can see every guess, but only the guesser sees its feedback, unless an opponent uses the X-Ray Vision skill (New).
- The first player to guess the code wins the round.
- There are two difficulty levels, Standard and Hardcore. They differ in the feedback you receive and in the points a win is worth.
- With a guessIo account (sign-in with Google) you can play Casual and Ranked matches against other players, and Custom room matches with friends. Without an account you can play practice matches against the computer or against a friend on the same device.
- (New) Players can add friends, challenge them to Custom rooms, take on the Daily Challenge and pick a skill before online matches. Section 16 covers everything V2.0.0 added.
Getting started
- Sign in with Google and choose a username (§13).
- Pick a match type, a difficulty and the number of players.
- Crack the code before the other players do.
02How a match works
In online matches the game server runs the match: it generates the secret code, keeps the clock, evaluates every guess and decides the result.
2.1 The secret code
- The code is made of digits from 0 to 9, and no digit appears twice. A code can start with 0.
- Its length depends on the number of players: 4 digits for 2 players, 5 for 3 players and 6 for 4 players.
- A new code is generated for every round. Codes are created with a cryptographically secure random number generator.
- The code stays hidden while the round is played. It is revealed to everyone when the round ends.
2.2 Taking turns
- Players take turns in a fixed order for the round. The player who goes first changes every round: the opening seat moves along by one each round.
- On your turn you submit one guess. A guess must have exactly as many digits as the code, contain digits only, and use no digit twice. A guess that breaks these rules is rejected and your turn continues, so you can try again while time remains.
- Each turn lasts 30 seconds. When time runs out, the turn is skipped and play passes to the next player. Skipped turns are counted in your statistics.
- Only the player whose turn it is can guess.
- (New) Before an online match every player picks one skill, which can be used once on your own turn (§16.9).
2.3 Feedback
After each guess, the game tells you something about every digit of that guess.
- Standard feedback has three possible answers for each digit: the digit is in the right place, it is in the code but in a different place, or it is not in the code.
- Hardcore feedback hides position information. For each digit you only learn whether it is in the code or not in the code, so you have to work out the positions yourself.
Example: the secret code is 1234 and a player guesses
1352.
| Digit | Standard feedback | Hardcore feedback |
|---|---|---|
1 |
In the right place | In the code |
3 |
In the code, in a different place | In the code |
5 |
Not in the code | Not in the code |
2 |
In the code, in a different place | In the code |
Only the player who made a guess gets its feedback. Other players see the digits that were guessed, without the feedback, except when a player uses the X-Ray Vision skill, enabling that player to track any guesses the target makes for the remainder of that round from the moment of activation.(New) (§16.9). A guess that matches the code exactly wins the round.
2.4 The shared guess limit
All guesses made by all players in a round count towards one shared limit: 10 guesses with 2 players, 15 with 3 players and 20 with 4 players. Guesses are numbered in the order they are made. If the limit is reached and nobody has cracked the code, the round is a draw.
2.5 Rounds
- The first player to submit the correct code wins the round.
- When a round ends, everyone sees the secret code, who won the round, the score so far, how long the round took, and the fastest guess (the shortest time from the start of a turn to the guess being submitted).
- A short pause (5 seconds) follows before the next round starts.
- (New) After the final round of a match, the round result appears briefly, and then your match results open (§16.13).
- Before the first round, a short countdown (5 seconds) runs once the match has been found.
2.6 Winning a match
A match is best of three rounds, and the same rules apply with 2, 3 or 4 players. Round 1 never decides a match on its own. (A player leaving a match can end it earlier; see §9.)
- After round 2, if exactly one player has won more rounds than everyone else, that player wins the match.
- Otherwise (the lead is shared, which includes two drawn rounds), round 3 is played.
- After round 3, the player with the most round wins wins the match. If the lead is shared, the match is a draw.
Examples with two players, A and B:
| Round 1 | Round 2 | What happens |
|---|---|---|
| A wins | A wins | A wins the match |
| A wins | B wins | Round 3 decides |
| Draw | B wins | B wins the match |
| Draw | Draw | Round 3 decides |
| A wins | Draw | A wins the match |
03Ways to play
3.1 Match types
| Item | Casual | Ranked | Custom room (New) | Practice |
|---|---|---|---|---|
| Account required | Yes | Yes | Yes | No |
| Opponents | Other players. Computer-controlled players can fill empty seats (§4). | Same as Casual | Friends who join with your room code or accept your challenge invite (New). Never computer-controlled players. | The computer, or a second person on the same device |
| Players | 2, 3 or 4 | 2, 3 or 4 | 2, 3 or 4 | 2 |
| Difficulty | Standard or Hardcore | Standard or Hardcore | Standard or Hardcore | Standard or Hardcore |
| Points | Yes | Yes | No | No |
| Rating | Not affected* | Yes | No | No |
| Statistics, match history and achievements | Yes | Yes | No | No |
* A match that is cancelled for inactivity changes rating in both Casual and Ranked matches (§9.4).
- Casual is for practice against other players: points are awarded and rating does not change.
- Ranked puts your rating on the line (§8).
- Custom room (New) is a match with friends, joined with a room code or a challenge invite. Previously known as Private room (§5, §16.2).
- Practice runs entirely in your browser and needs no account (§6).
3.2 Difficulty
- Standard: feedback tells you which digits are in the right place and which are in the code but elsewhere. A win is worth 3 points.
- Hardcore: position information is hidden (§2.3). A win is worth 5 points.
Both difficulties use the same rules for codes, turns and rounds.
3.3 Number of players
The number of players sets the code length and the shared guess limit.
| Players | Code length | Guess limit per round (shared) | Rating multiplier (Ranked) |
|---|---|---|---|
| 2 | 4 digits | 10 | 1.0 |
| 3 | 5 digits | 15 | 1.25 |
| 4 | 6 digits | 20 | 1.5 |
Practice matches have their own round-length options (§6).
04Finding a match
This section applies to Casual and Ranked matches.
- Your choices. You pick the match type (Casual or Ranked), the difficulty and the number of players (2, 3 or 4). Players who searched with the same three choices wait together.
- Order. Waiting players are matched in the order they joined. Ratings are not used to pair players.
- A full group starts at once. As soon as enough players are waiting, the match is formed.
- Empty seats. If there are not enough players, the game fills the empty seats with computer-controlled players (bots) so that the match can start. One seat is filled about every 5 seconds while the group is still short, so when nobody else is searching, the wait is about 5 seconds for each missing seat. Players who join the search in the meantime are given the open seats ahead of additional computer-controlled players.
- Computer-controlled players. They are accounts like any other, with a profile, points, a rating and statistics, and they take part in the match like any other player. Before each guess, a computer-controlled player waits a random time between 2 and 15 seconds; it has no turn timer. Its first guess is random. After that it picks a random code it has not guessed before that fits the feedback its own earlier guesses received. Computer-controlled players are never added to Custom rooms.
- Leaving the search. You can leave the search at any time. If a match cannot be launched, the waiting players are returned to the search with their original place in line.
- One thing at a time. You can have a search, a seat in a Custom room that is starting its match, or a seat in a live match, but not more than one of them. A seat in a Custom room that is still waiting is released when you start a search, and starting a new search replaces your earlier one.
- The weekly reset. (New) While a week rolls over, Ranked is closed for a few minutes and players waiting in the Ranked queue are taken out of it (§16.7).
- Blocked players. (New) Ranked matchmaking can still place you in the same public match as a player you have blocked (§16.4).
05Custom rooms (New)
A Custom room lets you play with friends. Previously known as Private room
- Create. Choose the number of players (2, 3 or 4) and the difficulty. You become the host, and the room gets a 6-character room code made of letters and digits (the letters I and O and the digits 0 and 1 are never used).
- Join. Share the code. Friends join by entering it; room codes are not case-sensitive. A room accepts as many players as it was created for.
- Start. When the room is full, and no seat is waiting for a returning player, the host starts the match. The match begins with the usual countdown.
- If the host leaves, the player who has been seated longest becomes the host. A room with no players is removed.
- If your connection drops while you are in a room, your seat is held for 10 seconds. Join again with the same code during that time to take it back. After that, the seat is released as if you had left.
- Custom matches follow the normal match rules (§2, §9) and never include computer-controlled players.
- Custom matches are not saved: they award no points and change no rating, statistics, achievements or match history.
- Skill power-ups. (New) When creating a Custom room, the host can toggle skills on or off (§16.9).
- Challenging a friend. (New) The Challenge button on your friends list creates a Custom room and sends that friend an invite (§16.2).
06Practice mode
Practice matches need no account and run entirely in your browser. The game's servers do not record them.
- Two ways to play. Vs computer: you play against a computer opponent. Pass and play: two people share one device and take turns.
- Difficulty. Standard or Hardcore, with the feedback rules from §2.3.
- Round length. You choose how long the code is, which also sets the shared guess limit:
| Round length | Code length | Guess limit per round (shared) |
|---|---|---|
| Easy (default) | 4 digits | 10 |
| Medium | 5 digits | 12 |
| Hard | 6 digits | 15 |
- Rules. A practice match has exactly two players and works like an online match: one shared secret code per round, a shared guess limit, a draw when the limit is reached, and best of three rounds. The player who opens the round alternates each round. There are no turn timers.
- The computer opponent. Its first guess is random. After that it picks a random code it has not guessed before that fits the feedback its own earlier guesses received. It pauses briefly before each guess.
- Resuming. An unfinished practice match is kept in your browser, on your device. When you come back, the game asks whether you want to resume it. It is cleared when the match finishes or when you abandon it.
- Nothing counts towards an account. Practice matches award no points and change no rating, statistics, achievements or leaderboard positions.
07Points
Points reward every Casual and Ranked match and are separate from rating.
| Result | Standard | Hardcore |
|---|---|---|
| Win | 3 | 5 |
| Draw | 1 | 1 |
| Loss | 0 | 0 |
- Only the winner of the match receives the win value. Every other player receives the loss value, including players who won some rounds and players who forfeited.
- When a match is a draw, every player receives the draw value.
- Points are added to your profile after the match is saved. Custom and practice matches award no points.
-
Points are taken away by an inactivity cancellation (§9.4).
(New) They are also spent on Daily Challenge retries, which cost 10 points each (§16.6).
08Rating
8.1 The basics
- Rating applies to Ranked matches. New accounts start at 0, and your rating never drops below 0.
- Casual, Custom and practice matches do not change your rating. The one exception is a match cancelled for inactivity (§9.4).
- Your match history records the rating change that was actually applied to you.
- Weekly reset. (New) Ratings run in weeks. Each week ends on Monday at 00:00 UTC, and everyone's rating starts again from zero (§16.7).
- Before and after. (New) After a match, your rating is shown as before and after, for example 1250 → 1268. In Ranked matches you also see your opponents' ratings (§16.13).
8.2 How a Ranked result is calculated
guessIo uses a multiplayer version of the Elo rating system.
- Groups. Players are grouped by the number of rounds they won: two or more rounds, exactly one round, or no rounds. Players in the same group tie. The group depends on rounds won, not on who won the match.
- Pairwise comparison. Every scored player is compared with every other scored player. Beating a higher-rated player earns more than beating a lower-rated one, and losing to a lower-rated player costs more.
- Averaging and lobby multiplier. The results are averaged over your opponents and multiplied by the lobby multiplier: 1.0 for a 2-player lobby, 1.25 for 3 players and 1.5 for 4 players. The multiplier is based on the lobby the match started with, even if players leave.
- Rounding. The final change is rounded to a whole number.
For the curious, for players a and
b with ratings Ra and Rb at
the start of the match:
expected(a, b) = 1 / (1 + 10 ^ ((Rb - Ra) / 400))
result(a, b) = 1 if a's group is better than b's, 0.5 if the groups are the same, 0 if worse
change(a) = round( average over every other scored player b of 32 x (result(a, b) - expected(a, b)),
then multiplied by the lobby multiplier )
Example: two equally rated players play a Ranked match and one of them wins both rounds. The winner gains 16 and the other player loses 16 (a rating that would fall below 0 stays at 0).
8.3 Who is scored
- Players who are connected when the match ends, and the player who won the match, are scored against each other as described above.
- A player who is not connected when a Ranked match ends (this includes players who quit or timed out and forfeited) receives a flat −30 instead.
- If only one player is scored, that player's change is 0.
09Leaving a match early
9.1 Losing your connection
- If your connection drops during a match, you keep your seat for 60 seconds, and the other players are told how long you have to return.
- While you are away, the turn timer keeps running for your turns, and turns that time out are skipped as usual.
- To come back, open the game again within the 60 seconds. If the game finds that you are still seated in a live match, you can reconnect to it or abandon it, which counts as a forfeit and may affect your rating. When you reconnect, the match is restored to its current state, including the feedback you have received so far.
- If you do not return within 60 seconds, you forfeit the match.
9.2 Quitting
You can forfeit a match at any time. A quit takes effect immediately. Tapping Forfeit more than once counts only once (New).
9.3 What a forfeit does
- Two-player match. The other player wins the match immediately. If a round is in progress, it is awarded to the remaining player first.
- Three- or four-player match. The player who forfeited is removed from the turn order, and the match continues among the other players under the normal rules (§2.6). When only one player is left, that player wins.
- The player who forfeited receives the loss value for points (§7). In a Ranked match, they also receive the flat −30 rating change (§8.3).
- A player who has forfeited can still look at the match but does not take turns again. After forfeiting a 3- or 4-player match, a player can start a new search while that match continues.
- In your match history, a loss in a match you forfeited is marked as a forfeit (§12.3).
9.4 Inactivity
The game counts consecutive turns that time out.
- When the timed-out turns add up to one full rotation of the players still seated, with no guess accepted in between, everyone in the match receives an inactivity warning.
- If a second full rotation passes without any accepted guess, the match is cancelled, with the reason "inactivity".
Any accepted guess resets the count, and the count starts again with each new round.
When a Casual or Ranked match is cancelled for inactivity:
- every player of the match receives a rating change of −30, in Casual matches as well as Ranked ones;
- every player who was still seated also loses 10% of their current points, rounded to the nearest whole number and never more than the points they have;
- players who had already forfeited receive the rating change but not the points penalty.
A cancelled match is saved in match history as cancelled and counts as a match played. Custom matches are not saved, so they carry no penalties.
9.5 Repeated quitting (New)
10Achievements
There are 16 achievements, including two Daily Challenge achievements (New). Each one is unlocked once, and the time it was unlocked is kept. The Achievements screen has a progress card (New) and shows the month each achievement was earned (New).
A full match is a completed match that ended normally (no quit, no connection timeout and no inactivity cancellation) and in which no player was disconnected or had forfeited when it ended. Wins and losses count towards achievements only in full matches, unless stated otherwise.
| Achievement | How to earn it |
|---|---|
| Welcome to guessIo | Play your first match. |
| Newbie | Win your first match (a full match). |
| Sharp Guesser | Win a round on your first guess: in a full match, your only guess in that round was the secret code. |
| Regular | Play 50 matches. |
| Speedster | Win a round in under 60 seconds, with your own guess being the secret code, in a full match. |
| Quick Draw | Win a match in under 90 seconds (a full match). |
| Flawless x5 | Win 5 matches in a row. |
| Flawless x10 | Win 10 matches in a row. |
| Flawless x20 | Win 20 matches in a row. |
| Hardcore Initiate | Win your first Hardcore match (a full match). |
| Terrible Guesser | Lose 3 matches in a row. |
| Hardcore Legend | Win 3 Hardcore matches in a row. |
| Centurion | Play 100 matches. |
| GuessIo Veteran | Play 500 matches. |
| Seven Days Running (New) | Maintain your Daily Challenge streak for 7 days (§16.5). |
| Thirty Days Running (New) | Maintain your Daily Challenge streak for 30 days (§16.5). |
Daily Challenge streaks. (New) Seven Days Running and Thirty Days Running use your Daily Challenge streak, not the match streaks described below. Any attempt keeps that streak going, and missing a whole day ends it.
Matches played. The count includes every saved match you took part in, cancelled ones included.
Streaks. A streak is checked over your most recent completed matches, newest first (for Hardcore Legend, over your most recent completed Hardcore matches). A streak of length N needs all of your N most recent matches to be wins (or all losses) in full matches.
- A draw breaks a streak.
- A match that you left yourself and did not win also breaks a streak.
- A match that you won or lost only because someone else left is skipped: it neither extends nor breaks a streak.
- Cancelled matches are ignored.
When achievements are checked.
- After each saved Casual or Ranked match, for every human player in it. If you unlock something and you are connected, the game tells you straight away. Unlocks made after a match stay marked as new until you acknowledge them, so you will see them even if you were offline.
- Whenever you view your achievements, which checks them again.
- Computer-controlled players are not checked for achievements.
Top-10 status. This is not an achievement and is never stored. Players who hold rank 10 or better on the rating leaderboard, and have played at least 10 Ranked matches, are shown as top-10 players on their profile. It is re-checked each time, so it can appear and disappear as ranks change.
11Leaderboards
There is one leaderboard, which ranks players by rating. (New) The Points leaderboard was removed in V2.0.0 (§16.8).
- It lists the top 20 players. The list is fixed at 20 entries.
- An entry shows the player's rank, display name, avatar and the rating.
- If you are signed in, your own entry is shown too, even when you are outside the top 20, as long as you have a rank.
- Entries are ordered by rating, highest first. Ties are broken by account age: the older account ranks first.
-
Active accounts are eligible, except for the reserved username
guest. Suspended, banned and deleted accounts are not listed. - The leaderboard is part of the signed-in game. Practice matches do not appear on them.
- Weekly Ratings leaderboard. (New) The Ratings leaderboard runs in weeks that end on Monday at 00:00 UTC, and it shows when it resets and how much time is left. When a week ends, ratings start again from zero, and the first time you open the app after that you see a recap of last week's top three. Your rank unlocks after you have played a few ranked matches in the week (§16.7).
- Player options. (New) Tap a player's name on a leaderboard to view their profile, add them as a friend, block them or report them (§16.3).
12Your profile and match history
12.1 Profile
Your profile shows your display name, username, avatar, the month and year you joined, your rating and points, the number of matches you have played, your wins, draws and losses, and your win rate (wins divided by matches played). It also lists your achievements and, if you qualify, your current top-10 position (§10).
Your public profile can be looked up by username, and the person looking does not need to be signed in. It contains your username, display name, avatar, points, rating and statistics. It never includes your email address.
Other players and your profile. (New) Other players can open your profile from a leaderboard, the Home podium or the match results, and see your rating, points, win rate, matches played, match record and unlocked achievements. The Private profile setting closes your profile to other players (§16.3, §16.4).
Shortcuts. (New) Your Profile has a Friends shortcut that shows how many new requests are waiting, and you can open the Daily Challenge from it (§16.1, §16.5).
12.2 Statistics
The game keeps these statistics for every account:
| Statistic | What it counts |
|---|---|
| Matches played | Every saved match you took part in, including cancelled ones |
| Matches won, lost and drawn | Completed matches by result. Cancelled matches count as none of these. |
| Rounds won | Rounds you won, summed over all saved matches |
| Turns skipped | Turns of yours that timed out |
12.3 Match history
Match history lists your saved Casual and Ranked matches, newest first. Custom and practice matches do not appear. The list can be narrowed to Ranked matches, Casual matches, wins or losses.
Each entry gives:
- the result: win, loss, draw or cancelled (a loss in a match you forfeited is marked as a forfeit);
- the usernames of your opponents;
- the match type and difficulty, and how long ago the match was played;
- the rating change you received, if there was one;
- the score: the rounds you won, followed by the highest number of rounds won by any opponent.
The details of a match include:
- the result, match type, difficulty, number of players, date and time, and how long the match lasted;
- every participant with the number of rounds they won;
- your rating change and the points you earned, when they were recorded for the match;
- for each round, its secret code and the player who won it, or "Draw";
- the total number of guesses made in the match and the match time.
Secret codes are shown only for matches that have ended, and only to the players who took part.
13Your account
13.1 Signing in
- Google is the only way to sign in. The game has no passwords of its own.
- Your Google account must have a verified email address.
- The first time you sign in, you choose a username to finish creating your account. Nothing is saved until you do, and you have 15 minutes after signing in to choose one.
-
Username: 3 to 30 characters, using lowercase
letters, digits and underscores. Usernames are unique regardless
of capitalization, the name
guestis reserved, and a username cannot be changed once your account exists. - Display name (also called your call sign): starts as your Google name (or your username if Google supplies none), up to 30 characters. You can change it at any time. Other players see it in queues, rooms and matches and on the leaderboards.
- Avatar: starts as your Google profile picture.
- Email: the address from your Google account. It is shown only to you and cannot be changed in the game.
- Search: (New) other players can find you by your exact username or call sign. The Private profile and Appear in search settings can hide you (§16.4).
13.2 One device at a time
Each sign-in starts a new session and ends the earlier one. If you sign in on another device or browser, the first one is signed out, and any live connection it had is closed. Logging out ends your session and closes your live connection.
13.3 Suspensions, bans and appeals
An account is either active, suspended, banned or deleted.
- A suspended or banned account cannot sign in to play. The game shows the account's status and the reason recorded for it, if there is one.
- A suspended account can submit an appeal: a written message of up to 1,000 characters. Only one appeal can be pending at a time, so a new appeal can be submitted only after the earlier one has been decided.
- A banned account cannot submit appeals in the game. A ban is permanent, and the decision is final.
- Automatic suspensions. (New) Quitting ranked matches several times in a row can lead to an automatic suspension (§9.5). You can appeal from the suspension screen.
13.4 Deleting your account
You can delete your account from the game's settings. Deleting is permanent and cannot be undone. See §15.4 for exactly what happens.
13.5 New settings (New)
V2.0.0 added these settings:
14App screenshots
These are the main screens of the guessIo app. Swipe, use the arrow buttons, or press the left and right arrow keys to move between them. Select the screen in the middle to open it larger.
15Your information
15.1 What guessIo receives from Google
When you sign in, guessIo asks Google for your basic profile and
email address (the openid, email and
profile permissions). It reads the following details.
| From Google | How it is used |
|---|---|
| Google account ID | Recognizes your account when you sign in again. Saved with your account. |
| Email address | Must be verified by Google. Saved with your account and never shown to other players. |
| Name | Becomes your starting display name. |
| Profile picture | Becomes your starting avatar. |
| First and last name | Used only to suggest a username when you create your account. Not saved to your account. If they give nothing usable, the first part of your email address is used for the suggestion. |
The access token Google issues for your sign-in is used once, to read these details, and is not stored. If you are new, these details are held only temporarily by the game while you choose a username, and nothing is saved to your account until you finish.
15.2 What other players can see
- In queues, rooms and matches: your display name (or your username if you have no display name) and your avatar.
- On leaderboards: your rank, display name, avatar and your rating.
- On your public profile: your username, display name, avatar, points, rating and statistics.
- In the match history of players you played against: your username, avatar and rounds won in that match, and whether you forfeited.
- Your email address is never shown to other players.
- (New) In search and on your profile: other players can look you up by exact username or call sign, and can open your profile to see your rating, points, win rate, matches played, match record and unlocked achievements. The privacy settings can hide you (§16.4).
- (New) If someone blocks you, or you block them, you are hidden from each other in search and profiles. The player who is blocked is not told.
15.3 What is saved from matches
Casual and Ranked matches are saved when they end, whether they were completed or cancelled. The record contains the match settings and result, every round (including its secret code), every guess with the player who made it, each player's result, and the resulting changes to points, rating and statistics. Players who took part can review these details in their match history (§12.3).
Custom matches are not saved. They are only counted in daily totals of completed and cancelled matches, which contain no player information.
Practice matches run in your browser. An unfinished one is kept in your browser's storage on your device so that you can resume it, and it is not sent to the game's servers.
15.4 Deleting your account
When you delete your account:
- your username is replaced with a generated placeholder, your email address and Google link are removed from the account, your display name becomes "Deleted User", and your avatar is removed;
- every sign-in session of the account is ended, and the account can no longer be signed in to;
- your points, rating, statistics, achievements and saved matches are left in place, attached to the anonymized account. Saved matches stay because they are also part of the other players' history.
If you later sign in with the same Google account, you start over as a new player.
15.5 Terms and Privacy Policy
The game links to its Terms of Service and Privacy Policy, which are published on the guessIo website.
16What's new in V2.0.0
V2.0.0 was released on November 1, 2026. It adds friends, a Daily Challenge, skills, a weekly Ratings leaderboard, Daily Challenge retries, notifications and a redesign of the app. Items in the earlier sections that were added or changed in V2.0.0 are marked (New). This section describes each update in full.
16.1 Friends
- Finding a player. Search for the exact username or call sign of the player you want to add. Your call sign is your display name (§13.1).
- Friend requests. You can send a request, and the player who receives it can accept or decline it. You can also cancel a request you have sent.
- Removing a friend. You can remove a friend at any time.
- Limit. You can have up to 10 friends.
- Challenge. The Challenge button on your friends list creates a Custom room and sends that friend an invite (§16.2).
- Profile shortcut. Your Profile has a Friends shortcut that shows how many new requests are waiting for you.
16.2 Challenge invites
A challenge invite is what your friend receives when you use Challenge on your friends list.
Receiving an invite
- The invite arrives straight away, on any screen except while you are in a match, searching for a match or inside a room.
- It shows who challenged you, the mode and the number of players, together with a countdown.
- You can Accept or Decline.
- If the invite runs out or the sender withdraws it, it disappears.
Sending an invite
- You can see what happened to your invite: it is still waiting, it was declined, or it expired. An expired or declined invite has an Invite again button.
- If an invite cannot be sent, you are told the reason: your friend is offline, your friend is in a match, or you invited them a moment ago.
- When your friend is offline, you can share the room code with them instead (§5).
16.3 Player profiles
You can open another player's profile. It shows their rating, points, win rate, matches played, match record and unlocked achievements. (§12 explains profiles and statistics.)
To see what you can do with a player, tap their name on the leaderboard, on the Home podium or on the match results. The options are:
16.4 Blocking, reporting and privacy
Blocking
- Blocking a player ends any friendship with them. You and the player no longer appear in each other's search or profiles.
- The player you block is not told.
- Blocking does not keep you out of the same match: Ranked matchmaking can still place you in the same public match (§4).
- Your blocked players are listed in Settings, where you can unblock them at any time.
Reporting
You can report a player for:
- harassment;
- an inappropriate name or picture;
- cheating;
- another reason.
You can add a note to a report. A note is optional and can be up to 500 characters.
Privacy settings
| Setting | What it does |
|---|---|
| Private profile | Hides you from search, stops other players from opening your profile and blocks friend requests. |
| Appear in search | Controls whether other players can find you in search. |
| Anyone can send friend requests | Lets you turn off friend requests from other players. |
16.5 Daily Challenge
The Daily Challenge is a puzzle that changes every day. Open it with the Daily button on Home or from your Profile. Each day you get a new code to crack against the clock.
- Your time. Your first finish sets your time. From then on, the time to beat is your best finish from the last 7 days. If you go 7 days without a finish, it resets.
- Retries. You can try as many times as you like until you finish one. If you finish without beating the time to beat, see §16.6.
- Streak. Any attempt keeps your streak going. Missing a whole day ends it.
- Calendar. Your last 30 days are shown on a streak calendar, with a colour for each day (see below).
- New challenge. A new challenge opens every day at 00:00 UTC, which is the same moment for every player.
- Achievements. The Daily Challenge adds two achievements for keeping your streak going: Seven Days Running (7 days) and Thirty Days Running (30 days) (§16.14).
Streak calendar colours
| Colour | What it means for that day |
|---|---|
| Blue | You started the challenge. |
| Red | You did not pass the challenge. |
| Green | You passed the challenge. |
16.6 Daily Challenge: retry
Missed the time to beat? You can take another shot.
- When it is offered. If you finish a Daily Challenge but do not beat the time to beat, you are invited to try again. The Daily page also has a Retry button.
- How long. You can retry until you beat your time.
- Cost. A retry costs 10 points (§7).
- Not enough points. If you do not have enough points, Retry is disabled.
- Streak calendar. A day you did not pass shows red. If you beat the time on a retry, that day turns from red to green in your streak calendar (§16.5).
- After you pass. Once you have beaten the time, there is no retry left to attempt for that day.
16.7 Weekly leaderboard
The Ratings leaderboard now runs in weeks (§11 describes the leaderboards). Rating is explained in §8.
- The week. Each week ends on Monday at 00:00 UTC. The leaderboard shows when it will reset and how much time is left.
- The reset. When a week ends, every player's rating starts again from zero.
- Counting matches. Every ranked match counts towards your rating, starting with your first one.
- Your rank. Your rank on the leaderboard unlocks after you have played a few ranked matches in the week. Until then, the leaderboard tells you how many more you need.
- Last week's recap. The first time you open the app after a reset, you see a recap of last week's top three players. Tap a name to view that player's profile. If you finished just outside the podium, the recap also shows your own place.
While the week rolls over
Ranked is closed for a few minutes when a week ends. During that time:
- players waiting in the Ranked queue are taken out of it;
- matches that are already under way can finish;
- Casual matches, Custom rooms and the Daily Challenge stay open.
Ranked reopens automatically.
16.8 Leaderboard: rating only
- The Points leaderboard has been removed. The leaderboard now ranks players by rating only (§11).
- Points are now spent on Daily Challenge retries (§16.6).
16.9 Skills
Before an online match, every player picks one skill. You can use your skill once, on your own turn.
| Skill | What it does |
|---|---|
| Reveal Position | Shows you one digit of the code in its place. The digit is picked at random. |
| Extra Turn | Gives you one more guess right after the current one. It is locked when only one guess is left. |
| Freeze | An opponent loses their next turn. |
| X-Ray Vision | Lets you see the feedback on an opponent's guesses for that round. |
Good to know
- Picking. Players pick one after another, with 10 seconds each. If your time runs out, a skill is chosen for you.
- Freeze. The player who is hit by Freeze is told.
- X-Ray Vision. The player being watched sees the message "You're being monitored", but never who is watching.
- Using a skill up. A skill is used up only when it actually takes effect.
- Custom rooms. When the host creates a Custom room, the host can switch Skill power-ups on or off.
- Tips. New players see a short welcome tip, and everyone sees an "Introducing skills" pop-up once. How to Play now covers skills as well.
16.10 Notifications
guessIo can notify you in your browser, even when it is not open. To turn this on:
- Open Settings → Notifications.
- Allow notifications when your browser asks for permission.
- Choose which types of notification you want.
| Type | What it tells you |
|---|---|
| Lost a top 3 spot | Someone passed you on the rating ladder. |
| Friend activity | You have a friend request, or a request was accepted. |
| Daily streak at risk | A reminder before your streak ends at 00:00 UTC (§16.5). |
- Turning notifications off on a device switches off all the types on that device.
- Notifications on a device also stop when you sign out.
- Notifications work only in browsers that support them.
16.11 Fair play
- Quitting ranked matches several times in a row can lead to an automatic suspension. So can staying disconnected until you are counted as having left (§9.1).
- Finishing a ranked match normally resets the count.
- If you are suspended, you can appeal from the suspension screen (§13.3).
16.12 A fresh new look
- Redesigned screens. The redesign covers Home, Play, Leaderboard, Matches, Profile, Settings, Help and the guest screens.
- Logo and icons. guessIo has a refreshed logo and new app icons.
- Home. Home shows a Code Legends podium with the top three players, plus your rating, win rate and matches played. It also lists your last three games and has a Play now shortcut.
- Bottom bar. The bottom bar now has four tabs: Home, Rank, Matches and Profile.
- Custom. The match type that used to be called Private is now called Custom (§5 now calls them Custom rooms).
16.13 Matches and results
- Rating change. After a match, your rating is shown as before and after, for example 1250 → 1268, in the colour of the change. In Ranked matches you also see your opponents' ratings. (§8 explains how rating changes.)
- Rating floor. Rating never goes below 0. A player on 0 who loses sees 0 → 0.
- The last round. After the final round of a match, the "next round" countdown is no longer shown. The round result appears briefly, and then your match results open.
- Repeated taps. Your guess is sent only once, even if you tap the key more than once. Tapping Forfeit twice counts as one forfeit.
16.14 Achievements
- There are now 16 achievements in total. The two new ones, Seven Days Running and Thirty Days Running, are earned by maintaining a Daily Challenge streak for 7 days and 30 days (§16.5). All 16 are listed in §10.
- The Achievements screen has a new progress card.
- Each achievement shows the month in which you earned it.
17Quick reference
Standard settings
| Setting | Value |
|---|---|
| Turn time | 30 seconds |
| Countdown before round 1 | 5 seconds |
| Pause between rounds | 5 seconds |
| Time to return after a disconnect during a match | 60 seconds |
| Custom-room seat held after a disconnect | 10 seconds |
| Matchmaking: one open seat filled | about every 5 seconds |
| Time to choose a username after signing in | 15 minutes |
| Time to pick a skill (New) | 10 seconds for each player |
| New Daily Challenge (New) | every day at 00:00 UTC |
| Weekly rating reset (New) | every Monday at 00:00 UTC |
Rounds, points and rating
| Item | Standard | Hardcore |
|---|---|---|
| Feedback | Right place, in the code elsewhere, or not in the code | In the code or not in the code |
| Points for a win / draw / loss | 3 / 1 / 0 | 5 / 1 / 0 |
| Players | Code length | Shared guess limit | Rating multiplier |
|---|---|---|---|
| 2 | 4 digits | 10 | 1.0 |
| 3 | 5 digits | 15 | 1.25 |
| 4 | 6 digits | 20 | 1.5 |
Penalties
| Situation | Effect |
|---|---|
| Forfeit or timed-out connection in a Ranked match | −30 rating; 0 points awarded |
| Forfeit or timed-out connection in a Casual match | No rating change; 0 points awarded |
| Match cancelled for inactivity (Casual or Ranked) | −30 rating for every player; players still seated also lose 10% of their points |
| Quitting ranked matches several times in a row (New) | Can lead to an automatic suspension |
Limits
| Item | Limit |
|---|---|
| Username | 3 to 30 characters: lowercase letters, digits, underscores |
| Display name | Up to 30 characters |
| Appeal message | Up to 1,000 characters |
| Leaderboard length | Top 20 |
| Friends (New) | Up to 10 |
| Report note (New) | Up to 500 characters (optional) |
| Daily Challenge retry (New) | 10 points each |
Terms
| Term | Meaning |
|---|---|
| Seat | A player's place in a match or a Custom room |
| Forfeit | Leaving a match so that it is lost, by quitting or by not returning in time |
| Full match | A completed match that ended normally with nobody disconnected or forfeited (§10) |
| Computer-controlled player (bot) | A server-controlled player that can fill empty seats in Casual and Ranked matches (§4) |
| Call sign | Your display name |
| Custom room (New) | A room for a match with friends, called a Private room before V2.0.0 (§5) |
| Skill (New) | An ability each player picks before an online match and uses once on their own turn (§16.9) |