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 โ†’