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.
โฝ Positions & Scoring
What is the difference between defender and offender?
Defender (goalkeeper): scores 2 points per goal. Offender (striker): scores 1 point per goal. Defenders score less frequently but each goal is worth more.
How are performance points calculated?
Performance points = (your team's total score รท 2) + win bonus. Both teammates on a winning team earn +2 bonus points each. This means winning together earns you shared credit.
Can players swap positions mid-game?
Yes. During an active game, use the Swap button to switch the defender and offender on a team. Stats for each goal are always recorded against the position at the time of the goal.
What is strike rate?
Strike rate = your goals รท total goals in the game ร 100. It shows how much of the scoring you contributed. Higher means you were the dominant scorer.
โ 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 & Stats
What is shown on the leaderboard?
Players ranked by performance points (from all approved games). You can also see win rate, total goals, and best streak. Filter by time period (this week, this month, all time).
What is Friends & Clan view vs Everyone?
Friends & Clan shows players you've added as friends or who are in your clans. Everyone shows all players who have their stats set to Public.
Can I see clan-specific rankings?
Yes. From a clan's page, tap Leaderboard to see rankings filtered to that clan only.
What is a player profile?
Each player has a profile page showing total games, wins, losses, win rate, total goals (with defender/offender split), best streak, and head-to-head records against every opponent. You can also see their top partner and nemesis.
๐ฅ 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 โ