Feature Guide
Everything you need to know about using Foosball Tracker.
๐ Getting Started
How do I join a clan?
Go to Clans and tap Join Clan. Enter the 8-character invite code your clan admin shares with you. You'll be a member instantly.
How do I create a clan?
Go to Clans โ Create Clan. Give your clan a name. You'll get a unique invite code to share with others.
Can I be in multiple clans?
Yes. You can join or create as many clans as you like. Your stats aggregate across all clans.
What is an invite code?
Each clan has a unique 8-character code. Share it with friends so they can join your clan. You can find it on your clan's page.
๐ฎ Recording Games
How do I start a game?
Go to Games โ New Game. Select your clan, choose 4 players (2 per team), assign defender and offender positions, then tap Start Game.
Can I play with friends from a different clan?
Yes. When creating a game, you can pick any player who is either a member of the selected clan or an accepted friend. This lets you include friends who aren't in the same clan.
What are the two game modes?
Standard: first to 10 goals wins. Quick: first to 5 goals wins. Choose when creating the game.
What's the difference between goals and points?
Goals are what you score. Points are what those goals are worth โ a defender goal = 2 points, an offender goal = 1 point, a team goal = 1 point. The first team to reach the goal target wins.
How do I score a goal?
During an active game, the designated scorer taps the goal button for whoever scored. A single scorer is assigned per game to prevent conflicts from multiple devices.
Can I pass scoring control to another player?
Yes. During an active game, the current scorer or game creator can tap the Pass button to transfer scoring responsibility to any other player in the game.
What is a team goal?
A team goal is used when you can't attribute the goal to a specific player (defender or offender). Both players on that team share the credit โ 0.5 goals each. It scores 1 point (same as an offender goal).
Can I undo a goal?
Yes. While the game is active, tap Undo to remove the last goal. You can also undo immediately after the game completes if the last goal caused the win.
What is an early end?
If you need to stop before reaching the goal target, use End Game Early. You must provide a reason. The higher-scoring team wins.
โฝ How Scoring Works
Goals win the game โ points do not
A game ends when one team reaches the goal target (5 or 10, chosen when the game is created). Points are counted separately and never decide who wins. A team can hold more points and still lose. (first team to reach the target number of goals wins)
A goal is worth more from the back
Where you were standing when you scored sets the goal's point value. Defenders score less often, so each of their goals is worth more. A team goal โ one neither player claims โ is worth the same as an offender's. (defender 2 pts ยท offender 1 pt ยท team goal 1 pt)
Your points are your team's points
This surprises people: performance points are not a reward for your own goals. Both team-mates always receive exactly the same number. Your team's points are halved between you, and the winning pair get a bonus each. Score five goals or none โ if you and your partner are on the same side, you finish with the same points. (your team's total points รท 2, plus 2 each if you won)
Only approved games count
A finished game waits for a clan reviewer to approve it. Nothing on your profile or the leaderboard moves until they do. Rejected and cancelled games never count.
Can players swap positions mid-game?
Yes. Use the Swap button on a team to exchange its defender and offender. Each goal is credited to whichever position you were in at the moment you scored, so swapping splits your goals between the two.
โ Game Approval
Why do games need approval?
The approval workflow ensures fair play. A clan reviewer (someone other than the players) checks the result and approves it before it counts on the leaderboard.
Who can approve games?
Clan reviewers โ players who have been assigned the reviewer role by a clan admin. They must confirm their password to approve or reject.
What happens to rejected games?
Rejected games do not count on the leaderboard. They stay in your game history with a Rejected status and the reviewer's reason for rejection.
When does a game count on the leaderboard?
Only Approved games are counted. Pending, Completed (waiting for review), Rejected, and Cancelled games are all excluded.
๐ Leaderboard & Seasons
How players are ranked
By total performance points. Level on points, the higher win rate goes first; still level, whoever needed fewer games. (points โ win rate โ fewest games)
Which games are included
Approved games only. Picking a season narrows it to games played inside that season's dates.
Friends & Clan vs Everyone
Friends & Clan shows people you play with โ your friends and clan mates. Everyone shows all players who have made their stats public.
Why does the leaderboard open on a season?
When a season is running it is selected by default, because that is usually what people want to see. Pick All time to include every game ever played, or a past season to look back.
Can I see clan-only rankings?
Yes. From a clan's page, tap Leaderboard for rankings limited to that clan.
Can I see my stats for one season?
Yes. Your profile has the same season chips as the leaderboard. Picking one recalculates everything below it โ scoring, clutch, form, partnerships and head-to-head โ for that season only.
๐ What Each Stat Means
Wins, losses and points โ Win rate
The share of your approved games that you won. Draws โ from a game ended early while level โ count as neither a win nor a loss, but still count as a game. (wins รท games played ร 100)
Wins, losses and points โ Points
Your performance points added up across every approved game. This is what the leaderboard ranks you by. (each game: team points รท 2, plus 2 if you won)
Scoring โ Total goals
Goals you scored across approved games. A team goal is shared, so it adds half a goal to each team-mate โ which is why this number can end in .5. (your goals + 0.5 per team goal your side scored)
Scoring โ Strike rate
How much of a game's scoring was yours, averaged over your games. High means you tend to be the one finishing; it says nothing about whether you won. (your goals รท all goals in the game ร 100)
Scoring โ Avg pts/game
Your performance points divided by games played. Because points are shared with your partner, this tracks how well your teams do rather than how much you personally score. (total points รท games played)
Position breakdown โ Defender goals
Goals scored from the back. Each is worth 2 points to your team.
Position breakdown โ Offender goals
Goals scored from the front. Each is worth 1 point to your team.
Position breakdown โ Most played
The position you have started in most often. Purely a count โ it does not mean you are better there.
Goal streaks โ Best (single game)
Your longest run of consecutive goals within one game.
Goal streaks โ Best (lifetime)
The best single-game run you have ever managed. It does not carry across games.
Performance by position โ Stronger position
Awarded to the position with the better win rate, but only once you have at least 3 games in both. Below that the sample is too small to mean anything, so no position is crowned.
Performance by position โ Points and goals per game
Your averages while playing that position, counting only games you started there.
Clutch โ Winning goals
Games where you scored the very last goal and your team won. The goal that ended it.
Clutch โ First goals
Games where you scored the opening goal, whatever happened afterwards.
Clutch โ Comeback wins
Games you won after being at least 3 goals behind at some point. "Best" shows the largest deficit you have come back from. (won, having trailed by 3+ goals)
Clutch โ Of team's goals
Your share of the goals your own side scored โ unlike strike rate, this ignores what the opposition did. (your goals รท your team's goals ร 100)
Recent form โ Current run
How many games you have won or lost in a row right now. A draw ends a run without starting a new one.
Recent form โ Last 10 vs career
Your win rate across those 10 games, with the arrow showing how far it sits above or below your career rate. It appears once you have at least 3 recent games.
Recent form โ Best win streak / worst losing run
Your longest winning and losing sequences of games, ever.
Partners & rivals โ Best partner / toughest pairing
The team-mate you win the most and least often alongside, by win rate rather than by number of wins.
Partners & rivals โ Nemesis / favourite opponent
Your nemesis genuinely beats you โ they must hold a winning record against you, not merely have played you often. Your favourite opponent is the reverse. If neither appears, nobody qualifies.
Partners & rivals โ Most played with / against
Straight counts of who you have shared or faced a table with most. No minimum, and no judgement about results.
Partnerships โ Win %
Games won together รท games played together. Both of you gained the same points from each of those games.
Head-to-head โ Win %
Games you won against that opponent รท games played against them. Counts games where you were on opposing sides.
๐ฅ Friends
How do I add a friend?
Go to your profile โ Friends section, search by name, and tap Send Request. They'll see it in their profile and can accept or decline.
What does adding a friend do?
Friends appear in your Friends & Clan leaderboard view, can be added to games across clans, and can see your profile and stats if your privacy is set to Friends & Clan.
Where do I see pending requests?
In your profile settings under the Friends section. Incoming requests show with Accept / Decline buttons.
๐ Privacy
Who can see my stats by default?
By default, your stats are set to Friends & Clan Only. Only players you've added as friends or members of your clans can see your leaderboard ranking and profile.
How do I make my stats public?
Go to your profile settings โ Privacy โ tap Everyone. Your stats will appear on the public global leaderboard.
Can the public leaderboard be seen without logging in?
Yes. Anyone can view the leaderboard at /leaderboard without an account โ but they'll only see players who have set their stats to Everyone.
Can I hide my profile from specific people?
Not per-person. Your privacy applies to everyone: either visible to all (Public) or restricted to friends and clan mates (Friends & Clan Only).
๐ Passkeys & Sign In
What is a passkey?
A passkey lets you sign in with Face ID, Touch ID, fingerprint, or Windows Hello โ no password needed. It's stored securely on your device or synced via iCloud Keychain / Google Password Manager.
How do I set up a passkey?
Go to your profile settings โ Biometric Sign-In โ Add Passkey. You'll be prompted to authenticate with your device biometrics.
Can I have passkeys on multiple devices?
Yes. Register a passkey on each device you use. If your passkeys sync (iCloud Keychain, Google PM), they'll be available on all your signed-in devices automatically.
What if I lose a device with a passkey?
Go to your profile settings โ Biometric Sign-In and remove the passkey for that device. You can still sign in with your password.
๐ For Reviewers
How do I know a game needs review?
You'll see a notification badge on the Review tab. Completed games waiting for your approval appear there.
What should I check before approving?
Verify the score is correct, all 4 players are listed, and the result matches what actually happened. If anything looks wrong, reject it and add a reason.
Do I need my password to approve?
Yes. Approval requires your account password or a passkey confirmation. This prevents accidental or unauthorized approvals.
What happens if I notice unusual patterns?
Some games may show a warning badge. Review them carefully. If the result seems manipulated, reject the game and note the reason.
Something still unclear?
Check what's new โ